@withpica/mcp-sdk 4.2.0 → 4.4.0

package/CHANGELOG.md

@@ -11,6 +11,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.4.0] - 2026-11-03
+
+### Added
+
+- Profile claim invite outcomes carry `address_bounced?: boolean`: true when the invite was made but the email did not go out because the address bounced before.
+- `works.search({ has_audio })`: filter works by whether audio is attached to the work or one of its recordings.
+
+## [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

@@ -1135,6 +1135,8 @@ declare class WorksResource extends BaseResource {
          * (works.lyrics; blank counts as lacking).
          */
         has_lyrics?: boolean;
+        /** Audio on the work or one of its recordings. */
+        has_audio?: boolean;
     }): Promise<PaginatedResult<Work>>;
     /**
      * The agreements linked to ONE work (GET /admin/works/:id/agreements).
@@ -3773,8 +3775,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>;
@@ -5249,6 +5271,11 @@ export interface ProfileClaimInviteOutcome {
     outcome: "invited" | "would_invite" | "skipped" | "failed";
     /** invited: "sent" | "held" (waiting for approval) | "failed". */
     send_status?: string;
+    /**
+     * invited: true when the email failed because this address bounced
+     * before. Inviting again can't reach it until the address changes.
+     */
+    address_bounced?: boolean;
     /** would_invite: the address the invite would go to. */
     email?: string;
     /** skipped: why (PERSON_HAS_NO_EMAIL, ALREADY_INVITED, ...). */