@withpica/mcp-server-directory 1.3.0 → 1.4.0

package/dist/prompts/public-question-atlas.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Public Question Atlas — ADR-229 Decision 1.
+ *
+ * Source-of-truth registry mapping natural public-discovery questions to
+ * the canonical directory-MCP tool resolution. Sister of:
+ *   - `mcp-server/src/prompts/creator-question-atlas.ts` (ADR-226, customer)
+ *   - `team-mcp-server/src/prompts/operator-question-atlas.ts` (ADR-228, operator)
+ *
+ * Read by:
+ *
+ *   - lint Rule 11F (extended in ADR-229) — validates every `directory_*`
+ *     tool's `Use when the user asks` block cites questions resolving
+ *     here, rejects creator/operator atlas cross-pollination, asserts
+ *     mutual exclusivity of `clean_empty_state` and `fallback_when_empty`,
+ *     and asserts `disambiguation` shape integrity
+ *   - `scripts/intent-resolution-eval.ts --surface=directory` (ADR-229 PR-3)
+ *   - the Phase 4 description rewrites — `Use when the user asks` blocks
+ *     pull question + synonym strings from here
+ *
+ * The `AtlasEntry` type is inline-duplicated rather than imported from a
+ * shared package, mirroring ADR-228's choice (Open Question 3 default —
+ * extract to `packages/mcp-atlas-types/` only if a fourth MCP surface
+ * lands or the type drift becomes painful).
+ *
+ * Two shape extensions vs the creator and operator atlases (per ADR-229
+ * Decision 4):
+ *
+ *   1. `clean_empty_state?: { message; suggest_query_shape }` — public-
+ *      surface analog of `fallback_when_empty`. The directory has no
+ *      internal action to nudge toward (the empty state IS the final
+ *      answer for the anonymous user); this field carries the prescribed
+ *      empty-state copy plus a query-shape hint for the calling LLM.
+ *
+ *   2. `disambiguation?: { ambiguous_terms[]; resolver_tool; resolver_intent }` —
+ *      first-class concern on the public surface (creator/operator MCPs
+ *      have a calling-context that narrows the search; the public
+ *      directory hits "Bowie", "Sade", "Madonna", "Lover Boy" constantly
+ *      and must declare an explicit resolver step).
+ *
+ * `clean_empty_state` and `fallback_when_empty` are mutually exclusive on
+ * a single entry — Rule 11F enforces this at lint time.
+ *
+ * The public atlas omits `natural_domain` (creator-side binds to
+ * `discovery.ts` CATEGORIES; the directory MCP has no equivalent
+ * taxonomy — the discovery surface is search and lookup, not category-
+ * faceted browse). It also omits `available_when` (the operator atlas's
+ * forward-compat hook for unshipped sections; the directory has no
+ * deferred-section concept).
+ */
+export interface AtlasFallback {
+    message: string;
+    next_tool: string;
+}
+export interface AtlasCleanEmptyState {
+    /**
+     * Atlas-prescribed copy for the empty-state response. The calling LLM
+     * may render in its own voice; the suggested-query-shape hint is the
+     * load-bearing part.
+     */
+    message: string;
+    /**
+     * Free-text hint for how to refine the query, interpreted by the LLM
+     * as guidance (not rendered verbatim). Example:
+     * `"title + writer | title + year | ISWC if known"`.
+     */
+    suggest_query_shape: string;
+}
+export interface AtlasDisambiguation {
+    /**
+     * Names known to be ambiguous in the music-metadata domain (multiple
+     * persons, artist projects, or works with the same string). v1 ships
+     * a static list; v2 (deferred per ADR-229 § Risks #3) could resolve
+     * dynamically against the index's name-collision frequency.
+     */
+    ambiguous_terms: string[];
+    /**
+     * The directory tool the agent should call FIRST to surface candidate
+     * entities for the user to disambiguate before committing to the
+     * lookup tool in `resolves_to`.
+     */
+    resolver_tool: string;
+    /**
+     * Free-text guidance for the LLM on how to run the resolver step.
+     * Example: `"Call directory_lookup_person first to surface candidates;
+     * ask which one before calling directory_list_works."`
+     */
+    resolver_intent: string;
+}
+export type AtlasResolution = {
+    kind: "tool";
+    name: string;
+    default_args?: Record<string, unknown>;
+} | {
+    kind: "prompt";
+    name: string;
+};
+export interface AtlasEntry {
+    question: string;
+    synonyms: string[];
+    resolves_to: AtlasResolution;
+    /** Mutually exclusive with `clean_empty_state` (lint-enforced). */
+    fallback_when_empty?: AtlasFallback;
+    /** ADR-229 Decision 4 — public-surface empty-state contract. */
+    clean_empty_state?: AtlasCleanEmptyState;
+    /** ADR-229 Decision 4 — public-surface name-collision contract. */
+    disambiguation?: AtlasDisambiguation;
+}
+/**
+ * Names known-ambiguous in the music-metadata domain — multiple persons
+ * sharing a stage name, or artist project names that collide with
+ * person names. Seed list per ADR-229 § Open Q2 (case-insensitive — the
+ * lint and the resolver normalise on lowercase).
+ *
+ * Grow this list as Phase 5 eval data surfaces real collisions the
+ * static seed misses. Do not prune without eval evidence — the cost of
+ * missing a real collision (wrong-tool routing on a public-facing
+ * surface) is higher than the cost of an extra resolver call.
+ */
+export declare const AMBIGUOUS_NAMES: string[];
+export declare const PUBLIC_ATLAS: AtlasEntry[];
+//# sourceMappingURL=public-question-atlas.d.ts.map

