@withpica/mcp-server 1.3.0

package/dist/tools/people.js

@@ -0,0 +1,481 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatStructuredList, withBillingGate, } from "@withpica/mcp-utils";
+import { computePersonGapHints } from "./gap-hints.js";
+// The two per-source `pica_people_enrich_*` tools were folded into
+// `pica_resolve_person` by ADR-179 Phase 2 and removed in ADR-154 F13;
+// the corresponding SDK enrich methods are no longer imported here.
+/**
+ * Canonical source for the pica_people_create / pica_people_update input
+ * shape. Mirror of PEOPLE_CORE_WRITE_FIELDS + PEOPLE_SATELLITE_ROUTED_FIELDS
+ * in lib/services/people-admin/write-constants.ts. Keep these two in sync:
+ * if a property is added here it must be added to the allow-list (so the
+ * HTTP route lets it through) and — if it's a satellite field — to
+ * ENRICHMENT_SATELLITE_FIELDS (so the service routes it to person_enrichment).
+ *
+ * Exported for future bulk-tool reuse.
+ */
+export const PEOPLE_WRITE_PROPERTIES = {
+    // names + identity
+    first_name: { type: "string", description: "First name" },
+    last_name: { type: "string", description: "Last name" },
+    middle_name: { type: "string", description: "Middle name" },
+    name: {
+        type: "string",
+        description: "Full name. Normally derived from first_name + last_name; set explicitly only for imports where the parts aren't separable.",
+    },
+    stage_name: {
+        type: "string",
+        description: "Primary stage / artist name (legacy singular)",
+    },
+    stage_names: {
+        type: "array",
+        items: { type: "string" },
+        description: "All stage / artist names (canonical plural)",
+    },
+    person_type: {
+        type: "array",
+        items: { type: "string" },
+        description: "Person classification array (e.g. ['individual'], ['business']). Canonical column — `type` is a deprecated duplicate and will be rejected.",
+    },
+    biography: { type: "string", description: "Biography text" },
+    // contact
+    email: { type: "string", description: "Primary email address" },
+    emails: {
+        type: "array",
+        items: {
+            type: "object",
+            properties: {
+                email: { type: "string" },
+                label: { type: "string" },
+                primary: { type: "boolean" },
+            },
+        },
+        description: "Additional emails with label/primary metadata",
+    },
+    phone: { type: "string", description: "Phone number" },
+    website: { type: "string", description: "Website URL" },
+    social_media: {
+        type: "object",
+        description: "Social handles keyed by platform, e.g. { twitter: '@ada', instagram: 'ada_lovelace' }",
+    },
+    // roles + tags
+    roles: {
+        type: "array",
+        items: { type: "string" },
+        description: "Roles (e.g. ['artist', 'songwriter', 'producer']). Canonical column — `role` singular is a deprecated duplicate and will be rejected. Defaults to ['collaborator'] on create if omitted.",
+    },
+    tags: {
+        type: "array",
+        items: { type: "string" },
+        description: "Tags for categorisation",
+    },
+    // PRO / industry identifiers on people itself
+    cae_ipi_number: {
+        type: "string",
+        description: "CAE/IPI number (songwriter/publisher identifier, 9-11 digits)",
+    },
+    ipn_number: {
+        type: "string",
+        description: "IPN number (performer identifier)",
+    },
+    prs_number: { type: "string", description: "PRS member number" },
+    ppl_number: { type: "string", description: "PPL member number" },
+    mcps_member_number: {
+        type: "string",
+        description: "MCPS member number",
+    },
+    pro_name: {
+        type: "string",
+        description: "Performing rights organisation name (e.g. PRS, ASCAP, BMI, SACEM)",
+    },
+    pro_member_number: {
+        type: "string",
+        description: "Member number at the PRO named in pro_name",
+    },
+    default_publisher: {
+        type: "string",
+        description: "Default publisher name for this person",
+    },
+    default_publisher_ipi: {
+        type: "string",
+        description: "Default publisher's IPI number",
+    },
+    // business-contact fields
+    company: { type: "string", description: "Company / organisation name" },
+    position: {
+        type: "string",
+        description: "Job title / position at the company",
+    },
+    territory: {
+        type: "string",
+        description: "Primary territory / market (e.g. 'UK', 'US East Coast')",
+    },
+    relationship_strength: {
+        type: "integer",
+        description: "Relationship strength score (caller-defined scale)",
+    },
+    // contact prefs
+    email_preferences: {
+        type: "object",
+        description: "Email opt-in preferences, e.g. { monthly_digest: true, news_announcements: false }",
+    },
+    // presence
+    profile_image_url: {
+        type: "string",
+        description: "URL to profile image",
+    },
+    // notes
+    notes: { type: "string", description: "Internal notes" },
+    // ---- Satellite-routed (person_enrichment) ----
+    // These are real columns on public.person_enrichment, not on public.people.
+    // The service layer (lib/services/people-admin/enrichment-satellite.ts)
+    // fans them out via syncPersonEnrichmentSatellite. Reads surface them
+    // back on the person record via a PostgREST join (see person-admin/
+    // constants.ts PERSON_ALL_COLUMNS -> person_enrichment(*)).
+    isni: {
+        type: "string",
+        description: "ISNI identifier (16 digits). Stored on person_enrichment satellite.",
+    },
+    musicbrainz_id: {
+        type: "string",
+        description: "MusicBrainz artist ID (UUID). Stored on person_enrichment satellite.",
+    },
+    wikidata_id: {
+        type: "string",
+        description: "Wikidata entity ID (e.g. Q7259). Stored on person_enrichment satellite.",
+    },
+    discogs_artist_id: {
+        type: "string",
+        description: "Discogs artist ID. Stored on person_enrichment satellite.",
+    },
+    deezer_artist_id: {
+        type: "string",
+        description: "Deezer artist ID. Stored on person_enrichment satellite.",
+    },
+    date_of_birth: {
+        type: "string",
+        description: "Date of birth (ISO 8601, YYYY-MM-DD). Stored on person_enrichment satellite.",
+    },
+    gender: {
+        type: "string",
+        description: "Gender (free text; commonly 'male' / 'female' / 'non_binary'). Stored on person_enrichment satellite.",
+    },
+    nationality: {
+        type: "string",
+        description: "Nationality (free text; ISO country name preferred). Stored on person_enrichment satellite.",
+    },
+    birth_place: {
+        type: "string",
+        description: "Place of birth (free text). Stored on person_enrichment satellite.",
+    },
+    instruments: {
+        type: "array",
+        items: { type: "string" },
+        description: "Instruments played. Stored on person_enrichment satellite.",
+    },
+    career_start_year: {
+        type: "integer",
+        description: "Year career started (4-digit). Stored on person_enrichment satellite.",
+    },
+};
+export class PeopleTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    /**
+     * Get all people tools
+     */
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_people_query",
+                    description: "Find people by name, role, or other criteria. " +
+                        "→ then: pica_people_inspect (details for a specific person)",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: {
+                                type: "string",
+                                description: "Search by name, email, or IPI",
+                            },
+                            role: {
+                                type: "string",
+                                description: "Filter by role (e.g. artist, songwriter, producer)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default: 50)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset",
+                            },
+                        },
+                    },
+                },
+                executor: this.queryPeople.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_inspect",
+                    description: "Get details for a specific person. Omit sections for everything. " +
+                        "→ then: pica_credits_update (add to work), pica_resolve_person (fill identifiers from ISNI/MusicBrainz)",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID",
+                            },
+                            sections: {
+                                type: "array",
+                                items: {
+                                    type: "string",
+                                    enum: [
+                                        "basic",
+                                        "credits",
+                                        "recording_credits",
+                                        "agreements",
+                                        "identifiers",
+                                        "enrichment",
+                                    ],
+                                },
+                                description: 'Which data sections to include. Omit for all sections. Use ["basic"] for lightweight lookup.',
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.inspectPerson.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_create",
+                    description: "Create a new person record. IMPORTANT: always call pica_people_query first to check for an existing record — duplicate people break credits and notifications. " +
+                        "External identifiers (isni, musicbrainz_id, wikidata_id, discogs_artist_id, deezer_artist_id) and biographical fields (date_of_birth, gender, nationality, birth_place, instruments, career_start_year) are stored on the person_enrichment satellite table — set them here and the service fans them out. " +
+                        "Deprecated duplicates that will be rejected: `type` (use `person_type`), `role` (use `roles`). " +
+                        "→ before: pica_people_query (check duplicates) → then: pica_resolve_person (fill identifiers from ISNI/MusicBrainz), pica_credits_update (add to work)",
+                    workflows: ["person-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: PEOPLE_WRITE_PROPERTIES,
+                        required: ["first_name", "last_name"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "person creation", this.createPerson.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_people_update",
+                    description: "Update an existing person record. Pass only the fields to change. " +
+                        "External identifiers (isni, musicbrainz_id, wikidata_id, discogs_artist_id, deezer_artist_id) and biographical fields (date_of_birth, gender, nationality, birth_place, instruments, career_start_year) are stored on the person_enrichment satellite — updating them here fans out through the service. " +
+                        "Deprecated duplicates that will be rejected: `type` (use `person_type`), `role` (use `roles`). " +
+                        "If setting email, a 500 may mean the email already exists on another person record (check via pica_people_query). " +
+                        "→ then: pica_people_inspect (verify changes persisted)",
+                    workflows: ["person-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID (required)",
+                            },
+                            ...PEOPLE_WRITE_PROPERTIES,
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "person update", this.updatePerson.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_people_delete",
+                    description: "Delete a person record",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "person deletion", this.deletePerson.bind(this)),
+            },
+        ];
+    }
+    /**
+     * Query people — unified list + search
+     */
+    async queryPeople(args) {
+        const limit = args.limit || 50;
+        const offset = args.offset || 0;
+        let items;
+        let total;
+        if (args.query) {
+            // Use server-side search when a query is provided
+            const result = await this.pica.people.search({
+                query: args.query,
+                limit,
+                offset,
+            });
+            items = result.data;
+            total = result.total;
+        }
+        else {
+            // Plain list
+            const people = await this.pica.people.list({ limit });
+            items = people;
+            total = people.length;
+        }
+        // Apply role filter client-side if provided
+        if (args.role) {
+            const roleLower = args.role.toLowerCase();
+            items = items.filter((person) => {
+                const roles = person.roles || [];
+                return roles.some((r) => r.toLowerCase() === roleLower);
+            });
+            total = items.length;
+        }
+        return formatStructuredList(items, "person", {
+            query: args.query,
+            total,
+            limit,
+        });
+    }
+    /**
+     * Inspect person — unified get + get_full with section filtering
+     */
+    async inspectPerson(args) {
+        const sections = args.sections;
+        const allSections = !sections || sections.length === 0 || sections.length === 6; // all 6 sections requested
+        if (sections && sections.length === 1 && sections[0] === "basic") {
+            // Lightweight: just the basic person record
+            const person = await this.pica.people.get(args.id);
+            const base = { person };
+            // ADR-193 Surface 2 — basic-section view still knows email,
+            // but identifiers aren't fetched here so gap hints stay quiet
+            // on industry-id gaps until the caller pulls identifiers.
+            const gap_hints = computePersonGapHints(base);
+            const enriched = gap_hints.length > 0 ? { ...base, gap_hints } : base;
+            return formatSuccess("Person basic details", enriched);
+        }
+        // Full context call — returns person, creditedWorks, recordingCredits, agreements, identifiers
+        const fullResult = await this.pica.entityContext.getPersonFull(args.id);
+        const data = fullResult;
+        if (allSections) {
+            // Return everything
+            const person = data.person || {};
+            const fullName = person.name || args.id;
+            const workCount = data.creditedWorks?.length || 0;
+            const recordingCount = data.recordingCredits?.length || 0;
+            const identifiers = data.identifiers || [];
+            const idTypes = identifiers.map((i) => i.type);
+            // ADR-193 Surface 2 — compute over the full payload so identifier
+            // heuristics see what the entity-context call surfaced.
+            const gap_hints = computePersonGapHints(data);
+            const enriched = gap_hints.length > 0
+                ? { ...fullResult, gap_hints }
+                : fullResult;
+            return formatSuccess(`"${fullName}" — credited on ${workCount} work${workCount !== 1 ? "s" : ""}, ` +
+                `${recordingCount} recording${recordingCount !== 1 ? "s" : ""}. ` +
+                `Identifiers: ${idTypes.length > 0 ? idTypes.join(", ") : "none"}.`, enriched);
+        }
+        // Build filtered response from full result
+        const result = {};
+        for (const section of sections) {
+            try {
+                switch (section) {
+                    case "basic":
+                        result.person = data.person;
+                        break;
+                    case "credits":
+                        result.creditedWorks = data.creditedWorks || [];
+                        break;
+                    case "recording_credits":
+                        result.recordingCredits = data.recordingCredits || [];
+                        break;
+                    case "agreements":
+                        result.agreements = data.agreements || [];
+                        break;
+                    case "identifiers":
+                        result.identifiers = data.identifiers || [];
+                        break;
+                    case "enrichment":
+                        result.enrichment = data.enrichment || data.identifiers || [];
+                        break;
+                }
+            }
+            catch {
+                // best-effort — the switch body is pure post-fetch property
+                // access on `data` (already resolved by getPersonFull above),
+                // so this catch fires only on unexpected runtime issues like
+                // a malformed payload. Not a section-fetch catch — ADR-224
+                // Rule 11 doesn't apply, and the lint recognises this marker.
+                result[section] = { error: `Failed to load ${section}` };
+            }
+        }
+        const person = data.person || {};
+        const fullName = person.name || args.id;
+        // ADR-193 Surface 2 — compute against the filtered result so hints
+        // only fire on sections the caller actually requested.
+        const gap_hints = computePersonGapHints(result);
+        const enriched = gap_hints.length > 0 ? { ...result, gap_hints } : result;
+        return formatSuccess(`"${fullName}" — sections: ${sections.join(", ")}`, enriched);
+    }
+    /**
+     * Create person
+     */
+    async createPerson(args) {
+        // Default roles to ["collaborator"] if not provided — the service requires at least one role
+        if (!args.roles || !Array.isArray(args.roles) || args.roles.length === 0) {
+            args.roles = ["collaborator"];
+        }
+        const person = await this.pica.people.create(args);
+        const hints = [
+            {
+                gap: "person_not_credited",
+                suggestion: "Add this person as a credit on a work (pica_credits_update)",
+                severity: "important",
+            },
+        ];
+        if (!person?.isni && !person?.musicbrainz_id) {
+            hints.push({
+                gap: "person_missing_identifiers",
+                suggestion: "Enrich with ISNI or MusicBrainz for royalty collection (pica_resolve_person)",
+                severity: "important",
+            });
+        }
+        if (person?.email) {
+            hints.push({
+                gap: "person_not_invited",
+                suggestion: `Invite ${person.first_name || "them"} to PICA so they can manage their own profile (pica_collaborators_invite)`,
+                severity: "nice_to_have",
+            });
+        }
+        return formatSuccess("Person created successfully", person, hints);
+    }
+    /**
+     * Update person
+     */
+    async updatePerson(args) {
+        const { id, ...updates } = args;
+        const person = await this.pica.people.update(id, updates);
+        return formatSuccess("Person updated successfully", person);
+    }
+    /**
+     * Delete person
+     */
+    async deletePerson(args) {
+        await this.pica.people.delete(args.id);
+        return formatSuccess(`Person ${args.id} deleted successfully`);
+    }
+}
+//# sourceMappingURL=people.js.map

