@withpica/mcp-server 2.22.0 → 2.23.0

package/dist/tools/people.d.ts

@@ -1,45 +1,269 @@
 /**
  * People Tools - MCP tools for managing people (artists, composers, etc.)
+ *
+ * ADR-174 Phase 2 item 4 — pica_people_create / pica_people_update
+ * write surfaces are now reconciled against public.people +
+ * public.person_enrichment. `additionalProperties: true` is off;
+ * unknown keys 400 at the route layer. Fields listed under
+ * SATELLITE_ROUTED live on public.person_enrichment and are fanned
+ * out from the service via syncPersonEnrichmentSatellite (see
+ * lib/services/people-admin/enrichment-satellite.ts).
  */
 import { PicaClient } from "@withpica/mcp-sdk";
 import { ToolDefinition, ToolExecutor } from "./index.js";
+/**
+ * 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 declare const PEOPLE_WRITE_PROPERTIES: {
+    readonly first_name: {
+        readonly type: "string";
+        readonly description: "First name";
+    };
+    readonly last_name: {
+        readonly type: "string";
+        readonly description: "Last name";
+    };
+    readonly middle_name: {
+        readonly type: "string";
+        readonly description: "Middle name";
+    };
+    readonly name: {
+        readonly type: "string";
+        readonly description: "Full name. Normally derived from first_name + last_name; set explicitly only for imports where the parts aren't separable.";
+    };
+    readonly stage_name: {
+        readonly type: "string";
+        readonly description: "Primary stage / artist name (legacy singular)";
+    };
+    readonly stage_names: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "All stage / artist names (canonical plural)";
+    };
+    readonly person_type: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "Person classification array (e.g. ['individual'], ['business']). Canonical column — `type` is a deprecated duplicate and will be rejected.";
+    };
+    readonly biography: {
+        readonly type: "string";
+        readonly description: "Biography text";
+    };
+    readonly email: {
+        readonly type: "string";
+        readonly description: "Primary email address";
+    };
+    readonly emails: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "object";
+            readonly properties: {
+                readonly email: {
+                    readonly type: "string";
+                };
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly primary: {
+                    readonly type: "boolean";
+                };
+            };
+        };
+        readonly description: "Additional emails with label/primary metadata";
+    };
+    readonly phone: {
+        readonly type: "string";
+        readonly description: "Phone number";
+    };
+    readonly website: {
+        readonly type: "string";
+        readonly description: "Website URL";
+    };
+    readonly social_media: {
+        readonly type: "object";
+        readonly description: "Social handles keyed by platform, e.g. { twitter: '@ada', instagram: 'ada_lovelace' }";
+    };
+    readonly roles: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly 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.";
+    };
+    readonly tags: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "Tags for categorisation";
+    };
+    readonly cae_ipi_number: {
+        readonly type: "string";
+        readonly description: "CAE/IPI number (songwriter/publisher identifier, 9-11 digits)";
+    };
+    readonly ipn_number: {
+        readonly type: "string";
+        readonly description: "IPN number (performer identifier)";
+    };
+    readonly prs_number: {
+        readonly type: "string";
+        readonly description: "PRS member number";
+    };
+    readonly ppl_number: {
+        readonly type: "string";
+        readonly description: "PPL member number";
+    };
+    readonly mcps_member_number: {
+        readonly type: "string";
+        readonly description: "MCPS member number";
+    };
+    readonly pro_name: {
+        readonly type: "string";
+        readonly description: "Performing rights organisation name (e.g. PRS, ASCAP, BMI, SACEM)";
+    };
+    readonly pro_member_number: {
+        readonly type: "string";
+        readonly description: "Member number at the PRO named in pro_name";
+    };
+    readonly default_publisher: {
+        readonly type: "string";
+        readonly description: "Default publisher name for this person";
+    };
+    readonly default_publisher_ipi: {
+        readonly type: "string";
+        readonly description: "Default publisher's IPI number";
+    };
+    readonly company: {
+        readonly type: "string";
+        readonly description: "Company / organisation name";
+    };
+    readonly position: {
+        readonly type: "string";
+        readonly description: "Job title / position at the company";
+    };
+    readonly territory: {
+        readonly type: "string";
+        readonly description: "Primary territory / market (e.g. 'UK', 'US East Coast')";
+    };
+    readonly relationship_strength: {
+        readonly type: "integer";
+        readonly description: "Relationship strength score (caller-defined scale)";
+    };
+    readonly email_preferences: {
+        readonly type: "object";
+        readonly description: "Email opt-in preferences, e.g. { monthly_digest: true, news_announcements: false }";
+    };
+    readonly profile_image_url: {
+        readonly type: "string";
+        readonly description: "URL to profile image";
+    };
+    readonly notes: {
+        readonly type: "string";
+        readonly description: "Internal notes";
+    };
+    readonly isni: {
+        readonly type: "string";
+        readonly description: "ISNI identifier (16 digits). Stored on person_enrichment satellite.";
+    };
+    readonly musicbrainz_id: {
+        readonly type: "string";
+        readonly description: "MusicBrainz artist ID (UUID). Stored on person_enrichment satellite.";
+    };
+    readonly wikidata_id: {
+        readonly type: "string";
+        readonly description: "Wikidata entity ID (e.g. Q7259). Stored on person_enrichment satellite.";
+    };
+    readonly discogs_artist_id: {
+        readonly type: "string";
+        readonly description: "Discogs artist ID. Stored on person_enrichment satellite.";
+    };
+    readonly deezer_artist_id: {
+        readonly type: "string";
+        readonly description: "Deezer artist ID. Stored on person_enrichment satellite.";
+    };
+    readonly date_of_birth: {
+        readonly type: "string";
+        readonly description: "Date of birth (ISO 8601, YYYY-MM-DD). Stored on person_enrichment satellite.";
+    };
+    readonly gender: {
+        readonly type: "string";
+        readonly description: "Gender (free text; commonly 'male' / 'female' / 'non_binary'). Stored on person_enrichment satellite.";
+    };
+    readonly nationality: {
+        readonly type: "string";
+        readonly description: "Nationality (free text; ISO country name preferred). Stored on person_enrichment satellite.";
+    };
+    readonly birth_place: {
+        readonly type: "string";
+        readonly description: "Place of birth (free text). Stored on person_enrichment satellite.";
+    };
+    readonly instruments: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "Instruments played. Stored on person_enrichment satellite.";
+    };
+    readonly career_start_year: {
+        readonly type: "integer";
+        readonly description: "Year career started (4-digit). Stored on person_enrichment satellite.";
+    };
+};
 export declare class PeopleTools {
-  private pica;
-  constructor(pica: PicaClient);
-  /**
-   * Get all people tools
-   */
-  getTools(): Array<{
-    definition: ToolDefinition;
-    executor: ToolExecutor;
-  }>;
-  /**
-   * Query people — unified list + search
-   */
-  private queryPeople;
-  /**
-   * Inspect person — unified get + get_full with section filtering
-   */
-  private inspectPerson;
-  /**
-   * Create person
-   */
-  private createPerson;
-  /**
-   * Update person
-   */
-  private updatePerson;
-  /**
-   * Delete person
-   */
-  private deletePerson;
-  /**
-   * Enrich from ISNI
-   */
-  private enrichFromISNI;
-  /**
-   * Enrich from MusicBrainz
-   */
-  private enrichFromMusicBrainz;
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all people tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    /**
+     * Query people — unified list + search
+     */
+    private queryPeople;
+    /**
+     * Inspect person — unified get + get_full with section filtering
+     */
+    private inspectPerson;
+    /**
+     * Create person
+     */
+    private createPerson;
+    /**
+     * Update person
+     */
+    private updatePerson;
+    /**
+     * Delete person
+     */
+    private deletePerson;
+    /**
+     * ADR-179 Phase 2 deprecation path for the two per-source person
+     * enrichment tools. The tool definitions stay registered (so
+     * `tools/list` responses still surface them) but every call returns
+     * a structured `TOOL_DEPRECATED` error pointing at
+     * `pica_resolve_person`. This is the one-minor-version window
+     * described in ADR-179 Decision 2 — downstream clients with
+     * hardcoded names get a typed error and a suggested replacement
+     * call, not silent removal.
+     *
+     * Removal is scheduled for the next `@withpica/mcp-server` minor
+     * after Phase 4's publish; see the ADR's Phase 4 entry.
+     */
+    private enrichFromISNI;
+    private enrichFromMusicBrainz;
 }
-//# sourceMappingURL=people.d.ts.map
+//# sourceMappingURL=people.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/tools/people.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAStE,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IAgazE;;OAEG;YACW,WAAW;IAwCzB;;OAEG;YACW,aAAa;IAsE3B;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,YAAY;IAK1B;;OAEG;YACW,cAAc;IAK5B;;OAEG;YACW,qBAAqB;CASpC"}
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/tools/people.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAatE;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2L1B,CAAC;AAEX,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA0KzE;;OAEG;YACW,WAAW;IAwCzB;;OAEG;YACW,aAAa;IAsE3B;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,YAAY;IAK1B;;;;;;;;;;;;OAYG;YACW,cAAc;YAQd,qBAAqB;CASpC"}