@withpica/mcp-sdk 3.14.0 → 3.16.0

package/dist/index.js

@@ -391,6 +391,8 @@ class WorksResource extends BaseResource {
             qp.set("has_iswc", String(params.has_iswc));
         if (params.has_publisher !== undefined)
             qp.set("has_publisher", String(params.has_publisher));
+        if (params.has_lyrics !== undefined)
+            qp.set("has_lyrics", String(params.has_lyrics));
         const qs = qp.toString();
         return this.requestPaginated("GET", `/admin/works${qs ? `?${qs}` : ""}`);
     }
@@ -876,6 +878,18 @@ class AudioFilesResource extends BaseResource {
     async get(id) {
         return this.request("GET", `/admin/audio-files/${id}`);
     }
+    /**
+     * The stored Whisper transcript for one audio file, linked to a work or not.
+     *
+     * Until 2026-09-07 a transcript was readable only as `works.lyrics` after
+     * propagation, so a transcript on an unlinked file had no reader at all —
+     * 218 of 558 on prod. `has_transcript: false` is a normal answer, not an
+     * error, and `reaches_work` says whether this transcript can be seen
+     * anywhere else.
+     */
+    async getTranscript(id) {
+        return this.request("GET", `/admin/audio-files/${id}/transcript`);
+    }
     /**
      * Attach ALL orphan audio files whose suggested match is ISRC-high and
      * non-ambiguous, in one call. Pairings are recomputed server-side at
@@ -1747,6 +1761,8 @@ class HealthResource extends BaseResource {
     /**
      * ADR-273 — apply accepted fix actions from a prior plan. Requires planToken
      * from catalogHealthPlan; accept is a list of actionIds (or "all_safe_auto").
+     * `selections` carries the human choice a resolve_person action needs
+     * ({ actionId, chosenPersonId }); a selection also accepts its action.
      * Returns honest per-action met/unmet plus a fresh verdict.
      */
     async catalogHealthFix(body) {
@@ -3630,6 +3646,46 @@ class StatementsResource extends BaseResource {
         return this.request("POST", "/admin/statements/ingest-agent", payload);
     }
 }
+class SelectionsResource extends BaseResource {
+    async list(params) {
+        const qp = new URLSearchParams();
+        if (params?.limit !== undefined)
+            qp.set("limit", String(params.limit));
+        if (params?.offset !== undefined)
+            qp.set("offset", String(params.offset));
+        const qs = qp.toString();
+        const result = await this.request("GET", `/admin/selections${qs ? `?${qs}` : ""}`);
+        return result.selections;
+    }
+    async create(data) {
+        const result = await this.request("POST", "/admin/selections", data);
+        return result.selection;
+    }
+    /**
+     * Per-id read. `resolve: true` also resolves the predicate — the route
+     * returns `{ selection, resolution }` instead of `{ selection }`, and
+     * `resolution` is omitted below when the caller didn't ask for it.
+     */
+    async inspect(id, opts) {
+        const qp = new URLSearchParams();
+        if (opts?.resolve)
+            qp.set("resolve", "true");
+        if (opts?.limit !== undefined)
+            qp.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            qp.set("offset", String(opts.offset));
+        const qs = qp.toString();
+        const result = await this.request("GET", `/admin/selections/${id}${qs ? `?${qs}` : ""}`);
+        return { selection: result.selection, resolution: result.resolution };
+    }
+    async update(id, data) {
+        const result = await this.request("PATCH", `/admin/selections/${id}`, data);
+        return result.selection;
+    }
+    async delete(id) {
+        await this.request("DELETE", `/admin/selections/${id}`);
+    }
+}
 class ShareLinksResource extends BaseResource {
     async list(params) {
         const qp = new URLSearchParams();
@@ -3962,6 +4018,8 @@ export class PicaClient {
     workForHire;
     royalties;
     statements;
+    /** ADR-319 — saved catalog selections. */
+    selections;
     shareLinks;
     consent;
     custody;
@@ -4076,6 +4134,7 @@ export class PicaClient {
         this.workForHire = new WorkForHireResource(baseUrl, config.apiKey, debug);
         this.royalties = new RoyaltiesResource(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);
         this.consent = new ConsentResource(baseUrl, config.apiKey, debug);
         this.custody = new CustodyResource(baseUrl, config.apiKey, debug);