@withpica/mcp-server-directory 1.3.0 → 1.4.0

package/dist/tools/index.js

@@ -0,0 +1,49 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { DirectoryWorksTools } from "./works.js";
+import { DirectoryPeopleTools } from "./people.js";
+import { DirectorySearchTools } from "./search.js";
+import { DirectoryRecordingsTools } from "./recordings.js";
+import { DirectoryChainTools } from "./chain.js";
+import { DirectorySkillsTools } from "./skills.js";
+import { DirectoryReleaseNotesTools } from "./release-notes.js";
+import { formatError, logError, ToolExecutionError } from "../utils/errors.js";
+export class ToolRegistry {
+    tools;
+    constructor(client) {
+        this.tools = new Map();
+        const groups = [
+            new DirectoryWorksTools(client),
+            new DirectoryPeopleTools(client),
+            new DirectorySearchTools(client),
+            new DirectoryRecordingsTools(client),
+            new DirectoryChainTools(client),
+            new DirectorySkillsTools(),
+            new DirectoryReleaseNotesTools(client),
+        ];
+        for (const group of groups) {
+            for (const tool of group.getTools()) {
+                this.tools.set(tool.definition.name, tool);
+            }
+        }
+    }
+    listTools() {
+        return Array.from(this.tools.values()).map((t) => t.definition);
+    }
+    async executeTool(name, args) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            throw new ToolExecutionError(`Tool not found: ${name}`);
+        }
+        try {
+            return await tool.executor(args);
+        }
+        catch (error) {
+            logError(`Tool execution: ${name}`, error);
+            return {
+                content: [formatError(error)],
+                isError: true,
+            };
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA+B/E,MAAM,OAAO,YAAY;IACf,KAAK,CAGX;IAEF,YAAY,MAAuB;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG;YACb,IAAI,mBAAmB,CAAC,MAAM,CAAC;YAC/B,IAAI,oBAAoB,CAAC,MAAM,CAAC;YAChC,IAAI,oBAAoB,CAAC,MAAM,CAAC;YAChC,IAAI,wBAAwB,CAAC,MAAM,CAAC;YACpC,IAAI,mBAAmB,CAAC,MAAM,CAAC;YAC/B,IAAI,oBAAoB,EAAE;YAC1B,IAAI,0BAA0B,CAAC,MAAM,CAAC;SACvC,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,IAAyB;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,mBAAmB,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBAC7B,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/tools/people.d.ts

@@ -0,0 +1,13 @@
+import { DirectoryClient } from "../client.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DirectoryPeopleTools {
+    private client;
+    constructor(client: DirectoryClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listPeople;
+    private lookupPerson;
+}
+//# sourceMappingURL=people.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/tools/people.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,qBAAa,oBAAoB;IAC/B,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;YAwE3D,UAAU;YAwBV,YAAY;CAsF3B"}

package/dist/tools/people.js

@@ -0,0 +1,177 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatStructuredList } from "../utils/formatting.js";
+export class DirectoryPeopleTools {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "directory_list_people",
+                    tier: "read",
+                    description: "Use when the user asks: 'list creators in PICA', 'people starting with B', " +
+                        "'browse the people directory'. " +
+                        "Browse and filter creators in the PICA public directory. " +
+                        "Filter by free-text (q), ISNI, IPI, or starting letter (A–Z, or '#' for numeric). " +
+                        "Returns paginated results. " +
+                        "→ then: directory_lookup_person (full profile with works and identifiers)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            q: {
+                                type: "string",
+                                description: "Text search across creator names",
+                            },
+                            isni: {
+                                type: "string",
+                                description: "Filter by ISNI identifier",
+                            },
+                            ipi: {
+                                type: "string",
+                                description: "Filter by IPI number",
+                            },
+                            letter: {
+                                type: "string",
+                                description: "Filter by last name starting letter (A–Z), or '#' for numeric",
+                            },
+                            page: {
+                                type: "number",
+                                description: "Page number (default: 1, 20 results per page)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listPeople.bind(this),
+            },
+            {
+                definition: {
+                    name: "directory_lookup_person",
+                    tier: "read",
+                    description: "Use when the user asks: 'lookup IPI 12345', 'who is creator X?', " +
+                        "'tell me about creator X', 'lookup ISNI X'. " +
+                        "Also call this BEFORE directory_list_works when the input person name is ambiguous " +
+                        "(e.g. 'Bowie', 'Sade', 'Madonna') to surface candidate persons for disambiguation. " +
+                        "Get full details of a creator by global creator ID (UUID), ISNI, IPI number, or MusicBrainz ID. " +
+                        "Returns identifiers, credited works with roles, collaborator network, and verification score " +
+                        "as a structured markdown summary. " +
+                        "→ then: directory_lookup_work (inspect a credited work), directory_search_recordings (find their recordings by audio)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Global creator ID (UUID), ISNI, IPI number, or MusicBrainz ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.lookupPerson.bind(this),
+            },
+        ];
+    }
+    async listPeople(args) {
+        const page = Math.max(args.page || 1, 1);
+        const limit = 20;
+        const offset = (page - 1) * limit;
+        const params = {
+            limit: String(limit),
+            offset: String(offset),
+        };
+        if (args.q)
+            params.q = args.q;
+        if (args.isni)
+            params.isni = args.isni;
+        if (args.ipi)
+            params.ipi = args.ipi;
+        if (args.letter)
+            params.letter = args.letter;
+        const response = await this.client.request("/people", params);
+        return formatStructuredList(response.data || [], "creator", {
+            page,
+            total: response.pagination?.total || 0,
+            total_pages: Math.ceil((response.pagination?.total || 0) / limit),
+        });
+    }
+    async lookupPerson(args) {
+        const response = await this.client.request(`/people/${encodeURIComponent(args.id)}`);
+        const data = response.data;
+        if (!data) {
+            return {
+                content: [{ type: "text", text: "Person not found." }],
+                structuredContent: {},
+            };
+        }
+        const lines = [];
+        const name = data.name || data.full_name || data.display_name || "Unknown";
+        lines.push(`## ${name}`);
+        lines.push("");
+        if (data.score !== undefined && data.score !== null) {
+            const tier = data.score >= 80
+                ? "verified"
+                : data.score >= 50
+                    ? "partial"
+                    : "incomplete";
+            lines.push(`- **Score:** ${data.score}/100 (${tier})`);
+            lines.push("");
+        }
+        const identifiers = [];
+        if (data.ipi || data.ipi_number)
+            identifiers.push({ type: "IPI", value: data.ipi || data.ipi_number });
+        if (data.isni)
+            identifiers.push({ type: "ISNI", value: data.isni });
+        if (data.musicbrainz_id)
+            identifiers.push({ type: "MusicBrainz", value: data.musicbrainz_id });
+        if (data.ipn)
+            identifiers.push({ type: "IPN", value: data.ipn });
+        lines.push("### Identifiers");
+        if (identifiers.length > 0) {
+            lines.push("| Type | Value |");
+            lines.push("| --- | --- |");
+            for (const id of identifiers) {
+                lines.push(`| ${id.type} | ${id.value} |`);
+            }
+        }
+        else {
+            lines.push("_No identifiers recorded._");
+        }
+        lines.push("");
+        const works = data.works || data.credited_works || [];
+        lines.push(`### Works (${works.length})`);
+        if (works.length > 0) {
+            lines.push("| Title | Role |");
+            lines.push("| --- | --- |");
+            for (const w of works) {
+                const title = w.title || "—";
+                const role = w.role || w.credit_role || "—";
+                lines.push(`| ${title} | ${role} |`);
+            }
+        }
+        else {
+            lines.push("_No works recorded._");
+        }
+        lines.push("");
+        const collaborators = data.collaborators || [];
+        lines.push(`### Collaborators (${collaborators.length})`);
+        if (collaborators.length > 0) {
+            lines.push("| Name |");
+            lines.push("| --- |");
+            for (const c of collaborators) {
+                const colName = c.name || c.full_name || c.display_name || "—";
+                lines.push(`| ${colName} |`);
+            }
+        }
+        else {
+            lines.push("_No collaborators recorded._");
+        }
+        lines.push("");
+        const markdown = lines.join("\n");
+        return {
+            content: [{ type: "text", text: markdown }],
+            structuredContent: data,
+        };
+    }
+}
+//# sourceMappingURL=people.js.map

