@pouchy_ai/admin-sdk 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.4.2 — 2026-07-16
+
+The rest of the 0.4.1 drift class — four more response/input shapes that lied
+about the live routes, caught by comparing every method against its
+`/v1/admin` handler. Type + doc fixes only (the client is a generic proxy).
+
+- **`listCredentials`** returns `{ enabled, skills }` (vault status + which
+  skill slugs hold credentials) — the old `{ credentials }` key never existed,
+  so `res.credentials` was always `undefined`. `putCredentials` returns
+  `{ ok, skill, entries }`.
+- **`updateProject`** returns what changed — `{ renamed?, name?, archived? }` —
+  not `{ project: { projectId } }` (that key never existed on PATCH).
+- **`createSchedule.runAt`** is **epoch milliseconds** (number), not an ISO
+  string — the server type-checks `typeof runAt === 'number'` and silently
+  drops a string (your "one-shot" 400s, or becomes recurring if
+  `intervalMinutes` was also set). Input also gains the server's `env?`.
+- **`SecretKey.displayPrefix`** — the stored-key metadata field is
+  `displayPrefix`, not `prefix` (affects `listKeys`/`createKey`/`rotateKey`
+  consumers); `lastUsedAt`/`revokedAt` marked optional as stored.
+- **`getTracesSummary`** now requires `agentId` — the server 400s without it,
+  so the old all-optional signature compiled calls that always fail.
+- **`createChannel`** input gains `env?` + `secret?` (connector credentials) —
+  the closed object literal blocked fields the server accepts, so test-env /
+  secret-bearing connectors were unreachable through the typed method.
+- **`getBilling().billing.periodEnd`** is `string | null` (always present).
+
+Also in this release: `GET /v1/admin/openapi` (the machine-readable spec this
+SDK mirrors) was rewritten against the live routes — it still described the
+pre-0.4.1 contract, so generated clients inherited every bug above.
+
 ## 0.4.1 — 2026-07-16
 
 Type-shape corrections — several method signatures had drifted from the live

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.4.1";
+export declare const ADMIN_SDK_VERSION = "0.4.2";
 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. */
