@withpica/mcp-sdk 3.25.0 → 3.26.0

package/CHANGELOG.md

@@ -11,6 +11,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.26.0] - 2026-10-17
+
+### Added
+
+- `credits.listRowsForWork(workId)` → `WorkCreditRows`: every credit row on a work, one entry per row
+  with its own `id`, its `role`, its `grain` (`composition` = songwriting, `master` = recording) and,
+  for a master credit, its `recording_id`; plus `count` (rows) and `people_count` (distinct people).
+  Reads `GET /admin/works/{id}/credits?view=rows`. `listForWork` still groups per person.
+
 ## [3.25.0] - 2026-10-14
 
 > **Publish order:** `asideFromReport` is imported as a value by

package/dist/index.d.ts

@@ -402,6 +402,30 @@ interface WorkCredit {
     split_status?: string;
     is_owner?: boolean;
 }
+/** One credit row on a work, from GET /admin/works/:id/credits?view=rows. */
+export interface WorkCreditRow {
+    /** The row's own id: work_collaborators.id or recording_credits.id. */
+    id: string;
+    /** "composition" = songwriting (work_collaborators), "master" = recording (recording_credits). */
+    grain: "composition" | "master";
+    person_id: string;
+    person_name: string;
+    ipi: string | null;
+    role: string;
+    split_percentage: number | null;
+    /** Set for a master credit: the recording it is on. */
+    recording_id: string | null;
+    is_primary: boolean | null;
+    notes: string | null;
+    attestation_status: string | null;
+}
+export interface WorkCreditRows {
+    credits: WorkCreditRow[];
+    /** Number of credit rows. */
+    count: number;
+    /** Number of distinct people among them. */
+    people_count: number;
+}
 interface WorkCreditsInput {
     credits: Array<{
         person_id: string;
@@ -919,9 +943,10 @@ export declare function currentCatalogue(): string | undefined;
 /**
  * Run `fn` in the current client catalogue (its requests still name it), but
  * leave its requests off the current call's report: for a check PICA makes
- * for itself (the billing gate reading the client's plan), which must not
- * read as the tool's own work having been answered (the MCP server judges a
- * call "every part refused" by that report).
+ * for itself, which must not read as the tool's own work having been
+ * answered (the MCP server judges a call "every part refused" by that
+ * report). No caller since the MCP billing gate was retired (ADR-335); kept
+ * because it is part of the published SDK.
  */
 export declare function asideFromReport<T>(fn: () => Promise<T>): Promise<T>;
 export declare class CatalogueNotHonouredError extends ApiError {
@@ -1578,6 +1603,11 @@ export interface AtomicCreditResult {
 }
 declare class CreditsResource extends BaseResource {
     listForWork(workId: string): Promise<WorkCredit[]>;
+    /**
+     * Every credit row on a work, composition and master, one entry per row
+     * with its own id (listForWork groups per person and keeps one id).
+     */
+    listRowsForWork(workId: string): Promise<WorkCreditRows>;
     updateForWork(workId: string, credits: WorkCreditsInput): Promise<WorkCredit[]>;
     listCollaborators(workId: string): Promise<WorkCredit[]>;
     updateCollaborators(workId: string, collaborators: WorkCreditsInput): Promise<WorkCredit[]>;