@withpica/mcp-server 1.3.0

package/dist/tools/credits.js

@@ -0,0 +1,541 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatStructuredList, withBillingGate, mapGapsToHints, } from "@withpica/mcp-utils";
+import { notifyParties, summarizeNotifications, } from "@withpica/mcp-utils";
+// ADR-213: 16-role enum for recording_credits. Mirror of
+// RECORDING_CREDIT_ROLES in lib/services/recording-credits.ts. Writer /
+// Composer / Lyricist / Arranger live on work_credits — those route via
+// pica_credits_update, not this tool.
+const RECORDING_CREDIT_ROLES = [
+    "MainArtist",
+    "FeaturedArtist",
+    "Remixer",
+    "Producer",
+    "Co-Producer",
+    "Executive Producer",
+    "Mixer",
+    "Engineer",
+    "Recording Engineer",
+    "Mastering Engineer",
+    "Performer",
+    "Vocalist",
+    "Instrumentalist",
+    "Arranger",
+    "Programmer",
+    "Other",
+];
+export class CreditsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        // NOTE: `pica_credits_balance` / `pica_credits_history` / `pica_credits_purchase`
+        // were removed from the MCP surface 2026-04-22 (see docs/MCP_REFINEMENT_LOG.md
+        // entry B-001). withPICA is subscription-only at £9.99/mo; surfacing a credit
+        // balance tool misled agents into gating actions behind a balance check.
+        // The underlying lib/services/credits/** infra remains intact for any internal
+        // telemetry or future pay-per-call work (MPP), it just isn't advertised.
+        //
+        // `pica_credits_list` and `pica_credits_update` below are work_credits
+        // (songwriter / producer credits on a work), not billing credits. Keep.
+        return [
+            {
+                definition: {
+                    name: "pica_credits_list",
+                    description: "Get all credits (collaborators, roles, and splits) for a specific work. Returns who wrote, composed, arranged, or produced the work and their percentage splits. " +
+                        "→ then: pica_credits_update (fix credits), pica_people_inspect (inspect a credited person)",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to get credits for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                    nextSteps: [
+                        {
+                            tool: "pica_credits_update",
+                            reason: "Fix or fill credit gaps when the listing surfaces missing roles or splits.",
+                            when: "on_success",
+                        },
+                        {
+                            tool: "pica_works_inspect",
+                            reason: "Re-inspect the work to see how the credits affect completeness scoring.",
+                            when: "on_success",
+                        },
+                    ],
+                },
+                executor: this.listCredits.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_credits_update",
+                    description: "Set credits on a work. Replaces all existing credits. Splits must total 100%. " +
+                        "15 roles: writer, composer, arranger, lyricist, producer, performer, engineer, mixer, mastering, owner, vocalist, instrumentalist, conductor, programmer, remixer. " +
+                        "For publishing credits, pass publisher_id (resolve a publisher name/IPI to an id via pica_publishers_query, or create one via pica_publishers_create). " +
+                        "Supports territory/rights metadata plus is_primary / notes / attestation_status. " +
+                        "IMPORTANT: After updating, call pica_credits_list to verify the credits actually persisted — silent failures are possible if roles are invalid. " +
+                        "After several mutations, surface a pica_dashboard_briefing to the user. " +
+                        "→ then: pica_credits_list (verify saved), pica_works_inspect (check progress)",
+                    workflows: ["work-required", "work-credits-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to set credits on",
+                            },
+                            credits: {
+                                type: "array",
+                                description: "Array of credit entries. Splits must total 100%.",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        person_id: {
+                                            type: "string",
+                                            description: "Person ID of the credited collaborator",
+                                        },
+                                        role: {
+                                            type: "string",
+                                            description: "Role (stored as credit_type on work_credits). One of: writer, composer, arranger, lyricist, producer, performer, engineer, mixer, mastering, owner, vocalist, instrumentalist, conductor, programmer, remixer.",
+                                            enum: [
+                                                "writer",
+                                                "composer",
+                                                "arranger",
+                                                "lyricist",
+                                                "producer",
+                                                "performer",
+                                                "engineer",
+                                                "mixer",
+                                                "mastering",
+                                                "owner",
+                                                "vocalist",
+                                                "instrumentalist",
+                                                "conductor",
+                                                "programmer",
+                                                "remixer",
+                                            ],
+                                        },
+                                        splits: {
+                                            type: "number",
+                                            description: "Percentage split (0-100), stored as writer_split_percentage on work_credits. All splits across the credits array must total 100%.",
+                                        },
+                                        publisher_id: {
+                                            type: "string",
+                                            description: "Publisher UUID on global_publishers. Resolve a publisher name or IPI to an id via pica_publishers_query, or create one via pica_publishers_create. Required when publisher_split_percentage is set.",
+                                        },
+                                        publisher_split_percentage: {
+                                            type: "number",
+                                            description: "Publisher's share percentage (0-100). Separate from writer split.",
+                                        },
+                                        territory: {
+                                            type: "array",
+                                            items: { type: "string" },
+                                            description: 'Territories where this credit applies (e.g., ["worldwide"], ["UK", "US"]). Default: ["worldwide"].',
+                                        },
+                                        rights_type: {
+                                            type: "string",
+                                            enum: [
+                                                "all",
+                                                "performing",
+                                                "mechanical",
+                                                "synchronization",
+                                            ],
+                                            description: "Type of rights covered. Default: all.",
+                                        },
+                                        start_date: {
+                                            type: "string",
+                                            description: "When rights start (ISO date). Null = from inception.",
+                                        },
+                                        end_date: {
+                                            type: "string",
+                                            description: "When rights end (ISO date). Null = perpetual.",
+                                        },
+                                        is_primary: {
+                                            type: "boolean",
+                                            description: "Mark this credit as the primary attribution for the person on this work.",
+                                        },
+                                        notes: {
+                                            type: "string",
+                                            description: "Free-text notes about this credit (e.g., recording-session context, contribution specifics).",
+                                        },
+                                        attestation_status: {
+                                            type: "string",
+                                            enum: ["pending", "attested", "disputed", "declined"],
+                                            description: "Attestation status. Default: pending. Service-managed fields attested_at / attested_by are set by the attestation workflow, not this tool.",
+                                        },
+                                    },
+                                    required: ["person_id", "role", "splits"],
+                                },
+                            },
+                        },
+                        required: ["work_id", "credits"],
+                    },
+                    nextSteps: [
+                        {
+                            tool: "pica_credits_list",
+                            reason: "Read the credits back to confirm every advertised field (is_primary, notes, attestation_status, publisher_id) actually persisted. Silent persistence drops are real — never trust the write response alone.",
+                            when: "on_success",
+                        },
+                        {
+                            tool: "pica_works_inspect",
+                            reason: "Check the work's completeness score now that credits are in place.",
+                            when: "on_success",
+                        },
+                    ],
+                },
+                executor: withBillingGate(this.pica, "credit update", this.updateCredits.bind(this)),
+            },
+            // ADR-213 Primitive B — pica_recording_credits_update
+            {
+                definition: {
+                    name: "pica_recording_credits_update",
+                    description: "Add a first-party performance / production credit to a recording. Writes to the recording_credits table (distinct from work_credits which is for songwriting credits). " +
+                        "16 roles: MainArtist, FeaturedArtist, Remixer, Producer, Co-Producer, Executive Producer, Mixer, Engineer, Recording Engineer, Mastering Engineer, Performer, Vocalist, Instrumentalist, Arranger, Programmer, Other. " +
+                        "(Songwriting credits — Writer, Composer, Lyricist, Arranger as a publishing role — go via pica_credits_update on the parent work.) " +
+                        "Resolve a person's name to person_id via pica_people_query first; if no person record exists, set person_id to null and credited_name carries the displayed name. " +
+                        "After writing, call pica_recordings_inspect with sections:['recording_credits'] to verify the credit persisted. " +
+                        "→ then: pica_recordings_inspect (verify saved), pica_people_query (resolve more credits)",
+                    workflows: ["recording-required", "recording-credits-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            recording_id: {
+                                type: "string",
+                                description: "The recording UUID to credit",
+                            },
+                            person_id: {
+                                type: "string",
+                                description: "Optional UUID of an existing person record. Resolve via pica_people_query (or pica_people_create) first. Null is allowed when the credited entity is not yet a person record.",
+                            },
+                            credited_name: {
+                                type: "string",
+                                description: "The displayed credit name (NOT NULL on recording_credits). Use the artist/performer's professional or contributor name as it should appear on the recording.",
+                            },
+                            role: {
+                                type: "string",
+                                description: "Recording credit role from the 16-entry RECORDING_CREDIT_ROLES enum.",
+                                enum: [...RECORDING_CREDIT_ROLES],
+                            },
+                            split_percentage: {
+                                type: "number",
+                                description: "Optional percentage share for this credit (0-100). Independent of work_credits writer_split_percentage — recording-side splits are tracked separately from songwriter splits.",
+                            },
+                            split_type: {
+                                type: "string",
+                                description: "Optional free-form split type label (e.g. 'master', 'producer_points').",
+                            },
+                            display_order: {
+                                type: "number",
+                                description: "Optional display order for sorting credits in UI lists. Defaults to 0.",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Optional free-text notes about this credit (recording-session context, role specifics).",
+                            },
+                        },
+                        required: ["recording_id", "credited_name", "role"],
+                    },
+                    nextSteps: [
+                        {
+                            tool: "pica_recordings_inspect",
+                            reason: "Read recording_credits back via sections:['recording_credits'] to confirm the new row persisted.",
+                            when: "on_success",
+                        },
+                        {
+                            tool: "pica_people_query",
+                            reason: "Resolve another person to credit, then call pica_recording_credits_update again for the next role.",
+                            when: "on_success",
+                        },
+                    ],
+                },
+                executor: withBillingGate(this.pica, "recording credit update", this.updateRecordingCredits.bind(this)),
+            },
+        ];
+    }
+    async listCredits(args) {
+        // Fetch both publishing collaborators and recording credits
+        const [collabSettled, creditsSettled] = await Promise.allSettled([
+            this.pica.credits.listCollaborators(args.work_id),
+            this.pica.credits.listForWork(args.work_id),
+        ]);
+        const collaborators = collabSettled.status === "fulfilled"
+            ? collabSettled.value
+            : { collaborators: [], count: 0 };
+        const recordingCredits = creditsSettled.status === "fulfilled" ? creditsSettled.value : [];
+        // Merge both into a single list
+        const collabArray = Array.isArray(collaborators)
+            ? collaborators
+            : collaborators?.collaborators || [];
+        const creditArray = Array.isArray(recordingCredits)
+            ? recordingCredits
+            : recordingCredits?.credits || [];
+        const allCredits = [...collabArray, ...creditArray];
+        return formatStructuredList(allCredits, "credit", {
+            work_id: args.work_id,
+        });
+    }
+    async updateCredits(args) {
+        // Validate splits total 100% before saving
+        const splitTotal = args.credits.reduce((sum, c) => sum + (c.splits || 0), 0);
+        if (splitTotal !== 100) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Splits total ${splitTotal}%, must be exactly 100%. Adjust the splits and try again.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Split credits by role type: publishing roles → /collaborators, recording roles → /credits
+        const PUBLISHING_ROLES = new Set([
+            "writer",
+            "composer",
+            "lyricist",
+            "arranger",
+        ]);
+        const allCredits = args.credits.map((c) => {
+            const credit = {
+                person_id: c.person_id,
+                role: c.role,
+                splits: c.splits || 0,
+            };
+            if (c.publisher_id)
+                credit.publisher_id = c.publisher_id;
+            if (c.publisher_split_percentage !== undefined)
+                credit.publisher_split_percentage = c.publisher_split_percentage;
+            if (c.territory)
+                credit.territory = c.territory;
+            if (c.rights_type)
+                credit.rights_type = c.rights_type;
+            if (c.start_date)
+                credit.start_date = c.start_date;
+            if (c.end_date)
+                credit.end_date = c.end_date;
+            if (c.is_primary !== undefined)
+                credit.is_primary = c.is_primary;
+            if (c.notes !== undefined)
+                credit.notes = c.notes;
+            if (c.attestation_status)
+                credit.attestation_status = c.attestation_status;
+            return credit;
+        });
+        const publishingCredits = allCredits.filter((c) => PUBLISHING_ROLES.has(String(c.role || "writer")
+            .split(", ")[0]
+            .trim()));
+        const recordingCredits = allCredits.filter((c) => !PUBLISHING_ROLES.has(String(c.role || "writer")
+            .split(", ")[0]
+            .trim()));
+        let credits;
+        // Route to correct endpoint(s)
+        if (publishingCredits.length > 0 && recordingCredits.length > 0) {
+            // Mixed — call both endpoints, use allSettled so a partial failure is reported not silently swallowed
+            const [pubSettled, recSettled] = await Promise.allSettled([
+                this.pica.credits.updateCollaborators(args.work_id, {
+                    credits: publishingCredits,
+                }),
+                this.pica.credits.updateForWork(args.work_id, {
+                    credits: recordingCredits,
+                }),
+            ]);
+            const pubResult = pubSettled.status === "fulfilled" ? pubSettled.value : null;
+            const recResult = recSettled.status === "fulfilled" ? recSettled.value : null;
+            const pubError = pubSettled.status === "rejected"
+                ? pubSettled.reason
+                : null;
+            const recError = recSettled.status === "rejected"
+                ? recSettled.reason
+                : null;
+            if (pubError && recError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `both publishing and recording credits failed to save — publishing error: ${pubError?.message ?? pubError}, recording error: ${recError?.message ?? recError}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (pubError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `recording credits updated, but publishing credits failed — ${pubError?.message ?? pubError}. retry the publishing portion.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (recError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `publishing credits updated, but recording credits failed — ${recError?.message ?? recError}. retry the recording portion.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            credits = { collaborators: pubResult, credits: recResult };
+        }
+        else if (publishingCredits.length > 0) {
+            credits = await this.pica.credits.updateCollaborators(args.work_id, {
+                credits: publishingCredits,
+            });
+        }
+        else {
+            credits = await this.pica.credits.updateForWork(args.work_id, {
+                credits: recordingCredits,
+            });
+        }
+        // Check completeness for hints about next steps
+        const hints = [];
+        try {
+            const completeness = await this.pica.health.getWorkCompleteness(args.work_id);
+            hints.push(...mapGapsToHints(completeness?.gaps || completeness?.missing || [], 3));
+        }
+        catch {
+            // Best-effort
+        }
+        // Notify all credited people about their credit
+        const parties = args.credits
+            .filter((c) => c.person_id)
+            .map((c) => ({
+            person_id: c.person_id,
+            message: `you've been credited as ${c.role || "writer"} (${c.splits || 0}%) on a work — please verify`,
+            work_id: args.work_id,
+            notification_type: "credit_added",
+        }));
+        let notifySummary = "";
+        if (parties.length > 0) {
+            const results = await notifyParties(this.pica, parties);
+            notifySummary = summarizeNotifications(results);
+        }
+        const msg = notifySummary
+            ? `Credits updated. ${notifySummary}`
+            : "Credits updated successfully";
+        return formatSuccess(msg, credits, hints);
+    }
+    /**
+     * ADR-213 Primitive B — pica_recording_credits_update
+     *
+     * Writes a single first-party recording credit to the recording_credits
+     * table via POST /admin/recordings/{recording_id}/credits.
+     *
+     * Validates role against RECORDING_CREDIT_ROLES (16 entries) before the
+     * round trip so we get a structured error rather than a generic 400 from
+     * the route. credited_name is required (NOT NULL on the table); the route
+     * also validates this but we surface it earlier.
+     *
+     * On success, includes a notification to the credited person if person_id
+     * is set, mirroring the work-side updateCredits notification flow.
+     */
+    async updateRecordingCredits(args) {
+        const recordingId = args.recording_id;
+        const personId = (args.person_id ?? null);
+        const creditedName = (args.credited_name ?? "");
+        const role = args.role;
+        if (!recordingId) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "recording_id is required.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!creditedName.trim()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "credited_name is required (recording_credits.credited_name is NOT NULL).",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!role || !RECORDING_CREDIT_ROLES.includes(role)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Invalid role '${role}'. Must be one of: ${RECORDING_CREDIT_ROLES.join(", ")}. Songwriting credits (Writer, Composer, Lyricist, Arranger) go via pica_credits_update on the parent work.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        let credit;
+        try {
+            credit = await this.pica.recordingCredits.create(recordingId, {
+                person_id: personId,
+                credited_name: creditedName.trim(),
+                role,
+                split_percentage: args.split_percentage ?? null,
+                split_type: args.split_type ?? null,
+                display_order: args.display_order ?? 0,
+                notes: args.notes ?? null,
+            });
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            // Distinguish person-not-found so the agent can recover via
+            // pica_people_query — surfaces next_tool guidance per ADR-198.
+            if (/person_id|fk|foreign key|not found/i.test(errorMessage) &&
+                personId) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Failed to create recording credit — person_id '${personId}' may not exist. Resolve via pica_people_query then retry. Underlying error: ${errorMessage}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to create recording credit: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Notify the credited person if structured (matches work-side pattern).
+        let notifySummary = "";
+        if (personId) {
+            const parties = [
+                {
+                    person_id: personId,
+                    message: `you've been credited as ${role} on a recording — please verify`,
+                    notification_type: "credit_added",
+                },
+            ];
+            try {
+                const results = await notifyParties(this.pica, parties);
+                notifySummary = summarizeNotifications(results);
+            }
+            catch {
+                // Best-effort — don't fail the create
+            }
+        }
+        const msg = notifySummary
+            ? `Recording credit added. ${notifySummary}`
+            : "Recording credit added successfully";
+        return formatSuccess(msg, credit);
+    }
+}
+//# sourceMappingURL=credits.js.map

