@withpica/mcp-server-directory 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -8,6 +8,34 @@ for breaking tool-surface changes.
 
 ## [Unreleased]
 
+## [1.4.0] - 2026-05-13
+
+### Added
+
+- **`directory_release_notes` tool + `release-notes://withpica/mcp-server-directory/latest` Resource (PR #414).**
+  Agent-facing surface for directory MCP release notes. Reads `CHANGELOG.md`
+  embedded at build time via `scripts/build-changelog.ts`. Returns the
+  last 3 versions by default with optional `since_version` and `sections`
+  filters. Resource counterpart serves the full CHANGELOG for
+  Resource-native clients. Sister of `pica_release_notes` (creator MCP)
+  and `team_release_notes` (team MCP). Disambiguated from catalogue-content
+  searches (`directory_search` / `directory_list_works` / `directory_chain`)
+  by the NOT-FOR clause in the description.
+
+## [1.3.0] - 2026-05-11
+
+### Added
+
+- **`directory_skill_list` + `directory_skill_get` — skill discovery on the public directory MCP (ADR-140 Phase 2b, PR #371).**
+  Lazy-loaded skill catalogue exposed via two meta-tools + one `skill://`
+  Resource per shipped skill (SEP-2640 bridge pattern). v1 ships
+  `find-music-for-sync-brief` — a methodology for searching the public
+  directory by audio characteristics + free-text brief. Skill metadata is
+  static at boot; bodies load on `skill_get` call. IP-protection lint
+  (Rule 14) gates skill content against trade-secret directories before
+  publish; cross-coverage parity lint asserts skill resource URIs match
+  between stdio and HTTP transports.
+
 ## [1.1.0] - 2026-04-21
 
 Shipped as minor rather than major despite the `*_full` tool removal:

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+export interface DirectoryClientConfig {
+    baseUrl: string;
+    debug?: boolean;
+}
+export declare class DirectoryClient {
+    private baseUrl;
+    private debug;
+    constructor(config: DirectoryClientConfig);
+    private fetchWithTimeout;
+    request<T>(path: string, params?: Record<string, string>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,EAAE,qBAAqB;YAK3B,gBAAgB;IAmBxB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAgF5E"}

package/dist/client.js

@@ -0,0 +1,93 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_RETRIES = 2;
+const RETRY_BASE_MS = 500;
+function isRetryableStatus(status) {
+    return status === 429 || status === 502 || status === 503 || status === 504;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class DirectoryClient {
+    baseUrl;
+    debug;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.debug = config.debug || false;
+    }
+    async fetchWithTimeout(url, init, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Request timed out after ${timeoutMs}ms: GET ${url}`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async request(path, params) {
+        const url = new URL(`${this.baseUrl}/api/public/directory${path}`);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            });
+        }
+        if (this.debug) {
+            console.error(`[Directory MCP] GET ${url.toString()} (timeout: ${DEFAULT_TIMEOUT_MS}ms)`);
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                const response = await this.fetchWithTimeout(url.toString(), { method: "GET", headers: { Accept: "application/json" } }, DEFAULT_TIMEOUT_MS);
+                if (response.ok) {
+                    const json = await response.json();
+                    if (json.success === false) {
+                        throw new Error(json.error || "API returned unsuccessful response");
+                    }
+                    return json;
+                }
+                const errorText = await response.text();
+                // Auth errors — fail fast, never retry
+                if (response.status === 401 || response.status === 403) {
+                    throw new Error(`Authentication failed: ${response.status} ${errorText}`);
+                }
+                if (isRetryableStatus(response.status) && attempt < MAX_RETRIES) {
+                    const retryAfter = response.headers.get("retry-after");
+                    const parsed = retryAfter ? parseInt(retryAfter, 10) : NaN;
+                    const delayMs = !isNaN(parsed)
+                        ? parsed * 1000
+                        : RETRY_BASE_MS * Math.pow(2, attempt);
+                    if (this.debug) {
+                        console.error(`[Directory MCP] ${response.status} on attempt ${attempt + 1}, retrying in ${delayMs}ms`);
+                    }
+                    await sleep(delayMs);
+                    continue;
+                }
+                throw new Error(`API request failed: ${response.status} ${errorText}`);
+            }
+            catch (err) {
+                lastError = err;
+                if (err.message?.includes("timed out") &&
+                    attempt < MAX_RETRIES) {
+                    const delayMs = RETRY_BASE_MS * Math.pow(2, attempt);
+                    if (this.debug) {
+                        console.error(`[Directory MCP] timeout on attempt ${attempt + 1}, retrying in ${delayMs}ms`);
+                    }
+                    await sleep(delayMs);
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastError || new Error("Request failed after retries");
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface ServerConfig {
+    directoryUrl: string;
+    serverName: string;
+    version: string;
+    debug: boolean;
+}
+export declare function loadConfig(): ServerConfig;
+export declare function validateConfig(config: ServerConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,UAAU,IAAI,YAAY,CAOzC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAIzD"}

package/dist/config.js

@@ -0,0 +1,15 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export function loadConfig() {
+    return {
+        directoryUrl: process.env.PICA_DIRECTORY_URL || "https://withpica.com",
+        serverName: "pica-directory-mcp-server",
+        version: "1.0.0",
+        debug: process.env.DEBUG === "true" || process.env.DEBUG === "1",
+    };
+}
+export function validateConfig(config) {
+    if (!config.directoryUrl || !config.directoryUrl.startsWith("http")) {
+        throw new Error("Invalid PICA_DIRECTORY_URL");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAS7D,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,sBAAsB;QACtE,UAAU,EAAE,2BAA2B;QACvC,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { loadConfig, validateConfig } from "./config.js";
+import { DirectoryMcpServer } from "./server.js";
+async function main() {
+    try {
+        const config = loadConfig();
+        validateConfig(config);
+        const server = new DirectoryMcpServer(config);
+        await server.start();
+        process.on("SIGINT", async () => {
+            console.error("[Directory MCP] Shutting down...");
+            await server.stop();
+            process.exit(0);
+        });
+        process.on("SIGTERM", async () => {
+            console.error("[Directory MCP] Shutting down...");
+            await server.stop();
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        console.error("[Directory MCP] Fatal error:", error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,6DAA6D;AAG7D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAC/B,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,8BAA8B,EAC9B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/lib/changelog.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Runtime CHANGELOG parser. Mirrors scripts/parse-changelog.ts but takes
+ * the markdown body as a string (no fs dependency) so the MCP runtime
+ * can read from a build-time embedded constant. Sister of
+ * mcp-server/src/lib/changelog.ts and team-mcp-server/src/lib/changelog.ts.
+ */
+export type ChangelogSectionName = "Added" | "Changed" | "Fixed" | "Removed" | "Security" | "Deprecated";
+export declare const CHANGELOG_SECTION_NAMES: ChangelogSectionName[];
+export interface ChangelogEntry {
+    version: string;
+    date: string | null;
+    sections: Partial<Record<ChangelogSectionName, string[]>>;
+    markdown: string;
+}
+export declare function parseChangelogText(text: string): ChangelogEntry[];
+//# sourceMappingURL=changelog.d.ts.map

package/dist/lib/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/lib/changelog.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,GACV,YAAY,CAAC;AAEjB,eAAO,MAAM,uBAAuB,EAAE,oBAAoB,EAOzD,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAiFjE"}

package/dist/lib/changelog.generated.d.ts

@@ -0,0 +1,4 @@
+export declare const CHANGELOG_MD = "# Changelog\n\nAll notable changes to `@withpica/mcp-server-directory` are documented here.\n\nThe format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to semantic versioning where the major number is incremented\nfor breaking tool-surface changes.\n\n## [Unreleased]\n\n## [1.4.0] - 2026-05-13\n\n### Added\n\n- **`directory_release_notes` tool + `release-notes://withpica/mcp-server-directory/latest` Resource (PR #414).**\n  Agent-facing surface for directory MCP release notes. Reads `CHANGELOG.md`\n  embedded at build time via `scripts/build-changelog.ts`. Returns the\n  last 3 versions by default with optional `since_version` and `sections`\n  filters. Resource counterpart serves the full CHANGELOG for\n  Resource-native clients. Sister of `pica_release_notes` (creator MCP)\n  and `team_release_notes` (team MCP). Disambiguated from catalogue-content\n  searches (`directory_search` / `directory_list_works` / `directory_chain`)\n  by the NOT-FOR clause in the description.\n\n## [1.3.0] - 2026-05-11\n\n### Added\n\n- **`directory_skill_list` + `directory_skill_get` \u2014 skill discovery on the public directory MCP (ADR-140 Phase 2b, PR #371).**\n  Lazy-loaded skill catalogue exposed via two meta-tools + one `skill://`\n  Resource per shipped skill (SEP-2640 bridge pattern). v1 ships\n  `find-music-for-sync-brief` \u2014 a methodology for searching the public\n  directory by audio characteristics + free-text brief. Skill metadata is\n  static at boot; bodies load on `skill_get` call. IP-protection lint\n  (Rule 14) gates skill content against trade-secret directories before\n  publish; cross-coverage parity lint asserts skill resource URIs match\n  between stdio and HTTP transports.\n\n## [1.1.0] - 2026-04-21\n\nShipped as minor rather than major despite the `*_full` tool removal:\nthe removed names had near-zero external adoption (they shipped recently\nand weren't advertised externally), and staying on the 1.x line keeps\n`^1.0.0` consumers on the upgrade path rather than stranding them on\nthe broken cascade. Clients that cached the `*_full` names will see a\ntool-not-found error and need to refresh their tool list.\n\n### Breaking\n\n- **Removed `directory_lookup_person_full` and `directory_lookup_work_full`.**\n  Both tools hit the same upstream endpoints as their non-`_full` counterparts\n  with only a formatting difference \u2014 there was no capability delta. The\n  `_full` variants are now the canonical names (`directory_lookup_person`\n  and `directory_lookup_work`); the thin variants have been deleted. Clients\n  that cached the `_full` names need to update their tool list; the\n  replacements return a superset of the prior data, so no output is lost.\n\n### Added\n\n- **`directory_chain` tool** \u2014 one-call rights-chain lookup. Accepts a\n  free-text query, a direct ISWC/ISRC `identifier`, or audio-only filters\n  (BPM / key / energy / mood). Returns the already-public `ChainResult`\n  shape: work + writers + publishers (names + roles only, no IPIs or\n  splits) + linked recording + audio characteristics. Wraps the existing\n  public `/api/public/directory/chain` endpoint \u2014 no new backing API work.\n- `directory_list_people` now accepts `letter` (A\u2013Z, `#`) for alphabetical\n  browsing. The backend has supported this for months; only the MCP tool\n  was missing the parameter.\n- `directory_list_works` now accepts `letter`, `sort` (`title` | `recent`),\n  and `isrc` \u2014 all previously backend-only.\n\n### Changed\n\n- **`directory_lookup_person` now matches its description.** Previously the\n  tool advertised ISNI / IPI / MusicBrainz ID support but the backing query\n  only matched `global_creator_id` \u2014 any non-UUID identifier silently 404'd.\n  The query now cascades through `global_creator_id` \u2192 `isni` \u2192\n  `cae_ipi_number` \u2192 `musicbrainz_id`, first hit wins.\n- `directory_search` description rewritten to drop the false \"ranked\" claim.\n  The backing endpoint is a fan-out (`listWorks` + `listPeople`,\n  half-limit each), not cross-type ranking. Callers should prefer typed\n  list tools when they know the entity type.\n- `directory_lookup_isrc` description rewritten to frame it honestly as a\n  pinned filter preset on `list_works` rather than a distinct lookup.\n";
+export declare const PACKAGE_NAME = "@withpica/mcp-server-directory";
+export declare const PACKAGE_VERSION = "1.4.0";
+//# sourceMappingURL=changelog.generated.d.ts.map

package/dist/lib/changelog.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.generated.d.ts","sourceRoot":"","sources":["../../src/lib/changelog.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,+vIAAwsI,CAAC;AACluI,eAAO,MAAM,YAAY,mCAAmC,CAAC;AAC7D,eAAO,MAAM,eAAe,UAAU,CAAC"}

package/dist/lib/changelog.generated.js

@@ -0,0 +1,6 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Generated by scripts/build-changelog.ts — do not edit.
+export const CHANGELOG_MD = "# Changelog\n\nAll notable changes to `@withpica/mcp-server-directory` are documented here.\n\nThe format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to semantic versioning where the major number is incremented\nfor breaking tool-surface changes.\n\n## [Unreleased]\n\n## [1.4.0] - 2026-05-13\n\n### Added\n\n- **`directory_release_notes` tool + `release-notes://withpica/mcp-server-directory/latest` Resource (PR #414).**\n  Agent-facing surface for directory MCP release notes. Reads `CHANGELOG.md`\n  embedded at build time via `scripts/build-changelog.ts`. Returns the\n  last 3 versions by default with optional `since_version` and `sections`\n  filters. Resource counterpart serves the full CHANGELOG for\n  Resource-native clients. Sister of `pica_release_notes` (creator MCP)\n  and `team_release_notes` (team MCP). Disambiguated from catalogue-content\n  searches (`directory_search` / `directory_list_works` / `directory_chain`)\n  by the NOT-FOR clause in the description.\n\n## [1.3.0] - 2026-05-11\n\n### Added\n\n- **`directory_skill_list` + `directory_skill_get` — skill discovery on the public directory MCP (ADR-140 Phase 2b, PR #371).**\n  Lazy-loaded skill catalogue exposed via two meta-tools + one `skill://`\n  Resource per shipped skill (SEP-2640 bridge pattern). v1 ships\n  `find-music-for-sync-brief` — a methodology for searching the public\n  directory by audio characteristics + free-text brief. Skill metadata is\n  static at boot; bodies load on `skill_get` call. IP-protection lint\n  (Rule 14) gates skill content against trade-secret directories before\n  publish; cross-coverage parity lint asserts skill resource URIs match\n  between stdio and HTTP transports.\n\n## [1.1.0] - 2026-04-21\n\nShipped as minor rather than major despite the `*_full` tool removal:\nthe removed names had near-zero external adoption (they shipped recently\nand weren't advertised externally), and staying on the 1.x line keeps\n`^1.0.0` consumers on the upgrade path rather than stranding them on\nthe broken cascade. Clients that cached the `*_full` names will see a\ntool-not-found error and need to refresh their tool list.\n\n### Breaking\n\n- **Removed `directory_lookup_person_full` and `directory_lookup_work_full`.**\n  Both tools hit the same upstream endpoints as their non-`_full` counterparts\n  with only a formatting difference — there was no capability delta. The\n  `_full` variants are now the canonical names (`directory_lookup_person`\n  and `directory_lookup_work`); the thin variants have been deleted. Clients\n  that cached the `_full` names need to update their tool list; the\n  replacements return a superset of the prior data, so no output is lost.\n\n### Added\n\n- **`directory_chain` tool** — one-call rights-chain lookup. Accepts a\n  free-text query, a direct ISWC/ISRC `identifier`, or audio-only filters\n  (BPM / key / energy / mood). Returns the already-public `ChainResult`\n  shape: work + writers + publishers (names + roles only, no IPIs or\n  splits) + linked recording + audio characteristics. Wraps the existing\n  public `/api/public/directory/chain` endpoint — no new backing API work.\n- `directory_list_people` now accepts `letter` (A–Z, `#`) for alphabetical\n  browsing. The backend has supported this for months; only the MCP tool\n  was missing the parameter.\n- `directory_list_works` now accepts `letter`, `sort` (`title` | `recent`),\n  and `isrc` — all previously backend-only.\n\n### Changed\n\n- **`directory_lookup_person` now matches its description.** Previously the\n  tool advertised ISNI / IPI / MusicBrainz ID support but the backing query\n  only matched `global_creator_id` — any non-UUID identifier silently 404'd.\n  The query now cascades through `global_creator_id` → `isni` →\n  `cae_ipi_number` → `musicbrainz_id`, first hit wins.\n- `directory_search` description rewritten to drop the false \"ranked\" claim.\n  The backing endpoint is a fan-out (`listWorks` + `listPeople`,\n  half-limit each), not cross-type ranking. Callers should prefer typed\n  list tools when they know the entity type.\n- `directory_lookup_isrc` description rewritten to frame it honestly as a\n  pinned filter preset on `list_works` rather than a distinct lookup.\n";
+export const PACKAGE_NAME = "@withpica/mcp-server-directory";
+export const PACKAGE_VERSION = "1.4.0";
+//# sourceMappingURL=changelog.generated.js.map

package/dist/lib/changelog.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.generated.js","sourceRoot":"","sources":["../../src/lib/changelog.generated.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,yDAAyD;AAEzD,MAAM,CAAC,MAAM,YAAY,GAAG,qsIAAqsI,CAAC;AACluI,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC"}

package/dist/lib/changelog.js

@@ -0,0 +1,84 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export const CHANGELOG_SECTION_NAMES = [
+    "Added",
+    "Changed",
+    "Fixed",
+    "Removed",
+    "Security",
+    "Deprecated",
+];
+const HEADING_RE = /^##\s+\[([^\]]+)\](?:\s*-\s*(\d{4}-\d{2}-\d{2}))?\s*$/;
+const SECTION_RE = /^###\s+(\w+)\s*$/;
+const BULLET_RE = /^-\s+(.*)$/;
+export function parseChangelogText(text) {
+    const lines = text.split("\n");
+    const entries = [];
+    let current = null;
+    let currentSection = null;
+    let currentBullet = null;
+    const flush = (endLine) => {
+        if (current && current.version !== "Unreleased") {
+            current.markdown = lines
+                .slice(current._start, endLine)
+                .join("\n")
+                .trimEnd();
+            const { _start: _start, ...rest } = current;
+            entries.push(rest);
+        }
+        current = null;
+        currentSection = null;
+        currentBullet = null;
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const headingMatch = line.match(HEADING_RE);
+        if (headingMatch) {
+            flush(i);
+            current = {
+                version: headingMatch[1],
+                date: headingMatch[2] ?? null,
+                sections: {},
+                markdown: "",
+                _start: i,
+            };
+            currentSection = null;
+            continue;
+        }
+        if (!current)
+            continue;
+        const sectionMatch = line.match(SECTION_RE);
+        if (sectionMatch) {
+            const name = sectionMatch[1];
+            if (CHANGELOG_SECTION_NAMES.includes(name)) {
+                currentSection = name;
+                if (!current.sections[name])
+                    current.sections[name] = [];
+            }
+            else {
+                currentSection = null;
+            }
+            currentBullet = null;
+            continue;
+        }
+        const bulletMatch = line.match(BULLET_RE);
+        if (bulletMatch && currentSection) {
+            const arr = current.sections[currentSection];
+            arr.push(bulletMatch[1].trim());
+            currentBullet = {
+                entry: current,
+                section: currentSection,
+                index: arr.length - 1,
+            };
+            continue;
+        }
+        if (currentBullet && line.startsWith("  ") && line.trim().length > 0) {
+            const arr = currentBullet.entry.sections[currentBullet.section];
+            arr[currentBullet.index] = `${arr[currentBullet.index]} ${line.trim()}`;
+            continue;
+        }
+        currentBullet = null;
+    }
+    flush(lines.length);
+    return entries;
+}
+//# sourceMappingURL=changelog.js.map

package/dist/lib/changelog.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Prompt Registry for Directory MCP Server
+ * Guided workflows for music discovery, sync licensing, and rights research
+ */
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+export interface PromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: string;
+        text: string;
+    };
+}
+export interface PromptResult {
+    messages: PromptMessage[];
+    [key: string]: unknown;
+}
+export declare class PromptRegistry {
+    listPrompts(): PromptDefinition[];
+    getPrompt(name: string, args?: Record<string, any>): Promise<PromptResult>;
+    private getFindMusicPrompt;
+    private getResearchCreatorPrompt;
+    private getDirectoryAutopilotPrompt;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,WAAW,IAAI,gBAAgB,EAAE;IAoC3B,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC,YAAY,CAAC;IAaxB,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,wBAAwB;IAwChC,OAAO,CAAC,2BAA2B;CAqCpC"}

package/dist/prompts/index.js

@@ -0,0 +1,165 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export class PromptRegistry {
+    listPrompts() {
+        return [
+            {
+                name: "find-music",
+                description: "Find music for a sync brief, playlist, or project — search by mood, BPM, key, energy, or description",
+                arguments: [
+                    {
+                        name: "brief",
+                        description: "What you're looking for — a mood, scene description, or audio characteristics",
+                        required: false,
+                    },
+                ],
+            },
+            {
+                name: "research-creator",
+                description: "Research a songwriter, composer, or performer — see their works, identifiers, collaborators, and verification status",
+                arguments: [
+                    {
+                        name: "name_or_id",
+                        description: "Creator name, IPI number, ISNI, or MusicBrainz ID",
+                        required: false,
+                    },
+                ],
+            },
+            {
+                name: "directory-autopilot",
+                description: "Not sure where to start? Describe what you need and get routed to the right workflow — sync search, rights research, or identifier lookup",
+                arguments: [],
+            },
+        ];
+    }
+    async getPrompt(name, args) {
+        switch (name) {
+            case "find-music":
+                return this.getFindMusicPrompt(args?.brief);
+            case "research-creator":
+                return this.getResearchCreatorPrompt(args?.name_or_id);
+            case "directory-autopilot":
+                return this.getDirectoryAutopilotPrompt();
+            default:
+                throw new Error(`Prompt not found: ${name}`);
+        }
+    }
+    getFindMusicPrompt(brief) {
+        const briefInstruction = brief
+            ? `The user is looking for: "${brief}". Translate this into audio search parameters.`
+            : `Ask me what I'm looking for — a mood, a scene, a vibe, or specific audio characteristics (BPM, key, energy).`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me find music in the PICA public directory for a sync brief or project.
+
+${briefInstruction}
+
+Workflow:
+1. Translate the brief into search parameters for directory_search_recordings:
+   - Mood descriptions → energy, danceability, key_mode, mood filters
+   - "Upbeat" → min_energy: 0.6, min_danceability: 0.5
+   - "Dark/moody" → max_energy: 0.4, key_mode: minor
+   - "Chill" → max_energy: 0.4, max_bpm: 100
+   - Specific requests → use BPM, key, duration filters directly
+
+2. Run directory_search_recordings with the parameters.
+
+3. For each promising result, use directory_lookup_work to get:
+   - Who wrote it (credits with IPI numbers)
+   - Whether credits are attested (verified ownership)
+   - DSP links (Spotify, Apple Music — so the user can listen)
+   - Registration score (higher = cleaner rights chain)
+
+4. Present results as a shortlist with:
+   - Title, artist, BPM, key, energy
+   - Credits summary (who to contact for licensing)
+   - Any flags (unattested credits, low registration score, missing ISRC)
+
+If no results match, suggest broadening the search (wider BPM range, drop key filter, etc.).
+
+Important: This is a public directory — only works from organisations that opted in are visible. If the catalog is small, say so.`,
+                    },
+                },
+            ],
+        };
+    }
+    getResearchCreatorPrompt(nameOrId) {
+        const searchInstruction = nameOrId
+            ? `Look up: "${nameOrId}". Try directory_lookup_person first (it accepts name, IPI, ISNI, or MusicBrainz ID). If that doesn't match, use directory_list_people with a text search.`
+            : `Ask me for the creator's name, IPI number, ISNI, or MusicBrainz ID.`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me research a music creator in the PICA public directory.
+
+${searchInstruction}
+
+Once you find the person, use directory_lookup_person to get their complete profile:
+- Identifiers (IPI, ISNI, MusicBrainz) — essential for rights verification
+- All credited works with roles (writer, composer, performer, producer)
+- Collaborator network — who they work with
+- Verification score — how complete their profile is
+
+Then for their most notable works (up to 5), use directory_lookup_work to get:
+- Full credits and splits (are they the sole writer or one of many?)
+- Recordings with ISRCs
+- Audio analysis (BPM, key, energy)
+- DSP links and registration status
+
+Present a summary:
+- Creator profile (name, identifiers, role patterns)
+- Catalog overview (how many works, typical roles, common collaborators)
+- Notable works with credit details
+- Any gaps (missing identifiers, unattested credits, low scores)
+
+This is useful for: rights research, due diligence before licensing, publisher evaluation, or understanding a catalog before acquisition.`,
+                    },
+                },
+            ],
+        };
+    }
+    getDirectoryAutopilotPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You've connected to the PICA public music directory. Help me find what I need.
+
+First, read the llms://primer resource to understand what's available.
+
+Then ask me what I'm looking for. Based on my answer, route to the right workflow:
+
+If I'm looking for MUSIC FOR A PROJECT (sync brief, playlist, mood search):
+→ Use the find-music workflow. Translate my description into audio search parameters and search recordings by BPM, key, energy, mood. Then look up full details on promising matches.
+
+If I'm looking for INFORMATION ABOUT A CREATOR (songwriter, composer, performer):
+→ Use the research-creator workflow. Look up their profile, works, identifiers, and collaborators.
+
+If I have a SPECIFIC IDENTIFIER to resolve (ISRC, ISWC, IPI, ISNI):
+→ Route directly to the right lookup tool:
+  - ISRC (e.g. USABC1234567) → directory_lookup_isrc → then directory_lookup_work
+  - ISWC (e.g. T-123.456.789-0) → directory_lookup_work
+  - IPI or ISNI → directory_lookup_person
+  - MusicBrainz ID → directory_lookup_person
+
+If I want to BROWSE what's in the directory:
+→ Use directory_search with a broad query, or directory_list_works / directory_list_people to paginate.
+
+Tell me which workflow you chose and why, in one sentence. Offer alternatives.
+
+Important: This is a read-only public directory. I can search and look up, but I can't create or modify anything. Only works from organisations that opted into the directory are visible.`,
+                    },
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AA8B7D,MAAM,OAAO,cAAc;IACzB,WAAW;QACT,OAAO;YACL;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EACT,sGAAsG;gBACxG,SAAS,EAAE;oBACT;wBACE,IAAI,EAAE,OAAO;wBACb,WAAW,EACT,+EAA+E;wBACjF,QAAQ,EAAE,KAAK;qBAChB;iBACF;aACF;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,sHAAsH;gBACxH,SAAS,EAAE;oBACT;wBACE,IAAI,EAAE,YAAY;wBAClB,WAAW,EAAE,mDAAmD;wBAChE,QAAQ,EAAE,KAAK;qBAChB;iBACF;aACF;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,2IAA2I;gBAC7I,SAAS,EAAE,EAAE;aACd;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CACb,IAAY,EACZ,IAA0B;QAE1B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9C,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,wBAAwB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACzD,KAAK,qBAAqB;gBACxB,OAAO,IAAI,CAAC,2BAA2B,EAAE,CAAC;YAC5C;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,KAAc;QACvC,MAAM,gBAAgB,GAAG,KAAK;YAC5B,CAAC,CAAC,6BAA6B,KAAK,iDAAiD;YACrF,CAAC,CAAC,8GAA8G,CAAC;QAEnH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;EAEhB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;kIAyBgH;qBACvH;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAEO,wBAAwB,CAAC,QAAiB;QAChD,MAAM,iBAAiB,GAAG,QAAQ;YAChC,CAAC,CAAC,aAAa,QAAQ,4JAA4J;YACnL,CAAC,CAAC,qEAAqE,CAAC;QAE1E,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;EAEhB,iBAAiB;;;;;;;;;;;;;;;;;;;;0IAoBuH;qBAC/H;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAEO,2BAA2B;QACjC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;2LAwByK;qBAChL;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF"}