@withpica/mcp-sdk 4.5.0 → 4.6.1

package/CHANGELOG.md

@@ -11,6 +11,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.6.1] - 2026-11-06
+
+### Changed
+
+- **`credits.updateForWork` / `credits.updateCollaborators` accept `splits: null`** (ADR-355
+  D4): a share that is not known is sent as null and stored as unknown, never as 0%. Type
+  widening only; a number still works as before.
+
+## [4.6.0] - 2026-11-06
+
+### Added
+
+- `exampleSong.get()` reads PICA's fixed example song (`GET /api/example-song`).
+- `ImportAnalysis.analysis` declares the optional `warnings`, `confidence`, `detectedDomain` and `estimatedSuccessRate` fields the analyse route already returns.
+
 ## [4.5.0] - 2026-11-04
 
 ### Added

package/dist/index.d.ts

@@ -437,7 +437,8 @@ interface WorkCreditsInput {
     credits: Array<{
         person_id: string;
         role: string;
-        splits: number;
+        /** 0-100; null when the share is not known (ADR-355 D4), never sent as 0. */
+        splits: number | null;
     }>;
 }
 interface PicaScorePillar {
@@ -1685,11 +1686,10 @@ declare class CreditsResource extends BaseResource {
      */
     atomicUpdate(workId: string, creditId: string, patch: WorkCreditAtomicUpdateInput): Promise<AtomicCreditUpdateResult>;
     /**
-     * Send pending credits on a work to their recipients for attestation.
-     * Lightweight alternative to pica_split_sheet_send — fans out the
-     * notification rails (in-app + telegram + email) without generating
-     * a formal split-sheet document. Recipients click through to
-     * confirm/dispute; this call only sends the prompt.
+     * Ask the people on a work's pending credits to confirm their part: one
+     * email per person, through the one "ask [name] to confirm" (ADR-355 C2),
+     * without generating a formal split-sheet document. Recipients confirm
+     * signed in from the email's link; this call only sends the ask.
      */
     sendForAttestation(workId: string, input?: {
         credit_ids?: string[];
@@ -3222,6 +3222,21 @@ declare class OnboardingResource extends BaseResource {
         intent_notes?: string;
     }): Promise<AcknowledgeOnboardingResponse>;
 }
+/**
+ * The example song: a made-up, complete song every account can read, marked
+ * `example: true` with a note saying so. It is in no catalogue.
+ */
+export interface ExampleSong {
+    example: true;
+    example_note: string;
+    url: string;
+    work: Record<string, unknown>;
+    [key: string]: unknown;
+}
+declare class ExampleSongResource extends BaseResource {
+    /** GET /api/example-song — the example song, read-only. */
+    get(): Promise<ExampleSong>;
+}
 export interface IntroduceSelfResponse {
     success: boolean;
     data: {
@@ -4053,7 +4068,12 @@ interface ImportAnalysis {
             aiConfidence?: number;
             required?: boolean;
         }>;
+        /** Columns left unmatched, duplicates, missing required fields. */
+        warnings?: string[];
         suggestions: string[];
+        confidence?: number;
+        detectedDomain?: string;
+        estimatedSuccessRate?: number;
     };
 }
 interface ImportValidation {
@@ -6352,12 +6372,18 @@ export interface ApprovalStatusResult {
     status: ApprovalStatusValue;
     /** ISO timestamp the owner decided; null while still pending. */
     decided_at: string | null;
-    /** Channel the decision arrived through ("email" | "telegram"); null while pending. */
+    /** Channel the decision arrived through ("email" | "telegram" | "in_app"); null while pending. */
     decided_via: string | null;
     /** ISO timestamp the pending request expires. */
     expires_at: string | null;
     /** Failed approvals only: why it did not run, in plain words. */
     failure_reason?: string;
+    /**
+     * Executed single approvals only: what ran — ids, counts, flags and short
+     * status words from the executor's result (the rule, agreement or
+     * relationship id; how many were sent, moved or deleted). Never free text.
+     */
+    result?: Record<string, unknown>;
     /** Batched merge approvals only, once run: per-outcome counts. */
     summary?: {
         total: number;
@@ -6463,6 +6489,7 @@ export declare class PicaClient {
     telegram: TelegramResource;
     gdpr: GdprResource;
     onboarding: OnboardingResource;
+    exampleSong: ExampleSongResource;
     agentIntroductions: AgentIntroductionsResource;
     workflowOutcomes: WorkflowOutcomesResource;
     feedback: FeedbackResource;