@withpica/mcp-server 2.5.2 → 2.6.0

package/dist/utils/formatting.d.ts

@@ -1,63 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,125 +0,0 @@
-// 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

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

package/dist/utils/mpp.d.ts

@@ -1,63 +0,0 @@
-import type { CallToolResult, McpError } from "@modelcontextprotocol/sdk/types.js";
-export declare const MPP_PER_CREDIT_PRICES: Record<string, number>;
-/** Default currency for MPP charges */
-export declare const MPP_DEFAULT_CURRENCY = "usd";
-/** All supported MPP currencies */
-export declare const MPP_SUPPORTED_CURRENCIES: string[];
-/**
- * Get per-credit amount in minor units for a currency.
- * Falls back to USD if currency not supported.
- */
-export declare function getMppPerCreditAmount(currency: string): number;
-/**
- * Calculate total charge amount for a number of credits.
- */
-export declare function getMppChargeAmount(creditCost: number, currency: string): {
-    amount: string;
-    currency: string;
-};
-/**
- * Check if MPP is configured (env vars present).
- */
-export declare function isMppConfigured(): boolean;
-/**
- * Get or create the MPP instance. Returns null if not configured.
- */
-export declare function getMppInstance(): any | null;
-/**
- * Reset the MPP instance (for testing).
- */
-export declare function resetMppInstance(): void;
-/**
- * Extra metadata from the MCP CallToolRequest.
- * Contains MPP credentials when an agent retries after a 402.
- */
-export type McpExtra = {
-    _meta?: Record<string, unknown>;
-    [key: string]: unknown;
-};
-/**
- * Result of an MPP charge attempt.
- */
-export type MppChargeResult = {
-    status: 402;
-    challenge: McpError;
-} | {
-    status: 200;
-    withReceipt: (result: CallToolResult) => CallToolResult;
-};
-/**
- * Attempt to charge via MPP for a credit-gated operation.
- *
- * @param creditCost  Number of credits the operation costs
- * @param operationName  Human-readable operation name for the charge description
- * @param currency  Currency to charge in (default: usd)
- * @param extra  The MCP request extra/meta (contains credential on retry)
- * @returns Charge result, or null if MPP is not configured
- */
-export declare function chargeMpp(creditCost: number, operationName: string, currency?: string, extra?: McpExtra): Promise<MppChargeResult | null>;
-/**
- * Format a human-readable price for a number of credits in a currency.
- */
-export declare function formatMppPrice(creditCost: number, currency?: string): string;
-//# sourceMappingURL=mpp.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mpp.d.ts","sourceRoot":"","sources":["../../src/utils/mpp.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACT,MAAM,oCAAoC,CAAC;AAO5C,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWxD,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,mCAAmC;AACnC,eAAO,MAAM,wBAAwB,UAAqC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOtC;AAaD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,GAAG,GAAG,IAAI,CAsB3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAMD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,QAAQ,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,cAAc,CAAA;CAAE,CAAC;AAE7E;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,MAA6B,EACvC,KAAK,GAAE,QAAa,GACnB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiBjC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAA6B,GACtC,MAAM,CAKR"}

package/dist/utils/mpp.js

