@pouchy_ai/admin-sdk 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.42.0 — 2026-10-08
+
+- **`getRecentTraces({ from, to })`: a custom window by UTC day** (admin API
+  1.19.0). The run browser could only look back from now (`sinceHours`); a
+  window that ends in the past (last Tuesday's failures) had no expression.
+  `from` / `to` are inclusive UTC days, given together, within the 30-day trace
+  retention — older is a 400, never an empty list that reads as "no runs".
+  `window.untilMs` (exclusive) is typed and present on such a window.
+  `sinceHours` alone behaves as before. Additive.
+- **`getUsageHistory()` rows carry `credits`** — the credits charged that
+  month (the pooled account figure on `scope: 'account'`), typed as optional
+  because an older server does not send it.
+
 ## 0.41.0 — 2026-10-02
 
 - **Three world session-mint codes join `ADMIN_ERROR_CODES`.** `POST

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.41.0";
+export declare const ADMIN_SDK_VERSION = "0.42.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
@@ -373,6 +373,9 @@ export interface MonthUsageHistoryEntry {
     mau: number;
     mauTest: number;
     sessions: number;
+    /** 0.42.0 (admin API 1.19.0): credits charged that month. Absent from an
+     *  older server. */
+    credits?: number;
     [k: string]: unknown;
 }
 export interface AuditRow {
@@ -1461,12 +1464,21 @@ export interface AdminClient {
     getRecentTraces(params?: {
         agentId?: string;
         sinceHours?: number;
+        /** 0.42.0 (admin API 1.19.0): a custom window by UTC day, inclusive,
+         *  both required together. Run traces are kept 30 days, so `from` must
+         *  fall within the last 30 UTC days — older is a 400, not an empty list.
+         *  `sinceHours` is ignored when these are given. */
+        from?: string;
+        to?: string;
         errorsOnly?: boolean;
         limit?: number;
     }): Promise<{
         sinceHours: number;
+        /** `untilMs` (exclusive) is present only on a custom window ending
+         *  before now. */
         window: {
             sinceMs: number;
+            untilMs?: number;
         };
         degraded: false | 'index' | 'error';
         traces: RecentTrace[];

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.41.0';
+export const ADMIN_SDK_VERSION = '0.42.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.41.0",
+	"version": "0.42.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",