@puku-ai/sdk 4.0.3 → 4.0.5

package/README.md

@@ -350,18 +350,35 @@ PukuAI.VERSION;          // SDK version
 
 
 
-### CJS / ESM shim
+### ESM and CJS
 
-When you `require('@puku-ai/sdk')`, the default export is a callable function
-that instantiates `PukuAI`:
+The default export behaves differently depending on the module system.
+
+**ESM** (`import PukuAI from "@puku-ai/sdk"`): the default export *is* the
+`PukuAI` class. Construct it with `new`:
 
 ```ts
-// CJS or ESM-from-CJS:
-const PukuAI = require("@puku-ai/sdk");          // or: import PukuAI from "@puku-ai/sdk"
-const client = new PukuAI({ apiKey, baseURL });  // works the same in both
+import PukuAI from "@puku-ai/sdk";
+
+const client = new PukuAI({ apiKey, baseURL });
+```
+
+**CJS** (`require("@puku-ai/sdk")`): the build applies a small callable shim
+(see `scripts/build.ts → patchCallableCjs`) that wraps `module.exports` in a
+function which delegates to `new exports.default(...)`. This means *both*
+of these work:
+
+```ts
+const PukuAI = require("@puku-ai/sdk");
+
+// Callable form (uses the shim):
+const client = PukuAI({ apiKey, baseURL });
+
+// Or as a class (`.default` is the same `PukuAI` class):
+const client = new PukuAI({ apiKey, baseURL });
 ```
 
-> The default export is the callable constructor, not the `PukuAI` class
+Use `import PukuAI from "@puku-ai/sdk"` in new code; the CJS callable form 
 
 
 ## License

