@withpica/mcp-sdk 3.20.0 → 3.22.0

package/CHANGELOG.md

@@ -11,6 +11,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.22.0] - 2026-09-30
+
+### Added
+
+- `integrity.waive` accepts `kind` (`not_applicable` | `restricted`) for the
+  platform-presence codes `PLATFORM_SPOTIFY` / `PLATFORM_YOUTUBE` /
+  `PLATFORM_APPLE_MUSIC`, and returns the work's re-scored `completeness`
+  for them; `integrity.revokeWaiver` now returns the route's answer
+  (`{ id, revoked, completeness? }`) instead of `void`.
+- `PlatformWaiverCode` / `PlatformWaiverKind` types; `IntegrityGapCode` gains
+  `WORK_NO_MASTER`, `WORK_SPLITS_ABSENT`, `WORK_SPLITS_INVALID`.
+
+### Deprecated
+
+- `Work.is_verified` is now optional and deprecated. `works` has no such
+  column (no applied migration adds one), so works responses do not carry it;
+  PICA keeps no work-level verified flag. Remove at the next major, with
+  `works.verify`.
+- `rights.statements()`, `rights.statement(incomeId)`, `rights.recordIncome(body)`,
+  `rights.societyChecks(workId)` and `rights.measures()` — ADR-321 Phase 3
+  (distribution, computed and not paid), over `GET/POST /admin/rights-income`,
+  `GET /admin/rights-income/{id}`, `GET /admin/rights-statements/society` and
+  `GET /admin/rights-statements/measures`. All need finance access.
+
+## [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

@@ -306,7 +306,13 @@ interface Work {
     isrc?: string;
     primary_artist?: string;
     duration_seconds?: number;
-    is_verified: boolean;
+    /**
+     * @deprecated `works` has no `is_verified` column (no applied migration
+     * adds one), so works responses do not carry this field. PICA keeps no
+     * work-level verified flag (see `WorksResource.verify`). Kept only so the
+     * published SDK's surface does not break; remove at the next major.
+     */
+    is_verified?: boolean;
     lyrics?: string;
     genre?: string;
     mood?: string;
@@ -1025,6 +1031,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>;
@@ -1471,7 +1484,14 @@ declare class PicaScoreResource extends BaseResource {
  * exported shapes (the SDK does not import from `lib/`, mcp<->lib
  * isolation). Keep in sync by hand if the service's exported types change.
  */
-export type IntegrityGapCode = "WORK_NO_RECORDING" | "RECORDING_NO_WORK" | "RECORDING_NO_RELEASE" | "WORK_NO_WRITER" | "RECORDING_NO_OWNER" | "COLLABORATOR_NOT_INVITED" | "COLLABORATOR_NOT_ATTESTED";
+export type IntegrityGapCode = "WORK_NO_RECORDING" | "RECORDING_NO_WORK" | "RECORDING_NO_RELEASE" | "WORK_NO_WRITER" | "RECORDING_NO_OWNER" | "COLLABORATOR_NOT_INVITED" | "COLLABORATOR_NOT_ATTESTED" | "WORK_NO_MASTER" | "WORK_SPLITS_ABSENT" | "WORK_SPLITS_INVALID";
+/**
+ * Platform-presence codes a work may be waived on (mig 20260929163712):
+ * the platform is not applicable to it, or restricted. Identifiers and
+ * registrations are never waivable.
+ */
+export type PlatformWaiverCode = "PLATFORM_SPOTIFY" | "PLATFORM_YOUTUBE" | "PLATFORM_APPLE_MUSIC";
+export type PlatformWaiverKind = "not_applicable" | "restricted";
 export type IntegrityEntityType = "work" | "recording" | "release" | "person";
 export interface AttestationProposal {
     kind: "send_attestation_invites";
@@ -1532,11 +1552,28 @@ declare class IntegrityResource extends BaseResource {
         entity_type: string;
         entity_id: string;
         reason: string;
+        /** Required for a platform code (PLATFORM_*); omitted otherwise. */
+        kind?: PlatformWaiverKind;
     }): Promise<{
         id: string;
+        kind?: PlatformWaiverKind;
+        completeness?: {
+            score: number | null;
+            platforms: number | null;
+        };
+    }>;
+    /**
+     * PATCH /admin/integrity/waivers { waiver_id, revoke: true }. No un-revoke
+     * path. A platform waiver answers with the work's re-scored `completeness`.
+     */
+    revokeWaiver(waiverId: string): Promise<{
+        id: string;
+        revoked: boolean;
+        completeness?: {
+            score: number | null;
+            platforms: number | null;
+        };
     }>;
-    /** PATCH /admin/integrity/waivers { waiver_id, revoke: true }. No un-revoke path. */
-    revokeWaiver(waiverId: string): Promise<void>;
 }
 interface PresignedUploadResult {
     uploadUrl: string;
@@ -2206,10 +2243,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 +4741,46 @@ 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>;
+    /**
+     * ADR-321 Phase 3 — GET /admin/rights-income. Statements: direct income
+     * and what it WOULD pay (no money moves). Needs finance access.
+     */
+    statements(params?: {
+        workId?: string;
+        limit?: number;
+        before?: string;
+    }): Promise<any>;
+    /** GET /admin/rights-income/{id} — one income event, recomputed now. */
+    statement(incomeId: string): Promise<any>;
+    /**
+     * 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 }`.
+     */
+    recordIncome(body: Record<string, unknown>): Promise<any>;
+    /** GET /admin/rights-statements/society?work_id= — society statements checked against the split. */
+    societyChecks(workId: string): Promise<any>;
+    /** GET /admin/rights-statements/measures — the four measures (ADR-321 §7a). */
+    measures(): Promise<any>;
+}
 declare class RoyaltiesResource extends BaseResource {
     payments(params?: {
         source?: string;
@@ -5212,6 +5296,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;