@pouchy_ai/admin-sdk 0.31.1 → 0.32.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.32.0 — 2026-09-06
+
+- **Diff entries are `{ field, before, after }`** — `diffAgentVersions` and
+  `getAgentPromotion` were typed `{ field, from, to }` since they were added,
+  and the server has always sent `before` / `after` (`diffAgentTemplates`).
+  Reading `d.from` / `d.to` gave `undefined` for every changed field. The
+  types (and the published OpenAPI spec) now say what the wire says; no
+  runtime change. If you read the keys by name, rename them.
+- **`getAgentPromotion().pinnedSnapshotMissing?`** — true when the production
+  pin names an archived snapshot that no longer exists, in which case live
+  instances run the staging head until a re-promote re-pins. Additive;
+  older servers omit it. The diff is empty in that state, so read this before
+  reading an empty diff as "in sync".
+
 ## 0.31.1 — 2026-09-06
 
 - **`AdminApiError.errorId`** — the server's lookup reference (`err_…`) for a

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.31.1";
+export declare const ADMIN_SDK_VERSION = "0.32.0";
 export declare const DEFAULT_BASE_URL = "https://pouchy.ai/v1/admin";
 /** Deadline for the routes whose server handler declares `maxDuration: 300` —
  *  the server's own ceiling plus headroom, so a client abort can only ever mean
@@ -517,8 +517,8 @@ export interface AdminClient {
         to: string;
         diff: Array<{
             field: string;
-            from: unknown;
-            to: unknown;
+            before: unknown;
+            after: unknown;
         }>;
     }>;
     /** Roll an agent back to an archived revision. git-revert semantics: the
@@ -529,16 +529,21 @@ export interface AdminClient {
     }>;
     /** Promotion status: the head (staging) vs the pinned production version, plus
      *  the diff a promotion would ship (empty when in sync). `pending` is false
-     *  when the agent was never promoted (live follows the head). */
+     *  when the agent was never promoted (live follows the head).
+     *  `pinnedSnapshotMissing` (0.32.0) is true when the pin names a snapshot
+     *  that no longer exists — live instances are then running the staging head
+     *  and a re-promote re-pins; the diff is empty in that state for the OTHER
+     *  reason, so read this field before reading an empty diff as "in sync". */
     getAgentPromotion(agentId: string): Promise<{
         stagingRev: number;
         prodRev: number | null;
         pending: boolean;
         diff: Array<{
             field: string;
-            from: unknown;
-            to: unknown;
+            before: unknown;
+            after: unknown;
         }>;
+        pinnedSnapshotMissing?: boolean;
     }>;
     /** Promote the head to production: freezes the head as an archived version and
      *  pins prodRev WITHOUT bumping the rev. Live instances re-resolve on their

package/dist/index.js

@@ -8,7 +8,7 @@
 //   import { createAdminClient } from '@pouchy_ai/admin-sdk';
 //   const admin = createAdminClient({ adminKey: process.env.POUCHY_ADMIN_KEY! });
 //   const { agents } = await admin.listAgents();
-export const ADMIN_SDK_VERSION = '0.31.1';
+export const ADMIN_SDK_VERSION = '0.32.0';
 export const DEFAULT_BASE_URL = 'https://pouchy.ai/v1/admin';
 /** Default per-request timeout (ms). A hung upstream otherwise never rejects. */
 const DEFAULT_TIMEOUT_MS = 30_000;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pouchy_ai/admin-sdk",
-	"version": "0.31.1",
+	"version": "0.32.0",
 	"description": "Typed TypeScript client for the Pouchy Admin API \u2014 manage agents, keys, end users, knowledge, skills, channels, schedules, webhooks and credentials headlessly, with a project Admin key.",
 	"type": "module",
 	"license": "SEE LICENSE IN LICENSE",