@withpica/mcp-server-directory 1.3.0 → 1.4.0

package/dist/tools/skills.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Directory MCP skill tools — ADR-140 Phase 2b
+ *
+ * Sister of mcp-server/src/tools/skills.ts. Two meta-tools — list and get —
+ * named `directory_skill_*` to match the directory MCP's `directory_*` prefix
+ * convention. Same lazy-loading shape as the creator MCP variant.
+ */
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DirectorySkillsTools {
+    private registry;
+    constructor();
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listSkills;
+    private getSkill;
+}
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/tools/skills.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAiB;;IAMjC,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA4C3D,UAAU;YAsBV,QAAQ;CA2DvB"}

package/dist/tools/skills.js

@@ -0,0 +1,127 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { SkillsRegistry, SkillNotFoundError } from "../skills/index.js";
+export class DirectorySkillsTools {
+    registry;
+    constructor() {
+        this.registry = new SkillsRegistry();
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "directory_skill_list",
+                    tier: "read",
+                    description: "Use when the user asks: 'what skills do you have?', 'what can you do?', 'show me your methodologies', 'how do I find music here?'. " +
+                        "Returns the list of downloadable directory skill methodologies — name, description, trigger phrases. " +
+                        "Cheap to call. Use directory_skill_get(name) to load a specific skill's full methodology body.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                        additionalProperties: false,
+                    },
+                },
+                executor: this.listSkills.bind(this),
+            },
+            {
+                definition: {
+                    name: "directory_skill_get",
+                    tier: "read",
+                    description: "Use when the user asks: 'what skills do you have?', 'what can you do?', 'show me your methodologies'. " +
+                        "Returns the full methodology body for one directory skill — markdown with step-by-step instructions and tool chains. " +
+                        "Call directory_skill_list first to see available skill names, then directory_skill_get to load one. Read once at the start of the workflow; do not re-fetch on every step.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            name: {
+                                type: "string",
+                                description: "Kebab-case skill name from directory_skill_list (e.g. 'find-music-for-sync-brief').",
+                            },
+                        },
+                        required: ["name"],
+                        additionalProperties: false,
+                    },
+                },
+                executor: this.getSkill.bind(this),
+            },
+        ];
+    }
+    async listSkills(_args) {
+        const skills = this.registry.listSkills();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: skills.length
+                        ? `Available directory skills (${skills.length}):\n\n` +
+                            skills
+                                .map((s) => `- ${s.name} — ${s.description}\n  triggers: ${s.triggers.join(", ")}\n  audience: ${s.audience}`)
+                                .join("\n\n") +
+                            "\n\nCall directory_skill_get(name) to load a skill's full methodology."
+                        : "No directory skills available.",
+                },
+            ],
+            structuredContent: { skills },
+        };
+    }
+    async getSkill(args) {
+        const name = String(args?.name ?? "").trim();
+        if (!name) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "Missing required argument: name. Call directory_skill_list to see available skill names.",
+                    },
+                ],
+            };
+        }
+        let skill;
+        try {
+            skill = this.registry.getSkill(name);
+        }
+        catch (err) {
+            if (err instanceof SkillNotFoundError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: `Skill not found: ${name}. Call directory_skill_list to see available skill names.`,
+                        },
+                    ],
+                };
+            }
+            throw err;
+        }
+        const frontmatterSummary = [
+            `# ${skill.name}`,
+            "",
+            `**Description:** ${skill.description}`,
+            `**Audience:** ${skill.audience}`,
+            `**Triggers:** ${skill.triggers.join(", ")}`,
+            `**Tools used:** ${skill.tools_required.join(", ")}`,
+            `**Output:** ${skill.output}`,
+            "",
+            "---",
+            "",
+        ].join("\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: frontmatterSummary + skill.body,
+                },
+            ],
+            structuredContent: {
+                name: skill.name,
+                description: skill.description,
+                triggers: skill.triggers,
+                audience: skill.audience,
+                tools_required: skill.tools_required,
+                output: skill.output,
+            },
+        };
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/tools/skills.js.map

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

package/dist/tools/works.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../src/tools/works.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,qBAAa,mBAAmB;IAC9B,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;YA2G3D,SAAS;YA2BT,UAAU;YA0GV,UAAU;CAYzB"}

package/dist/tools/works.js

