@withpica/mcp-server 2.97.4 → 2.98.0

package/dist/tools/approvals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAuB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA6DzE;;;;;OAKG;YACW,iBAAiB;CA2ChC"}
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAuB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAItE,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA6DzE;;;;;OAKG;YACW,iBAAiB;CAuDhC"}

package/dist/tools/approvals.js

@@ -12,6 +12,7 @@
  */
 import { EntityNotFoundError } from "@withpica/mcp-sdk";
 import { formatSuccess } from "@withpica/mcp-utils";
+import { applyArgAliases } from "./arg-aliases.js";
 export class ApprovalsTools {
     pica;
     constructor(pica) {
@@ -78,7 +79,19 @@ export class ApprovalsTools {
      * an unknown reference without crashing its loop.
      */
     async getApprovalStatus(args) {
-        const approvalId = typeof args.approval_id === "string" ? args.approval_id.trim() : "";
+        // The deferral envelope names this value `approval_reference`, so accept
+        // that spelling on a DIRECT call too. `pica_execute` applies the same
+        // alias before dispatch; resolving it here through the one alias table
+        // (`TOOL_ARG_ALIASES.pica_approval_status`) keeps direct and wrapped calls
+        // agreeing. Without it a direct `{approval_reference}` fell into the
+        // branch below and was answered `status: "not_found"` for an approval
+        // that exists. Pinned by `execute-approval-reference.test.ts`.
+        const { args: resolved } = applyArgAliases("pica_approval_status", args, [
+            "approval_id",
+        ]);
+        const approvalId = typeof resolved.approval_id === "string"
+            ? resolved.approval_id.trim()
+            : "";
         if (!approvalId) {
             // ⚠️ An agent lands here when a person points at the "N awaiting
             // approval" figure on /inspect and asks it to clear them. There is no

package/dist/tools/approvals.js.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D;;;;;;;;;;GAUG;AAEH,OAAO,EAAc,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,sBAAsB;oBAC5B,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;oBAC5B,IAAI,EAAE,MAAM;oBACZ,WAAW,EACT,mEAAmE;wBACnE,gEAAgE;wBAChE,kEAAkE;wBAClE,0DAA0D;wBAC1D,qEAAqE;wBACrE,qEAAqE;wBACrE,mCAAmC;oBACrC,SAAS,EAAE,gBAAgB;oBAC3B,eAAe,EAAE,YAAY;oBAC7B,iBAAiB,EACf,qHAAqH;oBACvH,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,WAAW,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,yGAAyG;6BAC5G;yBACF;wBACD,QAAQ,EAAE,CAAC,aAAa,CAAC;qBAC1B;oBACD,YAAY,EAAE;wBACZ,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,uEAAuE;6BAC1E;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,4DAA4D;6BAC/D;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,8EAA8E;6BACjF;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,4CAA4C;6BAC1D;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC5C;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,iBAAiB,CAC7B,IAAyB;QAEzB,yEAAyE;QACzE,sEAAsE;QACtE,uEAAuE;QACvE,2EAA2E;QAC3E,qEAAqE;QACrE,sEAAsE;QACtE,+DAA+D;QAC/D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,sBAAsB,EAAE,IAAI,EAAE;YACvE,aAAa;SACd,CAAC,CAAC;QACH,MAAM,UAAU,GACd,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ;YACtC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE;YAC7B,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,iEAAiE;YACjE,sEAAsE;YACtE,2DAA2D;YAC3D,iEAAiE;YACjE,wEAAwE;YACxE,4CAA4C;YAC5C,EAAE;YACF,yEAAyE;YACzE,yEAAyE;YACzE,4DAA4D;YAC5D,uEAAuE;YACvE,OAAO,aAAa,CAClB,kGAAkG,EAClG;gBACE,MAAM,EAAE,WAAW;gBACnB,GAAG,EAAE,4LAA4L;gBACjM,8BAA8B,EAC5B,wLAAwL;gBAC1L,aAAa,EACX,oJAAoJ;gBACtJ,cAAc,EAAE,KAAK;aACtB,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAC/D,OAAO,aAAa,CAAC,oBAAoB,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;gBACvC,OAAO,aAAa,CAAC,uCAAuC,EAAE;oBAC5D,MAAM,EAAE,WAAW;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/tools/arg-aliases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arg-aliases.d.ts","sourceRoot":"","sources":["../../src/tools/arg-aliases.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAc/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAanE,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,cAAc,CA0BhB"}
+{"version":3,"file":"arg-aliases.d.ts","sourceRoot":"","sources":["../../src/tools/arg-aliases.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAc/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBnE,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,cAAc,CA0BhB"}

package/dist/tools/arg-aliases.js

@@ -70,6 +70,18 @@ export const TOOL_ARG_ALIASES = {
         actionIds: "accept",
         action_ids: "accept",
     },
+    // A deferred write answers with a `human_approval_required` envelope that
+    // carries the id as `approval_reference` and names `pica_approval_status`
+    // as its `poll_tool` (`buildAgentResponse`, lib/services/human-approval-gate.ts)
+    // — but the poll tool's schema calls the same value `approval_id`. Agents
+    // copy the key they were just handed, so PICA's own two names for one value
+    // drew WRAPPED_ARGS_MISSING 10 times on prod, from Claude and ChatGPT alike
+    // (ops issue da9ba396, 2026-07-05 → 2026-09-28). Pinned end to end, against
+    // the real tool definition, by
+    // `src/__tests__/tools/execute-approval-reference.test.ts`.
+    pica_approval_status: {
+        approval_reference: "approval_id",
+    },
 };
 /**
  * Rename a tool's own id / explicit alias to the schema's real required

package/dist/tools/arg-aliases.js.map

@@ -1 +1 @@
-{"version":3,"file":"arg-aliases.js","sourceRoot":"","sources":["../../src/tools/arg-aliases.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsC;IAClE,KAAK,EAAE,CAAC,eAAe,EAAE,UAAU,EAAE,SAAS,CAAC;IAC/C,MAAM,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,QAAQ,EAAE,CAAC,YAAY,CAAC;IACxB,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,QAAQ,EAAE,CAAC,YAAY,CAAC;IACxB,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,QAAQ,EAAE,CAAC,YAAY,CAAC;IACxB,SAAS,EAAE,CAAC,aAAa,CAAC;IAC1B,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,MAAM,EAAE,CAAC,UAAU,CAAC;IACpB,UAAU,EAAE,CAAC,cAAc,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2C;IACtE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE;IACrD,4EAA4E;IAC5E,2EAA2E;IAC3E,yEAAyE;IACzE,0EAA0E;IAC1E,2EAA2E;IAC3E,0EAA0E;IAC1E,8CAA8C;IAC9C,uBAAuB,EAAE;QACvB,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,QAAQ;KACrB;CACF,CAAC;AAOF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,IAA6B,EAC7B,QAA2B;IAE3B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAwC,EAAE,CAAC;IACxD,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAEpD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,IAAI,MAAM;YAAE,SAAS,CAAC,oCAAoC;QAEnE,MAAM,UAAU,GACd,KAAK,KAAK,IAAI;YACZ,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;iBAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC;iBAChC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS,CAAC,qCAAqC;QAEzE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"arg-aliases.js","sourceRoot":"","sources":["../../src/tools/arg-aliases.ts"],"names":[],"mappings":"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"}

package/dist/tools/audio-files.d.ts

@@ -12,6 +12,44 @@ import { ToolDefinition, ToolExecutor } from "./index.js";
  * not exposed over MCP. See queryAudioFiles for the measurement.
  */
 export declare function toAudioListItem(row: unknown): Record<string, unknown>;
+/**
+ * The `identification` section of pica_audio_inspect — what ACRCloud said this
+ * file is. Built from the single-file GET, which already carries the
+ * audio_analysis_results satellite flattened onto the row (findById in
+ * lib/services/audio-files/queries.ts selects `audio_analysis_results(*)`), so
+ * the section costs no extra call.
+ *
+ * Before 2026-09-26 no read tool exposed these columns: the only way an agent
+ * saw a match was the full row echoed by pica_audio_update, which #2360
+ * slimmed — leaving them unreachable (ops issue 3cf19a67).
+ *
+ * Deliberately lean: each DSP entry keeps only track_id + link (artwork,
+ * preview URLs and artist genres are dropped), and the ACRCloud AI-detection
+ * payload is cut to its headline fields (the per-stem and per-generator
+ * probability arrays are left out). Values are copied as stored, never
+ * rescaled: `identification_confidence` is ACRCloud's match score as written
+ * (25-100 across prod rows on 2026-09-26). `ai_detection.confidence` is the
+ * AI probability on 0-100 (the AiDetectionAcrcloud type). Its prod values
+ * span 0.2-96.47, which looked like mixed scales, but read against the
+ * verdict on 2026-09-26 (723 rows, one model_id): every `ai_generated` row is
+ * ≥ 61.91 and every `human` row ≤ 47.71, and all 363 values ≤ 1 are `human`
+ * — one 0-100 scale, with human tracks scoring near zero. A file never run
+ * through ACRCloud reports `identification_status: null`.
+ */
+export declare function toIdentificationSection(file: unknown): Record<string, unknown>;
+/**
+ * The one-line summary of a matched pica_audio_identify.
+ *
+ * The route (app/api/admin/audio-files/[id]/identify) returns the service's
+ * IdentificationResult FLAT — `title`, `artist`, `confidence`,
+ * `externalIds.isrc[]` at the top level. Until 2026-09-26 this tool read a
+ * `result.match` object the route has never sent, so a real match never
+ * reached this branch; and it multiplied `confidence` by 100, which only a
+ * 0-1 score would need. ACRCloud's music score is 0-100 — every stored
+ * `audio_analysis_results.identification_confidence` on prod reads 25-100
+ * (2026-09-26) — so it is printed as-is.
+ */
+export declare function describeIdentifyMatch(result: unknown): string;
 export declare class AudioFilesTools {
     private pica;
     constructor(pica: PicaClient);
@@ -29,6 +67,7 @@ export declare class AudioFilesTools {
     private bulkAssignSuggested;
     private dismissMatch;
     private updateAudio;
+    private bulkUpdateAudio;
     private deleteAudioFile;
     private queryAudioFiles;
     private inspectAudioFile;

package/dist/tools/audio-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-files.d.ts","sourceRoot":"","sources":["../../src/tools/audio-files.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AA8CtE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQrE;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAmlB3D,WAAW;IAuCzB;;;;OAIG;YACW,eAAe;YA2Bf,mBAAmB;YAkCnB,YAAY;YAmBZ,WAAW;YA4CX,eAAe;YAgBf,eAAe;YA4Df,gBAAgB;YA6FhB,gBAAgB;YAchB,eAAe;YAyBf,cAAc;YAgDd,iBAAiB;IA2B/B;;;OAGG;YACW,mBAAmB;CAqClC"}
+{"version":3,"file":"audio-files.d.ts","sourceRoot":"","sources":["../../src/tools/audio-files.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAwDtE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQrE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAuB7D;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA8qB3D,WAAW;IA2CzB;;;;OAIG;YACW,eAAe;YA2Bf,mBAAmB;YAkCnB,YAAY;YAmBZ,WAAW;YA6CX,eAAe;YAyCf,eAAe;YAgBf,eAAe;YA6Df,gBAAgB;YAwGhB,gBAAgB;YAchB,eAAe;YAyBf,cAAc;YAgDd,iBAAiB;IAwB/B;;;OAGG;YACW,mBAAmB;CAqClC"}

package/dist/tools/audio-files.js

@@ -7,6 +7,15 @@ import { withBillingGate } from "@withpica/mcp-utils";
 // findUnassigned), so pageEnvelope's `limit` reflects what the server
 // actually applied even when the agent didn't pass one.
 const DEFAULT_AUDIO_QUERY_LIMIT = 50;
+/**
+ * Caps copied from the server so the schema advertises what the route
+ * enforces: `AUDIO_QUERY_MAX_WORK_IDS` in lib/services/audio-files/urls.ts and
+ * `AUDIO_BULK_UPDATE_MAX_ITEMS` in lib/services/audio-files/bulk-update.ts.
+ * Hand-copied (this package cannot import the app); no test ties them —
+ * change both together.
+ */
+const AUDIO_QUERY_MAX_WORK_IDS = 100;
+const AUDIO_BULK_UPDATE_MAX_ITEMS = 200;
 /** Fields a LIST row carries. Everything else is pica_audio_inspect's. */
 const AUDIO_LIST_FIELDS = [
     "id",
@@ -53,6 +62,107 @@ export function toAudioListItem(row) {
     }
     return out;
 }
+/**
+ * The `identification` section of pica_audio_inspect — what ACRCloud said this
+ * file is. Built from the single-file GET, which already carries the
+ * audio_analysis_results satellite flattened onto the row (findById in
+ * lib/services/audio-files/queries.ts selects `audio_analysis_results(*)`), so
+ * the section costs no extra call.
+ *
+ * Before 2026-09-26 no read tool exposed these columns: the only way an agent
+ * saw a match was the full row echoed by pica_audio_update, which #2360
+ * slimmed — leaving them unreachable (ops issue 3cf19a67).
+ *
+ * Deliberately lean: each DSP entry keeps only track_id + link (artwork,
+ * preview URLs and artist genres are dropped), and the ACRCloud AI-detection
+ * payload is cut to its headline fields (the per-stem and per-generator
+ * probability arrays are left out). Values are copied as stored, never
+ * rescaled: `identification_confidence` is ACRCloud's match score as written
+ * (25-100 across prod rows on 2026-09-26). `ai_detection.confidence` is the
+ * AI probability on 0-100 (the AiDetectionAcrcloud type). Its prod values
+ * span 0.2-96.47, which looked like mixed scales, but read against the
+ * verdict on 2026-09-26 (723 rows, one model_id): every `ai_generated` row is
+ * ≥ 61.91 and every `human` row ≤ 47.71, and all 363 values ≤ 1 are `human`
+ * — one 0-100 scale, with human tracks scoring near zero. A file never run
+ * through ACRCloud reports `identification_status: null`.
+ */
+export function toIdentificationSection(file) {
+    const src = file && typeof file === "object" ? file : {};
+    const asObject = (v) => v && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : null;
+    const strings = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+    const field = (k) => src[k] ?? null;
+    const externalIds = asObject(src.identification_external_ids) ?? {};
+    const dspRaw = asObject(src.identification_dsp_ids);
+    let dspIds = null;
+    if (dspRaw) {
+        dspIds = {};
+        for (const [platform, entry] of Object.entries(dspRaw)) {
+            const e = asObject(entry);
+            if (!e)
+                continue;
+            dspIds[platform] = { track_id: e.track_id ?? null, link: e.link ?? null };
+        }
+    }
+    const ai = asObject(src.ai_detection_acrcloud);
+    const aiDetection = ai
+        ? {
+            is_ai_generated: ai.is_ai_generated ?? null,
+            confidence: ai.confidence ?? null,
+            likely_source: ai.likely_source ?? null,
+            model_id: ai.model_id ?? null,
+        }
+        : null;
+    return {
+        identification_status: field("identification_status"),
+        identification_source: field("identification_source"),
+        identification_completed_at: field("identification_completed_at"),
+        confidence: field("identification_confidence"),
+        acrid: field("acrid"),
+        identified_title: field("identified_title"),
+        identified_artist: field("identified_artist"),
+        identified_album: field("identified_album"),
+        identified_label: field("identified_label"),
+        identified_release_date: field("identified_release_date"),
+        isrc: strings(externalIds.isrc),
+        upc: strings(externalIds.upc),
+        iswc: strings(externalIds.iswc),
+        dsp_ids: dspIds,
+        ai_detection: aiDetection,
+    };
+}
+/**
+ * The one-line summary of a matched pica_audio_identify.
+ *
+ * The route (app/api/admin/audio-files/[id]/identify) returns the service's
+ * IdentificationResult FLAT — `title`, `artist`, `confidence`,
+ * `externalIds.isrc[]` at the top level. Until 2026-09-26 this tool read a
+ * `result.match` object the route has never sent, so a real match never
+ * reached this branch; and it multiplied `confidence` by 100, which only a
+ * 0-1 score would need. ACRCloud's music score is 0-100 — every stored
+ * `audio_analysis_results.identification_confidence` on prod reads 25-100
+ * (2026-09-26) — so it is printed as-is.
+ */
+export function describeIdentifyMatch(result) {
+    const r = result && typeof result === "object"
+        ? result
+        : {};
+    const ext = r.externalIds && typeof r.externalIds === "object"
+        ? r.externalIds
+        : {};
+    const isrcs = Array.isArray(ext.isrc)
+        ? ext.isrc.filter((x) => typeof x === "string")
+        : [];
+    const confidence = typeof r.confidence === "number"
+        ? `${Math.round(r.confidence)}/100`
+        : "not reported";
+    const title = typeof r.title === "string" ? r.title : "untitled";
+    const artist = typeof r.artist === "string" ? r.artist : "unknown artist";
+    return (`Match found: "${title}" by ${artist} (ACRCloud score ${confidence}). ` +
+        `ISRC: ${isrcs.length ? isrcs.join(", ") : "none returned"}. ` +
+        "If the file is linked to a work, metadata has been propagated.");
+}
 export class AudioFilesTools {
     pica;
     constructor(pica) {
@@ -66,7 +176,7 @@ export class AudioFilesTools {
                     scope: "read:files",
                     audiences: ["stdio", "http", "public"],
                     tier: "read",
-                    description: "Find audio files — filter by name/title (`query`), work, file type, or analysis status. " +
+                    description: "Find audio files — filter by name/title (`query`), work (`work_id`, or `work_ids` for several at once), file type, or analysis status. " +
                         "Rows are a LEAN list shape (identity, size, duration, bpm/key/energy/mood, links, bucket). For one file, pica_audio_inspect adds sample rate, bit depth, danceability (sections: ['analysis']) and the waveform (sections: ['waveform']); the raw `metadata` jsonb, storage path and CDN URL are storage internals not exposed over MCP. " +
                         "→ then: pica_audio_inspect (details for a specific file), " +
                         "pica_audio_assign (attach an unassigned file to a work/recording). " +
@@ -81,6 +191,12 @@ export class AudioFilesTools {
                                 type: "string",
                                 description: "Filter by work ID to get all audio files for a specific work",
                             },
+                            work_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                maxItems: AUDIO_QUERY_MAX_WORK_IDS,
+                                description: `Audio for several works in ONE call (up to ${AUDIO_QUERY_MAX_WORK_IDS} work UUIDs) — e.g. every song in a playlist. Includes files attached through a recording of those works. Pages with limit/offset like the rest of the list; combine with file_type (e.g. 'master') to narrow to that kind of file.`,
+                            },
                             file_type: {
                                 type: "string",
                                 description: "Filter by file type",
@@ -119,7 +235,10 @@ export class AudioFilesTools {
                     tier: "read",
                     description: "Get details for a specific audio file, including its stored " +
                         'transcript (sections: ["transcript"]) even when the file is not ' +
-                        "linked to any work. Omit sections for everything. " +
+                        "linked to any work, and what ACRCloud identified it as " +
+                        '(sections: ["identification"] — status, matched title/artist/' +
+                        "album/label, ISRC/UPC, DSP ids, confidence, AI-detection " +
+                        "summary). Omit sections for everything. " +
                         "→ then: pica_audio_analyze (run analysis), pica_audio_identify (fingerprint match), " +
                         "pica_audio_assign (link an orphaned file to its work)",
                     workflows: ["audio-upload-required"],
@@ -142,13 +261,16 @@ export class AudioFilesTools {
                                         "waveform",
                                         "status",
                                         "transcript",
+                                        "identification",
                                     ],
                                 },
                                 description: "Which data sections to include. Omit for all sections. " +
                                     "`transcript` returns the stored speech-to-text transcript " +
                                     "for this file whether or not it is linked to a work — the " +
                                     "only way to read one that has not been copied onto a work's " +
-                                    "lyrics.",
+                                    "lyrics. `identification` returns the stored ACRCloud " +
+                                    "result; identification_status null means the file was " +
+                                    "never identified (run pica_audio_identify).",
                             },
                         },
                         required: ["id"],
@@ -240,7 +362,8 @@ export class AudioFilesTools {
                             },
                             file_size: {
                                 type: "number",
-                                description: "File size in bytes",
+                                minimum: 1,
+                                description: "Exact file size in bytes (> 0). Never send 0 or a guess — if you cannot read the file, you cannot upload it from here; send the user to withpica.com/inspect.",
                             },
                             work_id: {
                                 type: "string",
@@ -252,7 +375,7 @@ export class AudioFilesTools {
                             },
                             file_type: {
                                 type: "string",
-                                description: "Type of audio file (default: 'master')",
+                                description: "Type of audio file. Set it when you know it. If omitted, PICA reads the filename (instrumental / -inst / karaoke / playback / -pa → instrumental; stem(s) → stem; demo → demo; remix / radio edit / (live) / acoustic → version); with no signal in the name it stays 'master'.",
                                 enum: ["master", "instrumental", "stem", "demo", "version"],
                             },
                         },
@@ -310,7 +433,7 @@ export class AudioFilesTools {
                             },
                             file_type: {
                                 type: "string",
-                                description: "Type of audio file (default: 'master')",
+                                description: "Type of audio file. Set it when you know it. If omitted, PICA reads the filename (instrumental / -inst / karaoke / playback / -pa → instrumental; stem(s) → stem; demo → demo; remix / radio edit / (live) / acoustic → version); with no signal in the name it stays 'master'.",
                                 enum: ["master", "instrumental", "stem", "demo", "version"],
                             },
                             stem_label: {
@@ -582,6 +705,76 @@ export class AudioFilesTools {
                 },
                 executor: this.updateAudio.bind(this),
             },
+            {
+                definition: {
+                    name: "pica_audio_bulk_update",
+                    scope: "write:files",
+                    audiences: ["stdio", "http", "public"],
+                    tier: "write",
+                    description: `Update metadata on up to ${AUDIO_BULK_UPDATE_MAX_ITEMS} audio files in ONE call — each item sets any of ` +
+                        "file_type (master/instrumental/stem/demo/version), stem_label, version_label, title for one file id. " +
+                        "Use instead of looping pica_audio_update, e.g. to tag every file in a playlist as master or label a " +
+                        "set of stems. Only this organisation's files are touched. Returns one lean result per item — " +
+                        "updated, or failed with a reason (unknown id, bad file_type, nothing to set) — and never the file " +
+                        "rows; a bad item does not stop the others. To attach files to a work/recording use pica_audio_assign. " +
+                        "Reversible (update again). Pass dry_run:true to preview.",
+                    workflows: "infrastructure",
+                    vernacular_kind: "specialist",
+                    vernacular_reason: "Specialist catalog-metadata action in the audio management flow, outside the Creator Question Atlas.",
+                    annotations: { title: "bulk update audio" },
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            items: {
+                                type: "array",
+                                minItems: 1,
+                                maxItems: AUDIO_BULK_UPDATE_MAX_ITEMS,
+                                description: `One entry per audio file (max ${AUDIO_BULK_UPDATE_MAX_ITEMS}). Each needs id plus at least one field to set.`,
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        id: {
+                                            type: "string",
+                                            description: "the audio file to update",
+                                        },
+                                        file_type: {
+                                            type: "string",
+                                            enum: [
+                                                "master",
+                                                "instrumental",
+                                                "stem",
+                                                "demo",
+                                                "version",
+                                            ],
+                                            description: "set the file type",
+                                        },
+                                        stem_label: {
+                                            type: "string",
+                                            description: "label for a stem (e.g. 'drums'); pass an empty string to clear",
+                                        },
+                                        version_label: {
+                                            type: "string",
+                                            description: "label for a version (e.g. 'radio edit'); pass an empty string to clear",
+                                        },
+                                        title: {
+                                            type: "string",
+                                            description: "set the audio file's title",
+                                        },
+                                    },
+                                    required: ["id"],
+                                },
+                            },
+                            dry_run: {
+                                type: "boolean",
+                                description: "When true, validates every item and checks each id exists in this organisation, returning would_update / failed per item without writing anything.",
+                            },
+                        },
+                        required: ["items"],
+                    },
+                    previewMode: "dry_run",
+                },
+                executor: this.bulkUpdateAudio.bind(this),
+            },
         ];
     }
     async assignAudio(args) {
@@ -604,7 +797,11 @@ export class AudioFilesTools {
                 work_id: args.work_id,
                 recording_id: args.recording_id,
             });
-            return formatSuccess("Audio assigned", updated);
+            // The route returns the full row — waveform_data and the flattened
+            // analysis satellite, ~8k tokens a file (ops issue 5c53049a). An agent
+            // needs to see the link it made, not the waveform: project to the same
+            // lean shape a pica_audio_query row has.
+            return formatSuccess("Audio assigned", toAudioListItem(updated));
         }
         catch (err) {
             // resolve-any-ID recovery (WS5 tail): agents holding a bare id often
@@ -697,7 +894,42 @@ export class AudioFilesTools {
         // via the parent repo's node_modules (stale dist). CI builds the SDK fresh.
         const audioFiles = this.pica.audioFiles;
         const updated = await audioFiles.update(args.id, body);
-        return formatSuccess("Audio updated", updated);
+        // Lean row, not the full record — see assignAudio (ops issue 5c53049a).
+        return formatSuccess("Audio updated", toAudioListItem(updated));
+    }
+    async bulkUpdateAudio(args) {
+        const items = args.items;
+        if (!Array.isArray(items) || items.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "items must be a non-empty array of { id, file_type?, stem_label?, version_label?, title? }",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (items.length > AUDIO_BULK_UPDATE_MAX_ITEMS) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `at most ${AUDIO_BULK_UPDATE_MAX_ITEMS} items per call (got ${items.length}) — split the batch`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const dryRun = args.dry_run === true;
+        const result = await this.pica.audioFiles.bulkUpdate(items, dryRun ? { dry_run: true } : undefined);
+        const verb = dryRun ? "Would update" : "Updated";
+        const summary = `${verb} ${result.updated} of ${result.requested} audio file${result.requested === 1 ? "" : "s"}` +
+            (result.failed > 0
+                ? ` — ${result.failed} failed (see results[].reason).`
+                : ".") +
+            (dryRun ? " Nothing was written — re-run without dry_run to apply." : "");
+        return formatSuccess(summary, result);
     }
     async deleteAudioFile(args) {
         // AudioFilesResource.delete is added in this change's SDK update. In an
@@ -713,6 +945,7 @@ export class AudioFilesTools {
     async queryAudioFiles(args) {
         const raw = await this.pica.audioFiles.list({
             work_id: args.work_id,
+            work_ids: Array.isArray(args.work_ids) ? args.work_ids : undefined,
             file_type: args.file_type,
             unprocessed: args.unprocessed,
             unassigned: args.unassigned,
@@ -773,10 +1006,18 @@ export class AudioFilesTools {
         const includeWaveform = !!sections && sections.includes("waveform");
         const includeStatus = includeAll || sections.includes("status");
         const includeTranscript = includeAll || sections.includes("transcript");
+        const includeIdentification = includeAll || sections.includes("identification");
         const result = {};
-        // Fetch basic + analysis data from get (they come together)
-        if (includeBasic || includeAnalysis || includeWaveform) {
+        // Basic, analysis, waveform and identification all come from one get —
+        // the route flattens the analysis satellite onto the row.
+        if (includeBasic ||
+            includeAnalysis ||
+            includeWaveform ||
+            includeIdentification) {
             const file = await this.pica.audioFiles.get(args.id);
+            if (includeIdentification) {
+                result.identification = toIdentificationSection(file);
+            }
             if (includeWaveform) {
                 result.waveform = {
                     waveform_data: file.waveform_data ??
@@ -916,8 +1157,8 @@ export class AudioFilesTools {
         if (result.alreadyIdentified) {
             return formatSuccess("Already identified — no credits charged. Use force: true to re-identify.", result);
         }
-        else if (result.status === "matched" && result.match) {
-            return formatSuccess(`Match found: "${result.match.title}" by ${result.match.artist} (confidence: ${Math.round((result.match.confidence || 0) * 100)}%). ISRC: ${result.match.isrc || "unknown"}. If the file is linked to a work, metadata has been propagated.`, result);
+        else if (result.status === "matched") {
+            return formatSuccess(describeIdentifyMatch(result), result);
         }
         else if (result.status === "no_match") {
             return formatSuccess("No match found in ACRCloud database. This may be an unreleased or very rare track.", result);