package/dist/tools/people.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"people.js","sourceRoot":"","sources":["../../src/tools/people.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAgB7D,OAAO,EAEL,aAAa,EACb,oBAAoB,EACpB,eAAe,GAEhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,mEAAmE;AACnE,uEAAuE;AACvE,oEAAoE;AAEpE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,mBAAmB;IACnB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;IACzD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;IACvD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;IAC3D,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,4HAA4H;KAC/H;IACD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+CAA+C;KAC7D;IACD,WAAW,EAAE;QACX,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,6CAA6C;KAC3D;IACD,WAAW,EAAE;QACX,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EACT,4IAA4I;KAC/I;IACD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;IAE5D,UAAU;IACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IAC/D,MAAM,EAAE;QACN,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC7B;SACF;QACD,WAAW,EAAE,+CAA+C;KAC7D;IACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;IACtD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;IACvD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,uFAAuF;KAC1F;IAED,eAAe;IACf,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EACT,0LAA0L;KAC7L;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,yBAAyB;KACvC;IAED,8CAA8C;IAC9C,cAAc,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,+DAA+D;KAClE;IACD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mCAAmC;KACjD;IACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;IAChE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;IAChE,kBAAkB,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oBAAoB;KAClC;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,mEAAmE;KACtE;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4CAA4C;KAC1D;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wCAAwC;KACtD;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gCAAgC;KAC9C;IAED,0BAA0B;IAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;IACvE,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;KACnD;IACD,SAAS,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,yDAAyD;KACvE;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,oDAAoD;KAClE;IAED,gBAAgB;IAChB,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,oFAAoF;KACvF;IAED,WAAW;IACX,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sBAAsB;KACpC;IAED,QAAQ;IACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;IAExD,iDAAiD;IACjD,4EAA4E;IAC5E,wEAAwE;IACxE,sEAAsE;IACtE,oEAAoE;IACpE,4DAA4D;IAE5D,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,qEAAqE;KACxE;IACD,cAAc,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,sEAAsE;KACzE;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,yEAAyE;KAC5E;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,2DAA2D;KACzE;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0DAA0D;KACxE;IACD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,8EAA8E;KACjF;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,uGAAuG;KAC1G;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,6FAA6F;KAChG;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,oEAAoE;KACvE;IACD,WAAW,EAAE;QACX,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,4DAA4D;KAC1E;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,SAAS;QACf,WAAW,EACT,uEAAuE;KAC1E;CACO,CAAC;AAEX,MAAM,OAAO,WAAW;IACd,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,mBAAmB;oBACzB,WAAW,EACT,gDAAgD;wBAChD,6DAA6D;oBAC/D,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+BAA+B;6BAC7C;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,oDAAoD;6BACvD;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,2BAA2B;6BACzC;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,mBAAmB;6BACjC;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;aACtC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;oBAC3B,WAAW,EACT,mEAAmE;wBACnE,yGAAyG;oBAC3G,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,WAAW;6BACzB;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,OAAO;gCACb,KAAK,EAAE;oCACL,IAAI,EAAE,QAAQ;oCACd,IAAI,EAAE;wCACJ,OAAO;wCACP,SAAS;wCACT,mBAAmB;wCACnB,YAAY;wCACZ,aAAa;wCACb,YAAY;qCACb;iCACF;gCACD,WAAW,EACT,8FAA8F;6BACjG;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;qBACjB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;aACxC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EACT,iKAAiK;wBACjK,6SAA6S;wBAC7S,iGAAiG;wBACjG,wJAAwJ;oBAC1J,SAAS,EAAE,CAAC,iBAAiB,CAAC;oBAC9B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,uBAAuB;wBACnC,QAAQ,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;qBACtC;iBACF;gBACD,QAAQ,EAAE,eAAe,CACvB,IAAI,CAAC,IAAI,EACT,iBAAiB,EACjB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7B;aACF;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EACT,oEAAoE;wBACpE,2SAA2S;wBAC3S,iGAAiG;wBACjG,oHAAoH;wBACpH,wDAAwD;oBAC1D,SAAS,EAAE,CAAC,iBAAiB,CAAC;oBAC9B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,sBAAsB;6BACpC;4BACD,GAAG,uBAAuB;yBAC3B;wBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;qBACjB;iBACF;gBACD,QAAQ,EAAE,eAAe,CACvB,IAAI,CAAC,IAAI,EACT,eAAe,EACf,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7B;aACF;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EAAE,wBAAwB;oBACrC,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,WAAW;6BACzB;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;qBACjB;iBACF;gBACD,QAAQ,EAAE,eAAe,CACvB,IAAI,CAAC,IAAI,EACT,iBAAiB,EACjB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7B;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,IAAyB;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAEhC,IAAI,KAAY,CAAC;QACjB,IAAI,KAAa,CAAC;QAElB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,kDAAkD;YAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YACH,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;YACpB,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,aAAa;YACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,KAAK,GAAG,MAAM,CAAC;YACf,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,CAAC;QAED,4CAA4C;QAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,MAAW,EAAE,EAAE;gBACnC,MAAM,KAAK,GAAa,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;QACvB,CAAC;QAED,OAAO,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;YACL,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,IAAyB;QACnD,MAAM,QAAQ,GAAyB,IAAI,CAAC,QAAQ,CAAC;QACrD,MAAM,WAAW,GACf,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,2BAA2B;QAE1F,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACjE,4CAA4C;YAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC;YACxB,4DAA4D;YAC5D,8DAA8D;YAC9D,0DAA0D;YAC1D,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACtE,OAAO,aAAa,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC;QAED,+FAA+F;QAC/F,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,UAAiB,CAAC;QAE/B,IAAI,WAAW,EAAE,CAAC;YAChB,oBAAoB;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAC;YAClD,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,CAAC;YAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAEpD,kEAAkE;YAClE,wDAAwD;YACxD,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAA+B,CAAC,CAAC;YACzE,MAAM,QAAQ,GACZ,SAAS,CAAC,MAAM,GAAG,CAAC;gBAClB,CAAC,CAAC,EAAE,GAAI,UAAsC,EAAE,SAAS,EAAE;gBAC3D,CAAC,CAAC,UAAU,CAAC;YAEjB,OAAO,aAAa,CAClB,IAAI,QAAQ,mBAAmB,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;gBAC5E,GAAG,cAAc,aAAa,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;gBACjE,gBAAgB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,EACrE,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,KAAK,MAAM,OAAO,IAAI,QAAS,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,QAAQ,OAAO,EAAE,CAAC;oBAChB,KAAK,OAAO;wBACV,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;wBAC5B,MAAM;oBACR,KAAK,SAAS;wBACZ,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;wBAChD,MAAM;oBACR,KAAK,mBAAmB;wBACtB,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC;wBACtD,MAAM;oBACR,KAAK,YAAY;wBACf,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;wBAC1C,MAAM;oBACR,KAAK,aAAa;wBAChB,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;wBAC5C,MAAM;oBACR,KAAK,YAAY;wBACf,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;wBAC9D,MAAM;gBACV,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,4DAA4D;gBAC5D,8DAA8D;gBAC9D,6DAA6D;gBAC7D,2DAA2D;gBAC3D,8DAA8D;gBAC9D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,kBAAkB,OAAO,EAAE,EAAE,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QAExC,mEAAmE;QACnE,uDAAuD;QACvD,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAE1E,OAAO,aAAa,CAClB,IAAI,QAAQ,iBAAiB,QAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACnD,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,IAAyB;QAClD,6FAA6F;QAC7F,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,KAAK,GAAG,CAAC,cAAc,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,KAAK,GAAqB;YAC9B;gBACE,GAAG,EAAE,qBAAqB;gBAC1B,UAAU,EACR,6DAA6D;gBAC/D,QAAQ,EAAE,WAAW;aACtB;SACF,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,4BAA4B;gBACjC,UAAU,EACR,8EAA8E;gBAChF,QAAQ,EAAE,WAAW;aACtB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,oBAAoB;gBACzB,UAAU,EAAE,UAAU,MAAM,CAAC,UAAU,IAAI,MAAM,2EAA2E;gBAC5H,QAAQ,EAAE,cAAc;aACzB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,aAAa,CAAC,6BAA6B,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,IAAyB;QAClD,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,aAAa,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACK,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/projects.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Projects Tools — group works into projects (albums, EPs, compilations, or any collection)
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ProjectsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listProjects;
+    private getProject;
+    private createProject;
+    private updateProject;
+    private deleteProject;
+    private attachWorks;
+}
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.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;YA6Q3D,YAAY;YAQZ,UAAU;YAKV,aAAa;YAMb,aAAa;YAMb,aAAa;YAKb,WAAW;CAyC1B"}