@withpica/mcp-server 2.97.5 → 2.98.0

package/dist/tools/rights.js

@@ -0,0 +1,302 @@
+// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
+/**
+ * Programmable rights — MCP tools (ADR-321 §9, Phase 2).
+ *
+ * Agents propose, humans confirm. `pica_rights_propose` follows the
+ * duplicate-merge pattern (ADR-288): tier "destructive", approvalMode "human",
+ * resource scope `write:catalog` so a delegated agent can PROPOSE; the org
+ * owner approves out-of-band and `human-approval-executor` replays the frozen
+ * params through the same `proposeRightsRule` the route calls. Proposing never
+ * activates or confirms anything — each party confirms by email.
+ *
+ * `pica_rights_status` and `pica_rights_inspect` are reads over
+ * `GET /api/admin/rights/rules/{id}` and `GET /api/admin/works/{id}/rights`.
+ */
+import { ApiError } from "@withpica/mcp-sdk";
+import { formatSuccess, formatValidationError } from "@withpica/mcp-utils";
+import { typedError } from "./error-envelope.js";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** The share-rule kinds the propose route accepts (programmable-rights-share-rule SHARE_RULE_KINDS). */
+export const RIGHTS_SHARE_KINDS = [
+    "publisher",
+    "manager_commission",
+    "sold_share",
+    "other",
+];
+/**
+ * Build the POST body from tool args — only the fields the route reads, so
+ * nothing unexpected is forwarded. The route re-validates everything.
+ */
+export function buildProposeBody(args) {
+    const body = { rule: args.rule };
+    for (const key of [
+        "recording_id",
+        "ownership",
+        "side",
+        "subject_person_id",
+        "kind",
+        "parties",
+        "effective_from",
+        "effective_to",
+    ]) {
+        if (args[key] !== undefined)
+            body[key] = args[key];
+    }
+    return body;
+}
+/** Parse the `{ error: { code, message, details } }` body off an SDK ApiError. */
+function parseApiErrorBody(err) {
+    const text = err.message.replace(/^API request failed: \d+ /, "");
+    try {
+        const parsed = JSON.parse(text);
+        return {
+            code: parsed.error?.code,
+            message: parsed.error?.message,
+            reasons: parsed.error?.details?.reasons,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/** The one-line message for a successful proposal. Never says "active" unless it is. */
+export function proposeMessage(data) {
+    if (data.locked) {
+        return "The rule is locked: the only party confirmed it themselves in this one step.";
+    }
+    const n = data.requests?.length ?? 0;
+    const informed = data.informed?.length ?? 0;
+    return (`Proposed — nothing is active yet. ${n} ${n === 1 ? "party has" : "parties have"} been asked to confirm by email; ` +
+        `the rule becomes active only when every one of them confirms.` +
+        (informed > 0
+            ? ` ${informed} other ${informed === 1 ? "party was" : "parties were"} told, not asked.`
+            : "") +
+        " Check progress with pica_rights_status.");
+}
+/** The one-line message for a song's rights overview. Holds are PICA's rules. */
+export function inspectMessage(data) {
+    const title = data.workTitle ? `"${data.workTitle}"` : "this song";
+    const n = data.holds?.length ?? 0;
+    if (n === 0) {
+        return `Rules for ${title}. Nothing would be held under PICA's rules right now (amounts are not computed yet).`;
+    }
+    return (`Rules for ${title}. ${n} ${n === 1 ? "reason" : "reasons"} money would be held under PICA's rules — ` +
+        `each names who can clear it. These are PICA's rules, not a society's; no amounts are computed yet.`);
+}
+export class RightsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_rights_propose",
+                    // ADR-321 §9 / ADR-288 pattern — write:catalog (the propose route's
+                    // resource scope) so a catalog-scoped delegated agent can PROPOSE;
+                    // the human approval substitutes for destructive:*.
+                    scope: "write:catalog",
+                    audiences: ["stdio", "http", "public"],
+                    tier: "destructive",
+                    // Delegated-agent callers (OAuth / pica_grant_*) cannot run this
+                    // directly: the org owner approves out-of-band and PICA replays the
+                    // frozen params via human-approval-executor.
+                    approvalMode: "human",
+                    description: "Propose a programmable-rights rule on a song and email the people it affects to confirm it. " +
+                        "It PROPOSES ONLY: it never activates or confirms anything on anyone's behalf, and it never moves money. " +
+                        "Each party confirms (or declines) from their own email; the rule becomes active only when every party whose confirmation is needed has confirmed. " +
+                        'Three kinds: `rule:"song"` — the composition rule, from the song\'s writer splits; ' +
+                        "`rule:\"master\"` with `recording_id` and `ownership` — a recording's master rule. Ask the user who owns the master first: entering a recording doesn't make them its owner. A master locks only after every owner signs its master ownership sheet; " +
+                        "`rule:\"share\"` — divides ONE party's share among people (e.g. a writer's publishing deal: writer B 8000 / publisher P 2000 of B's share; " +
+                        "or a manager's commission with an `effective_to` end date). " +
+                        "Shares are basis points: 100 = 1%, and a share rule's parties must sum to 10,000 (100% of that one party's share). " +
+                        "A refusal (song not ready, parties don't add up) writes nothing and lists the reasons. " +
+                        "For delegated agents (OAuth connectors / pica_grant_*) this tool does NOT execute directly: it creates a pending human approval and the org owner approves out-of-band — relay the returned message and poll pica_approval_status. " +
+                        "Read the song's current rules first with pica_rights_inspect; follow a proposal with pica_rights_status.",
+                    workflows: "infrastructure",
+                    vernacular_kind: "specialist",
+                    vernacular_reason: "Destructive-tier proposal that emails third parties; invoked by exact name after explicit user confirmation.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The song (work) id (UUID) — find it with pica_search_all.",
+                            },
+                            rule: {
+                                type: "string",
+                                enum: ["song", "master", "share"],
+                                description: '"song" = the composition rule; "master" = a recording\'s master rule (needs recording_id); "share" = divide one party\'s share.',
+                            },
+                            recording_id: {
+                                type: "string",
+                                description: 'The recording (UUID). Required for rule:"master" and for a share on side:"master"; omit for a composition share.',
+                            },
+                            ownership: {
+                                type: "string",
+                                enum: ["only_me", "me_and_others", "someone_else"],
+                                description: 'rule:"master" only, required: the user\'s answer to "who owns the master of this recording?". Ask them — never assume. "someone_else" is refused with how to add the real owner; an agent can never lock "only_me" in one step.',
+                            },
+                            side: {
+                                type: "string",
+                                enum: ["composition", "master"],
+                                description: 'Share rules only: which side the divided share sits on (default "composition").',
+                            },
+                            subject_person_id: {
+                                type: "string",
+                                description: "Share rules only: the person whose share is being divided (UUID) — e.g. the writer with the publishing deal.",
+                            },
+                            kind: {
+                                type: "string",
+                                enum: [...RIGHTS_SHARE_KINDS],
+                                description: "Share rules only: publisher (a publishing deal), manager_commission (usually with effective_to), sold_share, or other.",
+                            },
+                            parties: {
+                                type: "array",
+                                description: "Share rules only: 1–20 people and their share_bp of the subject's share. Basis points: 100 = 1%; must sum to 10000.",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        person_id: {
+                                            type: "string",
+                                            description: "The person (UUID).",
+                                        },
+                                        share_bp: {
+                                            type: "integer",
+                                            description: "Their part of the subject's share in basis points (100 = 1%).",
+                                        },
+                                    },
+                                    required: ["person_id", "share_bp"],
+                                },
+                            },
+                            effective_from: {
+                                type: "string",
+                                description: "Share rules only: start date, YYYY-MM-DD.",
+                            },
+                            effective_to: {
+                                type: "string",
+                                description: "Share rules only, optional: end date, YYYY-MM-DD (e.g. when a manager's commission ends). The share reverts after it.",
+                            },
+                        },
+                        required: ["work_id", "rule"],
+                    },
+                },
+                executor: this.propose.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_rights_status",
+                    scope: "read:catalog",
+                    audiences: ["stdio", "http", "public"],
+                    tier: "read",
+                    description: "One programmable-rights rule's state: proposed, active, superseded or withdrawn; each party and whether they have confirmed this exact version (by its fingerprint), " +
+                        "with what happened to their confirm email while it is open (sent, held, failed, none, unknown — never assume it went); any open withdrawal (disputed); and its dates. Use after pica_rights_propose to see who is still to confirm. " +
+                        "Take rule_id from pica_rights_propose's result or from pica_rights_inspect. Read-only; nothing here confirms anything.",
+                    workflows: "infrastructure",
+                    vernacular_kind: "specialist",
+                    vernacular_reason: "Follow-up read keyed by a rule id from pica_rights_propose or pica_rights_inspect; the creator question routes to pica_rights_inspect.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            rule_id: {
+                                type: "string",
+                                description: "The rule id (UUID) — from pica_rights_propose's ruleId or pica_rights_inspect.",
+                            },
+                        },
+                        required: ["rule_id"],
+                    },
+                },
+                executor: this.status.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_rights_inspect",
+                    scope: "read:catalog",
+                    audiences: ["stdio", "http", "public"],
+                    tier: "read",
+                    description: "Use when the user asks: 'who gets paid on this song?', " +
+                        "'is this song programmable?', 'who still needs to confirm the rule?', " +
+                        "'what money would PICA hold on this song, and why?'. " +
+                        "A song's programmable-rights rules on both sides — the composition and each recording's master — song rules and share rules (publishing deals, manager commissions), " +
+                        "active and proposed, with version history, disputes (open withdrawals), and HOLDS: what money would be held and why, and who or what clears it. " +
+                        "Amounts are not computed yet (a later phase), so holds name the reason and the extent (the whole payment, or one party's portion) but no sums. " +
+                        "HONESTY: holds are PICA's own rules about when money is released, not a society's (PRS, MLC, PPL…) — say so; for what may be holding up society income use pica_royalties_blockers. " +
+                        "To propose a rule use pica_rights_propose.",
+                    workflows: "infrastructure",
+                    vernacular_kind: "creator-entry",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The song (work) id (UUID) — find it with pica_search_all.",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.inspect.bind(this),
+            },
+        ];
+    }
+    async propose(args) {
+        const workId = args.work_id;
+        if (typeof workId !== "string" || !UUID.test(workId)) {
+            return formatValidationError({
+                work_id: "must be the song's id (a UUID) — find it with pica_search_all",
+            });
+        }
+        if (args.rule !== "song" &&
+            args.rule !== "master" &&
+            args.rule !== "share") {
+            return formatValidationError({
+                rule: 'must be "song", "master" or "share"',
+            });
+        }
+        try {
+            const data = await this.pica.rights.propose(workId, buildProposeBody(args));
+            return formatSuccess(proposeMessage(data), data);
+        }
+        catch (err) {
+            // A 422 is a refusal decided before anything was written — surface the
+            // reasons so the agent can tell the user what to fix.
+            if (err instanceof ApiError &&
+                (err.status === 422 || err.status === 400)) {
+                const body = parseApiErrorBody(err);
+                const code = err.status === 400
+                    ? "VALIDATION_ERROR"
+                    : body.code === "NOT_CHECKED"
+                        ? "RIGHTS_NOT_CHECKED"
+                        : "RIGHTS_NOT_READY";
+                return typedError(code, body.message ?? err.message, {
+                    reasons: Array.isArray(body.reasons) ? body.reasons : [],
+                    nothing_written: true,
+                    retry_safe: false,
+                });
+            }
+            throw err;
+        }
+    }
+    async status(args) {
+        const ruleId = args.rule_id;
+        if (typeof ruleId !== "string" || !UUID.test(ruleId)) {
+            return formatValidationError({
+                rule_id: "must be a rule id (a UUID) — pica_rights_inspect lists a song's rules",
+            });
+        }
+        const data = await this.pica.rights.status(ruleId);
+        return formatSuccess("Rule status", data);
+    }
+    async inspect(args) {
+        const workId = args.work_id;
+        if (typeof workId !== "string" || !UUID.test(workId)) {
+            return formatValidationError({
+                work_id: "must be the song's id (a UUID) — find it with pica_search_all",
+            });
+        }
+        const data = await this.pica.rights.inspect(workId);
+        return formatSuccess(inspectMessage(data), data);
+    }
+}
+//# sourceMappingURL=rights.js.map