@@ -32,10 +32,13 @@ export interface SecretKey {
     keyId: string;
     label: string;
     env: Env;
-    prefix: string;
+    /** The key's display prefix (e.g. `pchy_live_ab12…`) — the server never
+     *  returns the plaintext after mint. */
+    displayPrefix: string;
     createdAt: string;
-    lastUsedAt: string | null;
-    revokedAt: string | null;
+    lastUsedAt?: string | null;
+    revokedAt?: string | null;
+    [k: string]: unknown;
 }
 export interface Instance {
     instanceId: string;
@@ -75,6 +78,8 @@ export interface CatalogVoice {
     previewUrl?: string;
     /** Present on tagged rows; filter with listVoices({ gender }). */
     gender?: 'female' | 'male' | 'neutral';
+    /** Present on tagged rows; filter with listVoices({ age }). */
+    age?: 'young' | 'middle_aged' | 'old';
     /** Locales this voice suits; ABSENT = unrestricted. */
     locales?: string[];
 }
@@ -281,14 +286,20 @@ export interface AdminClient {
     uninstallSkill(slug: string): Promise<{
         deleted: boolean;
     }>;
+    /** Secret-free vault metadata: `enabled` says whether the deployment has a
+     *  vault at all; `skills` lists which skill slugs hold credentials (values
+     *  are never returned by any endpoint). */
     listCredentials(): Promise<{
-        credentials: unknown[];
+        enabled: boolean;
+        skills: unknown[];
     }>;
     putCredentials(input: {
         skill: string;
         credentials: Record<string, unknown>;
     }): Promise<{
         ok: boolean;
+        skill: string;
+        entries: number;
     }>;
     deleteCredentials(skill: string): Promise<{
         deleted: boolean;
@@ -299,7 +310,11 @@ export interface AdminClient {
     createChannel(input: {
         type: string;
         agentId: string;
+        env?: Env;
         config?: Record<string, unknown>;
+        /** Connector credentials (bot token, signing secret, …) — stored
+         *  encrypted, never returned. */
+        secret?: Record<string, unknown>;
     }): Promise<{
         connector: {
             id: string;
@@ -319,15 +334,17 @@ export interface AdminClient {
         schedules: unknown[];
     }>;
     /** Create a schedule. `externalUserId` and `prompt` are required alongside
-     *  `agentId`; the schedule fires by `intervalMinutes` (recurring) or `runAt`
-     *  (one-shot ISO time) — there is NO cron field. Returns the stored record,
-     *  whose id lives on `.id`. */
+     *  `agentId`; the schedule fires by `intervalMinutes` (recurring, >=5) or
+     *  `runAt` (one-shot **epoch milliseconds** — an ISO string is silently
+     *  ignored by the server) — there is NO cron field. Returns the stored
+     *  record, whose id lives on `.id`. */
     createSchedule(input: {
         agentId: string;
         externalUserId: string;
         prompt: string;
         intervalMinutes?: number;
-        runAt?: string;
+        runAt?: number;
+        env?: Env;
         deliverTo?: unknown;
     }): Promise<{
         schedule: {
@@ -386,12 +403,14 @@ export interface AdminClient {
             plan: string;
             effectivePlan: string;
             mauLimit: number;
-            periodEnd?: string;
+            periodEnd: string | null;
         };
         ledger: unknown;
     }>;
-    getTracesSummary(params?: {
-        agentId?: string;
+    /** Aggregate trace analytics. `agentId` is REQUIRED — the server 400s
+     *  without it. */
+    getTracesSummary(params: {
+        agentId: string;
         sinceHours?: number;
     }): Promise<Record<string, unknown>>;
     /** Recent run rows project-wide (the failed-run browser). */
@@ -403,11 +422,12 @@ export interface AdminClient {
     }): Promise<{
         traces: RecentTrace[];
     }>;
-    /** Enabled platform voices for programmatic provisioning. Filter by gender
-     *  (explicitly tagged rows only) and/or locale (rows listing it, or with no
-     *  locale list = unrestricted). */
+    /** Enabled platform voices for programmatic provisioning. Filter by gender /
+     *  age (explicitly tagged rows only) and/or locale (rows listing it, or with
+     *  no locale list = unrestricted). */
     listVoices(params?: {
         gender?: 'female' | 'male' | 'neutral';
+        age?: 'young' | 'middle_aged' | 'old';
         locale?: string;
     }): Promise<{
         voices: CatalogVoice[];
@@ -424,13 +444,15 @@ export interface AdminClient {
             archived?: boolean;
         };
     }>;
+    /** Rename / archive the project. The response echoes only what changed —
+     *  `{ renamed, name }` and/or `{ archived }` — there is no `project` key. */
     updateProject(patch: {
         name?: string;
         archived?: boolean;
     }): Promise<{
-        project: {
-            projectId: string;
-        };
+        renamed?: boolean;
+        name?: string;
+        archived?: boolean;
     }>;
     /** Escape hatch: call any endpoint the typed methods don't cover yet. */
     request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;

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.1';
+export const ADMIN_SDK_VERSION = '0.4.2';
 export const DEFAULT_BASE_URL = 'https://pouchy.ai/v1/admin';
 /** Thrown on any non-2xx response. `status` is the HTTP status; `message` is the
  *  server's `error` string when present. */
@@ -104,7 +104,7 @@ export function createAdminClient(opts) {
         redeliverWebhook: (id) => request('POST', `/webhooks/deliveries/${encodeURIComponent(id)}/redeliver`),
         getUsage: () => request('GET', '/usage'),
         getBilling: () => request('GET', '/billing'),
-        getTracesSummary: (params = {}) => request('GET', `/traces/summary${qs(params)}`),
+        getTracesSummary: (params) => request('GET', `/traces/summary${qs(params)}`),
         getRecentTraces: (params = {}) => request('GET', `/traces/recent${qs({ ...params, errorsOnly: params.errorsOnly ? '1' : undefined })}`),
         listVoices: (params = {}) => request('GET', `/voice-catalog${qs(params)}`),
         getLogs: (params = {}) => request('GET', `/logs${qs(params)}`),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pouchy_ai/admin-sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Typed TypeScript client for the Pouchy Admin API — 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",