@withpica/mcp-server 2.6.2 → 2.8.0

package/dist/utils/errors.js

@@ -0,0 +1,115 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * Error handling utilities for MCP server
+ */
+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 AuthenticationError extends McpServerError {
+    constructor(message = "Authentication failed", details) {
+        super(message, "AUTHENTICATION_ERROR", details);
+        this.name = "AuthenticationError";
+    }
+}
+export class ToolExecutionError extends McpServerError {
+    constructor(message, details) {
+        super(message, "TOOL_EXECUTION_ERROR", details);
+        this.name = "ToolExecutionError";
+    }
+}
+export class ResourceError extends McpServerError {
+    constructor(message, details) {
+        super(message, "RESOURCE_ERROR", details);
+        this.name = "ResourceError";
+    }
+}
+/**
+ * Format error for MCP response
+ */
+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),
+        };
+    }
+    // Classify ApiError from SDK layer
+    const status = error?.status;
+    if (status === 0 ||
+        (error instanceof Error && error.message?.includes("timed out"))) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: "REQUEST_TIMEOUT",
+                message: "API request timed out after retries. The server may be slow or unreachable.",
+            }, null, 2),
+        };
+    }
+    if (status === 401 || status === 403) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: "AUTHENTICATION_ERROR",
+                message: "API authentication failed. Check your PICA_API_KEY is valid.",
+                status,
+            }, null, 2),
+        };
+    }
+    if (status === 429) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: "RATE_LIMITED",
+                message: "API rate limit exceeded after retries. Try again in a moment.",
+                status,
+            }, 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),
+    };
+}
+/**
+ * Log error with structured context (JSON to stderr for machine parsing)
+ */
+export function logError(context, error) {
+    const entry = {
+        level: "error",
+        context,
+        message: error instanceof Error ? error.message : String(error),
+        timestamp: new Date().toISOString(),
+    };
+    if (error?.status)
+        entry.status = error.status;
+    if (error?.retryable !== undefined)
+        entry.retryable = error.retryable;
+    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":"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"}

package/dist/utils/formatting.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Response formatting utilities
+ *
+ * All formatters return FormattedResult — both human-readable text content
+ * AND a structuredContent object for machine parsing (ADR-104 §1.2).
+ */
+export interface FormattedResult {
+  content: Array<{
+    type: string;
+    text: string;
+  }>;
+  structuredContent?: Record<string, unknown>;
+}
+/**
+ * Format data as JSON text for MCP response
+ */
+export declare function formatAsText(data: any): FormattedResult;
+/**
+ * Completion hint — tells the LLM what's missing on entities just touched.
+ * The LLM decides whether and how to surface these to the user.
+ */
+export interface CompletionHint {
+  gap: string;
+  suggestion: string;
+  count?: number;
+  severity?: "critical" | "important" | "nice_to_have";
+}
+/**
+ * Format success message, with optional completion hints for the guided loop.
+ *
+ * Completion hints are structured data appended to the response so the LLM
+ * can naturally suggest the next step without PICA dictating the conversation.
+ * If no hints are provided, the response is identical to the old format.
+ */
+export declare function formatSuccess(
+  message: string,
+  data?: any,
+  completionHints?: CompletionHint[],
+): FormattedResult;
+/**
+ * Map raw gap objects from the completeness API into CompletionHints.
+ * The API response shape varies — this handles the known field names.
+ */
+export declare function mapGapsToHints(
+  gaps: any[],
+  limit?: number,
+): CompletionHint[];
+/**
+ * Format array of items with count
+ */
+export declare function formatList<T>(
+  items: T[],
+  metadata?: Record<string, any>,
+): FormattedResult;
+/**
+ * Truncate text to max length
+ */
+export declare function truncate(text: string, maxLength?: number): string;
+/**
+ * Format validation error
+ */
+export declare function formatValidationError(
+  fields: Record<string, string>,
+): FormattedResult;
+/**
+ * Format structured response with dual content blocks:
+ * - Human-readable text (includes full JSON so all MCP clients can read it)
+ * - Machine-parseable structuredContent object
+ */
+export declare function formatStructured(
+  data: any,
+  summary?: string,
+): FormattedResult;
+/**
+ * Format a list with both human summary and structured JSON
+ */
+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;;;;;GAKG;AAEH,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;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,CAKvD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;CACtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,GAAG,EACV,eAAe,CAAC,EAAE,cAAc,EAAE,GACjC,eAAe,CA0BjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,GAAG,EAAE,EACX,KAAK,GAAE,MAAU,GAChB,cAAc,EAAE,CAOlB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,eAAe,CAsBjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,eAAe,CAWjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAW7E;AAED;;GAEG;AACH,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,CAOjB"}

package/dist/utils/formatting.js

@@ -0,0 +1,125 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * Format data as JSON text for MCP response
+ */
+export function formatAsText(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: data,
+    };
+}
+/**
+ * Format success message, with optional completion hints for the guided loop.
+ *
+ * Completion hints are structured data appended to the response so the LLM
+ * can naturally suggest the next step without PICA dictating the conversation.
+ * If no hints are provided, the response is identical to the old format.
+ */
+export function formatSuccess(message, data, completionHints) {
+    const response = {
+        success: true,
+        message,
+    };
+    if (data !== undefined) {
+        response.data = data;
+    }
+    if (completionHints && completionHints.length > 0) {
+        response.completion_hints = completionHints;
+        // Append a human-readable summary so all LLMs can see the hints
+        const hintLines = completionHints
+            .map((h) => `- ${h.suggestion}${h.count ? ` (${h.count} works)` : ""}`)
+            .join("\n");
+        message += `\n\nNext steps you could take:\n${hintLines}`;
+        response.message = message; // Keep structuredContent in sync with text
+    }
+    const jsonText = JSON.stringify(response, null, 2);
+    return {
+        content: [{ type: "text", text: `${message}\n\n${jsonText}` }],
+        structuredContent: response,
+    };
+}
+/**
+ * Map raw gap objects from the completeness API into CompletionHints.
+ * The API response shape varies — this handles the known field names.
+ */
+export function mapGapsToHints(gaps, limit = 5) {
+    if (!Array.isArray(gaps))
+        return [];
+    return gaps.slice(0, limit).map((g) => ({
+        gap: g.key || g.field || g.type || "unknown",
+        suggestion: g.suggestion || g.label || g.description || "",
+        severity: g.severity || "important",
+    }));
+}
+/**
+ * Format array of items with count
+ */
+export function formatList(items, metadata) {
+    const response = {
+        count: items.length,
+        items,
+    };
+    if (metadata) {
+        response.metadata = metadata;
+    }
+    const summary = `Found ${items.length} item${items.length !== 1 ? "s" : ""}.`;
+    const jsonText = JSON.stringify(response, null, 2);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${summary}\n\n${jsonText}`,
+            },
+        ],
+        structuredContent: response,
+    };
+}
+/**
+ * Truncate text to max length
+ */
+export function truncate(text, maxLength = 1000) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.substring(0, maxLength) + "... (truncated)";
+}
+/**
+ * Format validation error
+ */
+export function formatValidationError(fields) {
+    const structured = {
+        error: "VALIDATION_ERROR",
+        message: "Validation failed",
+        fields,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(structured, null, 2) }],
+        structuredContent: structured,
+    };
+}
+/**
+ * Format structured response with dual content blocks:
+ * - Human-readable text (includes full JSON so all MCP clients can read it)
+ * - Machine-parseable structuredContent object
+ */
+export function formatStructured(data, summary) {
+    const jsonText = JSON.stringify(data, null, 2);
+    return {
+        content: [
+            {
+                type: "text",
+                text: summary ? `${summary}\n\n${jsonText}` : jsonText,
+            },
+        ],
+        structuredContent: data,
+    };
+}
+/**
+ * Format a list with both human summary and structured JSON
+ */
+export function formatStructuredList(items, entityName, metadata) {
+    const count = items.length;
+    const summary = `Found ${count} ${entityName}${count !== 1 ? "s" : ""}${metadata?.query ? ` matching "${metadata.query}"` : ""}.`;
+    return formatStructured({ count, items, ...metadata }, summary);
+}
+//# 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":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@withpica/mcp-server",
   "mcpName": "io.github.withpica/pica",
-  "version": "2.6.2",
+  "version": "2.8.0",
   "description": "MCP Server for PICA Platform - enables AI assistants to interact with PICA",
   "type": "module",
   "main": "dist/index.js",

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.withpica/pica",
-  "description": "withPICA — manage your music catalog through conversation. 168 tools for works, recordings, credits, agreements, royalties, enrichment, licensing. lobby mode: no api key, sign in via magic link in chat. © 2024-2026 Withpica Ltd. All rights reserved.",
+  "description": "manage your music catalog through conversation — works, recordings, credits, agreements, royalties",
   "repository": {
     "url": "https://github.com/withpica/pica",
     "source": "github"