@puku-ai/sdk 2.0.2 → 2.1.0

package/README.md

@@ -120,8 +120,7 @@ try {
 }
 ```
 
-All error classes are static members of the `PukuAI` class, matching the
-`@anthropic-ai/sdk` ergonomics:
+All error classes are static members of the `PukuAI` class, 
 
 - `PukuAI.AnthropicError`
 - `PukuAI.APIError`
@@ -159,6 +158,7 @@ PUKU_API_KEY=pk_live_... \
 | `client.beta.messages.toolRunner(...).runUntilDone()` | ✅ works | `client.beta.messages` |
 | `ToolError` class (exceptions from the runner)     | ✅ works | `helpers/beta` |
 | MCP helpers (`mcpTool`, `mcpTools`, `mcpMessage`, `mcpMessages`, `mcpResourceToContent`, `mcpResourceToFile`) | ✅ exported | `helpers/beta/mcp` |
+| Agent toolset (`betaAgentToolset20260401`, `betaBashTool`, `betaReadTool`, `betaWriteTool`, `betaEditTool`, `betaGlobTool`, `betaGrepTool`) | ✅ exported | `tools/agent-toolset` |
 | Full error hierarchy (`APIError`, `RateLimitError`, `AuthenticationError`, …) | ✅ works | static on `PukuAI` |
 
 ### Known gateway gaps (SDK calls the correct path, gateway returns 404)
@@ -168,18 +168,8 @@ PUKU_API_KEY=pk_live_... \
 | `client.messages.countTokens`        | ⚠ 404  | SDK POSTs to `/v1/messages/count_tokens` exactly like upstream. Puku's gateway does not proxy this endpoint. |
 | `client.messages.batches.create`     | ⚠ 404  | SDK POSTs to `/v1/messages/batches` exactly like upstream. Puku's gateway does not proxy this endpoint. |
 
-### Helpers shipped as stubs (require peer deps)
 
-| Helper              | Status | How to enable |
-|---------------------|--------|---------------|
-| `betaZodTool`       | 🔌 stub | Pass `zod` as a peer dep (`npm install zod`). The stub throws a clear error directing you to install it. |
-| `betaZodOutputFormat` | 🔌 stub | Same as above. |
 
-> The SDK is a drop-in replacement for `@anthropic-ai/sdk`. Anything the
-> SDK does not list above (file uploads, vision inputs, prompt caching,
-> structured outputs, etc.) follows the same Anthropic call shapes and
-> is exposed under the same method names — see the other examples in
-> 
 
 ### Example: full tool-runner loop
 
@@ -192,7 +182,7 @@ const client = new PukuAI({
 });
 
 // A runnable tool. Puku-ai/sdk accepts the same BetaRunnableTool shape
-// as @anthropic-ai/sdk (tool def + run + parse).
+//  (tool def + run + parse).
 const getWeather = {
   name: "get_weather",
   description: "Get the current temperature for a city, in Celsius.",
@@ -254,7 +244,7 @@ const client = new PukuAI();
 
 // `mcpTools` converts an MCP client from @modelcontextprotocol/sdk into
 // a list of Anthropic tool definitions. The SDK ships every helper
-// `helpers/beta/mcp.ts` exports — same names as @anthropic-ai/sdk.
+
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
 
@@ -271,6 +261,48 @@ const reply = await client.beta.messages.create({
 });
 ```
 
+### Example: agent toolset (bash / read / write / edit / glob / grep)
+
+The SDK ships the upstream `tools/agent-toolset` surface — the same `BetaRunnableTool[]`
+factory used by puku-cli's agent mode to give the model a sandboxed shell + filesystem.
+
+```ts
+import { betaAgentToolset20260401 } from "@puku-ai/sdk";
+
+const tools = betaAgentToolset20260401({ workdir: "/tmp/sandbox" });
+// -> [bash, read, write, edit, glob, grep]
+
+const runner = client.beta.messages.toolRunner({
+  model: "puku-ai-2.8",
+  max_tokens: 1024,
+  messages: [{ role: "user", content: "List /tmp/sandbox and grep for TODO" }],
+  tools,
+});
+const final = await runner.runUntilDone();
+```
+
+Drop individual tools in or out:
+
+```ts
+const tools = betaAgentToolset20260401({ workdir: "/tmp/sandbox" })
+  .filter((t) => t.name !== "bash"); // no shell access
+```
+
+Or pick the individual factories:
+
+```ts
+import { betaReadTool, betaBashTool } from "@puku-ai/sdk";
+
+const tools = [betaReadTool({ workdir: "/tmp/sandbox" })];
+```
+
+> `setupSkills`, `resolveSkillVersion`, and `extractSkillArchive` require
+> `/v1/skills/{id}/versions/{version}` (download/retrieve/list) and
+> `/v1/sessions/{id}`, which the Puku gateway doesn't proxy. 
+> archive-validation helpers (`assertSafeMemberNames`,
+> `assertNoSpecialMembers`, `runArchiveTool`, `archiveTopDir`, `readHead`)
+> stay available — they are pure functions and don't touch the gateway.
+
 ## Namespace
 
 Resource and helper types live on the `PukuAI` class so they can be used

