@withpica/mcp-sdk 3.21.0 → 3.23.0

package/dist/index.js

@@ -559,6 +559,25 @@ class PeopleResource extends BaseResource {
     async bulkDelete(ids) {
         return this.request("POST", "/admin/people/bulk-delete", { ids });
     }
+    /**
+     * GET /admin/people/{id}/split-identity — what giving this person a new
+     * global identity would touch: who shares their current one, unattributed
+     * split rows naming it, open custody legs naming it, and which of their
+     * own identifiers equal it. Read-only.
+     */
+    async splitIdentityPreview(id) {
+        return this.request("GET", `/admin/people/${encodeURIComponent(id)}/split-identity`);
+    }
+    /**
+     * POST /admin/people/{id}/split-identity — give this person a NEW global
+     * identity. Body: `{ move_identifiers?, relink_split_ids?,
+     * clear_person_identifiers?, undo_external_ids? }`; every list defaults to
+     * empty (nothing moves, nothing is relinked). A refusal is a 4xx carrying
+     * a `SPLIT_*` code.
+     */
+    async splitIdentity(id, body) {
+        return this.request("POST", `/admin/people/${encodeURIComponent(id)}/split-identity`, body);
+    }
     /**
      * List a person's artist projects — per-stage-name Spotify/YouTube
      * identity + enrichment status (ADR-289 Wave B2 item 4, ports the
@@ -830,6 +849,7 @@ class CreditsResource extends BaseResource {
             work_id: env.work_id ?? workId,
             credit: env.data,
             allocation: env.allocation,
+            ...(env.person_change && { person_change: env.person_change }),
         };
     }
     /**
@@ -879,9 +899,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 {
@@ -1202,8 +1228,13 @@ class SyncPlacementsResource extends BaseResource {
             : "";
         await this.request("DELETE", `/admin/sync-placements/${id}${query}`);
     }
+    /**
+     * Attach a citation source (POST /api/admin/sync-placements/[id]/cite).
+     * This used to post to `/sources`, which has never existed, so every
+     * pica_sync_placements_cite call answered 404.
+     */
     async addSource(id, source) {
-        return this.request("POST", `/admin/sync-placements/${id}/sources`, source);
+        return this.request("POST", `/admin/sync-placements/${id}/cite`, source);
     }
 }
 class WorkspaceResource extends BaseResource {
@@ -1256,9 +1287,24 @@ class AuditResource extends BaseResource {
     }
 }
 class MemoryResource extends BaseResource {
+    /**
+     * The FIRST page of memories only (newest first, the route's default page
+     * size) — since 2026-10-02 the route pages. Kept for existing callers; use
+     * `listPage` to reach the rest.
+     */
     async list() {
         return this.request("GET", "/admin/memory");
     }
+    /** One page of memories, most recently changed first, with the total. */
+    async listPage(params) {
+        const query = new URLSearchParams();
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.offset)
+            query.set("offset", String(params.offset));
+        const qs = query.toString();
+        return this.requestPaginated("GET", `/admin/memory${qs ? `?${qs}` : ""}`);
+    }
     async search(query) {
         return this.request("GET", `/admin/memory/search?q=${encodeURIComponent(query)}`);
     }
