@pouchy_ai/admin-sdk 0.24.1 → 0.24.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.24.2 — 2026-08-08
+
+- **Docs-only: `extractJson` failure vocabulary gains `request_invalid`**
+  (server-side change; no SDK code moved — the code rides the open
+  `AdminErrorCode` string arm). The provider rejecting the REQUEST itself —
+  an unknown `model` (provider 404), or a parameter outside the provider's
+  validation (422) — now surfaces as `code: 'request_invalid'` with HTTP 400
+  and the provider's own message, instead of `unavailable`, whose documented
+  recovery ("back off and retry") sent integrators into an infinite backoff
+  loop for a request that can never succeed (e.g. a typo'd model name).
+  `schema_invalid` still covers provider-rejected schemas; `unavailable` is
+  now reliably transient. Also: `schemaName` is validated locally against the
+  provider's identifier grammar (letters/digits/underscores/dashes), so a bad
+  name is an immediate 400 naming `schemaName` rather than a provider 400
+  mislabelled `schema_invalid`.
+
 ## 0.24.1 — 2026-08-08
 
 - **Docs-only correction for `synthesizeSpeech`** (no code change): the rate

package/README.md

@@ -148,6 +148,8 @@ const { data } = await admin.extractJson<{ items: { kind: string; summary: strin
 
 Failures are typed rather than prose, so the recoveries are distinguishable:
 `schema_invalid` (400 — fix the schema; retrying verbatim cannot help),
+`request_invalid` (400 — the provider rejected the request itself: an unknown
+`model`, or a parameter outside the provider's validation; fix the request),
 `unavailable` (5xx — transient, back off), and `invalid_json` (502 — a
 completion arrived but did not parse or satisfy the schema; the error carries
 `raw`, the text actually returned). Tokens roll into the project's month usage

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.24.1";
+export declare const ADMIN_SDK_VERSION = "0.24.2";
 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
@@ -679,9 +679,12 @@ export interface AdminClient {
      *
      *  Failures are typed rather than prose, which is the point:
      *  `schema_invalid` (400 — fix the schema, retrying verbatim cannot help),
-     *  `unavailable` (5xx — transient, back off), `invalid_json` (502 — a
-     *  completion arrived but did not parse or did not satisfy the schema; the
-     *  error carries `raw`, the text actually returned).
+     *  `request_invalid` (400 — the provider rejected the request itself:
+     *  an unknown `model`, or a parameter outside the provider's validation;
+     *  fix the request, retrying verbatim cannot help), `unavailable` (5xx —
+     *  transient, back off), `invalid_json` (502 — a completion arrived but
+     *  did not parse or did not satisfy the schema; the error carries `raw`,
+     *  the text actually returned).
      *
      *  `reasoningEffort` is the thinking budget, default `'low'`. It matters more
      *  than it sounds for extraction: the shared one-shot floor is `'minimal'`,

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