@withpica/mcp-server 1.3.0

package/dist/tools/projects.js

@@ -0,0 +1,316 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatStructuredList } from "@withpica/mcp-utils";
+export class ProjectsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_projects_list",
+                    description: "List projects — albums, EPs, compilations, or any collection of works.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            limit: {
+                                type: "number",
+                                description: "Max results to return (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listProjects.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_get",
+                    description: "Get project details including linked works.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Project ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getProject.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_create",
+                    description: "Create a new project to organise collaborative work — writing camps, recording sessions, production/mixing/mastering milestones, retreats. " +
+                        "To attach works to the project after creation, call POST /api/admin/projects/[id]/works — work_ids is not accepted here.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            name: {
+                                type: "string",
+                                description: "Project name (required).",
+                            },
+                            project_type: {
+                                type: "string",
+                                description: "Type of project. Conventional values: writing_camp, recording_session, production, mixing, mastering, retreat, other. Defaults to writing_camp.",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Optional project description.",
+                            },
+                            start_date: {
+                                type: "string",
+                                description: "Project start date (ISO YYYY-MM-DD). Used for scheduling and calendar display.",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "Project end date (ISO YYYY-MM-DD). Must be on or after start_date if both set.",
+                            },
+                            location_name: {
+                                type: "string",
+                                description: "Physical location name (e.g. 'Abbey Road Studio 2').",
+                            },
+                            location_address: {
+                                type: "string",
+                                description: "Street address of the location.",
+                            },
+                            location_url: {
+                                type: "string",
+                                description: "URL to a map or location page (e.g. Google Maps link).",
+                            },
+                            virtual_url: {
+                                type: "string",
+                                description: "Video-call / virtual-meeting URL for remote participation.",
+                            },
+                            is_open: {
+                                type: "boolean",
+                                description: "Whether the project is open for new participants to join via the invite code. Default: true.",
+                            },
+                            max_participants: {
+                                type: "number",
+                                description: "Maximum number of participants. Null / omitted = no cap.",
+                            },
+                            status: {
+                                type: "string",
+                                enum: [
+                                    "draft",
+                                    "scheduled",
+                                    "active",
+                                    "completed",
+                                    "cancelled",
+                                ],
+                                description: "Project status. Default: draft.",
+                            },
+                            generate_invite_code: {
+                                type: "boolean",
+                                description: "If true, the service generates a unique invite code on create so participants can join. Default: false.",
+                            },
+                            metadata: {
+                                type: "object",
+                                additionalProperties: true,
+                                description: "Optional freeform jsonb metadata (e.g. { notes, tags }).",
+                            },
+                        },
+                        required: ["name"],
+                    },
+                },
+                executor: this.createProject.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_update",
+                    description: "Update project details. Any field from the Create schema can be updated. " +
+                        "To attach or detach works from the project, call /api/admin/projects/[id]/works — work_ids is not accepted here.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Project ID (required)." },
+                            name: { type: "string", description: "Updated project name." },
+                            project_type: {
+                                type: "string",
+                                description: "Updated project type. Conventional values: writing_camp, recording_session, production, mixing, mastering, retreat, other.",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Updated description.",
+                            },
+                            start_date: {
+                                type: "string",
+                                description: "Updated start date (ISO YYYY-MM-DD).",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "Updated end date (ISO YYYY-MM-DD).",
+                            },
+                            location_name: {
+                                type: "string",
+                                description: "Updated location name.",
+                            },
+                            location_address: {
+                                type: "string",
+                                description: "Updated location address.",
+                            },
+                            location_url: {
+                                type: "string",
+                                description: "Updated location URL.",
+                            },
+                            virtual_url: {
+                                type: "string",
+                                description: "Updated virtual-meeting URL.",
+                            },
+                            is_open: {
+                                type: "boolean",
+                                description: "Whether the project is open for new participants.",
+                            },
+                            max_participants: {
+                                type: "number",
+                                description: "Updated participant cap.",
+                            },
+                            status: {
+                                type: "string",
+                                enum: [
+                                    "draft",
+                                    "scheduled",
+                                    "active",
+                                    "completed",
+                                    "cancelled",
+                                ],
+                                description: "Updated project status.",
+                            },
+                            metadata: {
+                                type: "object",
+                                additionalProperties: true,
+                                description: "Updated freeform jsonb metadata.",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.updateProject.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_delete",
+                    description: "Delete a project. Works linked to it are not deleted.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Project ID to delete" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deleteProject.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_attach_works",
+                    description: "Attach one or more works to a project via the `project_works` " +
+                        "junction. `pica_projects_create` / `_update` do not accept " +
+                        "`work_ids` — use this tool instead. Each item is attached with " +
+                        "an individual POST so partial failure is surfaced per-work in " +
+                        "the result — already-linked works are reported as `skipped` " +
+                        "(not a hard error), and other failures surface their " +
+                        "admin-route error message in `failed[]`.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            project_id: {
+                                type: "string",
+                                description: "Project UUID.",
+                            },
+                            works: {
+                                type: "array",
+                                description: "Works to attach. Each: { work_id (required), project_day (optional integer >= 1), notes (optional string) }.",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        work_id: {
+                                            type: "string",
+                                            description: "Work UUID to attach.",
+                                        },
+                                        project_day: {
+                                            type: "number",
+                                            description: "Optional day number within the project (1-indexed).",
+                                        },
+                                        notes: {
+                                            type: "string",
+                                            description: "Optional notes about this attachment.",
+                                        },
+                                    },
+                                    required: ["work_id"],
+                                },
+                                minItems: 1,
+                            },
+                        },
+                        required: ["project_id", "works"],
+                    },
+                },
+                executor: this.attachWorks.bind(this),
+            },
+        ];
+    }
+    async listProjects(args) {
+        const result = await this.pica.projects.list({
+            limit: args.limit,
+        });
+        const projects = Array.isArray(result) ? result : [];
+        return formatStructuredList(projects, "project");
+    }
+    async getProject(args) {
+        const project = await this.pica.projects.get(args.id);
+        return formatSuccess("Project retrieved", project);
+    }
+    async createProject(args) {
+        const { id, ...data } = args;
+        const project = await this.pica.projects.create(data);
+        return formatSuccess("Project created", project);
+    }
+    async updateProject(args) {
+        const { id, ...updates } = args;
+        const project = await this.pica.projects.update(id, updates);
+        return formatSuccess("Project updated", project);
+    }
+    async deleteProject(args) {
+        await this.pica.projects.delete(args.id);
+        return formatSuccess(`Project ${args.id} deleted`);
+    }
+    async attachWorks(args) {
+        const projectId = args.project_id;
+        const works = args.works ?? [];
+        const attached = [];
+        const skipped = [];
+        const failed = [];
+        for (const item of works) {
+            try {
+                const res = await this.pica.projects.attachWork(projectId, {
+                    work_id: item.work_id,
+                    project_day: item.project_day ?? null,
+                    notes: item.notes ?? null,
+                });
+                attached.push({
+                    work_id: item.work_id,
+                    project_work_id: res?.data?.id ?? res?.id ?? "",
+                });
+            }
+            catch (err) {
+                const message = err?.message ?? (typeof err === "string" ? err : "unknown error");
+                if (/already linked/i.test(message)) {
+                    skipped.push({ work_id: item.work_id, reason: "already_linked" });
+                }
+                else {
+                    failed.push({ work_id: item.work_id, error: message });
+                }
+            }
+        }
+        return formatSuccess(`Attached ${attached.length}/${works.length} work(s) to project ${projectId}` +
+            (skipped.length ? ` — ${skipped.length} skipped` : "") +
+            (failed.length ? ` — ${failed.length} failed` : ""), { project_id: projectId, attached, skipped, failed });
+    }
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/public-filter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Public discovery filter — ADR-202.
+ *
+ * Filters and sanitizes ToolDefinitions for the unauthenticated
+ * /api/mcp/discover endpoint. Default-exclude: a tool not classified
+ * here is dropped from the public surface.
+ */
+import type { ToolDefinition, ToolMetadata } from "./index.js";
+export interface PublicToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: ToolDefinition["inputSchema"];
+    annotations?: ToolDefinition["annotations"];
+}
+export interface FilterOptions {
+    /** Look up risk metadata for a given tool name. */
+    metadataLookup: (name: string) => ToolMetadata | undefined;
+    /** When true (Phase 1 default), drop any tool whose risk is not "safe". */
+    readOnlyOnly?: boolean;
+}
+/**
+ * Apply ADR-202 filtering to a list of ToolDefinitions.
+ *
+ * Order of operations:
+ *   1. Drop META_TOOL_EXCLUDE
+ *   2. Drop CLASS_C_EXCLUDE
+ *   3. Drop anything not in CLASS_A_ALLOWLIST and not in CLASS_B_SANITIZED
+ *      (default-exclude)
+ *   4. If readOnlyOnly: drop tools whose risk metadata is not "safe"
+ *   5. Replace description for CLASS_B_SANITIZED entries
+ *   6. Strip executor reference (return PublicToolDefinition only)
+ */
+export declare function filterToolsForPublicDiscovery(tools: ToolDefinition[], options: FilterOptions): PublicToolDefinition[];
+/** Returns the first forbidden keyword found in a string, or null. */
+export declare function findForbiddenKeyword(text: string): string | null;
+export declare const _internal: {
+    CLASS_A_ALLOWLIST: ReadonlySet<string>;
+    CLASS_B_SANITIZED: Readonly<Record<string, string>>;
+    CLASS_C_EXCLUDE: ReadonlySet<string>;
+    META_TOOL_EXCLUDE: ReadonlySet<string>;
+    FORBIDDEN_KEYWORD_FRAGMENTS: readonly string[];
+};
+//# sourceMappingURL=public-filter.d.ts.map

package/dist/tools/public-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-filter.d.ts","sourceRoot":"","sources":["../../src/tools/public-filter.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqU/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IAC3D,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,aAAa,GACrB,oBAAoB,EAAE,CA2BxB;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE;AAID,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC"}