@withpica/mcp-server 2.5.4 → 2.6.0

package/dist/utils/credit-gate.js

@@ -1,100 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-import { chargeMpp, formatMppPrice, isMppConfigured, MPP_DEFAULT_CURRENCY, } from "./mpp.js";
-export const COST_MAP = {
-    analysis_audio: 1,
-    analysis_lyrics: 1,
-    analysis_audio_identify: 3,
-    external_mlc_lookup: 1,
-    export_song_registration: 1,
-    export_industry_csv: 1,
-    export_catalog_asset_report: 5,
-};
-const GRACE_DEBT_LIMIT = -5;
-/** Operation names for MPP charge descriptions */
-const OPERATION_NAMES = {
-    analysis_audio: "Audio analysis",
-    analysis_lyrics: "Lyrics transcription",
-    analysis_audio_identify: "Audio identification",
-    external_mlc_lookup: "MLC enrichment",
-    export_song_registration: "Song registration export",
-    export_industry_csv: "Industry-ready export",
-    export_catalog_asset_report: "Catalog asset report",
-};
-export function withCreditGate(pica, actionKey, operationName, executor) {
-    const cost = COST_MAP[actionKey];
-    if (!cost)
-        return executor; // free or unknown — pass through
-    return async (args) => {
-        // --- Path 1: Check credit balance ---
-        let balanceInsufficient = false;
-        let available = 0;
-        try {
-            const balanceData = await pica.creditsBalance.getBalance();
-            available =
-                balanceData?.balance ??
-                    balanceData?.data?.balance ??
-                    0;
-            if (available - cost >= GRACE_DEBT_LIMIT) {
-                // Sufficient credits — execute normally (API layer deducts)
-                return executor(args);
-            }
-            balanceInsufficient = true;
-        }
-        catch {
-            // Fail open on credit check errors — let the tool execute
-            return executor(args);
-        }
-        // --- Balance insufficient from here ---
-        // --- Path 2 & 3: Try MPP if configured ---
-        if (balanceInsufficient && isMppConfigured()) {
-            try {
-                // Extract _meta from args if present (threaded from MCP request)
-                const extra = args._meta ? { _meta: args._meta } : {};
-                const currency = args._mpp_currency || MPP_DEFAULT_CURRENCY;
-                const mppResult = await chargeMpp(cost, OPERATION_NAMES[actionKey] || operationName, currency, extra);
-                if (mppResult) {
-                    if (mppResult.status === 402) {
-                        // Path 3: No credential — return payment challenge
-                        // The McpError will be thrown and handled by the MCP SDK
-                        throw mppResult.challenge;
-                    }
-                    // Path 2: Payment succeeded — execute and attach receipt
-                    const toolResult = await executor(args);
-                    return mppResult.withReceipt(toolResult);
-                }
-            }
-            catch (error) {
-                // Re-throw MCP payment errors (they're the 402 challenge)
-                if (error &&
-                    typeof error === "object" &&
-                    "code" in error &&
-                    error.code === -32042) {
-                    throw error;
-                }
-                // MPP failed for other reason — fall through to insufficient_credits
-            }
-        }
-        // --- Path 4: No MPP or MPP failed — return insufficient_credits ---
-        const priceHint = isMppConfigured()
-            ? ` (${formatMppPrice(cost)} via inline payment)`
-            : "";
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({
-                        error: "insufficient_credits",
-                        message: `${operationName} costs ${cost} pica credit${cost !== 1 ? "s" : ""}, but you only have ${available}. Purchase more credits to continue.${priceHint}`,
-                        balance: available,
-                        cost,
-                        action: actionKey,
-                        purchase_hint: "Use pica_credits_purchase to get a checkout link, or visit /settings (credits tab).",
-                        fallback_url: "https://withpica.com/settings?tab=credits",
-                    }, null, 2),
-                },
-            ],
-            isError: true,
-        };
-    };
-}
-//# sourceMappingURL=credit-gate.js.map

package/dist/utils/credit-gate.js.map

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

package/dist/utils/enrichment-format.d.ts

@@ -1,31 +0,0 @@
-/**
- * Shared enrichment result formatting utilities
- *
- * Detects whether an enrichment call actually found data and formats
- * the response accordingly — matched / partial / no_match.
- * Prevents tools from returning unconditional success messages when
- * the API returned nothing. (ADR-149 Phase 2)
- */
-import { ToolResult } from "../tools/index.js";
-export type ResultQuality = "matched" | "partial" | "no_match";
-/**
- * Inspect the raw enrichment result and determine data quality.
- *
- * Resolution order:
- * 1. If the API already set `result_quality`, trust it.
- * 2. If `fieldsUpdated` is present, use count to decide.
- * 3. If `writers`/`publishers` arrays are present (MLC shape), check emptiness.
- * 4. If a non-empty `data` object is present, treat as matched.
- * 5. Default to `partial` — better than falsely claiming "no match".
- */
-export declare function detectResultQuality(result: unknown): ResultQuality;
-/**
- * Build a ToolResult for an enrichment call with quality signalling.
- *
- * @param entityType  "work" | "person"
- * @param entityId    The ID that was enriched
- * @param source      Display name of the source ("MLC", "MusicBrainz", "general", …)
- * @param result      Raw API response
- */
-export declare function formatEnrichmentResult(entityType: string, entityId: string, source: string, result: unknown): ToolResult;
-//# sourceMappingURL=enrichment-format.d.ts.map

