@withpica/mcp-sdk 3.21.0 → 3.22.0

package/CHANGELOG.md

@@ -11,6 +11,30 @@ 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

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;
@@ -1478,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";
@@ -1539,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;
@@ -4728,6 +4758,28 @@ declare class RightsResource extends BaseResource {
     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?: {