package/dist/tools/people.js.map

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

package/dist/tools/recordings.d.ts

@@ -0,0 +1,12 @@
+import { DirectoryClient } from "../client.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DirectoryRecordingsTools {
+    private client;
+    constructor(client: DirectoryClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private searchRecordings;
+}
+//# sourceMappingURL=recordings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recordings.d.ts","sourceRoot":"","sources":["../../src/tools/recordings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,qBAAa,wBAAwB;IACnC,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;YAqF3D,gBAAgB;CAkD/B"}

package/dist/tools/recordings.js

@@ -0,0 +1,145 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatStructuredList } from "../utils/formatting.js";
+export class DirectoryRecordingsTools {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "directory_search_recordings",
+                    tier: "read",
+                    description: "Use when the user asks: 'find upbeat tracks around 120 BPM', " +
+                        "'find instrumental tracks in C minor', 'find energetic music for sync', " +
+                        "'tracks at X BPM in [key]'. " +
+                        "AUDIO-FEATURE search only — for name- or title-shaped queries use directory_lookup_work, " +
+                        "directory_lookup_isrc, or directory_lookup_person, NOT this tool. " +
+                        "Find tracks by BPM, key, energy, danceability, duration, and more. " +
+                        "Only returns recordings from organisations that have opted into the directory. " +
+                        "→ then: directory_lookup_work (credits and licensing details for a matched track)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            min_bpm: {
+                                type: "number",
+                                description: "Minimum BPM (e.g. 100)",
+                            },
+                            max_bpm: {
+                                type: "number",
+                                description: "Maximum BPM (e.g. 140)",
+                            },
+                            key: {
+                                type: "string",
+                                description: "Musical key (e.g. 'C', 'F#', 'Bb'). Matches the detected key.",
+                            },
+                            key_mode: {
+                                type: "string",
+                                enum: ["major", "minor"],
+                                description: "Key mode — major or minor",
+                            },
+                            min_energy: {
+                                type: "number",
+                                description: "Minimum energy (0-1). Higher = more energetic.",
+                            },
+                            max_energy: {
+                                type: "number",
+                                description: "Maximum energy (0-1).",
+                            },
+                            min_danceability: {
+                                type: "number",
+                                description: "Minimum danceability (0-1). Higher = more danceable.",
+                            },
+                            max_danceability: {
+                                type: "number",
+                                description: "Maximum danceability (0-1).",
+                            },
+                            min_duration: {
+                                type: "number",
+                                description: "Minimum duration in seconds.",
+                            },
+                            max_duration: {
+                                type: "number",
+                                description: "Maximum duration in seconds.",
+                            },
+                            vocals_only: {
+                                type: "boolean",
+                                description: "Only return tracks with vocals.",
+                            },
+                            instrumental_only: {
+                                type: "boolean",
+                                description: "Only return instrumental tracks.",
+                            },
+                            mood: {
+                                type: "string",
+                                description: "Filter by mood (exact match).",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results to return (default: 20, max: 100).",
+                            },
+                        },
+                    },
+                },
+                executor: this.searchRecordings.bind(this),
+            },
+        ];
+    }
+    async searchRecordings(args) {
+        const params = {};
+        // Map all filters to query params
+        const numericKeys = [
+            "min_bpm",
+            "max_bpm",
+            "min_energy",
+            "max_energy",
+            "min_danceability",
+            "max_danceability",
+            "min_duration",
+            "max_duration",
+            "limit",
+        ];
+        for (const k of numericKeys) {
+            if (args[k] != null)
+                params[k] = String(args[k]);
+        }
+        if (args.key)
+            params.key = args.key;
+        if (args.key_mode)
+            params.key_mode = args.key_mode;
+        if (args.mood)
+            params.mood = args.mood;
+        if (args.vocals_only)
+            params.vocals_only = "true";
+        if (args.instrumental_only)
+            params.instrumental_only = "true";
+        const response = await this.client.request("/recordings", params);
+        const recordings = response.data || [];
+        // Format each recording for readability
+        const formatted = recordings.map((r) => {
+            const parts = [`${r.title} (${r.isrc})`];
+            if (r.artist_name)
+                parts.push(`Artist: ${r.artist_name}`);
+            if (r.bpm)
+                parts.push(`BPM: ${Math.round(r.bpm)}`);
+            if (r.key)
+                parts.push(`Key: ${r.key}${r.key_mode ? ` ${r.key_mode}` : ""}`);
+            if (r.energy != null)
+                parts.push(`Energy: ${r.energy}`);
+            if (r.duration_seconds)
+                parts.push(`Duration: ${Math.round(r.duration_seconds)}s`);
+            if (r.has_vocals != null)
+                parts.push(r.has_vocals ? "Vocals: yes" : "Instrumental");
+            if (r.owner_org_name)
+                parts.push(`Owner: ${r.owner_org_name}`);
+            if (r.work_title)
+                parts.push(`Work: ${r.work_title}`);
+            return { ...r, _summary: parts.join(" | ") };
+        });
+        return formatStructuredList(formatted, "recording", {
+            filters: args,
+        });
+    }
+}
+//# sourceMappingURL=recordings.js.map