@@ -0,0 +1,248 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatStructuredList } from "../utils/formatting.js";
+export class DirectoryWorksTools {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "directory_list_works",
+                    tier: "read",
+                    description: "Use when the user asks: 'list works in PICA', 'works starting with B', " +
+                        "'find works by publisher X', 'browse the catalog'. " +
+                        "Browse and filter verified musical works in the PICA public directory. " +
+                        "Filter by free-text (q), ISWC, ISRC, publisher, label, or starting letter (A–Z, or '#' for numeric). " +
+                        "Sort by title (default) or recent. Returns paginated results. " +
+                        "→ then: directory_lookup_work (full details with credits and audio)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            q: {
+                                type: "string",
+                                description: "Text search across work titles and identifiers",
+                            },
+                            iswc: {
+                                type: "string",
+                                description: "Filter by ISWC (e.g. T-123.456.789-0)",
+                            },
+                            isrc: {
+                                type: "string",
+                                description: "Filter by ISRC (exact match, cross-table recording lookup)",
+                            },
+                            publisher: {
+                                type: "string",
+                                description: "Filter by publisher name (partial match)",
+                            },
+                            label: {
+                                type: "string",
+                                description: "Filter by record label (partial match)",
+                            },
+                            letter: {
+                                type: "string",
+                                description: "Filter by title starting letter (A–Z), or '#' for numeric",
+                            },
+                            sort: {
+                                type: "string",
+                                enum: ["title", "recent"],
+                                description: "Sort order (default: title)",
+                            },
+                            page: {
+                                type: "number",
+                                description: "Page number (default: 1, 20 results per page)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listWorks.bind(this),
+            },
+            {
+                definition: {
+                    name: "directory_lookup_work",
+                    tier: "read",
+                    description: "Use when the user asks: 'what's the ISWC for X?', 'who wrote X?', " +
+                        "'tell me about song X', 'is this song registered?'. " +
+                        "Get full details of a single work by ISWC or work UUID. " +
+                        "Returns credits with IPI numbers and attestation status, recordings with ISRCs, " +
+                        "audio analysis (BPM, key, energy), DSP links (Spotify, Apple Music), " +
+                        "AI provenance, and registration score as a structured markdown summary. " +
+                        "→ then: directory_lookup_person (research a credited writer), directory_search_recordings (find similar tracks by audio)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            identifier: {
+                                type: "string",
+                                description: "ISWC (e.g. T-123.456.789-0) or work UUID",
+                            },
+                        },
+                        required: ["identifier"],
+                    },
+                },
+                executor: this.lookupWork.bind(this),
+            },
+            {
+                definition: {
+                    name: "directory_lookup_isrc",
+                    tier: "read",
+                    description: "Use when the user asks: 'lookup ISRC X', 'what's the work for ISRC X?', " +
+                        "'find the work for this recording'. " +
+                        "Shortcut: look up the work(s) associated with a recording identifier (ISRC). " +
+                        "Equivalent to directory_list_works with an isrc filter, pinned for recording-first discovery. " +
+                        "→ then: directory_lookup_work (full details on the matched work)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            isrc: {
+                                type: "string",
+                                description: "ISRC code (e.g. USABC1234567)",
+                            },
+                        },
+                        required: ["isrc"],
+                    },
+                },
+                executor: this.lookupIsrc.bind(this),
+            },
+        ];
+    }
+    async listWorks(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.iswc)
+            params.iswc = args.iswc;
+        if (args.isrc)
+            params.isrc = args.isrc;
+        if (args.publisher)
+            params.publisher = args.publisher;
+        if (args.label)
+            params.label = args.label;
+        if (args.letter)
+            params.letter = args.letter;
+        if (args.sort)
+            params.sort = args.sort;
+        const response = await this.client.request("/works", params);
+        return formatStructuredList(response.data || [], "work", {
+            page,
+            total: response.pagination?.total || 0,
+            total_pages: Math.ceil((response.pagination?.total || 0) / limit),
+        });
+    }
+    async lookupWork(args) {
+        const response = await this.client.request(`/works/${encodeURIComponent(args.identifier)}`);
+        const data = response.data;
+        if (!data) {
+            return {
+                content: [{ type: "text", text: "Work not found." }],
+                structuredContent: {},
+            };
+        }
+        const lines = [];
+        const artistName = data.artist_name || data.primary_artist || "";
+        lines.push(`## ${data.title}${artistName ? ` by ${artistName}` : ""}`);
+        lines.push("");
+        const metaParts = [];
+        if (data.iswc)
+            metaParts.push(`**ISWC:** ${data.iswc}`);
+        if (data.organisation_name)
+            metaParts.push(`**Organisation:** ${data.organisation_name}`);
+        if (metaParts.length > 0)
+            lines.push(metaParts.join(" | "));
+        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 credits = data.credits || [];
+        lines.push(`### Credits (${credits.length})`);
+        if (credits.length > 0) {
+            lines.push("| Role | Name | IPI | Attestation |");
+            lines.push("| --- | --- | --- | --- |");
+            for (const c of credits) {
+                const role = c.role || c.credit_role || "—";
+                const name = c.name || c.person_name || "—";
+                const ipi = c.ipi || c.ipi_number || "—";
+                const attestation = c.attestation_status || c.attestation || "—";
+                lines.push(`| ${role} | ${name} | ${ipi} | ${attestation} |`);
+            }
+        }
+        else {
+            lines.push("_No credits recorded._");
+        }
+        lines.push("");
+        const recordings = data.recordings || [];
+        lines.push(`### Recordings (${recordings.length})`);
+        if (recordings.length > 0) {
+            lines.push("| ISRC | Type |");
+            lines.push("| --- | --- |");
+            for (const r of recordings) {
+                const isrc = r.isrc || "—";
+                const type = r.recording_type || r.type || "—";
+                lines.push(`| ${isrc} | ${type} |`);
+            }
+        }
+        else {
+            lines.push("_No recordings linked._");
+        }
+        lines.push("");
+        const audio = data.audio_analysis || data.audio || null;
+        if (audio) {
+            lines.push("### Audio");
+            const audioParts = [];
+            if (audio.bpm !== undefined && audio.bpm !== null)
+                audioParts.push(`**BPM:** ${audio.bpm}`);
+            if (audio.key)
+                audioParts.push(`**Key:** ${audio.key}`);
+            if (audio.energy !== undefined && audio.energy !== null)
+                audioParts.push(`**Energy:** ${audio.energy}`);
+            if (audioParts.length > 0) {
+                lines.push(`- ${audioParts.join(" | ")}`);
+            }
+            lines.push("");
+        }
+        const dsp = data.dsp_links || data.streaming_links || null;
+        if (dsp && typeof dsp === "object" && Object.keys(dsp).length > 0) {
+            lines.push("### DSP Links");
+            if (dsp.spotify)
+                lines.push(`- Spotify: ${dsp.spotify}`);
+            if (dsp.apple_music)
+                lines.push(`- Apple Music: ${dsp.apple_music}`);
+            if (dsp.youtube)
+                lines.push(`- YouTube: ${dsp.youtube}`);
+            for (const [key, val] of Object.entries(dsp)) {
+                if (!["spotify", "apple_music", "youtube"].includes(key) && val) {
+                    lines.push(`- ${key}: ${val}`);
+                }
+            }
+            lines.push("");
+        }
+        const markdown = lines.join("\n");
+        return {
+            content: [{ type: "text", text: markdown }],
+            structuredContent: data,
+        };
+    }
+    async lookupIsrc(args) {
+        const response = await this.client.request("/works", {
+            isrc: args.isrc,
+            limit: "100",
+            offset: "0",
+        });
+        return formatStructuredList(response.data || [], "work", {
+            isrc: args.isrc,
+            total: response.pagination?.total || 0,
+        });
+    }
+}
+//# sourceMappingURL=works.js.map

