@pouchy_ai/admin-sdk 0.27.0 → 0.27.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.27.1 — 2026-08-28
+
+- **Docs-only, but read it if you use `encodingFormat: 'base64'`.** The 0.27.0
+  README's decode snippet was `new Float32Array(Buffer.from(s,'base64').buffer)`
+  — on Node runtimes that pool small buffers (every 768-dim vector qualifies),
+  `.buffer` is the whole shared pool and that form silently decodes ~2048
+  garbage-tailed elements. Our own live acceptance probe caught it on first
+  field run. Correct, everywhere:
+  `const buf = Buffer.from(s, 'base64'); new Float32Array(buf.buffer, buf.byteOffset, buf.length / 4)`.
+  No client code changed.
+
 ## 0.27.0 — 2026-08-28
 
 - **New: `embedTexts` — text → embedding vectors** (`POST

package/README.md

@@ -187,8 +187,26 @@ Two rules keep a stored index honest:
    is always exactly what you stored.
 
 For bulk reindex, `encodingFormat: 'base64'` returns each vector as
-little-endian float32 base64 (~3.5× smaller at 768 dims):
-`new Float32Array(Buffer.from(embedding, 'base64').buffer)`.
+little-endian float32 base64 (~3.5× smaller at 768 dims). Decode with the
+**offset-safe** form:
+
+```ts
+const res = await admin.embedTexts({
+  input: ['来张咖啡店自拍'],
+  encodingFormat: 'base64'
+});
+for (const { embedding } of res.data) {
+  const buf = Buffer.from(embedding as string, 'base64');
+  const vec = new Float32Array(buf.buffer, buf.byteOffset, buf.length / 4);
+  // vec.length === res.dimensions, always
+  void vec;
+}
+```
+
+Not `new Float32Array(buf.buffer)` — on Node runtimes that pool small buffers
+(every 768-dim vector qualifies), `.buffer` is the whole shared pool and the
+naive form silently decodes ~2048 garbage-tailed elements. Caught live by our
+own acceptance probe; the three-arg form is correct everywhere.
 
 Failures are typed: `invalid_request` (400 — fix and resend), `unavailable`
 (503 — transient, back off and retry), `provider_error` (502 — the upstream

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.27.0";
+export declare const ADMIN_SDK_VERSION = "0.27.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

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