package/dist/tools/recordings.js.map

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

package/dist/tools/release-notes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * directory_release_notes — what shipped in the PICA directory MCP.
+ *
+ * Reads CHANGELOG.md embedded at build time via scripts/build-changelog.ts.
+ * Sister of pica_release_notes (creator MCP) and team_release_notes (team MCP).
+ *
+ * Public-facing MCP — no trade-secret content in the description (per
+ * .claude/rules/ip-protection.md). The CHANGELOG body is the same file
+ * shipped in the npm tarball, already vetted as public.
+ */
+import { DirectoryClient } from "../client.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DirectoryReleaseNotesTools {
+    private client;
+    constructor(client: DirectoryClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private releaseNotes;
+}
+//# sourceMappingURL=release-notes.d.ts.map

package/dist/tools/release-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-notes.d.ts","sourceRoot":"","sources":["../../src/tools/release-notes.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAyBtE,qBAAa,0BAA0B;IACzB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA6CzE,OAAO,CAAC,YAAY,CAyDlB;CACH"}

package/dist/tools/release-notes.js

@@ -0,0 +1,102 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { parseChangelogText, CHANGELOG_SECTION_NAMES, } from "../lib/changelog.js";
+import { CHANGELOG_MD, PACKAGE_NAME, PACKAGE_VERSION, } from "../lib/changelog.generated.js";
+const RESOURCE_URI = "release-notes://withpica/mcp-server-directory/latest";
+const DEFAULT_LIMIT = 3;
+const MAX_LIMIT = 20;
+function compareSemver(a, b) {
+    const parse = (v) => v.split(".").map((n) => parseInt(n, 10) || 0);
+    const [a1, a2, a3] = parse(a);
+    const [b1, b2, b3] = parse(b);
+    if (a1 !== b1)
+        return a1 - b1;
+    if (a2 !== b2)
+        return a2 - b2;
+    return a3 - b3;
+}
+export class DirectoryReleaseNotesTools {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "directory_release_notes",
+                    tier: "read",
+                    description: "Use when the user asks: 'what's new in the directory mcp', " +
+                        "'what changed in the directory', 'directory release notes', " +
+                        "'what version is the directory on'. " +
+                        "Returns recent releases of the PICA directory MCP server — " +
+                        "what shipped in the public catalogue surface itself. " +
+                        "NOT for catalogue content searches (use directory_search / " +
+                        "directory_list_works / directory_chain for those). " +
+                        "Returns { package, current_version, releases: [{ version, date, sections, markdown }], resource_uri }. " +
+                        "Defaults to the last 3 releases; use `since_version` to bound the output " +
+                        "or `sections` to filter to Added/Fixed/etc.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            since_version: {
+                                type: "string",
+                                description: "If set, returns only releases strictly greater than this version " +
+                                    "(semver-compared). Versions equal to since_version are excluded.",
+                            },
+                            limit: {
+                                type: "number",
+                                description: `Maximum number of releases to return. Default ${DEFAULT_LIMIT}, max ${MAX_LIMIT}.`,
+                            },
+                            sections: {
+                                type: "array",
+                                items: { type: "string", enum: [...CHANGELOG_SECTION_NAMES] },
+                                description: "Filter each release's sections to only these names " +
+                                    "(e.g. ['Added', 'Fixed']). Sections not in the list are omitted from output.",
+                            },
+                        },
+                    },
+                },
+                executor: this.releaseNotes.bind(this),
+            },
+        ];
+    }
+    releaseNotes = async (args) => {
+        const sinceVersion = typeof args.since_version === "string" ? args.since_version : null;
+        const rawLimit = typeof args.limit === "number" ? args.limit : DEFAULT_LIMIT;
+        const limit = Math.max(1, Math.min(MAX_LIMIT, Math.floor(rawLimit)));
+        const sectionFilter = Array.isArray(args.sections)
+            ? args.sections.filter((s) => CHANGELOG_SECTION_NAMES.includes(s))
+            : null;
+        const all = parseChangelogText(CHANGELOG_MD);
+        let filtered = all;
+        if (sinceVersion) {
+            filtered = all.filter((e) => compareSemver(e.version, sinceVersion) > 0);
+        }
+        filtered = filtered.slice(0, limit);
+        const releases = filtered.map((e) => {
+            const sections = sectionFilter
+                ? Object.fromEntries(Object.entries(e.sections).filter(([k]) => sectionFilter.includes(k)))
+                : e.sections;
+            return {
+                version: e.version,
+                date: e.date,
+                sections,
+                markdown: e.markdown,
+            };
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        package: PACKAGE_NAME,
+                        current_version: PACKAGE_VERSION,
+                        releases,
+                        resource_uri: RESOURCE_URI,
+                    }, null, 2),
+                },
+            ],
+        };
+    };
+}
+//# sourceMappingURL=release-notes.js.map

