@withpica/mcp-sdk 3.20.0 → 3.22.0

package/dist/index.js

@@ -420,6 +420,13 @@ class WorksResource extends BaseResource {
     async delete(id) {
         return this.request("DELETE", `/admin/works/${id}`);
     }
+    /**
+     * @deprecated `works` has no `is_verified` column, so PATCH /admin/works/[id]
+     * refuses this body (VALIDATION_ERROR "unknown field 'is_verified'") on every
+     * call. PICA keeps no work-level verified flag; the MCP tool
+     * `pica_works_verify` no longer calls this. Kept only so the published SDK's
+     * surface does not break; remove at the next major.
+     */
     async verify(id) {
         return this.request("PATCH", `/admin/works/${id}`, {
             is_verified: true,
@@ -872,9 +879,15 @@ class IntegrityResource extends BaseResource {
     async waive(input) {
         return this.request("POST", "/admin/integrity/waivers", input);
     }
-    /** PATCH /admin/integrity/waivers { waiver_id, revoke: true }. No un-revoke path. */
+    /**
+     * PATCH /admin/integrity/waivers { waiver_id, revoke: true }. No un-revoke
+     * path. A platform waiver answers with the work's re-scored `completeness`.
+     */
     async revokeWaiver(waiverId) {
-        await this.request("PATCH", "/admin/integrity/waivers", { waiver_id: waiverId, revoke: true });
+        return this.request("PATCH", "/admin/integrity/waivers", {
+            waiver_id: waiverId,
+            revoke: true,
+        });
     }
 }
 class AudioFilesResource extends BaseResource {
@@ -1642,6 +1655,11 @@ class EnrichmentResource extends BaseResource {
      * `artist_title_to_youtube` recording-create), a uniqueness check
      * runs instead; conflicts return `{ status: 'create_conflict' }` and
      * cannot be forced.
+     *
+     * File-type questions (`entity_type: 'audio_file'`) take the owner's own
+     * answer: `file_type` (master / version / instrumental / demo / stem) and,
+     * for a stem, an optional `stem_label`. A refused answer is a 400 with
+     * `code: 'INVALID_FILE_TYPE_ANSWER'`.
      */
     async applyEnrichmentProposal(proposalId, options) {
         return this.request("POST", `/admin/enrichment-proposals/${proposalId}/apply`, options ?? {});
@@ -3632,6 +3650,66 @@ class WorkForHireResource extends BaseResource {
         await this.request("DELETE", `/admin/work-for-hire/${id}`);
     }
 }
+/**
+ * ADR-321 Phase 2 — programmable rights. `propose` only proposes: the route
+ * never activates a rule on an API key, and each party confirms by email.
+ */
+class RightsResource extends BaseResource {
+    /**
+     * POST /admin/works/{id}/rights/propose. Body is one of
+     * `{ rule: "song" }`, `{ rule: "master", recording_id }` or
+     * `{ rule: "share", side?, recording_id?, subject_person_id, kind,
+     * parties: [{ person_id, share_bp }], effective_from, effective_to? }`.
+     * A refusal is a 422 carrying `details.reasons`.
+     */
+    async propose(workId, body) {
+        return this.request("POST", `/admin/works/${encodeURIComponent(workId)}/rights/propose`, body);
+    }
+    /** GET /admin/rights/rules/{id} — one rule's status and confirmations. */
+    async status(ruleId) {
+        return this.request("GET", `/admin/rights/rules/${encodeURIComponent(ruleId)}`);
+    }
+    /** GET /admin/works/{id}/rights — every rule on a song, history, holds. */
+    async inspect(workId) {
+        return this.request("GET", `/admin/works/${encodeURIComponent(workId)}/rights`);
+    }
+    /**
+     * ADR-321 Phase 3 — GET /admin/rights-income. Statements: direct income
+     * and what it WOULD pay (no money moves). Needs finance access.
+     */
+    async statements(params) {
+        const qp = new URLSearchParams();
+        if (params?.workId)
+            qp.set("work_id", params.workId);
+        if (params?.limit)
+            qp.set("limit", String(params.limit));
+        if (params?.before)
+            qp.set("before", params.before);
+        const qs = qp.toString();
+        return this.request("GET", `/admin/rights-income${qs ? `?${qs}` : ""}`);
+    }
+    /** GET /admin/rights-income/{id} — one income event, recomputed now. */
+    async statement(incomeId) {
+        return this.request("GET", `/admin/rights-income/${encodeURIComponent(incomeId)}`);
+    }
+    /**
+     * POST /admin/rights-income — record direct income. Body is
+     * `{ work_id, side, recording_id?, income_type, fee_kind, currency,
+     * amount: "1250.00", earned_on, description? }` or
+     * `{ enquiry_id, side, recording_id?, earned_on }`.
+     */
+    async recordIncome(body) {
+        return this.request("POST", "/admin/rights-income", body);
+    }
+    /** GET /admin/rights-statements/society?work_id= — society statements checked against the split. */
+    async societyChecks(workId) {
+        return this.request("GET", `/admin/rights-statements/society?work_id=${encodeURIComponent(workId)}`);
+    }
+    /** GET /admin/rights-statements/measures — the four measures (ADR-321 §7a). */
+    async measures() {
+        return this.request("GET", "/admin/rights-statements/measures");
+    }
+}
 class RoyaltiesResource extends BaseResource {
     async payments(params) {
         const qp = new URLSearchParams();
@@ -4125,6 +4203,8 @@ export class PicaClient {
     producerAgreements;
     workForHire;
     royalties;
+    /** ADR-321 Phase 2 — programmable rights (propose / status / inspect). */
+    rights;
     statements;
     /** ADR-319 — saved catalog selections. */
     selections;
@@ -4241,6 +4321,7 @@ export class PicaClient {
         this.producerAgreements = new ProducerAgreementsResource(baseUrl, config.apiKey, debug);
         this.workForHire = new WorkForHireResource(baseUrl, config.apiKey, debug);
         this.royalties = new RoyaltiesResource(baseUrl, config.apiKey, debug);
+        this.rights = new RightsResource(baseUrl, config.apiKey, debug);
         this.statements = new StatementsResource(baseUrl, config.apiKey, debug);
         this.selections = new SelectionsResource(baseUrl, config.apiKey, debug);
         this.shareLinks = new ShareLinksResource(baseUrl, config.apiKey, debug);