package/dist/tools/credits.js.map

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

package/dist/tools/custody-hints.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ADR-158 Plan C Phase 2 — completion hints for pica_works_create.
+ *
+ * When a fresh work is created, the custody columns default to
+ * "entry_default" (the org that typed it in is the placeholder custodian
+ * until an actual claim is made). These hints nudge the agent to have
+ * the rights conversation immediately rather than leaving custody dangling.
+ *
+ * The helper is intentionally defensive — the SDK's `Work` TS interface
+ * does not declare `composition_custody_source` / `master_custody_source`,
+ * but the API returns them as JSON pass-through from `worksService.create`.
+ * Callers pass the raw work object; we read the fields with a typed wrapper.
+ */
+import type { CompletionHint } from "@withpica/mcp-utils";
+export declare function buildCustodyHints(work: unknown): CompletionHint[];
+//# sourceMappingURL=custody-hints.d.ts.map

package/dist/tools/custody-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custody-hints.d.ts","sourceRoot":"","sources":["../../src/tools/custody-hints.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,EAAE,CA+BjE"}

package/dist/tools/custody-hints.js

@@ -0,0 +1,27 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export function buildCustodyHints(work) {
+    const w = (work ?? {});
+    const hints = [];
+    if (w.composition_custody_source === "entry_default") {
+        hints.push({
+            gap: "custody_unclaimed_composition",
+            severity: "important",
+            suggestion: "Who holds the publishing (composition) rights? If you, call pica_custody_claim with chain='composition'. If someone else (publisher, co-writer), invite them via pica_collaborators_invite and let them claim custody on acceptance.",
+        });
+    }
+    if (w.master_custody_source === "entry_default") {
+        hints.push({
+            gap: "custody_unclaimed_master",
+            severity: "important",
+            suggestion: "Who holds the recording (master) rights? Label, distributor, self-released? Same pattern — claim it yourself via pica_custody_claim with chain='master', or invite the rightsholder.",
+        });
+    }
+    // Always fire the split hint — we never know splits from a single work row.
+    hints.push({
+        gap: "rights_share_unknown",
+        severity: "nice_to_have",
+        suggestion: "Is the publishing 100% yours or split with co-writers? If split, add co-writers via pica_work_credits_add with their percentage shares so the splits sum to 100. Then invite them via pica_collaborators_invite to confirm.",
+    });
+    return hints;
+}
+//# sourceMappingURL=custody-hints.js.map