package/dist/tools/works.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class McpServerError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(message: string, code: string, details?: any | undefined);
+}
+export declare class ToolExecutionError extends McpServerError {
+    constructor(message: string, details?: any);
+}
+export declare function formatError(error: any): {
+    type: string;
+    text: string;
+};
+export declare function logError(context: string, error: any): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAe,SAAQ,KAAK;IAG9B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,GAAG;gBAFpB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,GAAG,YAAA;CAMvB;AAED,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA+BtE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAS1D"}

package/dist/utils/errors.js

@@ -0,0 +1,48 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export class McpServerError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "McpServerError";
+        Object.setPrototypeOf(this, McpServerError.prototype);
+    }
+}
+export class ToolExecutionError extends McpServerError {
+    constructor(message, details) {
+        super(message, "TOOL_EXECUTION_ERROR", details);
+        this.name = "ToolExecutionError";
+    }
+}
+export function formatError(error) {
+    if (error instanceof McpServerError) {
+        return {
+            type: "text",
+            text: JSON.stringify({ error: error.code, message: error.message, details: error.details }, null, 2),
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            type: "text",
+            text: JSON.stringify({ error: "UNKNOWN_ERROR", message: error.message }, null, 2),
+        };
+    }
+    return {
+        type: "text",
+        text: JSON.stringify({ error: "UNKNOWN_ERROR", message: String(error) }, null, 2),
+    };
+}
+export function logError(context, error) {
+    const entry = {
+        level: "error",
+        context,
+        message: error instanceof Error ? error.message : String(error),
+        timestamp: new Date().toISOString(),
+    };
+    if (error instanceof Error && error.stack)
+        entry.stack = error.stack;
+    console.error(JSON.stringify(entry));
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,OAAO,cAAe,SAAQ,KAAK;IAG9B;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EACrE,IAAI,EACJ,CAAC,CACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAClD,IAAI,EACJ,CAAC,CACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAClD,IAAI,EACJ,CAAC,CACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAU;IAClD,MAAM,KAAK,GAA4B;QACrC,KAAK,EAAE,OAAO;QACd,OAAO;QACP,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACrE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/formatting.d.ts

@@ -0,0 +1,10 @@
+export interface FormattedResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+}
+export declare function formatAsText(data: any): FormattedResult;
+export declare function formatStructuredList<T>(items: T[], entityName: string, metadata?: Record<string, any>): FormattedResult;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,CAKvD;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,eAAe,CASjB"}