package/dist/tools/rights.js.map

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

package/dist/tools/royalties.d.ts

@@ -40,10 +40,33 @@ export declare class RoyaltiesTools {
     }>;
     private listPayments;
     private getEarnings;
-    private getGaps;
+    private getBlockers;
     private listStatements;
     private getStatement;
     private listUnmatched;
     private attributePayment;
 }
+/**
+ * The one-line message for a song's blockers. It never calls a song clear
+ * unless `state` is "clear" — the honesty rule in the tool description, made
+ * true in the text an agent reads first.
+ */
+export declare function songBlockersMessage(result: {
+    state?: string;
+    blockers?: unknown[];
+    unchecked?: Array<{
+        reason?: string;
+    }>;
+}): string;
+/** The one-line message for the catalogue roll-up. Same honesty rule. */
+export declare function catalogueBlockersMessage(data: {
+    summary?: {
+        total?: number;
+        clear?: number;
+        blocked?: number;
+        unknown?: number;
+        unchecked?: unknown[];
+    };
+    total_listed?: number;
+}): string;
 //# sourceMappingURL=royalties.d.ts.map

package/dist/tools/royalties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"royalties.d.ts","sourceRoot":"","sources":["../../src/tools/royalties.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAI3E,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAkX3D,YAAY;YA2BZ,WAAW;YAWX,OAAO;YAkCP,cAAc;YAiBd,YAAY;YAiBZ,aAAa;YA0Bb,gBAAgB;CAoB/B"}
+{"version":3,"file":"royalties.d.ts","sourceRoot":"","sources":["../../src/tools/royalties.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAI3E,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAwY3D,YAAY;YA2BZ,WAAW;YAWX,WAAW;YAaX,cAAc;YAiBd,YAAY;YAiBZ,aAAa;YA0Bb,gBAAgB;CAoB/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxC,GAAG,MAAM,CAcT;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;KACvB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAUT"}

package/dist/tools/royalties.js

@@ -62,7 +62,7 @@ export class RoyaltiesTools {
                     description: "Use when the user asks: 'how much did I earn?', 'what are my earnings?', 'did I get paid?', " +
                         "'how much has this song earned?', 'what's X earned?', 'what's this song worth?'. " +
                         "Detailed earnings summary with breakdown by source and tax category, plus recent payment records and pagination. " +
-                        "For what's missing rather than what's paid (unregistered works, unlinked credits) use pica_royalties_summary instead.",
+                        "For what's holding a song's money up rather than what's paid (missing ISWC or IPI, no confirmed registration) use pica_royalties_blockers instead.",
                     workflows: "infrastructure",
                     vernacular_kind: "specialist",
                     vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
@@ -90,44 +90,6 @@ export class RoyaltiesTools {
                 },
                 executor: this.getEarnings.bind(this),
             },
-            {
-                definition: {
-                    name: "pica_royalties_summary",
-                    scope: "read:finances",
-                    audiences: ["stdio", "http", "public"],
-                    tier: "read",
-                    description: "Use when the user asks: 'what royalties am I missing?', 'where should I register?', " +
-                        "'what registrations are missing?', 'what am I missing?'. " +
-                        "Royalty gap analysis — identifies missing registrations, unlinked credits, and payment gaps. " +
-                        "Does NOT return earnings totals or payment amounts — for 'how much did I earn?' use pica_royalties_get instead.",
-                    workflows: "infrastructure",
-                    vernacular_kind: "creator-entry",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            priority: {
-                                type: "string",
-                                description: "Filter by priority: high, medium, low",
-                            },
-                            gap_type: {
-                                type: "string",
-                                description: "Filter by gap type: prs_missing, ppl_missing, mcps_missing, " +
-                                    "spotify_missing, isrc_missing, iswc_missing, tunecode_missing, " +
-                                    "payment_missing, credit_unlinked",
-                            },
-                            work_id: {
-                                type: "string",
-                                description: "Filter gaps for a specific work",
-                            },
-                            limit: {
-                                type: "number",
-                                description: "Number of gaps to return (default 20)",
-                            },
-                        },
-                    },
-                },
-                executor: this.getGaps.bind(this),
-            },
             {
                 definition: {
                     name: "pica_statements_list",
@@ -311,6 +273,64 @@ export class RoyaltiesTools {
                 },
                 executor: this.listUnmatched.bind(this),
             },
+            {
+                definition: {
+                    name: "pica_royalties_blockers",
+                    scope: "read:catalog",
+                    audiences: ["stdio", "http", "public"],
+                    tier: "read",
+                    description: "Use when the user asks: 'why isn't this song being paid?', " +
+                        "'what's holding up my money?', 'why am I not getting paid for X?', " +
+                        "'what's stopping my songs being paid?'. " +
+                        "What in the record is likely holding up a song's society income (PRS, MLC, PPL and so on), " +
+                        "each with the fix: missing ISWC, writers without an IPI or society membership, shares that " +
+                        "don't total 100%, disputed credits, no confirmed registration, recordings without an ISRC. " +
+                        "Pass work_id for one song; omit it for the whole catalogue (a summary plus the songs that aren't clear, paged). " +
+                        "HONESTY RULES — follow them exactly: (1) say 'nothing is holding it up' ONLY when state is 'clear'; " +
+                        "if state is 'unknown' or `unchecked` is non-empty, tell the user those areas could not be checked — never call it clear. " +
+                        "(2) these are what the record shows, not the society's own reason; say so. " +
+                        "(3) evidence 'record_shows' means not confirmed — e.g. 'no confirmed registration', never 'not registered'. " +
+                        "For earnings amounts use pica_royalties_get.",
+                    workflows: "infrastructure",
+                    vernacular_kind: "creator-entry",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                format: "uuid",
+                                description: "The song (work) to check — its id (UUID), not its title. Find the id with pica_search_all. Omit for the whole catalogue.",
+                            },
+                            code: {
+                                type: "string",
+                                enum: [
+                                    "no_iswc",
+                                    "no_writers",
+                                    "writer_shares_unknown",
+                                    "writer_shares_not_100",
+                                    "writer_person_deleted",
+                                    "writer_no_ipi",
+                                    "writer_no_society",
+                                    "credit_disputed",
+                                    "split_dispute_open",
+                                    "not_registered",
+                                    "recording_no_isrc",
+                                ],
+                                description: "Catalogue only: list just the songs with this blocker.",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Catalogue only: songs per page, 1–200 (default 50).",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Catalogue only: songs to skip (default 0).",
+                            },
+                        },
+                    },
+                },
+                executor: this.getBlockers.bind(this),
+            },
             // UNVERIFIED (ADR-286 Task 8b): authored in a worktree that cannot build
             // these packages; must compile + test in the main checkout before merge.
             {
@@ -383,34 +403,17 @@ export class RoyaltiesTools {
         });
         return formatSuccess("Earnings summary", data);
     }
