@withpica/mcp-sdk 3.18.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}`);
     }
@@ -1899,11 +1947,11 @@ class SettingsResource extends BaseResource {
      * the auth context — `user_id` is never accepted (ADR-184 rule 2).
      *
      * The route lazy-creates the backing `people` row if the user's
-     * `user_profiles.person_id` is null, then fires
-     * `crossLinkOnIdentifierUpdate` so newly-visible cross-org credits
-     * appear on the next `pica_discoveries_query`. Response includes the
-     * count of new discoveries in each of the 3 typed tables so the
-     * agent can surface "found N more…" in the same conversation.
+     * `user_profiles.person_id` is null. Identifiers are saved on that record
+     * only; this call triggers no cross-org linking (a typed IPI is not
+     * evidence).
+     * Response includes the count of discoveries written in each of the 3
+     * typed tables in the last 10 seconds.
      * ADR-189 Phase 3.
      */
     async updateMyIdentity(params) {
@@ -2523,6 +2571,16 @@ class ExportResource extends BaseResource {
     async catalogAssetReport(params) {
         return this.request("POST", "/admin/exports/catalog-asset-report", params);
     }
+    /**
+     * One ZIP holding the song dossier (PDF + JSON) of each work named — the
+     * work, its recordings, the releases they appear on, people, provenance and
+     * consent — plus a manifest and README. Returns a signed-URL JSON envelope
+     * with a per-work `works[]` account of what was included. 1–60 work ids;
+     * a malformed id or a longer list is refused with a 400.
+     */
+    async songDossiers(params) {
+        return this.request("POST", "/admin/exports/song-dossiers", params);
+    }
     async aiConsent(params) {
         // Returns a signed-URL JSON envelope. The inline `?format=json`
         // path stays the default for the SDK; the route also returns the
@@ -3620,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");
     }