@@ -1,137 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-/**
- * MPP (Machine Payments Protocol) inline payment helper.
- *
- * Wraps mppx to provide per-credit charging for credit-gated MCP operations.
- * Same pricing as credit packs (pica_25 best-value rate per credit).
- *
- * Environment variables:
- *   MPP_SECRET_KEY          — HMAC key for challenge binding (required for MPP)
- *   MPP_STRIPE_NETWORK_ID   — Stripe Business Network Profile ID (required for MPP)
- *   MPP_TESTNET             — set "true" for staging/dev
- *   STRIPE_SECRET_KEY       — already exists, used by mppx for payment settlement
- *
- * If MPP_SECRET_KEY or MPP_STRIPE_NETWORK_ID are not set, MPP is disabled
- * and the gate falls through to the existing insufficient_credits error.
- */
-import { Mppx, stripe } from "mppx/server";
-import { Transport as McpTransport } from "mppx/mcp-sdk/server";
-// ---------------------------------------------------------------------------
-// Per-credit pricing in minor units (pica_25 pack / 25 credits)
-// Verified against live Stripe prices 2026-03-31
-// ---------------------------------------------------------------------------
-export const MPP_PER_CREDIT_PRICES = {
-    gbp: 40, // £0.40
-    usd: 48, // $0.48
-    eur: 44, // €0.44
-    cad: 64, // CA$0.64
-    aud: 72, // A$0.72
-    zar: 396, // R4
-    ngn: 20000, // ₦200
-    kes: 3196, // KSh32
-    brl: 160, // R$1.60
-    mxn: 636, // MX$6
-};
-/** Default currency for MPP charges */
-export const MPP_DEFAULT_CURRENCY = "usd";
-/** All supported MPP currencies */
-export const MPP_SUPPORTED_CURRENCIES = Object.keys(MPP_PER_CREDIT_PRICES);
-/**
- * Get per-credit amount in minor units for a currency.
- * Falls back to USD if currency not supported.
- */
-export function getMppPerCreditAmount(currency) {
-    const key = currency.toLowerCase();
-    return (MPP_PER_CREDIT_PRICES[key] ?? MPP_PER_CREDIT_PRICES[MPP_DEFAULT_CURRENCY]);
-}
-/**
- * Calculate total charge amount for a number of credits.
- */
-export function getMppChargeAmount(creditCost, currency) {
-    const perCredit = getMppPerCreditAmount(currency);
-    const total = perCredit * creditCost;
-    return {
-        amount: String(total),
-        currency: currency.toLowerCase(),
-    };
-}
-// ---------------------------------------------------------------------------
-// MPP instance (lazy singleton)
-// ---------------------------------------------------------------------------
-// Use `any` for the instance type — mppx generics are deeply nested and
-// cause "two different types with this name exist" errors with explicit annotations.
-// The runtime behavior is fully type-safe via mppx's internal validation.
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-let mppInstance = null;
-let mppChecked = false;
-/**
- * Check if MPP is configured (env vars present).
- */
-export function isMppConfigured() {
-    return !!(process.env.MPP_SECRET_KEY &&
-        process.env.MPP_STRIPE_NETWORK_ID &&
-        process.env.STRIPE_SECRET_KEY);
-}
-/**
- * Get or create the MPP instance. Returns null if not configured.
- */
-export function getMppInstance() {
-    if (mppChecked)
-        return mppInstance;
-    mppChecked = true;
-    if (!isMppConfigured()) {
-        return null;
-    }
-    mppInstance = Mppx.create({
-        methods: [
-            stripe.charge({
-                secretKey: process.env.STRIPE_SECRET_KEY,
-                networkId: process.env.MPP_STRIPE_NETWORK_ID,
-                paymentMethodTypes: ["card", "link"],
-            }),
-        ],
-        secretKey: process.env.MPP_SECRET_KEY,
-        realm: "withpica.com",
-        transport: McpTransport.mcpSdk(),
-    });
-    return mppInstance;
-}
-/**
- * Reset the MPP instance (for testing).
- */
-export function resetMppInstance() {
-    mppInstance = null;
-    mppChecked = false;
-}
-/**
- * Attempt to charge via MPP for a credit-gated operation.
- *
- * @param creditCost  Number of credits the operation costs
- * @param operationName  Human-readable operation name for the charge description
- * @param currency  Currency to charge in (default: usd)
- * @param extra  The MCP request extra/meta (contains credential on retry)
- * @returns Charge result, or null if MPP is not configured
- */
-export async function chargeMpp(creditCost, operationName, currency = MPP_DEFAULT_CURRENCY, extra = {}) {
-    const mpp = getMppInstance();
-    if (!mpp)
-        return null;
-    const { amount, currency: chargeCurrency } = getMppChargeAmount(creditCost, currency);
-    const handler = mpp.charge({
-        amount,
-        currency: chargeCurrency,
-        description: `${operationName} (${creditCost} pica credit${creditCost !== 1 ? "s" : ""})`,
-    });
-    const result = await handler(extra);
-    return result;
-}
-/**
- * Format a human-readable price for a number of credits in a currency.
- */
-export function formatMppPrice(creditCost, currency = MPP_DEFAULT_CURRENCY) {
-    const perCredit = getMppPerCreditAmount(currency);
-    const total = (perCredit * creditCost) / 100;
-    const cur = currency.toUpperCase();
-    return `${total.toFixed(2)} ${cur}`;
-}
-//# sourceMappingURL=mpp.js.map

package/dist/utils/mpp.js.map

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

package/dist/utils/notify-parties.d.ts