package/dist/utils/formatting.js

@@ -0,0 +1,16 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export function formatAsText(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: data,
+    };
+}
+export function formatStructuredList(items, entityName, metadata) {
+    const count = items.length;
+    const summary = `Found ${count} ${entityName}${count !== 1 ? "s" : ""}${metadata?.query ? ` matching "${metadata.query}"` : ""}.`;
+    return {
+        content: [{ type: "text", text: summary }],
+        structuredContent: { count, items, ...metadata },
+    };
+}
+//# sourceMappingURL=formatting.js.map

package/dist/utils/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAO7D,MAAM,UAAU,YAAY,CAAC,IAAS;IACpC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAChE,iBAAiB,EAAE,IAA+B;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAU,EACV,UAAkB,EAClB,QAA8B;IAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,OAAO,GAAG,SAAS,KAAK,IAAI,UAAU,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GACnE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,cAAc,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EACtD,GAAG,CAAC;IACJ,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAA6B;KAC5E,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withpica/mcp-server-directory",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "MCP Server for PICA Public Directory — enables AI assistants to search verified works and creators",
   "type": "module",
   "main": "dist/index.js",
@@ -8,14 +8,15 @@
     "pica-directory-mcp": "./dist/index.js"
   },
   "scripts": {
-    "prebuild": "tsx scripts/build-skills.ts",
+    "prebuild": "tsx scripts/build-changelog.ts && tsx scripts/build-skills.ts",
     "build": "tsc",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
     "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
-    "prepublishOnly": "npm run build"
+    "lint:changelog": "tsx ../scripts/lint-changelog.ts --package=.",
+    "prepublishOnly": "npm run build && npm run lint:changelog"
   },
   "author": "PICA Platform",
   "license": "MIT",

package/scripts/build-changelog.ts

@@ -0,0 +1,25 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+
+import { readFileSync, writeFileSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(__dirname, "..");
+const changelogPath = resolve(root, "CHANGELOG.md");
+const outPath = resolve(root, "src/lib/changelog.generated.ts");
+const pkg = JSON.parse(readFileSync(resolve(root, "package.json"), "utf8"));
+
+const md = readFileSync(changelogPath, "utf8");
+const escaped = JSON.stringify(md);
+
+writeFileSync(
+  outPath,
+  `// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.\n` +
+    `// Generated by scripts/build-changelog.ts — do not edit.\n\n` +
+    `export const CHANGELOG_MD = ${escaped};\n` +
+    `export const PACKAGE_NAME = ${JSON.stringify(pkg.name)};\n` +
+    `export const PACKAGE_VERSION = ${JSON.stringify(pkg.version)};\n`,
+);
+
+console.log(`Wrote ${outPath} (${md.length} chars).`);