@pouchy_ai/admin-sdk 0.4.4 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.5.0 — 2026-07-17
+
+Additive: end-user listing pagination.
+
+- **`listUsers` gains cursor pagination**: pass `limit` (clamped 1..100
+  server-side, default 100) and `cursor` (opaque — the previous response's
+  `nextCursor`); the response now carries `nextCursor` while more rows exist.
+  Previously the unfiltered listing was hard-capped at the 100 most recently
+  active instances with no way to reach the tail. The filtered variants
+  (`external_user_id` / `external_user_prefix`) are unchanged and don't
+  paginate. Requires a server deployment serving Admin API >= 1.2.0; older
+  servers ignore the new params and never return `nextCursor` (you just get
+  the old first-100 behavior).
+
 ## 0.4.4 — 2026-07-17
 
 Transport-error parity with the JS/python/unity siblings (they got this in

package/README.md

@@ -88,7 +88,7 @@ try {
 | Agents | `listAgents` · `createAgent` · `getAgent` · `updateAgent` · `deleteAgent` |
 | Voices | `listVoices({ gender?, age?, locale? })` — catalog for programmatic voice selection (each `CatalogVoice` carries `age`) |
 | Secret keys | `listKeys` · `createKey` · `revokeKey` · `rotateKey` (24 h grace) |
-| End users | `listUsers` · `setUserSuspended` · `deleteUser` · `getUserWallet` · `getUserTraces` · `importUsers` · `exportUser` · `getUserSessions` · `getUserTurns` |
+| End users | `listUsers({ limit?, cursor? })` (cursor-paginated — the response's `nextCursor` feeds the next page; filter variants: `external_user_id` / `external_user_prefix`) · `setUserSuspended` · `deleteUser` · `getUserWallet` · `getUserTraces` · `importUsers` · `exportUser` · `getUserSessions` · `getUserTurns` |
 | Knowledge | `listKnowledge` · `ingestKnowledge` · `deleteKnowledge` |
 | Skills | `listSkills` · `installSkill` · `updateSkill` · `setSkillRate` · `setSkillDailyCap` · `grantSkill` (free-HTTP) · `compileSkill` (prose→tools) · `uninstallSkill` |
 | Credentials | `listCredentials` · `putCredentials` · `deleteCredentials` |

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.4.4";
+export declare const ADMIN_SDK_VERSION = "0.5.0";
 export declare const DEFAULT_BASE_URL = "https://pouchy.ai/v1/admin";
 export interface AdminClientOptions {
     /** A project Admin key (`pchy_admin_…`) from the dashboard Admin Keys page. */
@@ -159,13 +159,19 @@ export interface AdminClient {
             graceUntil: string | null;
         };
     }>;
-    /** List end-user instances. Filter by exact external id or by prefix (the
-     *  server ignores any other query param and hard-caps the page at 100). */
+    /** List end-user instances. Filter by exact external id or by prefix, or
+     *  page the full listing: `limit` (clamped 1..100 server-side, default 100)
+     *  + `cursor` (opaque — pass back the previous response's `nextCursor`).
+     *  `nextCursor` is present while more rows exist; the filtered variants
+     *  don't paginate. */
     listUsers(params?: {
         external_user_id?: string;
         external_user_prefix?: string;
+        limit?: number;
+        cursor?: string;
     }): Promise<{
         users: Instance[];
+        nextCursor?: string;
     }>;
     setUserSuspended(instanceId: string, suspended: boolean): Promise<{
         suspended: boolean;

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