@pouchy_ai/admin-sdk 0.32.1 → 0.33.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.33.0 — 2026-09-08
+
+### Added
+
+- `Agent.instructions?: boolean` — the template flag that grants
+  `chat.instructions` on an agent's session mints, so a turn may carry an
+  `instructions` field (developer-authored rules for THAT turn, joined to the
+  prompt and never scored as user speech by inbound moderation; issue #3379).
+
+  Typed here because it is the **only** way to obtain that scope, and an
+  integrator's first instinct is to request it at mint time — which silently
+  does nothing: the scope sits outside the mintable default set on purpose
+  (the field it unlocks skips moderation, and a session token is routinely
+  held by the end user's own client), and `validateSessionRequest` narrows a
+  requested scope to that set. Flip the template flag instead, from the
+  Dashboard or `PATCH /v1/projects/{id}/agents/{agentId}` with
+  `{"instructions": true}`. Settings-class: no `templateRev` bump; existing
+  session tokens gain the scope on re-mint.
+
 ## 0.32.1 — 2026-09-06
 
 - **A transport failure now names the request.** `AdminApiError.message` on a

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.32.1";
+export declare const ADMIN_SDK_VERSION = "0.33.0";
 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
@@ -165,6 +165,14 @@ export interface Agent {
      *  (concurrent headless workers under one persona). Default false since
      *  owner decision D-10 (2026-09-05). */
     spawnSubtasks?: boolean;
+    /** Grant `chat.instructions` on this agent's session mints, so a turn may
+     *  carry an `instructions` field — developer-authored rules for THAT turn,
+     *  joined to the prompt and never scored as user speech by inbound
+     *  moderation (issue #3379). Default false, and this template flag is the
+     *  ONLY way to obtain the scope: it sits outside the mintable default set
+     *  on purpose, so asking for it in the session-mint body is narrowed away.
+     *  Leave it off unless your backend assembles per-turn rules itself. */
+    instructions?: boolean;
     /** Reply-cue opt-in (see ReplyCues). */
     replyCues?: ReplyCues;
     templateRev: number;

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