-    async getGaps(args) {
-        const data = await this.pica.royalties.gaps({
-            priority: args.priority,
-            gapType: args.gap_type,
-            workId: args.work_id,
-            limit: args.limit || 20,
-        });
-        const hints = [];
-        const gaps = Array.isArray(data) ? data : [];
-        const prsGaps = gaps.filter((g) => g.gap_type === "prs_missing");
-        if (prsGaps.length > 0) {
-            hints.push({
-                gap: "prs_missing",
-                suggestion: `Register ${prsGaps.length} work(s) with PRS (pica_works_inspect with sections: ["registration"])`,
-                count: prsGaps.length,
-                severity: "critical",
-            });
+    async getBlockers(args) {
+        if (args.work_id) {
+            const data = await this.pica.royalties.blockers(String(args.work_id));
+            return formatSuccess(songBlockersMessage(data), data);
         }
-        const isrcGaps = gaps.filter((g) => g.gap_type === "isrc_missing");
-        if (isrcGaps.length > 0) {
-            hints.push({
-                gap: "isrc_missing",
-                suggestion: `Add ISRCs to ${isrcGaps.length} recording(s) for royalty tracking`,
-                count: isrcGaps.length,
-                severity: "important",
-            });
-        }
-        return formatSuccess(`Found ${gaps.length} royalty gaps`, data, hints);
+        const data = await this.pica.royalties.blockersCatalogue({
+            code: args.code,
+            limit: args.limit,
+            offset: args.offset,
+        });
+        return formatSuccess(catalogueBlockersMessage(data), data);
     }
     async listStatements(args) {
         const data = await this.pica.statements.history({
@@ -467,4 +470,34 @@ export class RoyaltiesTools {
         return formatSuccess(`Royalty payment ${args.royalty_payment_id} ${action}`, data);
     }
 }
+/**
+ * The one-line message for a song's blockers. It never calls a song clear
+ * unless `state` is "clear" — the honesty rule in the tool description, made
+ * true in the text an agent reads first.
+ */
+export function songBlockersMessage(result) {
+    const n = result.blockers?.length ?? 0;
+    const gaps = (result.unchecked ?? [])
+        .map((u) => u.reason)
+        .filter(Boolean)
+        .join("; ");
+    if (result.state === "clear")
+        return "Nothing in the record looks like it's holding up money on this song.";
+    if (n > 0)
+        return (`${n} thing${n === 1 ? "" : "s"} in the record likely holding up money on this song (what the record shows, not the society's own reason).` +
+            (gaps ? ` Also could not check: ${gaps}.` : ""));
+    return `Nothing found so far, but this is NOT a clean bill — could not check: ${gaps || "some areas"}.`;
+}
+/** The one-line message for the catalogue roll-up. Same honesty rule. */
+export function catalogueBlockersMessage(data) {
+    const s = data.summary ?? {};
+    const base = `${s.total ?? 0} songs: ${s.blocked ?? 0} with something likely holding up money, ${s.clear ?? 0} clear`;
+    const unknown = s.unknown
+        ? `, ${s.unknown} not fully checked (not clear — say so)`
+        : "";
+    const low = s.unchecked?.length
+        ? " Some areas could not be checked, so counts may be low."
+        : "";
+    return `${base}${unknown}.${low}`;
+}
 //# sourceMappingURL=royalties.js.map

package/dist/tools/royalties.js.map

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

package/dist/tools/section-validation.d.ts

@@ -0,0 +1,14 @@
+import type { ToolResult } from "./index.js";
+/** The closed list of section names the schema declares, or null if none. */
+export declare function declaredSectionNames(inputSchema: unknown): string[] | null;
+/**
+ * Returns a VALIDATION_ERROR result naming the unknown section(s) and the
+ * valid ones, or `null` when the call may proceed (no `sections` sent, the
+ * tool declares no closed list, or every name is known).
+ *
+ * A bare string (`sections: "basic"`) is checked as a one-element list rather
+ * than coerced, so a typo there is refused too; other non-array shapes are
+ * left to the executor.
+ */
+export declare function rejectUnknownSections(toolName: string, inputSchema: unknown, args: Record<string, unknown> | undefined): ToolResult | null;
+//# sourceMappingURL=section-validation.d.ts.map

package/dist/tools/section-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-validation.d.ts","sourceRoot":"","sources":["../../src/tools/section-validation.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7C,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAQ1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,UAAU,GAAG,IAAI,CA8BnB"}