package/package.json

@@ -1,228 +1,28 @@
 {
   "name": "@puku-ai/sdk",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "PukuAI SDK — drop-in replacement for @anthropic-ai/sdk that routes requests through the Puku AI gateway.",
-  "type": "commonjs",
-  "main": "./index.js",
-  "types": "./index.d.ts",
+  "type": "module",
+  "main": "./sdk.cjs",
+  "module": "./sdk.mjs",
+  "types": "./sdk.d.ts",
   "exports": {
     ".": {
-      "require": {
-        "types": "./index.d.ts",
-        "default": "./index.js"
-      },
-      "types": "./index.d.mts",
-      "default": "./index.mjs"
+      "types": "./sdk.d.ts",
+      "import": "./sdk.mjs",
+      "require": "./sdk.cjs",
+      "default": "./sdk.mjs"
     },
-    "./.github/*.mjs": {
-      "default": "./.github/*.mjs"
-    },
-    "./.github/*.js": {
-      "default": "./.github/*.js"
-    },
-    "./.github/*": {
-      "import": "./.github/*.mjs",
-      "require": "./.github/*.js"
-    },
-    "./_vendor/*.mjs": {
-      "default": "./_vendor/*.mjs"
-    },
-    "./_vendor/*.js": {
-      "default": "./_vendor/*.js"
-    },
-    "./_vendor/*": {
-      "import": "./_vendor/*.mjs",
-      "require": "./_vendor/*.js"
-    },
-    "./api-promise": {
-      "import": "./api-promise.mjs",
-      "require": "./api-promise.js"
-    },
-    "./api-promise.js": {
-      "default": "./api-promise.js"
-    },
-    "./api-promise.mjs": {
-      "default": "./api-promise.mjs"
-    },
-    "./client": {
-      "import": "./client.mjs",
-      "require": "./client.js"
-    },
-    "./client.js": {
-      "default": "./client.js"
-    },
-    "./client.mjs": {
-      "default": "./client.mjs"
-    },
-    "./core/*.mjs": {
-      "default": "./core/*.mjs"
-    },
-    "./core/*.js": {
-      "default": "./core/*.js"
-    },
-    "./core/*": {
-      "import": "./core/*.mjs",
-      "require": "./core/*.js"
-    },
-    "./error": {
-      "import": "./error.mjs",
-      "require": "./error.js"
-    },
-    "./error.js": {
-      "default": "./error.js"
-    },
-    "./error.mjs": {
-      "default": "./error.mjs"
-    },
-    "./helpers/*.mjs": {
-      "default": "./helpers/*.mjs"
-    },
-    "./helpers/*.js": {
-      "default": "./helpers/*.js"
-    },
-    "./helpers/*": {
-      "import": "./helpers/*.mjs",
-      "require": "./helpers/*.js"
-    },
-    "./index": {
-      "import": "./index.mjs",
-      "require": "./index.js"
-    },
-    "./index.js": {
-      "default": "./index.js"
-    },
-    "./index.mjs": {
-      "default": "./index.mjs"
-    },
-    "./internal/*.mjs": {
-      "default": "./internal/*.mjs"
-    },
-    "./internal/*.js": {
-      "default": "./internal/*.js"
-    },
-    "./internal/*": {
-      "import": "./internal/*.mjs",
-      "require": "./internal/*.js"
-    },
-    "./lib/*.mjs": {
-      "default": "./lib/*.mjs"
-    },
-    "./lib/*.js": {
-      "default": "./lib/*.js"
-    },
-    "./lib/*": {
-      "import": "./lib/*.mjs",
-      "require": "./lib/*.js"
-    },
-    "./pagination": {
-      "import": "./pagination.mjs",
-      "require": "./pagination.js"
-    },
-    "./pagination.js": {
-      "default": "./pagination.js"
-    },
-    "./pagination.mjs": {
-      "default": "./pagination.mjs"
-    },
-    "./resource": {
-      "import": "./resource.mjs",
-      "require": "./resource.js"
-    },
-    "./resource.js": {
-      "default": "./resource.js"
-    },
-    "./resource.mjs": {
-      "default": "./resource.mjs"
-    },
-    "./resources/*.mjs": {
-      "default": "./resources/*.mjs"
-    },
-    "./resources/*.js": {
-      "default": "./resources/*.js"
-    },
-    "./resources/*": {
-      "import": "./resources/*.mjs",
-      "require": "./resources/*.js"
-    },
-    "./resources": {
-      "import": "./resources.mjs",
-      "require": "./resources.js"
-    },
-    "./resources.js": {
-      "default": "./resources.js"
-    },
-    "./resources.mjs": {
-      "default": "./resources.mjs"
-    },
-    "./streaming": {
-      "import": "./streaming.mjs",
-      "require": "./streaming.js"
-    },
-    "./streaming.js": {
-      "default": "./streaming.js"
-    },
-    "./streaming.mjs": {
-      "default": "./streaming.mjs"
-    },
-    "./tools/*.mjs": {
-      "default": "./tools/*.mjs"
-    },
-    "./tools/*.js": {
-      "default": "./tools/*.js"
-    },
-    "./tools/*": {
-      "import": "./tools/*.mjs",
-      "require": "./tools/*.js"
-    },
-    "./uploads": {
-      "import": "./uploads.mjs",
-      "require": "./uploads.js"
-    },
-    "./uploads.js": {
-      "default": "./uploads.js"
-    },
-    "./uploads.mjs": {
-      "default": "./uploads.mjs"
-    },
-    "./version": {
-      "import": "./version.mjs",
-      "require": "./version.js"
-    },
-    "./version.js": {
-      "default": "./version.js"
-    },
-    "./version.mjs": {
-      "default": "./version.mjs"
-    },
-    "./tools/memory/node": {
-      "import": "./tools/memory/node.mjs",
-      "require": "./tools/memory/node.js"
-    }
+    "./package.json": "./package.json"
   },
   "files": [
-    "**/*",
-    "!src/**",
-    "!vendor/**",
-    "!scripts/**",
-    "!tests/**",
-    "!examples/**",
-    "!docs/**",
-    "!dist-cjs/**",
-    "!dist-esm/**",
-    "!node_modules/**",
-    "!**/*.ts",
-    "!**/*.tsbuildinfo",
-    "!.env",
-    "!.env.*",
-    "!.github/workflows/**",
-    "!bun.lock",
-    "!pnpm-lock.yaml",
-    "!reference/**",
-    "!tsconfig.json",
-    "!tsconfig.cjs.json",
-    "!tsconfig.esm.json",
-    "!.npmignore",
-    "!.gitignore"
+    "sdk.mjs",
+    "sdk.cjs",
+    "sdk.d.ts",
+    "sdk.mjs.map",
+    "sdk.cjs.map",
+    "LICENSE",
+    "README.md"
   ],
   "engines": {
     "node": ">=18"
@@ -242,7 +42,6 @@
   },
   "homepage": "https://github.com/puku-ai/puku-ai-sdk#readme",
   "dependencies": {
-    "standardwebhooks": "^1.0.0",
     "json-schema-to-ts": "^3.1.1"
   },
   "peerDependencies": {
@@ -255,12 +54,11 @@
   },
   "scripts": {
     "build": "bun run scripts/build.ts",
-    "smoke": "bun run build && node --experimental-vm-modules scripts/smoke.mjs",
+    "smoke": "node scripts/smoke-offline.mjs",
+    "smoke:live": "bun run build && node --experimental-vm-modules scripts/smoke.mjs",
     "integration": "bun run build && node scripts/integration.mjs",
     "parity": "bun run build && node tests/parity/run-all.mjs",
-    "staging": "node scripts/run-all-staging.mjs",
-    "type-check": "tsc --noEmit scripts/type-check.mts --module ESNext --moduleResolution Bundler --target ES2022 --allowImportingTsExtensions --skipLibCheck",
-    "lint": "tsc --noEmit",
+    "type-check": "tsc --noEmit",
     "prepack": "bun run build"
   },
   "devDependencies": {