@withpica/mcp-sdk 3.19.0 → 3.20.0

package/dist/index.js

@@ -882,6 +882,8 @@ class AudioFilesResource extends BaseResource {
         const queryParams = new URLSearchParams();
         if (params?.work_id)
             queryParams.set("work_id", params.work_id);
+        if (params?.work_ids && params.work_ids.length > 0)
+            queryParams.set("work_ids", params.work_ids.join(","));
         if (params?.file_type)
             queryParams.set("file_type", params.file_type);
         if (params?.unprocessed)
@@ -942,6 +944,15 @@ class AudioFilesResource extends BaseResource {
     async update(id, body) {
         return this.request("PATCH", `/admin/audio-files/${id}`, body);
     }
+    /**
+     * Per-file metadata patches for up to 200 files in one request (ops issue
+     * 5c53049a). Returns one lean result per item — `updated`, `would_update`
+     * (dry run) or `failed` with a reason — never the rows. Wraps
+     * POST /admin/audio-files/bulk-update.
+     */
+    async bulkUpdate(items, params) {
+        return this.request("POST", "/admin/audio-files/bulk-update", { items, ...(params?.dry_run ? { dry_run: true } : {}) });
+    }
     async analyze(id, options) {
         return this.request("POST", `/admin/audio-files/${id}/analyze`, options);
     }
@@ -1743,6 +1754,43 @@ class HealthResource extends BaseResource {
     async getLowScoreWorks() {
         return this.request("GET", "/admin/quality/completeness/low-score");
     }
+    /**
+     * One page of works below a completeness threshold, with the route's
+     * `meta` (true `total` below the threshold, `has_more`). Backs
+     * `pica_works_query {health_filter: "low_completeness"}` — the bare
+     * `getLowScoreWorks()` above sends no limit/offset, so the tool used to
+     * ignore both (ops issue 314325eb).
+     */
+    async getLowScoreWorksPage(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));
+        if (params.threshold !== undefined)
+            qp.set("threshold", String(params.threshold));
+        const qs = qp.toString();
+        const env = await this.requestWithEnvelope("GET", `/admin/quality/completeness/low-score${qs ? `?${qs}` : ""}`);
+        return { data: Array.isArray(env.data) ? env.data : [], meta: env.meta };
+    }
+    /**
+     * One page of the cross-org reconciliation scan, with the route's `meta`
+     * (`scanned`, `candidates_total`, `next_offset`). `offset`/`limit` page the
+     * candidate works, not the returned rows — see the route. Backs
+     * `pica_works_query {health_filter: "needs_attention"}`.
+     */
+    async getWorksHealthPage(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));
+        if (params.unreconciledOnly)
+            qp.set("unreconciledOnly", "true");
+        const qs = qp.toString();
+        const env = await this.requestWithEnvelope("GET", `/admin/quality/works-health${qs ? `?${qs}` : ""}`);
+        return { data: Array.isArray(env.data) ? env.data : [], meta: env.meta };
+    }
     async getWorkCompleteness(workId) {
         return this.request("GET", `/admin/quality/completeness/${workId}`);
     }
@@ -3630,6 +3678,26 @@ class RoyaltiesResource extends BaseResource {
         const qs = qp.toString();
         return this.request("GET", `/admin/royalties/gaps${qs ? `?${qs}` : ""}`);
     }
+    /**
+     * ADR-321 Phase 0 — what in one song's record is likely holding up its
+     * society income. `state` is "clear" only when every area was checked;
+     * `unchecked` lists areas that could not be.
+     */
+    async blockers(workId) {
+        return this.request("GET", `/admin/works/${encodeURIComponent(workId)}/money-blockers`);
+    }
+    /** ADR-321 Phase 0 — the catalogue roll-up: summary + songs not clear, paged. */
+    async blockersCatalogue(params) {
+        const qp = new URLSearchParams();
+        if (params?.code)
+            qp.set("code", params.code);
+        if (params?.limit !== undefined)
+            qp.set("limit", String(params.limit));
+        if (params?.offset !== undefined)
+            qp.set("offset", String(params.offset));
+        const qs = qp.toString();
+        return this.request("GET", `/admin/money-blockers${qs ? `?${qs}` : ""}`);
+    }
     async stats() {
         return this.request("GET", "/admin/royalties/stats");
     }