package/dist/utils/enrichment-format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"enrichment-format.d.ts","sourceRoot":"","sources":["../../src/utils/enrichment-format.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CA+BlE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACd,UAAU,CA0BZ"}

package/dist/utils/enrichment-format.js

@@ -1,69 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-/**
- * Inspect the raw enrichment result and determine data quality.
- *
- * Resolution order:
- * 1. If the API already set `result_quality`, trust it.
- * 2. If `fieldsUpdated` is present, use count to decide.
- * 3. If `writers`/`publishers` arrays are present (MLC shape), check emptiness.
- * 4. If a non-empty `data` object is present, treat as matched.
- * 5. Default to `partial` — better than falsely claiming "no match".
- */
-export function detectResultQuality(result) {
-    if (!result || typeof result !== "object")
-        return "no_match";
-    const r = result;
-    if (r.result_quality === "matched" || r.result_quality === "partial" || r.result_quality === "no_match") {
-        return r.result_quality;
-    }
-    if (typeof r.fieldsUpdated === "number") {
-        return r.fieldsUpdated > 0 ? "matched" : "no_match";
-    }
-    const hasWriters = Array.isArray(r.writers);
-    const hasPublishers = Array.isArray(r.publishers);
-    if (hasWriters || hasPublishers) {
-        const writersEmpty = hasWriters && r.writers.length === 0;
-        const publishersEmpty = hasPublishers && r.publishers.length === 0;
-        if ((hasWriters ? writersEmpty : true) &&
-            (hasPublishers ? publishersEmpty : true)) {
-            return "no_match";
-        }
-        return "matched";
-    }
-    if (r.data && typeof r.data === "object" && Object.keys(r.data).length > 0) {
-        return "matched";
-    }
-    return "partial";
-}
-/**
- * Build a ToolResult for an enrichment call with quality signalling.
- *
- * @param entityType  "work" | "person"
- * @param entityId    The ID that was enriched
- * @param source      Display name of the source ("MLC", "MusicBrainz", "general", …)
- * @param result      Raw API response
- */
-export function formatEnrichmentResult(entityType, entityId, source, result) {
-    const quality = detectResultQuality(result);
-    const messages = {
-        matched: `${source} enrichment complete for ${entityType} ${entityId} — data found and applied`,
-        partial: `${source} enrichment complete for ${entityType} ${entityId} — some data found`,
-        no_match: `no ${source} match found for ${entityType} ${entityId}`,
-    };
-    const response = {
-        success: true,
-        message: messages[quality],
-        result_quality: quality,
-        data: result,
-    };
-    if (quality === "no_match") {
-        response.suggestion =
-            "try a different enrichment source for additional metadata";
-    }
-    const jsonText = JSON.stringify(response, null, 2);
-    return {
-        content: [{ type: "text", text: `${response.message}\n\n${jsonText}` }],
-        structuredContent: response,
-    };
-}
-//# sourceMappingURL=enrichment-format.js.map

package/dist/utils/enrichment-format.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"enrichment-format.js","sourceRoot":"","sources":["../../src/utils/enrichment-format.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAe7D;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC;IAC7D,MAAM,CAAC,GAAG,MAAiC,CAAC;IAE5C,IAAI,CAAC,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACxG,OAAO,CAAC,CAAC,cAA+B,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IACtD,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,UAAU,IAAK,CAAC,CAAC,OAAqB,CAAC,MAAM,KAAK,CAAC,CAAC;QACzE,MAAM,eAAe,GAAG,aAAa,IAAK,CAAC,CAAC,UAAwB,CAAC,MAAM,KAAK,CAAC,CAAC;QAClF,IACE,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;YAClC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,EACxC,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,QAAgB,EAChB,MAAc,EACd,MAAe;IAEf,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAkC;QAC9C,OAAO,EAAE,GAAG,MAAM,4BAA4B,UAAU,IAAI,QAAQ,2BAA2B;QAC/F,OAAO,EAAE,GAAG,MAAM,4BAA4B,UAAU,IAAI,QAAQ,oBAAoB;QACxF,QAAQ,EAAE,MAAM,MAAM,oBAAoB,UAAU,IAAI,QAAQ,EAAE;KACnE,CAAC;IAEF,MAAM,QAAQ,GAA4B;QACxC,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;QAC1B,cAAc,EAAE,OAAO;QACvB,IAAI,EAAE,MAAM;KACb,CAAC;IAEF,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,QAAQ,CAAC,UAAU;YACjB,2DAA2D,CAAC;IAChE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,OAAO,OAAO,QAAQ,EAAE,EAAE,CAAC;QACvE,iBAAiB,EAAE,QAAQ;KAC5B,CAAC;AACJ,CAAC"}