package/dist/tools/release-notes.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,12 @@
+import { DirectoryClient } from "../client.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DirectorySearchTools {
+    private client;
+    constructor(client: DirectoryClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private search;
+}
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,qBAAa,oBAAoB;IAC/B,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;YAmC3D,MAAM;CAiBrB"}

package/dist/tools/search.js

@@ -0,0 +1,56 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatStructuredList } from "../utils/formatting.js";
+export class DirectorySearchTools {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "directory_search",
+                    tier: "read",
+                    description: "Use when the user asks: 'find me X', 'who or what is X?', " +
+                        "'find any record of X'. " +
+                        "Use when the entity type is not yet known. " +
+                        "Convenience fan-out across works and creators — runs list_works and list_people with the same query and returns the union. " +
+                        "No cross-type ranking; prefer list_works or list_people when the entity type is known. " +
+                        "→ then: directory_lookup_work (work details), directory_lookup_person (creator details)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: {
+                                type: "string",
+                                description: "Search query — matches work titles, ISWCs, creator names, ISNIs",
+                            },
+                            type: {
+                                type: "string",
+                                enum: ["works", "people"],
+                                description: "Limit results to a specific entity type",
+                            },
+                        },
+                        required: ["query"],
+                    },
+                },
+                executor: this.search.bind(this),
+            },
+        ];
+    }
+    async search(args) {
+        const params = {
+            q: args.query,
+            limit: "20",
+            offset: "0",
+        };
+        if (args.type)
+            params.type = args.type;
+        const response = await this.client.request("/search", params);
+        return formatStructuredList(response.data || [], "result", {
+            query: args.query,
+            type: args.type || "all",
+            total: response.pagination?.total || 0,
+        });
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAI7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAkB;IAEhC,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,kBAAkB;oBACxB,IAAI,EAAE,MAAM;oBACZ,WAAW,EACT,4DAA4D;wBAC5D,0BAA0B;wBAC1B,6CAA6C;wBAC7C,6HAA6H;wBAC7H,yFAAyF;wBACzF,yFAAyF;oBAC3F,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,iEAAiE;6BACpE;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;gCACzB,WAAW,EAAE,yCAAyC;6BACvD;yBACF;wBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;qBACpB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACjC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,IAAyB;QAC5C,MAAM,MAAM,GAA2B;YACrC,CAAC,EAAE,IAAI,CAAC,KAAK;YACb,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,GAAG;SACZ,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEvC,MAAM,QAAQ,GAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEnE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE;YACzD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;YACxB,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;CACF"}