package/dist/index.cjs

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * @puku-ai/sdk — public entrypoint.
+ *
+ * Re-exports the bundled vendor tree (`./vendor`) with a single targeted
+ * change: the HTTP transport reads `PUKU_BASE_URL` (required, no fallback).
+ *
+ * Public API surface: `PukuAI` is the client class. Error classes are
+ * `PukuError` (base), `APIError`, `RateLimitError`, etc. — all re-exported.
+ *
+ * Consumers only ever import from this root — there are no subpath exports.
+ * Helpers previously reachable via `@puku-ai/sdk/helpers/beta/...` or
+ * `@puku-ai/sdk/tools/...` are re-exported here as named symbols. The build
+ * pipeline (scripts/build.ts) bundles the entire vendor tree into a single
+ * `sdk.mjs` at the package root, so the internal file layout is invisible
+ * to consumers.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+// Auto-generated by scripts/build.ts — puku callable shim.
+// Wraps the tsc CJS output so `require("@puku-ai/sdk")(opts)` calls
+// `new module.exports.default(opts)`.
+exports = module.exports = function (...args) {
+  return new exports.default(...args);
+};
+Object.defineProperty
+exports.extractSkillArchive = exports.setupSkills = exports.BashTimeoutError = exports.BashSession = exports.resolvePath = exports.betaGrepTool = exports.betaGlobTool = exports.betaEditTool = exports.betaWriteTool = exports.betaReadTool = exports.betaBashTool = exports.betaAgentToolset20260401 = exports.ToolError = exports.UnsupportedMCPValueError = exports.mcpResourceToFile = exports.mcpResourceToContent = exports.mcpContent = exports.mcpMessages = exports.mcpMessage = exports.mcpTools = exports.mcpTool = exports.betaMemoryTool = exports.betaZodOutputFormat = exports.betaZodTool = exports.betaJSONSchemaOutputFormat = exports.betaTool = exports.VERSION = exports.default = void 0;
+// Re-export everything from the vendor root first. This brings the client
+// class, default callable, VERSION, APIPromise, PagePromise, toFile, all the
+// error classes (static members of PukuAI), and the parser types.
+__exportStar(require("./vendor/index.js"), exports);
+var index_js_1 = require("./vendor/index.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(index_js_1).default; } });
+var version_js_1 = require("./vendor/version.js");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_js_1.VERSION; } });
+// ── Helper functions previously exposed via subpath exports ────────────────
+var json_schema_js_1 = require("./vendor/helpers/beta/json-schema.js");
+Object.defineProperty(exports, "betaTool", { enumerable: true, get: function () { return json_schema_js_1.betaTool; } });
+Object.defineProperty(exports, "betaJSONSchemaOutputFormat", { enumerable: true, get: function () { return json_schema_js_1.betaJSONSchemaOutputFormat; } });
+var zod_js_1 = require("./vendor/helpers/beta/zod.js");
+Object.defineProperty(exports, "betaZodTool", { enumerable: true, get: function () { return zod_js_1.betaZodTool; } });
+Object.defineProperty(exports, "betaZodOutputFormat", { enumerable: true, get: function () { return zod_js_1.betaZodOutputFormat; } });
+var memory_js_1 = require("./vendor/helpers/beta/memory.js");
+Object.defineProperty(exports, "betaMemoryTool", { enumerable: true, get: function () { return memory_js_1.betaMemoryTool; } });
+var mcp_js_1 = require("./vendor/helpers/beta/mcp.js");
+Object.defineProperty(exports, "mcpTool", { enumerable: true, get: function () { return mcp_js_1.mcpTool; } });
+Object.defineProperty(exports, "mcpTools", { enumerable: true, get: function () { return mcp_js_1.mcpTools; } });
+Object.defineProperty(exports, "mcpMessage", { enumerable: true, get: function () { return mcp_js_1.mcpMessage; } });
+Object.defineProperty(exports, "mcpMessages", { enumerable: true, get: function () { return mcp_js_1.mcpMessages; } });
+Object.defineProperty(exports, "mcpContent", { enumerable: true, get: function () { return mcp_js_1.mcpContent; } });
+Object.defineProperty(exports, "mcpResourceToContent", { enumerable: true, get: function () { return mcp_js_1.mcpResourceToContent; } });
+Object.defineProperty(exports, "mcpResourceToFile", { enumerable: true, get: function () { return mcp_js_1.mcpResourceToFile; } });
+Object.defineProperty(exports, "UnsupportedMCPValueError", { enumerable: true, get: function () { return mcp_js_1.UnsupportedMCPValueError; } });
+// ── Runnable-tool surface ──────────────────────────────────────────────────
+var ToolError_js_1 = require("./vendor/lib/tools/ToolError.js");
+Object.defineProperty(exports, "ToolError", { enumerable: true, get: function () { return ToolError_js_1.ToolError; } });
+// ── Agent toolset ──────────────────────────────────────────────────────────
+var node_js_1 = require("./vendor/tools/agent-toolset/node.js");
+Object.defineProperty(exports, "betaAgentToolset20260401", { enumerable: true, get: function () { return node_js_1.betaAgentToolset20260401; } });
+Object.defineProperty(exports, "betaBashTool", { enumerable: true, get: function () { return node_js_1.betaBashTool; } });
+Object.defineProperty(exports, "betaReadTool", { enumerable: true, get: function () { return node_js_1.betaReadTool; } });
+Object.defineProperty(exports, "betaWriteTool", { enumerable: true, get: function () { return node_js_1.betaWriteTool; } });
+Object.defineProperty(exports, "betaEditTool", { enumerable: true, get: function () { return node_js_1.betaEditTool; } });
+Object.defineProperty(exports, "betaGlobTool", { enumerable: true, get: function () { return node_js_1.betaGlobTool; } });
+Object.defineProperty(exports, "betaGrepTool", { enumerable: true, get: function () { return node_js_1.betaGrepTool; } });
+Object.defineProperty(exports, "resolvePath", { enumerable: true, get: function () { return node_js_1.resolvePath; } });
+Object.defineProperty(exports, "BashSession", { enumerable: true, get: function () { return node_js_1.BashSession; } });
+Object.defineProperty(exports, "BashTimeoutError", { enumerable: true, get: function () { return node_js_1.BashTimeoutError; } });
+Object.defineProperty(exports, "setupSkills", { enumerable: true, get: function () { return node_js_1.setupSkills; } });
+Object.defineProperty(exports, "extractSkillArchive", { enumerable: true, get: function () { return node_js_1.extractSkillArchive; } });

