@pouchy_ai/admin-sdk 0.26.0 → 0.26.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.26.1 — 2026-08-09
+
+- **Docs-only.** No type, method or signature moves. `extractJson`'s failure
+  table now says which arm each 400 can come from: `schema_invalid` is
+  reachable only on a **strict** call, because `strict: false` sends
+  `{type:'json_object'}` and the schema never reaches the wire. A provider
+  rejection of a schema-less call — JSON mode refusing a custom `system`
+  prompt that never contains the word "json" is the common one — is
+  `request_invalid`, the code that already meant "the provider rejected the
+  request itself". Server-side change; both codes are 400 and neither is
+  retryable, so no client logic that branches on retry direction is affected.
+- `schemaName: ''` is accepted again as "unset" (it falls back to the
+  documented `extraction` default). The 0.24.x-era identifier-grammar check
+  400'd it with a charset message that named characters the empty string does
+  not have.
+
 ## 0.26.0 — 2026-08-09
 
 - **New methods `importAgentPlugin` / `exportAgentPlugin`** (additive; nothing

package/README.md

@@ -147,9 +147,12 @@ 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),
+`schema_invalid` (400 — fix the schema; retrying verbatim cannot help; only
+reachable on a **strict** call, since `strict: false` never puts a schema on the
+wire), `request_invalid` (400 — the provider rejected the request itself: an
+unknown `model`, a parameter outside the provider's validation, or any rejection
+of a schema-less `strict: false` call — for example JSON mode refusing a custom
+`system` prompt that never says "json"; 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.26.0";
+export declare const ADMIN_SDK_VERSION = "0.26.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
@@ -678,9 +678,12 @@ export interface AdminClient {
      *  validation.
      *
      *  Failures are typed rather than prose, which is the point:
-     *  `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;
+     *  `schema_invalid` (400 — fix the schema, retrying verbatim cannot help;
+     *  only reachable on a STRICT call, because `strict: false` never puts a
+     *  schema on the wire), `request_invalid` (400 — the provider rejected the
+     *  request itself: an unknown `model`, a parameter outside the provider's
+     *  validation, or any rejection of a schema-less `strict: false` call, such
+     *  as JSON mode refusing a `system` prompt that never says "json";
      *  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`,

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.26.0';
+export const ADMIN_SDK_VERSION = '0.26.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;

package/package.json

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