@@ -1,35 +0,0 @@
-/**
- * Reusable party notification utility.
- *
- * Sends notifications to people involved in a write operation.
- * Delivers via in-app + Telegram + email (all fire-and-forget).
- * Used by agreement, credit, split, and collaborator tools.
- */
-import { PicaClient } from "../pica-sdk.js";
-export interface PartyNotification {
-    person_id: string;
-    message: string;
-    work_id?: string;
-    notification_type?: string;
-}
-export interface NotifyResult {
-    person_id: string;
-    name: string;
-    delivered: boolean;
-    channels?: {
-        in_app?: boolean;
-        telegram?: boolean;
-        email?: boolean;
-    };
-    reason?: string;
-}
-/**
- * Notify one or more parties about a catalog action.
- * Returns results per person. Never throws — failures are per-party.
- */
-export declare function notifyParties(pica: PicaClient, parties: PartyNotification[]): Promise<NotifyResult[]>;
-/**
- * Format notification results into a human-readable summary line.
- */
-export declare function summarizeNotifications(results: NotifyResult[]): string;
-//# sourceMappingURL=notify-parties.d.ts.map

package/dist/utils/notify-parties.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"notify-parties.d.ts","sourceRoot":"","sources":["../../src/utils/notify-parties.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,EAAE,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC,CAiCzB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAuBtE"}

package/dist/utils/notify-parties.js

@@ -1,59 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-/**
- * Notify one or more parties about a catalog action.
- * Returns results per person. Never throws — failures are per-party.
- */
-export async function notifyParties(pica, parties) {
-    const results = [];
-    for (const party of parties) {
-        if (!party.person_id)
-            continue;
-        try {
-            const result = await pica.notifications.sendToPerson({
-                person_id: party.person_id,
-                message: party.message,
-                work_id: party.work_id,
-                notification_type: party.notification_type || "collaboration_update",
-            });
-            const data = result.data || result;
-            results.push({
-                person_id: party.person_id,
-                name: data.person_name || "Unknown",
-                delivered: data.delivered,
-                channels: data.channels,
-                reason: data.reason,
-            });
-        }
-        catch {
-            results.push({
-                person_id: party.person_id,
-                name: "Unknown",
-                delivered: false,
-                reason: "notification_failed",
-            });
-        }
-    }
-    return results;
-}
-/**
- * Format notification results into a human-readable summary line.
- */
-export function summarizeNotifications(results) {
-    if (results.length === 0)
-        return "";
-    const delivered = results.filter((r) => r.delivered);
-    const notPica = results.filter((r) => r.reason === "not_a_pica_user");
-    const failed = results.filter((r) => !r.delivered && r.reason !== "not_a_pica_user");
-    const parts = [];
-    if (delivered.length > 0) {
-        parts.push(`Notified: ${delivered.map((r) => r.name).join(", ")}`);
-    }
-    if (notPica.length > 0) {
-        parts.push(`Not PICA users (use pica_collaborators_invite): ${notPica.map((r) => r.name).join(", ")}`);
-    }
-    if (failed.length > 0) {
-        parts.push(`Notification failed: ${failed.map((r) => r.name).join(", ")}`);
-    }
-    return parts.join(". ");
-}
-//# sourceMappingURL=notify-parties.js.map

package/dist/utils/notify-parties.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"notify-parties.js","sourceRoot":"","sources":["../../src/utils/notify-parties.ts"],"names":[],"mappings":"AAAA,6DAA6D;AA2B7D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAgB,EAChB,OAA4B;IAE5B,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,SAAS;QAE/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC;gBACnD,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,sBAAsB;aACrE,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;gBACnC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,qBAAqB;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,iBAAiB,CACtD,CAAC;IAEF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,mDAAmD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/server.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.withpica/pica",
-  "description": "193 tools for music catalog management — works, recordings, credits, royalties",
-  "repository": {
-    "url": "https://github.com/withpica/pica",
-    "source": "github",
-    "subfolder": "mcp-server"
-  },
-  "version": "2.4.1",
-  "packages": [
-    {
-      "registryType": "npm",
-      "identifier": "@withpica/mcp-server",
-      "version": "2.4.1",
-      "transport": {
-        "type": "stdio"
-      },
-      "environmentVariables": [
-        {
-          "description": "Your PICA API key — get one at https://connect.withpica.com",
-          "isRequired": true,
-          "format": "string",
-          "isSecret": true,
-          "name": "PICA_API_KEY"
-        }
-      ]
-    }
-  ]
-}