@pouchy_ai/admin-sdk 0.27.1 → 0.28.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.28.0 — 2026-08-29
+
+- **`installSkill` / `importAgentPlugin` now type the re-push outcome.** Both
+  installs re-push the new def to running instances (a RE-install/RE-import
+  takes effect now, not on the next persona edit — server change 2026-08-29;
+  Admin API 1.11.0), and both results now carry `reprovisioned` /
+  `truncated`, same semantics as the skill-knob calls: `truncated: true`
+  means the sweep hit a cap (100 agents / 200 instances) and the remainder
+  keep the OLD def until a persona edit. `installSkill` also gains the
+  `warnings?: string[]` the server always sent (e.g. skipped OpenAPI
+  operations). Types only — no runtime change; existing destructuring keeps
+  working.
+
 ## 0.27.1 — 2026-08-28
 
 - **Docs-only, but read it if you use `encodingFormat: 'base64'`.** The 0.27.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.27.1";
+export declare const ADMIN_SDK_VERSION = "0.28.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
@@ -813,6 +813,13 @@ export interface AdminClient {
     listSkills(): Promise<{
         skills: unknown[];
     }>;
+    /** Install (or RE-install — same slug, next version) a custom skill. The
+     *  new def is re-pushed to running instances in one bounded sweep, so a
+     *  re-import takes effect now rather than on the next persona edit; the
+     *  result carries the same `reprovisioned` / `truncated` outcome as the
+     *  skill-knob calls (`truncated: true` = the sweep hit a cap and the
+     *  remainder keep the OLD def until a persona edit — see SkillKnobResult).
+     *  `warnings` lists non-fatal drops (e.g. skipped OpenAPI operations). */
     installSkill(input: {
         md?: string;
         url?: string;
@@ -820,12 +827,13 @@ export interface AdminClient {
         openapi?: string;
         openapiUrl?: string;
         slug?: string;
-    }): Promise<{
+    }): Promise<SkillKnobResult<{
         skill: {
             slug: string;
             version: number;
         };
-    }>;
+        warnings?: string[];
+    }>>;
     /** Generic PATCH of a skill's knobs. **Exactly ONE knob per call** — the
      *  endpoint disambiguates by payload, so a patch naming two (say
      *  `{ ratePerMin, maxCallsPerDay }`) is refused with 400 rather than
@@ -895,13 +903,16 @@ export interface AdminClient {
      *  store credentials with `putCredentials` after install. Resolves 201
      *  when at least one component installed (`skipped`/`errors` carry the
      *  rest); a package with nothing installable rejects with a 422 naming
-     *  the first per-component reason. */
+     *  the first per-component reason. The whole installed set is re-pushed to
+     *  running instances in ONE bounded sweep (a RE-import takes effect now,
+     *  not on the next persona edit) — `reprovisioned` / `truncated` report
+     *  it, same semantics as the skill-knob calls. */
     importAgentPlugin(input: {
         files: Array<{
             path: string;
             content: string;
         }>;
-    }): Promise<{
+    }): Promise<SkillKnobResult<{
         plugin: {
             name: string;
             version?: string;
@@ -919,7 +930,7 @@ export interface AdminClient {
             component: string;
             error: string;
         }>;
-    }>;
+    }>>;
     /** Export one installed skill as a conformant Agent Plugins 1.0.0 package
      *  (file map — write it to a directory or zip it yourself). Portable face:
      *  SKILL.md instruction prose or an mcp.json streamable-http reference;

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