@withpica/mcp-sdk 3.20.0 → 3.21.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,
@@ -1642,6 +1649,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 +3644,30 @@ 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`);
+    }
+}
 class RoyaltiesResource extends BaseResource {
     async payments(params) {
         const qp = new URLSearchParams();
@@ -4125,6 +4161,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 +4279,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);