@withpica/mcp-sdk 4.4.0 → 4.6.0

package/CHANGELOG.md

@@ -11,6 +11,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+
+- `ApprovalStatusResult.failure_reason`: on a failed approval, why it did not run, in plain
+  words (optional).
+
 ## [4.4.0] - 2026-11-03
 
 ### Added

package/dist/index.d.ts

@@ -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,10 +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;
@@ -6461,6 +6489,7 @@ export declare class PicaClient {
     telegram: TelegramResource;
     gdpr: GdprResource;
     onboarding: OnboardingResource;
+    exampleSong: ExampleSongResource;
     agentIntroductions: AgentIntroductionsResource;
     workflowOutcomes: WorkflowOutcomesResource;
     feedback: FeedbackResource;