@@ -2708,8 +2754,12 @@ class AssetsResource extends BaseResource {
     async exportAll() {
         return this.request("GET", "/admin/assets/export");
     }
+    /**
+     * AI-assisted price estimate for the asset's make/model. The route is
+     * POST-only (it spends an AI call each time); this sent GET and got 405.
+     */
     async marketCheck(id) {
-        return this.request("GET", `/admin/assets/${id}/market-check`);
+        return this.request("POST", `/admin/assets/${id}/market-check`);
     }
     // --- Production-asset links (ADR-156 operating principle #3) ---
     // Typed edges between physical_assets and works/recordings, with
@@ -2806,6 +2856,24 @@ class ImportResource extends BaseResource {
             throw new Error(`Template fetch failed: ${response.status}`);
         return response.text();
     }
+    /**
+     * Emails that reached the organisation's forwarding address, newest first,
+     * with what PICA did with each (stored on arrival, waiting for review,
+     * dismissed, failed). Owners and admins only.
+     */
+    async listForwardedEmails(options) {
+        const params = new URLSearchParams();
+        if (options?.limit !== undefined)
+            params.set("limit", String(options.limit));
+        if (options?.offset !== undefined)
+            params.set("offset", String(options.offset));
+        const qs = params.toString();
+        return this.request("GET", `/admin/email-intake/forwarded${qs ? `?${qs}` : ""}`);
+    }
+    /** One forwarded email, with its text body when PICA kept one. */
+    async getForwardedEmail(id) {
+        return this.request("GET", `/admin/email-intake/forwarded/${encodeURIComponent(id)}`);
+    }
 }
 // --- Documents Resource ---
 class DocumentsResource extends BaseResource {
@@ -3343,6 +3411,22 @@ class RecordingSplitsResource extends BaseResource {
     async delete(recordingId, splitId) {
         return this.request("DELETE", `/admin/recordings/${recordingId}/splits/${splitId}`);
     }
+    /**
+     * Edit a split and keep the route's whole envelope: `data` is the row, and
+     * `previous` / `changed_fields` / `verification_cleared` sit beside it —
+     * `request()` would drop them. verification_cleared is true when the edit
+     * cleared the holder's confirmation.
+     */
+    async edit(recordingId, splitId, data) {
+        return this.requestWithEnvelope("PATCH", `/admin/recordings/${recordingId}/splits/${splitId}`, data);
+    }
+    /**
+     * End a split: sets end_date (default today) so it stops counting toward
+     * the 100% total; the row is kept. Same envelope as `edit`.
+     */
+    async end(recordingId, splitId, data = {}) {
+        return this.requestWithEnvelope("POST", `/admin/recordings/${recordingId}/splits/${splitId}/end`, data);
+    }
     async verify(recordingId, splitId) {
         return this.request("POST", `/admin/recordings/${recordingId}/splits/${splitId}/verify`);
     }
@@ -3424,6 +3508,36 @@ class PartyClaimsResource extends BaseResource {
         return (res?.data ?? []);
     }
 }
+/**
+ * Claim your profile: invite people to claim their profile (a preview
+ * unless `confirm`), and read where people stand.
+ */
+class ProfileClaimsResource extends BaseResource {
+    async invite(params) {
+        const res = await this.request("POST", "/admin/people/claim-invites", params);
+        if (res && typeof res === "object" && "data" in res && res.data) {
+            return res.data;
+        }
+        return (res ?? null);
+    }
+    async status(params) {
+        const q = new URLSearchParams();
+        for (const id of params?.person_ids ?? [])
+            q.append("person_id", id);
+        if (params?.state)
+            q.set("state", params.state);
+        if (params?.limit)
+            q.set("limit", String(params.limit));
+        const qs = q.toString();
+        const res = await this.request("GET", `/admin/profile-claims${qs ? `?${qs}` : ""}`);
+        const body = res;
+        const inner = body?.people ? body : body?.data;
+        return {
+            people: inner?.people ?? [],
+            truncated: inner?.truncated === true,
+        };
+    }
+}
 class ReleasesResource extends BaseResource {
     async list(params) {
         const parts = [];
@@ -3667,6 +3781,42 @@ class RightsResource extends BaseResource {
     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) {
@@ -4157,6 +4307,7 @@ export class PicaClient {
     publishers;
     labels;
     partyClaims;
+    profileClaims;
     agreementTemplates;
     producerAgreements;
     workForHire;
@@ -4275,6 +4426,7 @@ export class PicaClient {
         this.publishers = new PublishersResource(baseUrl, config.apiKey, debug);
         this.labels = new LabelsResource(baseUrl, config.apiKey, debug);
         this.partyClaims = new PartyClaimsResource(baseUrl, config.apiKey, debug);
+        this.profileClaims = new ProfileClaimsResource(baseUrl, config.apiKey, debug);
         this.agreementTemplates = new AgreementTemplatesResource(baseUrl, config.apiKey, debug);
         this.producerAgreements = new ProducerAgreementsResource(baseUrl, config.apiKey, debug);
         this.workForHire = new WorkForHireResource(baseUrl, config.apiKey, debug);