package/dist/utils/errors.d.ts

@@ -1,29 +0,0 @@
-/**
- * Error handling utilities for MCP server
- */
-export declare class McpServerError extends Error {
-    code: string;
-    details?: any | undefined;
-    constructor(message: string, code: string, details?: any | undefined);
-}
-export declare class AuthenticationError extends McpServerError {
-    constructor(message?: string, details?: any);
-}
-export declare class ToolExecutionError extends McpServerError {
-    constructor(message: string, details?: any);
-}
-export declare class ResourceError extends McpServerError {
-    constructor(message: string, details?: any);
-}
-/**
- * Format error for MCP response
- */
-export declare function formatError(error: any): {
-    type: string;
-    text: string;
-};
-/**
- * Log error with structured context (JSON to stderr for machine parsing)
- */
-export declare function logError(context: string, error: any): void;
-//# sourceMappingURL=errors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,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,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,GAAE,MAAgC,EAAE,OAAO,CAAC,EAAE,GAAG;CAIrE;AAED,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwHtE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAc1D"}

package/dist/utils/errors.js

@@ -1,139 +0,0 @@
-// 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) {
-    const status = error?.status;
-    const rawMessage = error instanceof Error ? error.message : error?.message || String(error);
-    // Attempt to parse structured error body from API responses
-    let structuredBody = null;
-    try {
-        if (typeof rawMessage === "string" && rawMessage.startsWith("{")) {
-            structuredBody = JSON.parse(rawMessage);
-        }
-    }
-    catch {
-        // Not JSON — use raw message
-    }
-    if (error instanceof McpServerError) {
-        return {
-            type: "text",
-            text: JSON.stringify({
-                error: error.code,
-                message: error.message,
-                details: error.details,
-                retry_safe: false,
-            }, null, 2),
-        };
-    }
-    // Classify ApiError from SDK layer
-    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.",
-                retry_safe: true,
-                suggestion: "wait a moment and try again",
-            }, 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,
-                retry_safe: false,
-                suggestion: "your API key may be invalid or expired — check your PICA settings",
-            }, 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,
-                retry_safe: true,
-                suggestion: "wait a moment and try again",
-            }, null, 2),
-        };
-    }
-    // Structured error body from API — propagate domain-specific codes
-    if (structuredBody?.error_code) {
-        return {
-            type: "text",
-            text: JSON.stringify({
-                error: structuredBody.error_code,
-                message: structuredBody.message || rawMessage,
-                details: structuredBody.details,
-                retry_safe: false,
-            }, null, 2),
-        };
-    }
-    // Generic fallback
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-        type: "text",
-        text: JSON.stringify({
-            error: "UNKNOWN_ERROR",
-            message,
-            retry_safe: false,
-        }, 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

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

package/dist/utils/formatting.d.ts

@@ -1,64 +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;
-export declare function guardResponseSize(text: string, toolName: string): string;
-//# 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,CAQvD;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;AAWD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkBxE"}

package/dist/utils/formatting.js

@@ -1,153 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-/**
- * Format data as JSON text for MCP response
- */
-export function formatAsText(data) {
-    // Round-trip through JSON to ensure structuredContent is a plain object
-    // (raw API responses may contain class instances or Date objects that fail MCP validation)
-    const serialized = JSON.stringify(data, null, 2);
-    return {
-        content: [{ type: "text", text: serialized }],
-        structuredContent: JSON.parse(serialized),
-    };
-}
-/**
- * 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);
-}
-/**
- * Guard against oversized tool responses that would blow the agent's context window.
- * Block playbook: "Check byte size before returning text."
- * Lowin: "Respect the token budget."
- *
- * Threshold: 100KB (~25K tokens). Truncates with recovery instructions.
- */
-const MAX_RESPONSE_BYTES = 100_000;
-export function guardResponseSize(text, toolName) {
-    const byteSize = Buffer.byteLength(text, "utf8");
-    if (byteSize <= MAX_RESPONSE_BYTES) {
-        return text;
-    }
-    // Truncate by chars (conservative — multi-byte chars mean fewer chars than bytes)
-    const truncated = text.substring(0, MAX_RESPONSE_BYTES);
-    const recovery = [
-        "\n\n---",
-        `TRUNCATED: Response from ${toolName} exceeded 100KB (was ${Math.round(byteSize / 1024)}KB).`,
-        "To get complete results, narrow your query:",
-        "- Use a smaller 'limit' parameter (e.g. limit=10)",
-        "- Add search/filter parameters to reduce results",
-        '- Use a more specific tool (e.g. pica_works_inspect with sections: ["basic"] instead of pica_works_query)',
-    ].join("\n");
-    return truncated + recovery;
-}
-//# 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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"}