package/dist/prompts/public-question-atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-question-atlas.d.ts","sourceRoot":"","sources":["../../src/prompts/public-question-atlas.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,eAAe,CAAC;IAC7B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,aAAa,CAAC;IACpC,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,mEAAmE;IACnE,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,EAWnC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,UAAU,EA+apC,CAAC"}

package/dist/prompts/public-question-atlas.js

@@ -0,0 +1,434 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * Names known-ambiguous in the music-metadata domain — multiple persons
+ * sharing a stage name, or artist project names that collide with
+ * person names. Seed list per ADR-229 § Open Q2 (case-insensitive — the
+ * lint and the resolver normalise on lowercase).
+ *
+ * Grow this list as Phase 5 eval data surfaces real collisions the
+ * static seed misses. Do not prune without eval evidence — the cost of
+ * missing a real collision (wrong-tool routing on a public-facing
+ * surface) is higher than the cost of an extra resolver call.
+ */
+export const AMBIGUOUS_NAMES = [
+    "Bowie",
+    "Sade",
+    "Madonna",
+    "Cher",
+    "Drake",
+    "Prince",
+    "Eminem",
+    "Beyoncé",
+    "Adele",
+    "Sia",
+];
+export const PUBLIC_ATLAS = [
+    // ─────────────────────────────────────────────────────────────────
+    // A. Identifier-lookup — direct resolution, no disambiguation
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "what's the ISWC for X?",
+        synonyms: ["ISWC of X", "song code for X", "registration number for X"],
+        resolves_to: { kind: "tool", name: "directory_lookup_work" },
+        clean_empty_state: {
+            message: "No work matched that title in our index. The work may not be " +
+                "registered with a society we mirror, or the title may be " +
+                "ambiguous — try a writer name or year of release to narrow.",
+            suggest_query_shape: "title + writer | title + year | ISWC if known",
+        },
+    },
+    {
+        question: "lookup IPI 12345",
+        synonyms: [
+            "find IPI X",
+            "person with IPI X",
+            "who is IPI X?",
+            "look up IPI number",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_person" },
+        clean_empty_state: {
+            message: "No creator matched that IPI in our index. The IPI may not be " +
+                "mirrored from the source society yet, or it may belong to a " +
+                "publisher rather than a writer — try the directory_list_people " +
+                "filter or search by name.",
+            suggest_query_shape: "IPI | ISNI | writer name | publisher name",
+        },
+    },
+    {
+        question: "lookup ISRC X",
+        synonyms: [
+            "what's the work for ISRC X?",
+            "find the work for this recording",
+            "look up ISRC code",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_isrc" },
+        clean_empty_state: {
+            message: "No work matched that ISRC in our index. The recording may not " +
+                "be linked to a registered work yet, or the ISRC may belong to " +
+                "a recording outside our mirrored societies — try a title or " +
+                "writer-name lookup.",
+            suggest_query_shape: "ISRC | title + artist | ISWC if known",
+        },
+    },
+    {
+        question: "lookup ISNI X",
+        synonyms: [
+            "find creator by ISNI",
+            "person with ISNI X",
+            "look up ISNI identifier",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_person" },
+        clean_empty_state: {
+            message: "No creator matched that ISNI in our index. The creator may not " +
+                "have an ISNI registered, or the ISNI may not be mirrored — try " +
+                "an IPI lookup or a name search.",
+            suggest_query_shape: "ISNI | IPI | creator name",
+        },
+    },
+    {
+        question: "find creator by MusicBrainz ID",
+        synonyms: ["lookup MBID X", "person with MusicBrainz ID"],
+        resolves_to: { kind: "tool", name: "directory_lookup_person" },
+        clean_empty_state: {
+            message: "No creator matched that MusicBrainz ID in our index. The MBID " +
+                "may not be mirrored, or it may identify a release/recording " +
+                "rather than a person — try an ISNI or name lookup.",
+            suggest_query_shape: "MBID | ISNI | creator name",
+        },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // B. Name-lookup — works
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "who wrote X?",
+        synonyms: [
+            "who composed X?",
+            "writers of X",
+            "songwriters for X",
+            "credits for song X",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_work" },
+        clean_empty_state: {
+            message: "No work matched that title. The song may not be in our index " +
+                "yet, or the title may be ambiguous (many works share the same " +
+                "title) — try a writer name or year of release.",
+            suggest_query_shape: "title + writer | title + year | ISWC if known",
+        },
+    },
+    {
+        question: "find me song X",
+        synonyms: ["look up song X by title", "is there a song called X?"],
+        resolves_to: { kind: "tool", name: "directory_lookup_work" },
+        clean_empty_state: {
+            message: "No work matched that title in our index. Try refining with the " +
+                "writer's name, year of release, or the ISWC if you have it.",
+            suggest_query_shape: "title + writer | title + year | ISWC if known",
+        },
+    },
+    {
+        question: "tell me about song X",
+        synonyms: [
+            "show me song X",
+            "what do you know about song X?",
+            "details for song X",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_work" },
+    },
+    {
+        question: "find recordings of X",
+        synonyms: [
+            "versions of X",
+            "covers of X",
+            "who recorded X?",
+            "list recordings of song X",
+        ],
+        // Disambiguation routes through directory_lookup_work first so the
+        // agent can pick the right work-row; recordings then come from the
+        // work-detail response. NEVER directory_search_recordings — that
+        // tool is audio-feature-only despite the verb match.
+        disambiguation: {
+            ambiguous_terms: AMBIGUOUS_NAMES,
+            resolver_tool: "directory_lookup_work",
+            resolver_intent: "Call directory_lookup_work first to identify the work " +
+                "(multiple works may share the title); then read the recordings[] " +
+                "field from the work-detail response. If the user typed an " +
+                "ISRC-shaped string, call directory_lookup_isrc instead. " +
+                "DO NOT call directory_search_recordings — that tool is for " +
+                "audio-feature filters (BPM/key/energy), not recording lookup.",
+        },
+        resolves_to: { kind: "tool", name: "directory_lookup_work" },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // C. Name-lookup — people (heavy disambiguation)
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "find Bowie's songs",
+        synonyms: [
+            "songs by X",
+            "X discography",
+            "X's catalog",
+            "what has X written?",
+        ],
+        disambiguation: {
+            ambiguous_terms: AMBIGUOUS_NAMES,
+            resolver_tool: "directory_lookup_person",
+            resolver_intent: "Call directory_lookup_person first to surface candidate persons " +
+                "(many stage names map to multiple creators); ask the user to " +
+                "pick one before calling directory_list_works with the resolved " +
+                "person ID.",
+        },
+        resolves_to: { kind: "tool", name: "directory_list_works" },
+    },
+    {
+        question: "who is creator X?",
+        synonyms: [
+            "find creator X",
+            "look up artist by name",
+            "find the songwriter X",
+        ],
+        disambiguation: {
+            ambiguous_terms: AMBIGUOUS_NAMES,
+            resolver_tool: "directory_lookup_person",
+            resolver_intent: "Call directory_lookup_person; if the response shows multiple " +
+                "candidates (common for stage names), surface them and let the " +
+                "user pick before any follow-up call.",
+        },
+        resolves_to: { kind: "tool", name: "directory_lookup_person" },
+    },
+    {
+        question: "tell me about creator X",
+        synonyms: [
+            "show me creator X",
+            "what do you know about creator X?",
+            "details for creator X",
+            "what's X's catalog?",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_person" },
+    },
+    {
+        question: "who performs this song?",
+        synonyms: [
+            "who recorded this version?",
+            "performers of this recording",
+            "artist on this ISRC",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_isrc" },
+        clean_empty_state: {
+            message: "No recording matched that identifier. If you have a song title " +
+                "instead of an ISRC, look up the work and read its recordings " +
+                "list. Performer credits surface there per recording.",
+            suggest_query_shape: "ISRC | work title + artist",
+        },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // D. Discovery-traversal / chain (graph shape)
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "show me the rights chain for X",
+        synonyms: [
+            "full graph for X",
+            "rights chain on this song",
+            "what's the chain for X?",
+        ],
+        resolves_to: { kind: "tool", name: "directory_chain" },
+    },
+    {
+        question: "give me everything on this song",
+        synonyms: [
+            "everything we know about this work",
+            "what's the full picture for X?",
+            "full picture for X",
+            "the whole graph for X",
+        ],
+        resolves_to: { kind: "tool", name: "directory_chain" },
+    },
+    {
+        question: "trace the chain from this writer to that work",
+        synonyms: [
+            "how is X connected to Y?",
+            "trace this credit",
+            "show the connection between X and Y",
+        ],
+        resolves_to: { kind: "tool", name: "directory_chain" },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // E. Browse / filter
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "list works in PICA",
+        synonyms: [
+            "browse the catalog",
+            "what works are in the directory?",
+            "show me all works",
+        ],
+        resolves_to: { kind: "tool", name: "directory_list_works" },
+    },
+    {
+        question: "works starting with B",
+        synonyms: [
+            "list works starting with letter X",
+            "browse catalog by first letter",
+            "alphabetical work browse",
+        ],
+        resolves_to: {
+            kind: "tool",
+            name: "directory_list_works",
+            default_args: { letter: "B" },
+        },
+    },
+    {
+        question: "find works by publisher X",
+        synonyms: [
+            "list publisher X's works",
+            "what's in publisher X's catalog?",
+            "publisher catalog browse",
+        ],
+        resolves_to: { kind: "tool", name: "directory_list_works" },
+    },
+    {
+        question: "find works by label X",
+        synonyms: [
+            "list label X's recordings",
+            "what's on label X?",
+            "label catalog browse",
+        ],
+        resolves_to: { kind: "tool", name: "directory_list_works" },
+    },
+    {
+        question: "list creators in PICA",
+        synonyms: [
+            "browse the people directory",
+            "what creators are in the directory?",
+            "show me all creators",
+        ],
+        resolves_to: { kind: "tool", name: "directory_list_people" },
+    },
+    {
+        question: "people starting with B",
+        synonyms: [
+            "list creators starting with letter X",
+            "browse creators by first letter",
+            "alphabetical people browse",
+        ],
+        resolves_to: {
+            kind: "tool",
+            name: "directory_list_people",
+            default_args: { letter: "B" },
+        },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // F. Audio-feature search (sync licensing — distinct from text search)
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "find upbeat tracks around 120 BPM",
+        synonyms: [
+            "find tracks at X BPM",
+            "find energetic music for sync",
+            "tracks with high energy",
+        ],
+        resolves_to: { kind: "tool", name: "directory_search_recordings" },
+    },
+    {
+        question: "find instrumental tracks in C minor",
+        synonyms: [
+            "tracks in [key]",
+            "instrumental tracks for sync",
+            "find moody music in a minor key",
+        ],
+        resolves_to: { kind: "tool", name: "directory_search_recordings" },
+    },
+    {
+        question: "tracks at X BPM in [key]",
+        synonyms: [
+            "find music matching tempo and key",
+            "audio-feature search for sync",
+            "filter recordings by audio characteristics",
+        ],
+        resolves_to: { kind: "tool", name: "directory_search_recordings" },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // G. Cross-type search (entity type unknown)
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "find me X",
+        synonyms: [
+            "is there anything about X in the directory?",
+            "find any record of X",
+            "search the directory for X",
+        ],
+        resolves_to: { kind: "tool", name: "directory_search" },
+        clean_empty_state: {
+            message: "No matches in our public directory. The work, creator, or " +
+                "recording may not be mirrored from a society we cover yet, or " +
+                "the spelling may differ — try an identifier (ISWC / ISRC / IPI) " +
+                "if you have one.",
+            suggest_query_shape: "name + role | identifier (ISWC/ISRC/IPI/ISNI) | title + writer",
+        },
+    },
+    {
+        question: "who or what is X?",
+        synonyms: [
+            "is X a song or a person?",
+            "what kind of thing is X?",
+            "fan-out search for X",
+        ],
+        resolves_to: { kind: "tool", name: "directory_search" },
+        clean_empty_state: {
+            message: "No matches in our public directory across works or creators. " +
+                "Try narrowing to one entity type (work title or creator name), " +
+                "or supply an identifier if you have one.",
+            suggest_query_shape: "title + writer | creator name + role | identifier",
+        },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // H. Registration / status (specialised lookups)
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "is this song registered?",
+        synonyms: [
+            "is X in PICA?",
+            "is this work known?",
+            "registration status of X",
+            "is the ISWC issued for X?",
+        ],
+        resolves_to: { kind: "tool", name: "directory_lookup_work" },
+        clean_empty_state: {
+            message: "We don't have this work in our directory. That can mean it's " +
+                "unregistered, registered with a society we don't mirror, or the " +
+                "title is ambiguous. Try a writer name or year to narrow, or " +
+                "look up by ISWC if you have one.",
+            suggest_query_shape: "title + writer | title + year | ISWC if known",
+        },
+    },
+    {
+        // ADR-140 Phase 2b — skill discovery meta-questions.
+        // Routes to directory_skill_list so an external LLM connecting to the
+        // directory MCP via Anthropic's MCP Directory or ChatGPT Apps catalogue
+        // can ask "what can this server do?" and get a list of named
+        // methodologies (find-music-for-sync-brief, etc.) rather than having
+        // to read the full 9-tool surface description-by-description.
+        question: "what skills do you have?",
+        synonyms: [
+            "what can you do?",
+            "show me your methodologies",
+            "how do I find music here?",
+            "how do I use this directory?",
+            "what workflows are available?",
+        ],
+        resolves_to: { kind: "tool", name: "directory_skill_list" },
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // Directory-surface self-introspection — what shipped in this MCP
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "what's new in the directory mcp",
+        synonyms: [
+            "what changed in the directory",
+            "directory release notes",
+            "what version is the directory on",
+            "directory changelog",
+        ],
+        resolves_to: { kind: "tool", name: "directory_release_notes" },
+    },
+];
+//# sourceMappingURL=public-question-atlas.js.map

package/dist/prompts/public-question-atlas.js.map

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

package/dist/resources/llms-primer.d.ts

@@ -0,0 +1,2 @@
+export declare const DIRECTORY_PRIMER = "# PICA Directory \u2014 Public Music Catalog Search\n\nRead-only access to published music catalog data. No authentication required.\nWorks and people are only visible if the owning organisation has opted into\nthe directory.\n\n## First Connection\n\nIf you're not sure where to start, invoke the **directory-autopilot** prompt.\nIt asks what you need and routes to the right workflow: sync search, rights\nresearch, or identifier lookup.\n\n## What You Can Do\n- Search works by title, ISWC, publisher, label\n- Search people by name, ISNI, IPI\n- Look up works by recording ISRC (directory_lookup_isrc)\n- Search recordings by audio characteristics (BPM, key, mood, energy)\n\n## What You Cannot Do\n- Create, update, or delete anything (read-only)\n- Access unpublished works or private catalog data\n- See financial data, agreements, or internal metadata\n\n## Entity Model\n- **Work**: composition with title, ISWC, credits, recordings\n- **Person**: writer/composer/performer with IPI, ISNI identifiers\n- **Recording**: audio capture with ISRC, linked to one work\n\n## Recommended Flow\n1. directory_search (broad text search across works + people)\n2. directory_lookup_work or directory_lookup_person (detailed view)\n3. directory_search_recordings (audio characteristic search for sync)\n";
+//# sourceMappingURL=llms-primer.d.ts.map

package/dist/resources/llms-primer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.d.ts","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,wxCAgC5B,CAAC"}

package/dist/resources/llms-primer.js

@@ -0,0 +1,35 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export const DIRECTORY_PRIMER = `# PICA Directory — Public Music Catalog Search
+
+Read-only access to published music catalog data. No authentication required.
+Works and people are only visible if the owning organisation has opted into
+the directory.
+
+## First Connection
+
+If you're not sure where to start, invoke the **directory-autopilot** prompt.
+It asks what you need and routes to the right workflow: sync search, rights
+research, or identifier lookup.
+
+## What You Can Do
+- Search works by title, ISWC, publisher, label
+- Search people by name, ISNI, IPI
+- Look up works by recording ISRC (directory_lookup_isrc)
+- Search recordings by audio characteristics (BPM, key, mood, energy)
+
+## What You Cannot Do
+- Create, update, or delete anything (read-only)
+- Access unpublished works or private catalog data
+- See financial data, agreements, or internal metadata
+
+## Entity Model
+- **Work**: composition with title, ISWC, credits, recordings
+- **Person**: writer/composer/performer with IPI, ISNI identifiers
+- **Recording**: audio capture with ISRC, linked to one work
+
+## Recommended Flow
+1. directory_search (broad text search across works + people)
+2. directory_lookup_work or directory_lookup_person (detailed view)
+3. directory_search_recordings (audio characteristic search for sync)
+`;
+//# sourceMappingURL=llms-primer.js.map

package/dist/resources/llms-primer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.js","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC/B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,33 @@
+import { ServerConfig } from "./config.js";
+export declare class DirectoryMcpServer {
+    private server;
+    private client;
+    private toolRegistry;
+    private promptRegistry;
+    private skillsRegistry;
+    private config;
+    private clientAttributionLogged;
+    constructor(config: ServerConfig);
+    private setupHandlers;
+    /**
+     * Emit a single stderr line per session naming the client that handshook
+     * with us — sourced from `clientInfo` on the MCP `initialize` request.
+     * Self-declared, NOT authenticated; treat as provenance metadata only.
+     *
+     * Directory MCP is unauthenticated and writes no audit rows, so this
+     * stderr breadcrumb is the only attribution surface today. When/if a
+     * directory audit pipeline lands, fold these values into McpAuditEntry
+     * (the wire shape already carries optional client_name + client_version).
+     */
+    private logClientAttributionOnce;
+    /**
+     * Resolve a skill:// URI. ADR-140 Phase 2b — SEP-2640 bridge pattern.
+     * Two URI shapes:
+     *   - skill://withpica/index.json
+     *   - skill://withpica/<name>/SKILL.md
+     */
+    private readSkillResource;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAe;IAK7B,OAAO,CAAC,uBAAuB,CAAS;gBAE5B,MAAM,EAAE,YAAY;IA4BhC,OAAO,CAAC,aAAa;IA4GrB;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAsDnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}