@withpica/mcp-server 1.3.0

package/dist/tools/directory.js

@@ -0,0 +1,107 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess } from "@withpica/mcp-utils";
+export class DirectoryTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_directory_settings",
+                    description: "Get or update your account's directory visibility settings. " +
+                        "Controls whether your catalogue appears in the PICA public directory " +
+                        "and what information is shown (audio previews, splits, publishers, etc.).",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            action: {
+                                type: "string",
+                                enum: ["get", "update"],
+                                description: "Action to perform. 'get' returns current settings. 'update' changes settings.",
+                            },
+                            opted_in: {
+                                type: "boolean",
+                                description: "Make catalogue discoverable in the PICA directory. " +
+                                    "When true, sync supervisors and AI agents can find your recordings.",
+                            },
+                            show_audio_preview: {
+                                type: "boolean",
+                                description: "Allow audio previews in directory listings. " +
+                                    "When true, visitors can listen to your tracks.",
+                            },
+                            show_splits: {
+                                type: "boolean",
+                                description: "Show credit split percentages in directory.",
+                            },
+                            show_publishers: {
+                                type: "boolean",
+                                description: "Show publisher information in directory.",
+                            },
+                            show_agreements: {
+                                type: "boolean",
+                                description: "Show agreement details in directory.",
+                            },
+                            show_stems: {
+                                type: "boolean",
+                                description: "Show stems/instrumentals in directory.",
+                            },
+                            contact_enabled: {
+                                type: "boolean",
+                                description: "Allow licensing enquiries from the directory. " +
+                                    "When true, supervisors can send enquiries directly.",
+                            },
+                        },
+                        required: ["action"],
+                    },
+                },
+                executor: this.directorySettings.bind(this),
+            },
+        ];
+    }
+    async directorySettings(args) {
+        if (args.action === "get") {
+            const result = await this.pica.directory.getSettings();
+            const s = result.settings;
+            const status = s.opted_in ? "discoverable" : "private";
+            const summary = [
+                `Directory status: ${status}`,
+                `Eligible works: ${result.eligible_work_count}`,
+                s.show_audio_preview ? "Audio preview: on" : "Audio preview: off",
+                s.contact_enabled ? "Enquiries: on" : "Enquiries: off",
+                s.show_splits ? "Splits: visible" : "Splits: hidden",
+                s.show_publishers ? "Publishers: visible" : "Publishers: hidden",
+            ].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: result,
+            };
+        }
+        // Update
+        const updates = {};
+        const boolFields = [
+            "opted_in",
+            "show_audio_preview",
+            "show_splits",
+            "show_publishers",
+            "show_agreements",
+            "show_stems",
+            "contact_enabled",
+        ];
+        for (const field of boolFields) {
+            if (args[field] !== undefined)
+                updates[field] = Boolean(args[field]);
+        }
+        if (Object.keys(updates).length === 0) {
+            return formatAsText({
+                error: "No settings to update. Provide at least one setting field.",
+            });
+        }
+        const result = await this.pica.directory.updateSettings(updates);
+        const status = result.opted_in ? "discoverable" : "private";
+        return formatSuccess(`Directory settings updated. Your catalogue is now ${status}.`, result);
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/tools/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/tools/directory.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAQ7D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,yBAAyB;oBAC/B,WAAW,EACT,8DAA8D;wBAC9D,uEAAuE;wBACvE,2EAA2E;oBAC7E,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;gCACvB,WAAW,EACT,+EAA+E;6BAClF;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,SAAS;gCACf,WAAW,EACT,qDAAqD;oCACrD,qEAAqE;6BACxE;4BACD,kBAAkB,EAAE;gCAClB,IAAI,EAAE,SAAS;gCACf,WAAW,EACT,8CAA8C;oCAC9C,gDAAgD;6BACnD;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,6CAA6C;6BAC3D;4BACD,eAAe,EAAE;gCACf,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,0CAA0C;6BACxD;4BACD,eAAe,EAAE;gCACf,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,sCAAsC;6BACpD;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,wCAAwC;6BACtD;4BACD,eAAe,EAAE;gCACf,IAAI,EAAE,SAAS;gCACf,WAAW,EACT,gDAAgD;oCAChD,qDAAqD;6BACxD;yBACF;wBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;qBACrB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC5C;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,IAAyB;QACvD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;YAEvD,MAAM,OAAO,GAAG;gBACd,qBAAqB,MAAM,EAAE;gBAC7B,mBAAmB,MAAM,CAAC,mBAAmB,EAAE;gBAC/C,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,oBAAoB;gBACjE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB;gBACtD,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB;gBACpD,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,oBAAoB;aACjE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,iBAAiB,EAAE,MAA4C;aAChE,CAAC;QACJ,CAAC;QAED,SAAS;QACT,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG;YACjB,UAAU;YACV,oBAAoB;YACpB,aAAa;YACb,iBAAiB;YACjB,iBAAiB;YACjB,YAAY;YACZ,iBAAiB;SAClB,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS;gBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,YAAY,CAAC;gBAClB,KAAK,EAAE,4DAA4D;aACpE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;QAE5D,OAAO,aAAa,CAClB,qDAAqD,MAAM,GAAG,EAC9D,MAAM,CACP,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/discovery.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Layered Discovery Tools — ADR-149 Phase 5d
+ *
+ * When MCP_LAYERED_DISCOVERY=1, the catalog server handshake exposes only:
+ *   pica_sign_in, pica_sign_out, pica_discover, pica_tool_details, pica_execute
+ *
+ * Agents use pica_discover → pica_tool_details → pica_execute to progressively
+ * discover and invoke the full tool set without overwhelming the context window.
+ */
+import type { ToolDefinition, ToolExecutor, ToolExecutorContext } from "./index.js";
+interface CategoryDefinition {
+    description: string;
+    tools: string[];
+    depends_on: string[];
+}
+/**
+ * Hand-maintained category taxonomy for the catalog server.
+ * Grouped by natural entity/capability prefix.
+ * Cross-server depends_on declarations use "<server-slug>:<category>" format.
+ *
+ * Exported so `scripts/lint-mcp-tools.ts` can enforce taxonomy completeness
+ * (every registered tool ∈ taxonomy ∪ archetype-allowlist) at
+ * prepublishOnly time. Sealed after the bug class bit four times — silently
+ * for `pica_upload` + `pica_download` since ADR-152, for `pica_submit_feedback`
+ * since ADR-184, and again for `pica_report_issue` + `pica_my_reported_issues`
+ * (ADR-196 Phase 3) which were the exact failure mode they were designed to
+ * catch and so couldn't catch themselves. ~95 further pre-existing violators
+ * are grandfathered in `scripts/mcp-tool-lint-baseline.json` for retrofit.
+ */
+export declare const CATEGORIES: Record<string, CategoryDefinition>;
+export declare class DiscoveryTools {
+    private executeToolFn;
+    private getToolDef;
+    constructor(executeToolFn: (name: string, args: Record<string, any>, ctx?: ToolExecutorContext) => Promise<any>, getToolDef: (name: string) => {
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+        metadata?: any;
+    } | undefined);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private buildDiscoverTool;
+    private buildToolDetailsTool;
+    private buildToolDetail;
+    private buildExecuteTool;
+}
+export {};
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAMpB,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CA+hBzD,CAAC;AAoBF,qBAAa,cAAc;IAEvB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,UAAU;gBALV,aAAa,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,GAAG,CAAC,EAAE,mBAAmB,KACtB,OAAO,CAAC,GAAG,CAAC,EACT,UAAU,EAAE,CAClB,IAAI,EAAE,MAAM,KAEV;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,GACtE,SAAS;IAGf,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IAQzE,OAAO,CAAC,iBAAiB;IAsDzB,OAAO,CAAC,oBAAoB;IAwH5B,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,gBAAgB;CAqHzB"}