@withpica/mcp-server-directory 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -8,11 +8,63 @@ for breaking tool-surface changes.
 
 ## [Unreleased]
 
+## [1.5.0] - 2026-09-26
+
+### Fixed
+
+- The `pica-directory-mcp` bin entry is written `dist/index.js`. npm 11.13
+  rejects the `./dist/index.js` form at publish and silently drops the bin,
+  which would have broken `npx @withpica/mcp-server-directory`.
+
+### Added
+
+- **`directory_send_licensing_enquiry`** (tier `write`, the directory's first
+  non-read tool). An agent helping someone find music can now, with their
+  go-ahead, send the owner a licensing enquiry through the same public route
+  as the directory's web form. The enquiry is passed to the owner, who can reply
+  by email; a confirmation to the requester is usually sent but not
+  guaranteed. Nothing is agreed or priced, and a budget is optional. Refusals
+  come back as not sent, with the reason (403 owner not taking enquiries, 404
+  not listed, 429 too many); a server error or lost answer comes back as an
+  unknown outcome, so an agent does not resend a stored enquiry.
+- `directory_lookup_work` now ends with a **Licensing** section: the work's
+  public page and whether enquiries are open (`work_page_url`,
+  `enquiries_open` in structured content).
+
+### Changed
+
+- The `find-music-for-sync-brief` skill points at the enquiry tool instead of
+  telling the user to find the rights holder themselves.
+
+## [1.4.2] - 2026-08-24
+
+### Added
+
+- **A README on the npm page.** This package published with no README at all, so
+  its npm listing showed only the one-line description — a stranger evaluating it
+  had nothing to read. The README is now generated by
+  `scripts/build-mcp-readmes.mjs` from the tool registry and `package.json`, so
+  the install command, the tool inventory and the version cannot drift from the
+  code the way a hand-written one did. `--check` fails CI on drift.
+- `homepage` and `bugs.email` in `package.json`, so the npm page links somewhere
+  and a problem has a route back.
+
+### Fixed
+
+- **The published tool count drifted to 9 of 11** — `directory_release_notes`, `directory_skill_get` and `directory_skill_list` had been added without the count following; now derived from the registry with a parity tripwire, and the one destructive tool no longer wears a write tier (pica #2024).
+
+- `formatAsText`: bare array payloads are wrapped in the standard
+  `{ items, count }` list envelope — MCP requires structuredContent to be a
+  record, and the SDK server rejects arrays with -32602 (latent here: no
+  current call sites, fixed in lockstep with `@withpica/mcp-utils`).
+
 ## [1.4.1] - 2026-05-16
 
 ### Changed
 
-- Brand consistency: "PICA" → "withPICA" in package metadata (description, author).
+- Branding pass: "PICA" → "withPICA" in package metadata
+  (commit `9787d4c37`). Published to npm 2026-05-16 without committing the
+  version bump — repo realigned 2026-06-12.
 
 ## [1.4.0] - 2026-05-13
 

package/README.md

@@ -0,0 +1,63 @@
+<!-- GENERATED FILE — do not edit by hand.
+     Prose lives in mcp-server/README.intro.md; the tool inventory is
+     derived from the source registries. Regenerate with
+     `node scripts/build-mcp-readmes.mjs`; `--check` fails on drift. -->
+
+# @withpica/mcp-server-directory
+
+MCP server for the **withPICA public directory** — search over works, recordings and creators that rights holders have chosen to publish, plus one write: sending a licensing enquiry to an owner, when the user asks. No account, no API key, no setup.
+
+## Install
+
+```bash
+claude mcp add withpica-directory -- npx --yes @withpica/mcp-server-directory@latest
+```
+
+## What it can answer
+
+Who wrote this song. What the ISWC is. Which recordings exist of a work and what their ISRCs are. Which creators match a name, an ISNI or an IPI. Which published recordings sit in a tempo, key, energy or mood range. And, in one call, the rights chain for a work: writers, publishers, recording, audio.
+
+Every entry is published deliberately by its rights holder, with attested credits and verified identifiers.
+
+## REST, if you would rather not run a process
+
+- `GET https://withpica.com/api/public/directory/works`
+- `GET https://withpica.com/api/public/directory/people`
+- `GET https://withpica.com/api/public/directory/search?q={query}`
+- `GET https://withpica.com/api/public/directory/recordings`
+- `GET https://withpica.com/api/public/directory/consent?iswc={iswc}`
+
+100 requests/minute unauthenticated. Licensing keys unlock extended fields and their own limits.
+
+## Before you train on any of this
+
+withpica.com publishes a blanket TDM reservation at <https://withpica.com/.well-known/tdmrep.json> (`"tdm-reservation": 1`). Nothing here is licensed for text-and-data mining or model training by default.
+
+The `consent` endpoint above is the granular counterpart: ask it about an identifier and it reports what the rights holders have actually cleared, and at what level. A work is cleared at a level only when every credited contributor has granted at least that level; one refusal blocks it. Read `no_assertion_published` literally — it means no permission is published for that identifier, which is not a maybe.
+
+## Links
+
+- Directory: <https://directory.withpica.com>
+- Machine-readable: <https://withpica.com/directory/llms.txt>
+- Support: support@withpica.com
+
+## Tools
+
+12 tools, all read-only except `directory_send_licensing_enquiry`:
+
+- `directory_chain` — Graph lookup — resolves a query, ISWC, or ISRC to its full rights chain in one call
+- `directory_list_people` — Browse and filter creators in the PICA public directory
+- `directory_list_works` — Browse and filter verified musical works in the PICA public directory
+- `directory_lookup_isrc` — Shortcut: look up the work(s) associated with a recording identifier (ISRC)
+- `directory_lookup_person` — Get full details of a creator by global creator ID (UUID), ISNI, IPI number, or MusicBrainz ID
+- `directory_lookup_work` — Get full details of a single work by ISWC or work UUID
+- `directory_release_notes` — Returns recent releases of the PICA directory MCP server — what shipped in the public catalogue surface itself
+- `directory_search` — Convenience fan-out across works and creators — runs list_works and list_people with the same query and returns the union
+- `directory_search_recordings` — Find tracks by BPM, key, energy, danceability, duration, and more
+- `directory_send_licensing_enquiry` — Sends a licensing enquiry to the owner of a work listed in the public directory
+- `directory_skill_get` — Returns the full methodology body for one directory skill — markdown with step-by-step instructions and tool chains
+- `directory_skill_list` — Returns the list of downloadable directory skill methodologies — name, description, trigger phrases
+
+---
+
+Generated for `@withpica/mcp-server-directory@1.5.0`. © 2024-2026 Withpica Ltd. All rights reserved. MIT licensed.

package/dist/client.d.ts

@@ -7,6 +7,20 @@ export declare class DirectoryClient {
     private debug;
     constructor(config: DirectoryClientConfig);
     private fetchWithTimeout;
+    /** The public page for a directory work, for a human to open. */
+    workPageUrl(workId: string): string;
+    /**
+     * Send a licensing enquiry through the public enquiry route (the same one
+     * the directory's web form uses). ONE attempt, never retried: a retry after
+     * a timeout or a 5xx could store the enquiry twice and email the owner
+     * twice. Resolves with the status and parsed body for every HTTP answer,
+     * so the caller can tell a refusal (400/403/404/429) from a failure;
+     * throws only when no answer arrived.
+     */
+    sendLicensingEnquiry(body: Record<string, unknown>): Promise<{
+        status: number;
+        json: any;
+    }>;
     request<T>(path: string, params?: Record<string, string>): Promise<T>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +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"}
+{"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;IAqB9B,iEAAiE;IACjE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAInC;;;;;;;OAOG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC;IAmBnC,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

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 const DEFAULT_TIMEOUT_MS = 15_000;
 const MAX_RETRIES = 2;
 const RETRY_BASE_MS = 500;
@@ -23,7 +23,7 @@ export class DirectoryClient {
         }
         catch (err) {
             if (err.name === "AbortError") {
-                throw new Error(`Request timed out after ${timeoutMs}ms: GET ${url}`);
+                throw new Error(`Request timed out after ${timeoutMs}ms: ${init.method ?? "GET"} ${url}`);
             }
             throw err;
         }
@@ -31,6 +31,33 @@ export class DirectoryClient {
             clearTimeout(timer);
         }
     }
+    /** The public page for a directory work, for a human to open. */
+    workPageUrl(workId) {
+        return `${this.baseUrl}/directory/works/${encodeURIComponent(workId)}`;
+    }
+    /**
+     * Send a licensing enquiry through the public enquiry route (the same one
+     * the directory's web form uses). ONE attempt, never retried: a retry after
+     * a timeout or a 5xx could store the enquiry twice and email the owner
+     * twice. Resolves with the status and parsed body for every HTTP answer,
+     * so the caller can tell a refusal (400/403/404/429) from a failure;
+     * throws only when no answer arrived.
+     */
+    async sendLicensingEnquiry(body) {
+        const url = `${this.baseUrl}/api/shop/license-enquiries`;
+        if (this.debug)
+            console.error(`[Directory MCP] POST ${url}`);
+        const response = await this.fetchWithTimeout(url, {
+            method: "POST",
+            headers: {
+                Accept: "application/json",
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        }, DEFAULT_TIMEOUT_MS);
+        const json = await response.json().catch(() => null);
+        return { status: response.status, json };
+    }
     async request(path, params) {
         const url = new URL(`${this.baseUrl}/api/public/directory${path}`);
         if (params) {

package/dist/client.js.map

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

package/dist/config.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 export function loadConfig() {
     return {
         directoryUrl: process.env.PICA_DIRECTORY_URL || "https://withpica.com",

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 import { loadConfig, validateConfig } from "./config.js";
 import { DirectoryMcpServer } from "./server.js";
 async function main() {

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,6DAA6D;AAE7D,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.generated.d.ts

@@ -1,4 +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.1] - 2026-05-16\n\n### Changed\n\n- Brand consistency: \"PICA\" \u2192 \"withPICA\" in package metadata (description, author).\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 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.5.0] - 2026-09-26\n\n### Fixed\n\n- The `pica-directory-mcp` bin entry is written `dist/index.js`. npm 11.13\n  rejects the `./dist/index.js` form at publish and silently drops the bin,\n  which would have broken `npx @withpica/mcp-server-directory`.\n\n### Added\n\n- **`directory_send_licensing_enquiry`** (tier `write`, the directory's first\n  non-read tool). An agent helping someone find music can now, with their\n  go-ahead, send the owner a licensing enquiry through the same public route\n  as the directory's web form. The enquiry is passed to the owner, who can reply\n  by email; a confirmation to the requester is usually sent but not\n  guaranteed. Nothing is agreed or priced, and a budget is optional. Refusals\n  come back as not sent, with the reason (403 owner not taking enquiries, 404\n  not listed, 429 too many); a server error or lost answer comes back as an\n  unknown outcome, so an agent does not resend a stored enquiry.\n- `directory_lookup_work` now ends with a **Licensing** section: the work's\n  public page and whether enquiries are open (`work_page_url`,\n  `enquiries_open` in structured content).\n\n### Changed\n\n- The `find-music-for-sync-brief` skill points at the enquiry tool instead of\n  telling the user to find the rights holder themselves.\n\n## [1.4.2] - 2026-08-24\n\n### Added\n\n- **A README on the npm page.** This package published with no README at all, so\n  its npm listing showed only the one-line description \u2014 a stranger evaluating it\n  had nothing to read. The README is now generated by\n  `scripts/build-mcp-readmes.mjs` from the tool registry and `package.json`, so\n  the install command, the tool inventory and the version cannot drift from the\n  code the way a hand-written one did. `--check` fails CI on drift.\n- `homepage` and `bugs.email` in `package.json`, so the npm page links somewhere\n  and a problem has a route back.\n\n### Fixed\n\n- **The published tool count drifted to 9 of 11** \u2014 `directory_release_notes`, `directory_skill_get` and `directory_skill_list` had been added without the count following; now derived from the registry with a parity tripwire, and the one destructive tool no longer wears a write tier (pica #2024).\n\n- `formatAsText`: bare array payloads are wrapped in the standard\n  `{ items, count }` list envelope \u2014 MCP requires structuredContent to be a\n  record, and the SDK server rejects arrays with -32602 (latent here: no\n  current call sites, fixed in lockstep with `@withpica/mcp-utils`).\n\n## [1.4.1] - 2026-05-16\n\n### Changed\n\n- Branding pass: \"PICA\" \u2192 \"withPICA\" in package metadata\n  (commit `9787d4c37`). Published to npm 2026-05-16 without committing the\n  version bump \u2014 repo realigned 2026-06-12.\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.1";
+export declare const PACKAGE_VERSION = "1.5.0";
 //# sourceMappingURL=changelog.generated.d.ts.map

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

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

package/dist/lib/changelog.generated.js

@@ -1,6 +1,6 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-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.1] - 2026-05-16\n\n### Changed\n\n- Brand consistency: \"PICA\" → \"withPICA\" in package metadata (description, author).\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 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.5.0] - 2026-09-26\n\n### Fixed\n\n- The `pica-directory-mcp` bin entry is written `dist/index.js`. npm 11.13\n  rejects the `./dist/index.js` form at publish and silently drops the bin,\n  which would have broken `npx @withpica/mcp-server-directory`.\n\n### Added\n\n- **`directory_send_licensing_enquiry`** (tier `write`, the directory's first\n  non-read tool). An agent helping someone find music can now, with their\n  go-ahead, send the owner a licensing enquiry through the same public route\n  as the directory's web form. The enquiry is passed to the owner, who can reply\n  by email; a confirmation to the requester is usually sent but not\n  guaranteed. Nothing is agreed or priced, and a budget is optional. Refusals\n  come back as not sent, with the reason (403 owner not taking enquiries, 404\n  not listed, 429 too many); a server error or lost answer comes back as an\n  unknown outcome, so an agent does not resend a stored enquiry.\n- `directory_lookup_work` now ends with a **Licensing** section: the work's\n  public page and whether enquiries are open (`work_page_url`,\n  `enquiries_open` in structured content).\n\n### Changed\n\n- The `find-music-for-sync-brief` skill points at the enquiry tool instead of\n  telling the user to find the rights holder themselves.\n\n## [1.4.2] - 2026-08-24\n\n### Added\n\n- **A README on the npm page.** This package published with no README at all, so\n  its npm listing showed only the one-line description — a stranger evaluating it\n  had nothing to read. The README is now generated by\n  `scripts/build-mcp-readmes.mjs` from the tool registry and `package.json`, so\n  the install command, the tool inventory and the version cannot drift from the\n  code the way a hand-written one did. `--check` fails CI on drift.\n- `homepage` and `bugs.email` in `package.json`, so the npm page links somewhere\n  and a problem has a route back.\n\n### Fixed\n\n- **The published tool count drifted to 9 of 11** — `directory_release_notes`, `directory_skill_get` and `directory_skill_list` had been added without the count following; now derived from the registry with a parity tripwire, and the one destructive tool no longer wears a write tier (pica #2024).\n\n- `formatAsText`: bare array payloads are wrapped in the standard\n  `{ items, count }` list envelope — MCP requires structuredContent to be a\n  record, and the SDK server rejects arrays with -32602 (latent here: no\n  current call sites, fixed in lockstep with `@withpica/mcp-utils`).\n\n## [1.4.1] - 2026-05-16\n\n### Changed\n\n- Branding pass: \"PICA\" → \"withPICA\" in package metadata\n  (commit `9787d4c37`). Published to npm 2026-05-16 without committing the\n  version bump — repo realigned 2026-06-12.\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.1";
+export const PACKAGE_VERSION = "1.5.0";
 //# sourceMappingURL=changelog.generated.js.map

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

@@ -1 +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,00IAA00I,CAAC;AACv2I,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC"}
+{"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,w3NAAw3N,CAAC;AACr5N,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC"}

package/dist/lib/changelog.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 export const CHANGELOG_SECTION_NAMES = [
     "Added",
     "Changed",

package/dist/prompts/index.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 export class PromptRegistry {
     listPrompts() {
         return [
@@ -155,7 +155,7 @@ If I want to BROWSE what's in the directory:
 
 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.`,
+Important: The directory's catalogue is read-only: I can search and look up, but I can't create or modify anything in it. The one thing I can send, and only if you ask, is a licensing enquiry to a work's owner, with your own name and email. Only works from organisations that opted into the directory are visible.`,
                     },
                 },
             ],

package/dist/prompts/index.js.map

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;0TAwBwS;qBAC/S;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -1 +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"}
+{"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,EA8bpC,CAAC"}

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

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-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
@@ -430,5 +430,19 @@ export const PUBLIC_ATLAS = [
         ],
         resolves_to: { kind: "tool", name: "directory_release_notes" },
     },
+    // ─────────────────────────────────────────────────────────────────
+    // Reaching an owner — the directory's one write
+    // ─────────────────────────────────────────────────────────────────
+    {
+        question: "can I license this song?",
+        synonyms: [
+            "ask the owner if I can use this",
+            "send a licensing enquiry",
+            "contact the rights holder",
+            "who do I ask to license this?",
+            "I want to use this track in my project",
+        ],
+        resolves_to: { kind: "tool", name: "directory_send_licensing_enquiry" },
+    },
 ];
 //# sourceMappingURL=public-question-atlas.js.map

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

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

@@ -1,2 +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";
+export declare const DIRECTORY_PRIMER = "# PICA Directory \u2014 Public Music Catalog Search\n\nRead access to published music catalog data, plus one write: sending a\nlicensing enquiry to a work's owner when the user asks. No authentication\nrequired.\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- Send a licensing enquiry to a work's owner (directory_send_licensing_enquiry),\n  only when the user asks and gives their own name, email and project\n\n## What You Cannot Do\n- Create, update, or delete catalogue data (the catalogue is 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

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

package/dist/resources/llms-primer.js

@@ -1,7 +1,9 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-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.
+Read access to published music catalog data, plus one write: sending a
+licensing enquiry to a work's owner when the user asks. No authentication
+required.
 Works and people are only visible if the owning organisation has opted into
 the directory.
 
@@ -16,9 +18,11 @@ research, or identifier lookup.
 - Search people by name, ISNI, IPI
 - Look up works by recording ISRC (directory_lookup_isrc)
 - Search recordings by audio characteristics (BPM, key, mood, energy)
+- Send a licensing enquiry to a work's owner (directory_send_licensing_enquiry),
+  only when the user asks and gives their own name, email and project
 
 ## What You Cannot Do
-- Create, update, or delete anything (read-only)
+- Create, update, or delete catalogue data (the catalogue is read-only)
 - Access unpublished works or private catalog data
 - See financial data, agreements, or internal metadata
 

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

@@ -1 +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"}
+{"version":3,"file":"llms-primer.js","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC/B,CAAC"}

package/dist/server.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";

package/dist/skills/index.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 /**
  * Skills Registry — directory MCP, ADR-140 Phase 2b
  *

package/dist/skills/skills.generated.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 export const SKILLS = {
     "find-music-for-sync-brief": {
         name: "find-music-for-sync-brief",
@@ -7,7 +7,7 @@ export const SKILLS = {
         audience: "sync supervisor / music library / ad agency / film & TV music team",
         tools_required: ["directory_search_recordings", "directory_lookup_work", "directory_lookup_person"],
         output: "A rights-aware shortlist — each result with title, artist, audio characteristics (BPM, key, energy), credits summary for licensing contact, and any flags (unattested credits, low registration score, missing ISRC).",
-        body: "# find-music-for-sync-brief\n\nHelp the user find music in PICA's public directory for a sync brief. Translate their description (mood, vibe, scene, era, vocal style) into search parameters, run the search, and return a shortlist that includes the information they need to license — not just the track.\n\nThis is a public skill — any AI agent connected to the directory MCP can use it. The directory only contains works from organisations that have opted in.\n\n## Step 1 — Translate the brief\n\nMost sync briefs are described in natural language. Translate before searching:\n\n| User says | Search parameters |\n|---|---|\n| upbeat / uplifting / driving | `min_energy: 0.6`, `min_danceability: 0.5` |\n| dark / moody / brooding | `max_energy: 0.4`, `key_mode: minor` |\n| chill / ambient / background | `max_energy: 0.4`, `max_bpm: 100` |\n| epic / cinematic | `min_energy: 0.7`, often longer durations |\n| specific BPM (\"around 120bpm\") | `min_bpm: 115`, `max_bpm: 125` |\n| acoustic / sparse | typically lower `danceability` and `energy` |\n| vocal / instrumental | filter on `has_vocals` if available |\n\nIf the user gives an artist or song reference (\"something like X\"), look up that reference first via `directory_lookup_work` or `directory_search_recordings` by title — then mimic its audio profile in the new search.\n\n## Step 2 — Search\n\nCall `directory_search_recordings` with the parameters from step 1. Default limit is fine for an initial scan.\n\nIf the brief is vague, do two searches with slightly different parameters and compare. If too many results, narrow on BPM or key. If too few, widen the BPM range first, then drop key_mode.\n\n## Step 3 — Lookup full details\n\nFor the top 5-10 promising results, call `directory_lookup_work` to get:\n\n- **Who wrote it** — credits with IPI numbers (essential for the licensing contact path)\n- **Whether credits are attested** — an unattested credit means the ownership claim hasn't been verified; flag this\n- **DSP links** (Spotify, Apple Music) — the user wants to listen before shortlisting\n- **Registration score** — higher score = cleaner rights chain = easier to license\n\nFor high-value matches where the user wants to know more about the creator, call `directory_lookup_person` with the IPI to see the writer's broader catalog and collaborator network.\n\n## Step 4 — Present the shortlist\n\nPresent each shortlisted track with:\n\n- **Title, artist** — what the user listens for\n- **Audio profile** — BPM, key, energy (one line, the supervisor's quick filter)\n- **Credits summary** — writers with IPI, publisher if known (this is the licensing path)\n- **DSP links** — so the user can listen\n- **Flags** — unattested credits, low registration score, missing ISRC, multiple writers (= multi-party clearance needed)\n\nIf a track has all green flags (attested credits, high registration score, ISRC present, single or low-count writers), call it out as \"clean to clear.\"\n\n## Step 5 — If no results\n\nIf the search returns nothing, walk the user back through the brief:\n- Widen the BPM range first (most supervisors don't actually mind ±10 BPM)\n- Drop the key filter (key matching matters less than mood for most placements)\n- Drop the energy bounds and search by genre/mood text only\n- Suggest the user expand to adjacent moods (\"uplifting\" → also try \"warm\" or \"hopeful\")\n\nBe honest if the directory is small for a specific style — PICA's directory grows with org opt-ins; some niches are sparse.\n\n## What not to do\n\n- Don't claim to license tracks — this skill returns a shortlist, not a license. The user contacts the rights holder via the credits summary.\n- Don't speculate about pricing — sync fees are negotiated per-placement\n- Don't return results from outside the directory (no general web search, no Spotify metadata directly) — the directory is the source of truth for this skill\n- Don't return tracks with no attested credits without flagging them as \"rights chain unverified\"\n\n## Follow-on skills\n\n- `due-diligence-on-creator` (Stage 2 candidate) — for deeper research on a specific writer before reaching out\n",
+        body: "# find-music-for-sync-brief\n\nHelp the user find music in PICA's public directory for a sync brief. Translate their description (mood, vibe, scene, era, vocal style) into search parameters, run the search, and return a shortlist that includes the information they need to license — not just the track.\n\nThis is a public skill — any AI agent connected to the directory MCP can use it. The directory only contains works from organisations that have opted in.\n\n## Step 1 — Translate the brief\n\nMost sync briefs are described in natural language. Translate before searching:\n\n| User says | Search parameters |\n|---|---|\n| upbeat / uplifting / driving | `min_energy: 0.6`, `min_danceability: 0.5` |\n| dark / moody / brooding | `max_energy: 0.4`, `key_mode: minor` |\n| chill / ambient / background | `max_energy: 0.4`, `max_bpm: 100` |\n| epic / cinematic | `min_energy: 0.7`, often longer durations |\n| specific BPM (\"around 120bpm\") | `min_bpm: 115`, `max_bpm: 125` |\n| acoustic / sparse | typically lower `danceability` and `energy` |\n| vocal / instrumental | filter on `has_vocals` if available |\n\nIf the user gives an artist or song reference (\"something like X\"), look up that reference first via `directory_lookup_work` or `directory_search_recordings` by title — then mimic its audio profile in the new search.\n\n## Step 2 — Search\n\nCall `directory_search_recordings` with the parameters from step 1. Default limit is fine for an initial scan.\n\nIf the brief is vague, do two searches with slightly different parameters and compare. If too many results, narrow on BPM or key. If too few, widen the BPM range first, then drop key_mode.\n\n## Step 3 — Lookup full details\n\nFor the top 5-10 promising results, call `directory_lookup_work` to get:\n\n- **Who wrote it** — credits with IPI numbers (essential for the licensing contact path)\n- **Whether credits are attested** — an unattested credit means the ownership claim hasn't been verified; flag this\n- **DSP links** (Spotify, Apple Music) — the user wants to listen before shortlisting\n- **Registration score** — higher score = cleaner rights chain = easier to license\n\nFor high-value matches where the user wants to know more about the creator, call `directory_lookup_person` with the IPI to see the writer's broader catalog and collaborator network.\n\n## Step 4 — Present the shortlist\n\nPresent each shortlisted track with:\n\n- **Title, artist** — what the user listens for\n- **Audio profile** — BPM, key, energy (one line, the supervisor's quick filter)\n- **Credits summary** — writers with IPI, publisher if known (this is the licensing path)\n- **DSP links** — so the user can listen\n- **Flags** — unattested credits, low registration score, missing ISRC, multiple writers (= multi-party clearance needed)\n\nIf a track has all green flags (attested credits, high registration score, ISRC present, single or low-count writers), call it out as \"clean to clear.\"\n\n## Step 5 — If no results\n\nIf the search returns nothing, walk the user back through the brief:\n- Widen the BPM range first (most supervisors don't actually mind ±10 BPM)\n- Drop the key filter (key matching matters less than mood for most placements)\n- Drop the energy bounds and search by genre/mood text only\n- Suggest the user expand to adjacent moods (\"uplifting\" → also try \"warm\" or \"hopeful\")\n\nBe honest if the directory is small for a specific style — PICA's directory grows with org opt-ins; some niches are sparse.\n\n## What not to do\n\n- Don't claim to license tracks — this skill returns a shortlist, not a license. When the user wants to approach an owner, offer `directory_send_licensing_enquiry`, and send it only once they say yes and give their own name, email and project description. Never invent those details.\n- Don't speculate about pricing — sync fees are negotiated per-placement\n- Don't return results from outside the directory (no general web search, no Spotify metadata directly) — the directory is the source of truth for this skill\n- Don't return tracks with no attested credits without flagging them as \"rights chain unverified\"\n\n## Follow-on skills\n\n- `due-diligence-on-creator` (Stage 2 candidate) — for deeper research on a specific writer before reaching out\n",
     },
 };
 export const SKILL_NAMES = ["find-music-for-sync-brief"];

package/dist/skills/skills.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.generated.js","sourceRoot":"","sources":["../../src/skills/skills.generated.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAoB7D,MAAM,CAAC,MAAM,MAAM,GAA0B;IAC3C,2BAA2B,EAAE;QAC3B,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,yNAAyN;QACtO,QAAQ,EAAE,CAAC,6BAA6B,EAAC,kCAAkC,EAAC,sBAAsB,EAAC,oCAAoC,EAAC,+BAA+B,CAAC;QACxK,QAAQ,EAAE,oEAAoE;QAC9E,cAAc,EAAE,CAAC,6BAA6B,EAAC,uBAAuB,EAAC,yBAAyB,CAAC;QACjG,MAAM,EAAE,uNAAuN;QAC/N,IAAI,EAAE,ijIAAijI;KACxjI;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAA0B,CAAC,2BAA2B,CAAC,CAAC"}
+{"version":3,"file":"skills.generated.js","sourceRoot":"","sources":["../../src/skills/skills.generated.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAoB7D,MAAM,CAAC,MAAM,MAAM,GAA0B;IAC3C,2BAA2B,EAAE;QAC3B,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,yNAAyN;QACtO,QAAQ,EAAE,CAAC,6BAA6B,EAAC,kCAAkC,EAAC,sBAAsB,EAAC,oCAAoC,EAAC,+BAA+B,CAAC;QACxK,QAAQ,EAAE,oEAAoE;QAC9E,cAAc,EAAE,CAAC,6BAA6B,EAAC,uBAAuB,EAAC,yBAAyB,CAAC;QACjG,MAAM,EAAE,uNAAuN;QAC/N,IAAI,EAAE,+rIAA+rI;KACtsI;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAA0B,CAAC,2BAA2B,CAAC,CAAC"}

package/dist/tools/chain.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
 export class DirectoryChainTools {
     client;
     constructor(client) {

package/dist/tools/enquiries.d.ts

@@ -0,0 +1,19 @@
+import { DirectoryClient } from "../client.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+/**
+ * The directory's only non-read tool: send a licensing enquiry to the owner
+ * of a work listed in the public directory. It goes through the same public
+ * route as the directory's web form (POST /api/shop/license-enquiries), so
+ * the same rules apply: the work must be listed, the owner must not have
+ * switched enquiries off, and a budget is optional.
+ */
+export declare class DirectoryEnquiryTools {
+    private client;
+    constructor(client: DirectoryClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private sendEnquiry;
+}
+//# sourceMappingURL=enquiries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enquiries.d.ts","sourceRoot":"","sources":["../../src/tools/enquiries.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAqCtE;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA0F3D,WAAW;CAiE1B"}