@withpica/mcp-sdk 3.20.0 → 3.21.0

package/CHANGELOG.md

@@ -11,6 +11,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.21.0] - 2026-09-29
+
+### Added
+
+- `rights.propose(workId, body)`, `rights.status(ruleId)` and
+  `rights.inspect(workId)` — ADR-321 Phase 2, over
+  `POST /admin/works/{id}/rights/propose`, `GET /admin/rights/rules/{id}` and
+  `GET /admin/works/{id}/rights`.
+
 ## [3.20.0] - 2026-09-26
 
 ### Changed

package/dist/index.d.ts

@@ -1025,6 +1025,13 @@ declare class WorksResource extends BaseResource {
     }): Promise<Work>;
     update(id: string, updates: Partial<Work>): Promise<Work>;
     delete(id: string): Promise<DeletionResult>;
+    /**
+     * @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.
+     */
     verify(id: string): Promise<Work>;
     bulkDelete(ids: string[]): Promise<void>;
     bulkMoveToPerformances(ids: string[]): Promise<unknown>;
@@ -2206,10 +2213,17 @@ declare 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'`.
      */
     applyEnrichmentProposal(proposalId: string, options?: {
         force?: boolean;
         resolution_note?: string;
+        file_type?: "master" | "version" | "instrumental" | "demo" | "stem";
+        stem_label?: string;
     }): Promise<any>;
     /**
      * Reject a pending proposal. Content-hash suppression (ADR-163)
@@ -4697,6 +4711,24 @@ declare class WorkForHireResource extends BaseResource {
     update(id: string, data: Record<string, any>): Promise<any>;
     delete(id: string): Promise<void>;
 }
+/**
+ * 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.
+ */
+declare 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`.
+     */
+    propose(workId: string, body: Record<string, unknown>): Promise<any>;
+    /** GET /admin/rights/rules/{id} — one rule's status and confirmations. */
+    status(ruleId: string): Promise<any>;
+    /** GET /admin/works/{id}/rights — every rule on a song, history, holds. */
+    inspect(workId: string): Promise<any>;
+}
 declare class RoyaltiesResource extends BaseResource {
     payments(params?: {
         source?: string;
@@ -5212,6 +5244,8 @@ export declare class PicaClient {
     producerAgreements: ProducerAgreementsResource;
     workForHire: WorkForHireResource;
     royalties: RoyaltiesResource;
+    /** ADR-321 Phase 2 — programmable rights (propose / status / inspect). */
+    rights: RightsResource;
     statements: StatementsResource;
     /** ADR-319 — saved catalog selections. */
     selections: SelectionsResource;