@pouchy_ai/admin-sdk 0.32.1 → 0.34.0

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.34.0 — 2026-09-08
+
+### Fixed
+
+- **`instructions`, `knowledgeDocIds` and `agentCardExtras` were dropped by the
+  agent create/update surface, so setting any of them answered `200` and did
+  nothing.** `agent-input.ts` maps a request body onto `createAgent`/
+  `updateAgent` with an object literal that enumerates its fields, and three
+  fields the store accepts had fallen out of it — on BOTH management surfaces
+  (`/v1/admin/agents` and `/v1/projects/{id}/agents`) and therefore the
+  Dashboard too, which PATCHes the latter. `instructions` was dead the day it
+  shipped; the Dashboard's knowledge-scope picker has been a silent no-op for
+  as long as it has existed; `agentCardExtras` is documented for the DeJoy
+  integration and was unreachable over HTTP. Server-side fix — no SDK change
+  was needed to make them work.
+
+### Added
+
+- `Agent.knowledgeDocIds?: string[]` — typed alongside `instructions`, so the
+  two fields this release un-drops are both discoverable from the SDK rather
+  than only from the API reference.
+
+## 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.34.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,17 @@ export interface Agent {
      *  (concurrent headless workers under one persona). Default false since
      *  owner decision D-10 (2026-09-05). */
     spawnSubtasks?: boolean;
+    /** Restrict this agent's project-knowledge recall to the named documents
+     *  (`[]` clears). Read live off the agent row every turn — no rev bump. */
+    knowledgeDocIds?: string[];
+    /** 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.34.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.34.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",