package/dist/vendor/_vendor/partial-json-parser/parser.cjs

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.partialParse = void 0;
+const tokenize = (input) => {
+    let current = 0;
+    let tokens = [];
+    while (current < input.length) {
+        let char = input[current];
+        if (char === '\\') {
+            current++;
+            continue;
+        }
+        if (char === '{') {
+            tokens.push({
+                type: 'brace',
+                value: '{',
+            });
+            current++;
+            continue;
+        }
+        if (char === '}') {
+            tokens.push({
+                type: 'brace',
+                value: '}',
+            });
+            current++;
+            continue;
+        }
+        if (char === '[') {
+            tokens.push({
+                type: 'paren',
+                value: '[',
+            });
+            current++;
+            continue;
+        }
+        if (char === ']') {
+            tokens.push({
+                type: 'paren',
+                value: ']',
+            });
+            current++;
+            continue;
+        }
+        if (char === ':') {
+            tokens.push({
+                type: 'separator',
+                value: ':',
+            });
+            current++;
+            continue;
+        }
+        if (char === ',') {
+            tokens.push({
+                type: 'delimiter',
+                value: ',',
+            });
+            current++;
+            continue;
+        }
+        if (char === '"') {
+            let value = '';
+            let danglingQuote = false;
+            char = input[++current];
+            while (char !== '"') {
+                if (current === input.length) {
+                    danglingQuote = true;
+                    break;
+                }
+                if (char === '\\') {
+                    current++;
+                    if (current === input.length) {
+                        danglingQuote = true;
+                        break;
+                    }
+                    value += char + input[current];
+                    char = input[++current];
+                }
+                else {
+                    value += char;
+                    char = input[++current];
+                }
+            }
+            char = input[++current];
+            if (!danglingQuote) {
+                tokens.push({
+                    type: 'string',
+                    value,
+                });
+            }
+            continue;
+        }
+        let WHITESPACE = /\s/;
+        if (char && WHITESPACE.test(char)) {
+            current++;
+            continue;
+        }
+        let NUMBERS = /[0-9]/;
+        if ((char && NUMBERS.test(char)) || char === '-' || char === '.') {
+            let value = '';
+            if (char === '-') {
+                value += char;
+                char = input[++current];
+            }
+            while ((char && NUMBERS.test(char)) || char === '.') {
+                value += char;
+                char = input[++current];
+            }
+            tokens.push({
+                type: 'number',
+                value,
+            });
+            continue;
+        }
+        let LETTERS = /[a-z]/i;
+        if (char && LETTERS.test(char)) {
+            let value = '';
+            while (char && LETTERS.test(char)) {
+                if (current === input.length) {
+                    break;
+                }
+                value += char;
+                char = input[++current];
+            }
+            if (value == 'true' || value == 'false' || value === 'null') {
+                tokens.push({
+                    type: 'name',
+                    value,
+                });
+            }
+            else {
+                // unknown token, e.g. `nul` which isn't quite `null`
+                current++;
+                continue;
+            }
+            continue;
+        }
+        current++;
+    }
+    return tokens;
+}, strip = (tokens) => {
+    if (tokens.length === 0) {
+        return tokens;
+    }
+    let lastToken = tokens[tokens.length - 1];
+    switch (lastToken.type) {
+        case 'separator':
+            tokens = tokens.slice(0, tokens.length - 1);
+            return strip(tokens);
+            break;
+        case 'number':
+            let lastCharacterOfLastToken = lastToken.value[lastToken.value.length - 1];
+            if (lastCharacterOfLastToken === '.' || lastCharacterOfLastToken === '-') {
+                tokens = tokens.slice(0, tokens.length - 1);
+                return strip(tokens);
+            }
+        case 'string':
+            let tokenBeforeTheLastToken = tokens[tokens.length - 2];
+            if (tokenBeforeTheLastToken?.type === 'delimiter') {
+                tokens = tokens.slice(0, tokens.length - 1);
+                return strip(tokens);
+            }
+            else if (tokenBeforeTheLastToken?.type === 'brace' && tokenBeforeTheLastToken.value === '{') {
+                tokens = tokens.slice(0, tokens.length - 1);
+                return strip(tokens);
+            }
+            break;
+        case 'delimiter':
+            tokens = tokens.slice(0, tokens.length - 1);
+            return strip(tokens);
+            break;
+    }
+    return tokens;
+}, unstrip = (tokens) => {
+    let tail = [];
+    tokens.map((token) => {
+        if (token.type === 'brace') {
+            if (token.value === '{') {
+                tail.push('}');
+            }
+            else {
+                tail.splice(tail.lastIndexOf('}'), 1);
+            }
+        }
+        if (token.type === 'paren') {
+            if (token.value === '[') {
+                tail.push(']');
+            }
+            else {
+                tail.splice(tail.lastIndexOf(']'), 1);
+            }
+        }
+    });
+    if (tail.length > 0) {
+        tail.reverse().map((item) => {
+            if (item === '}') {
+                tokens.push({
+                    type: 'brace',
+                    value: '}',
+                });
+            }
+            else if (item === ']') {
+                tokens.push({
+                    type: 'paren',
+                    value: ']',
+                });
+            }
+        });
+    }
+    return tokens;
+}, generate = (tokens) => {
+    let output = '';
+    tokens.map((token) => {
+        switch (token.type) {
+            case 'string':
+                output += '"' + token.value + '"';
+                break;
+            default:
+                output += token.value;
+                break;
+        }
+    });
+    return output;
+}, partialParse = (input) => JSON.parse(generate(unstrip(strip(tokenize(input)))));
+exports.partialParse = partialParse;

package/dist/vendor/api-promise.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @deprecated Import from ./core/api-promise instead */
+__exportStar(require("./core/api-promise"), exports);