@pouchy_ai/admin-sdk 0.43.0 → 0.44.1

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.44.1 — 2026-10-16
+
+- **`story_contract_v5_write_disabled`** joins `ADMIN_ERROR_CODES` — a Story
+  Package publish that scopes flags to roles (`visibility.flagDefault:
+  "role-scoped"`, Story Contract v5, world API 1.55.0) answers 409 with this
+  code in an environment that has not enabled v5 writes, the field intact.
+  Vocabulary only; no method changed.
+
+## 0.44.0 — 2026-10-09
+
+- **`getRecentTraces` and `getTracesSummary` say when the read hit its cap**
+  (admin API 1.21.0): `truncated: true` with `sampledRuns`, the pair the
+  health read already carried. With `errorsOnly` the recent read scans the
+  window's newest runs and keeps the failures, so on a busy project an empty
+  list could mean "the newest runs all succeeded" rather than "no failures in
+  this window", and nothing told the two apart. Absent on a read under its cap.
+  Additive; no existing field changed.
+
 ## 0.43.0 — 2026-10-08
 
 - **Three period reads** (admin API 1.20.0), the same answers the dashboard

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.43.0";
+export declare const ADMIN_SDK_VERSION = "0.44.1";
 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
@@ -60,7 +60,7 @@ export interface AdminClientOptions {
  *  published: on this plane the status line never disambiguates, so two of the
  *  durable-run routes answer 409 for two entirely different reasons each, with
  *  different recoveries. `code` is the only thing that tells them apart. */
-export declare const ADMIN_ERROR_CODES: readonly ["story_contract_v2_write_disabled", "story_contract_v3_write_disabled", "story_contract_v4_write_disabled", "has_pins", "pins_unknown", "story_package_limit", "story_package_documents_limit", "episode_history_incomplete", "episode_ended", "idempotency_key_reused", "stale_deliberation", "deliberation_disabled", "deliberation_uncalibrated", "deliberation_not_enabled", "deliberation_candidates_exceeded", "schedule_limit_reached", "one_shot_spent", "ghost_row", "channel_limit_reached", "webhook_limit_reached", "run_limit_reached", "reembed_required", "run_terminal", "run_not_parked", "stale_token", "run_not_waiting", "event_mismatch", "subscription_exists", "world_actor_conflict", "world_revision_mismatch", "world_provider_mismatch"];
+export declare const ADMIN_ERROR_CODES: readonly ["story_contract_v2_write_disabled", "story_contract_v3_write_disabled", "story_contract_v4_write_disabled", "story_contract_v5_write_disabled", "has_pins", "pins_unknown", "story_package_limit", "story_package_documents_limit", "episode_history_incomplete", "episode_ended", "idempotency_key_reused", "stale_deliberation", "deliberation_disabled", "deliberation_uncalibrated", "deliberation_not_enabled", "deliberation_candidates_exceeded", "schedule_limit_reached", "one_shot_spent", "ghost_row", "channel_limit_reached", "webhook_limit_reached", "run_limit_reached", "reembed_required", "run_terminal", "run_not_parked", "stale_token", "run_not_waiting", "event_mismatch", "subscription_exists", "world_actor_conflict", "world_revision_mismatch", "world_provider_mismatch"];
 /** `AdminApiError.code` values. The `(string & {})` arm keeps the type open for
  *  codes newer than this SDK build while preserving autocomplete — same
  *  doctrine as the companion SDK's `CompanionErrorCodeValue`. */
@@ -1632,6 +1632,13 @@ export interface AdminClient {
             untilMs?: number;
         };
         degraded: false | 'index' | 'error';
+        /** 0.44.0 (admin API 1.21.0): present only when the read hit its cap.
+         *  The rows (with `errorsOnly`, the failures) then come from the window's
+         *  newest `sampledRuns` runs only, so an empty `errorsOnly` list is NOT
+         *  "no failed runs in this window". */
+        truncated?: true;
+        /** With `truncated`: how many runs the read took. */
+        sampledRuns?: number;
         traces: RecentTrace[];
     }>;
     /** Enabled platform voices for programmatic provisioning. Filter by gender /

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.43.0';
+export const ADMIN_SDK_VERSION = '0.44.1';
 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;
@@ -73,6 +73,7 @@ export const ADMIN_ERROR_CODES = [
     'story_contract_v2_write_disabled',
     'story_contract_v3_write_disabled',
     'story_contract_v4_write_disabled',
+    'story_contract_v5_write_disabled',
     'has_pins',
     'pins_unknown',
     'story_package_limit',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pouchy_ai/admin-sdk",
-	"version": "0.43.0",
+	"version": "0.44.1",
 	"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",