@pouchy_ai/admin-sdk 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to `@pouchy_ai/admin-sdk` are documented here.
 
+## 0.4.0 — 2026-07-13
+
+Full skill-lifecycle parity — the two knobs the dashboard grew (a runaway
+guard + the prose→tools upgrade) are now typed on the client:
+
+- **`setSkillDailyCap(slug, maxCallsPerDay)`** — the opt-in daily call ceiling
+  (`PATCH /v1/admin/skills/{slug}` with `{ maxCallsPerDay }`, 1..20000, null to
+  clear): max HTTP calls per rolling 24h for a skill, a runaway guard for
+  autonomous outbound the per-minute cap doesn't cover. Returns `reprovisioned`.
+- **`compileSkill(slug)`** — compile a docs-only skill's prose into declared
+  `http` tools (`POST /v1/admin/skills/{slug}/compile`): a one-shot LLM proposes
+  tools bound to the skill's allowlist, re-installed (reversible via rollback).
+  Returns `{ skill, toolNames, warnings }`.
+- (Also fixes the `ADMIN_SDK_VERSION` constant, which had drifted to `0.2.0`.)
+
 ## 0.3.0 — 2026-07-13
 
 Skill-config parity — a docs-only skill (no `tools:` block) can now be

package/README.md

@@ -87,7 +87,7 @@ try {
 | Secret keys | `listKeys` · `createKey` · `revokeKey` · `rotateKey` (24 h grace) |
 | End users | `listUsers` · `setUserSuspended` · `deleteUser` · `getUserWallet` · `getUserTraces` · `importUsers` · `exportUser` · `getUserSessions` · `getUserTurns` |
 | Knowledge | `listKnowledge` · `ingestKnowledge` · `deleteKnowledge` |
-| Skills | `listSkills` · `installSkill` · `updateSkill` · `setSkillRate` · `grantSkill` (free-HTTP) · `uninstallSkill` |
+| Skills | `listSkills` · `installSkill` · `updateSkill` · `setSkillRate` · `setSkillDailyCap` · `grantSkill` (free-HTTP) · `compileSkill` (prose→tools) · `uninstallSkill` |
 | Credentials | `listCredentials` · `putCredentials` · `deleteCredentials` |
 | Channels | `listChannels` · `createChannel` · `getChannel` · `updateChannel` · `deleteChannel` |
 | Schedules | `listSchedules` · `createSchedule` · `getSchedule` · `updateSchedule` · `deleteSchedule` |

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const ADMIN_SDK_VERSION = "0.2.0";
+export declare const ADMIN_SDK_VERSION = "0.4.0";
 export declare const DEFAULT_BASE_URL = "https://pouchy.ai/v1/admin";
 export interface AdminClientOptions {
     /** A project Admin key (`pchy_admin_…`) from the dashboard Admin Keys page. */
@@ -237,6 +237,25 @@ export interface AdminClient {
     setSkillRate(slug: string, ratePerMin: number | null): Promise<{
         ratePerMin: number | null;
     }>;
+    /** Set a skill's opt-in daily call ceiling — max HTTP calls per rolling 24h
+     *  (1..20000; null clears it, leaving only the per-minute cap). A runaway
+     *  guard for autonomous outbound. Re-pushes the def to running instances. */
+    setSkillDailyCap(slug: string, maxCallsPerDay: number | null): Promise<{
+        maxCallsPerDay: number | null;
+        reprovisioned: number;
+    }>;
+    /** Compile a docs-only skill's prose (curl snippets / endpoint tables) into
+     *  declared `http` tools via a one-shot LLM, then re-install the result
+     *  (safety gate + version archive → reversible via rollback). Each tool is
+     *  bound to the skill's allowlist; `warnings` lists any dropped by a bad host
+     *  or shape. Turns a free-HTTP skill into structured `run_skill` tools. */
+    compileSkill(slug: string): Promise<{
+        skill: {
+            slug: string;
+        };
+        toolNames: string[];
+        warnings: string[];
+    }>;
     /** Free-HTTP grant (universal import): let the agent drive this skill's API
      *  from its prose body via `http_request`, bounded to the manifest's
      *  `allowed_domains` ∪ `grantedDomains`. This is how a docs-only skill

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.2.0';
+export const ADMIN_SDK_VERSION = '0.4.0';
 export const DEFAULT_BASE_URL = 'https://pouchy.ai/v1/admin';
 /** Thrown on any non-2xx response. `status` is the HTTP status; `message` is the
  *  server's `error` string when present. */
@@ -75,6 +75,8 @@ export function createAdminClient(opts) {
         installSkill: (input) => request('POST', '/skills', input),
         updateSkill: (slug, patch) => request('PATCH', `/skills/${encodeURIComponent(slug)}`, patch),
         setSkillRate: (slug, ratePerMin) => request('PATCH', `/skills/${encodeURIComponent(slug)}`, { ratePerMin }),
+        setSkillDailyCap: (slug, maxCallsPerDay) => request('PATCH', `/skills/${encodeURIComponent(slug)}`, { maxCallsPerDay }),
+        compileSkill: (slug) => request('POST', `/skills/${encodeURIComponent(slug)}/compile`, {}),
         grantSkill: (slug, grant) => request('PATCH', `/skills/${encodeURIComponent(slug)}`, {
             freeHttp: grant.freeHttp,
             grantedDomains: grant.grantedDomains ?? []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pouchy_ai/admin-sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Typed TypeScript client for the Pouchy Admin API — 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",