@withpica/mcp-sdk 4.2.0 → 4.3.0

package/CHANGELOG.md

@@ -11,6 +11,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.3.0] - 2026-11-02
+
+### Added
+
+- `bulk.updateWorksWithResult(workIds, updates)`: a works bulk update's whole answer,
+  `{ data, count, refused, message? }`. `refused` lists the works not updated, each
+  `{ id, code, error }` (`status_move_not_allowed`, `not_found` or `not_updated`).
+  `bulk.updateWorks` is unchanged: it still returns only the updated works, which is why it
+  could not say which were refused. Backs `pica_works_bulk_update` in `@withpica/mcp-server`
+  2.115.0.
+
 ## [4.2.0] - 2026-10-31
 
 ### Added

package/dist/index.d.ts

@@ -3773,8 +3773,28 @@ declare class AnalyticsResource extends BaseResource {
     provenanceCertificateGet(workId: string): Promise<any>;
     catalogDiligence(): Promise<any>;
 }
+/** A works bulk update's whole answer (POST /admin/works/bulk-update). */
+export interface WorksBulkUpdateResult {
+    /** The works updated. */
+    data: unknown[];
+    /** How many were updated. */
+    count: number;
+    /** The works not updated, each with why (e.g. a refused status move). */
+    refused: Array<{
+        id: string;
+        code: string;
+        error: string;
+    }>;
+    message?: string;
+}
 declare class BulkResource extends BaseResource {
     updateWorks(workIds: string[], updates: Record<string, any>): Promise<any>;
+    /**
+     * Like updateWorks, but the whole answer: updateWorks returns only the
+     * updated works (`request()` narrows to `.data`), which drops `count` and
+     * `refused`, so a caller can't tell which works were not updated.
+     */
+    updateWorksWithResult(workIds: string[], updates: Record<string, any>): Promise<WorksBulkUpdateResult>;
     updatePeopleRoles(personIds: string[], roles: string[], action?: string): Promise<any>;
     addPeopleTags(personIds: string[], tags: string[]): Promise<unknown>;
     linkArtist(workIds: string[], personId: string, artistName: string, dryRun?: boolean): Promise<unknown>;