package/dist/tools/custody-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custody-hints.js","sourceRoot":"","sources":["../../src/tools/custody-hints.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAuB7D,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAoB,CAAC;IAC1C,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,IAAI,CAAC,CAAC,0BAA0B,KAAK,eAAe,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,EAAE,+BAA+B;YACpC,QAAQ,EAAE,WAAW;YACrB,UAAU,EACR,sOAAsO;SACzO,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,CAAC,qBAAqB,KAAK,eAAe,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,EAAE,0BAA0B;YAC/B,QAAQ,EAAE,WAAW;YACrB,UAAU,EACR,sLAAsL;SACzL,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,IAAI,CAAC;QACT,GAAG,EAAE,sBAAsB;QAC3B,QAAQ,EAAE,cAAc;QACxB,UAAU,EACR,6NAA6N;KAChO,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/custody.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Custody MCP Tools — ADR-158 Plan C Phase 1
+ *
+ * Six tools covering the custody claim lifecycle + reconciliation, exposed
+ * on the stdio transport. Thin wrappers around this.pica.custody.* which
+ * calls the HTTP routes under /api/admin/custody/.
+ *
+ * Tools:
+ *   pica_custody_claim             — request custody of a work's chain
+ *   pica_custody_respond           — accept/decline/dispute an incoming claim
+ *   pica_custody_list              — list incoming + outgoing claims
+ *   pica_custody_history           — custody-related provenance_history rows
+ *   pica_custody_resolve_pending   — preview inheritable works for a global_publisher_id
+ *   pica_custody_reconcile         — bulk-claim inheritable works
+ *
+ * RBAC (enforced at the HTTP route layer, see app/api/admin/custody/*):
+ *   claim, respond, resolve_pending, reconcile → admin/owner only
+ *   list, history                              → any authenticated member
+ *
+ * Pricing: FREE. ADR-162 deprecates credit gating as a user-facing concept.
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import type { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class CustodyTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private claim;
+    private respond;
+    private list;
+    private history;
+    private resolvePending;
+    private reconcile;
+}
+//# sourceMappingURL=custody.d.ts.map