@puku-ai/sdk 4.0.3 → 4.0.5

package/dist/vendor/helpers/zod.cjs

@@ -0,0 +1,77 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodOutputFormat = zodOutputFormat;
+const transform_json_schema_1 = require("../lib/transform-json-schema");
+const z = __importStar(require("zod/v4"));
+const error_1 = require("../core/error");
+/**
+ * Creates a JSON schema output format object from the given Zod schema.
+ *
+ * If this is passed to the `.parse()` method then the response message will contain a
+ * `.parsed_output` property that is the result of parsing the content with the given Zod object.
+ *
+ * This can be passed directly to the `.create()` method but will not
+ * result in any automatic parsing, you'll have to parse the response yourself.
+ */
+function zodOutputFormat(zodObject) {
+    const jsonSchema = (0, transform_json_schema_1.transformJSONSchema)(z.toJSONSchema(zodObject, { reused: 'ref' }));
+    return {
+        type: 'json_schema',
+        schema: {
+            ...jsonSchema,
+        },
+        parse: (content) => {
+            let parsed;
+            try {
+                parsed = JSON.parse(content);
+            }
+            catch (error) {
+                throw new error_1.PukuError(`Failed to parse structured output as JSON: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            const output = zodObject.safeParse(parsed);
+            if (!output.success) {
+                const formattedIssues = output.error.issues
+                    .slice(0, 5)
+                    .map((issue) => `  - ${issue.path.join('.')}: ${issue.message}`)
+                    .join('\n');
+                const issueCount = output.error.issues.length;
+                const suffix = issueCount > 5 ? `\n  ... and ${issueCount - 5} more issue(s)` : '';
+                throw new error_1.PukuError(`Failed to parse structured output: ${output.error.message}\nValidation issues:\n${formattedIssues}${suffix}`);
+            }
+            return output.data;
+        },
+    };
+}

package/dist/vendor/index.cjs

@@ -0,0 +1,54 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+//
+// Public API surface:
+//   `PukuAI`   — client class (default + named)
+//   `BasePuku` — base class (named)
+//   `PukuError` — base error (named; static `PukuAI.PukuError` is also exposed)
+//
+// Static members on `PukuAI` mirror the upstream pattern: `PukuAI.PukuError`,
+// `PukuAI.APIError`, `PukuAI.RateLimitError`, ... are accessible directly.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Stream = exports.UnprocessableEntityError = exports.PermissionDeniedError = exports.InternalServerError = exports.AuthenticationError = exports.BadRequestError = exports.RateLimitError = exports.ConflictError = exports.NotFoundError = exports.RetryableError = exports.APIUserAbortError = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.APIError = exports.PukuError = exports.MODEL_NONSTREAMING_TOKENS = exports.FEDERATION_BETA_HEADER = exports.OAUTH_API_BETA_HEADER = exports.PagePromise = exports.AI_PROMPT = exports.HUMAN_PROMPT = exports.BetaFallbackState = exports.betaRefusalFallbackMiddleware = exports.APIPromise = exports.toFile = exports.VERSION = exports.BasePuku = exports.PukuAI = exports.default = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return client_js_1.PukuAI; } });
+Object.defineProperty(exports, "PukuAI", { enumerable: true, get: function () { return client_js_1.PukuAI; } });
+Object.defineProperty(exports, "BasePuku", { enumerable: true, get: function () { return client_js_1.BasePuku; } });
+var version_js_1 = require("./version.js");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_js_1.VERSION; } });
+var uploads_js_1 = require("./core/uploads.js");
+Object.defineProperty(exports, "toFile", { enumerable: true, get: function () { return uploads_js_1.toFile; } });
+var api_promise_js_1 = require("./core/api-promise.js");
+Object.defineProperty(exports, "APIPromise", { enumerable: true, get: function () { return api_promise_js_1.APIPromise; } });
+var middleware_js_1 = require("./lib/middleware.js");
+Object.defineProperty(exports, "betaRefusalFallbackMiddleware", { enumerable: true, get: function () { return middleware_js_1.betaRefusalFallbackMiddleware; } });
+Object.defineProperty(exports, "BetaFallbackState", { enumerable: true, get: function () { return middleware_js_1.BetaFallbackState; } });
+var client_js_2 = require("./client.js");
+Object.defineProperty(exports, "HUMAN_PROMPT", { enumerable: true, get: function () { return client_js_2.HUMAN_PROMPT; } });
+Object.defineProperty(exports, "AI_PROMPT", { enumerable: true, get: function () { return client_js_2.AI_PROMPT; } });
+var pagination_js_1 = require("./core/pagination.js");
+Object.defineProperty(exports, "PagePromise", { enumerable: true, get: function () { return pagination_js_1.PagePromise; } });
+// ── Constants ──────────────────────────────────────────────────────────────
+var types_js_1 = require("./lib/credentials/types.js");
+Object.defineProperty(exports, "OAUTH_API_BETA_HEADER", { enumerable: true, get: function () { return types_js_1.OAUTH_API_BETA_HEADER; } });
+Object.defineProperty(exports, "FEDERATION_BETA_HEADER", { enumerable: true, get: function () { return types_js_1.FEDERATION_BETA_HEADER; } });
+var constants_js_1 = require("./internal/constants.js");
+Object.defineProperty(exports, "MODEL_NONSTREAMING_TOKENS", { enumerable: true, get: function () { return constants_js_1.MODEL_NONSTREAMING_TOKENS; } });
+var error_js_1 = require("./core/error.js");
+Object.defineProperty(exports, "PukuError", { enumerable: true, get: function () { return error_js_1.PukuError; } });
+Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return error_js_1.APIError; } });
+Object.defineProperty(exports, "APIConnectionError", { enumerable: true, get: function () { return error_js_1.APIConnectionError; } });
+Object.defineProperty(exports, "APIConnectionTimeoutError", { enumerable: true, get: function () { return error_js_1.APIConnectionTimeoutError; } });
+Object.defineProperty(exports, "APIUserAbortError", { enumerable: true, get: function () { return error_js_1.APIUserAbortError; } });
+Object.defineProperty(exports, "RetryableError", { enumerable: true, get: function () { return error_js_1.RetryableError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return error_js_1.NotFoundError; } });
+Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return error_js_1.ConflictError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return error_js_1.RateLimitError; } });
+Object.defineProperty(exports, "BadRequestError", { enumerable: true, get: function () { return error_js_1.BadRequestError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return error_js_1.AuthenticationError; } });
+Object.defineProperty(exports, "InternalServerError", { enumerable: true, get: function () { return error_js_1.InternalServerError; } });
+Object.defineProperty(exports, "PermissionDeniedError", { enumerable: true, get: function () { return error_js_1.PermissionDeniedError; } });
+Object.defineProperty(exports, "UnprocessableEntityError", { enumerable: true, get: function () { return error_js_1.UnprocessableEntityError; } });
+// ── Streaming class ─────────────────────────────────────────────────────────
+var streaming_js_1 = require("./core/streaming.js");
+Object.defineProperty(exports, "Stream", { enumerable: true, get: function () { return streaming_js_1.Stream; } });

package/dist/vendor/internal/builtin-types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/vendor/internal/constants.cjs

@@ -0,0 +1,12 @@
+"use strict";
+// File containing shared constants
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_NONSTREAMING_TOKENS = void 0;
+/**
+ * Model-specific timeout constraints for non-streaming requests
+ */
+exports.MODEL_NONSTREAMING_TOKENS = {
+    'puku-ai-2.7': 8192,
+    'puku-ai-2.8': 8192,
+    'opus-4.8': 8192,
+};

package/dist/vendor/internal/decoders/jsonl.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONLDecoder = void 0;
+const error_1 = require("../../core/error");
+const shims_1 = require("../shims");
+const line_1 = require("./line");
+class JSONLDecoder {
+    iterator;
+    controller;
+    constructor(iterator, controller) {
+        this.iterator = iterator;
+        this.controller = controller;
+    }
+    async *decoder() {
+        const lineDecoder = new line_1.LineDecoder();
+        for await (const chunk of this.iterator) {
+            for (const line of lineDecoder.decode(chunk)) {
+                yield JSON.parse(line);
+            }
+        }
+        for (const line of lineDecoder.flush()) {
+            yield JSON.parse(line);
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return this.decoder();
+    }
+    static fromResponse(response, controller) {
+        if (!response.body) {
+            controller.abort();
+            if (typeof globalThis.navigator !== 'undefined' &&
+                globalThis.navigator.product === 'ReactNative') {
+                throw new error_1.PukuError(`The default react-native fetch implementation does not support streaming. Please use expo/fetch: https://docs.expo.dev/versions/latest/sdk/expo/#expofetch-api`);
+            }
+            throw new error_1.PukuError(`Attempted to iterate over a response with no body`);
+        }
+        return new JSONLDecoder((0, shims_1.ReadableStreamToAsyncIterable)(response.body), controller);
+    }
+}
+exports.JSONLDecoder = JSONLDecoder;

package/dist/vendor/internal/decoders/line.cjs

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LineDecoder = void 0;
+exports.findDoubleNewlineIndex = findDoubleNewlineIndex;
+const bytes_1 = require("../utils/bytes");
+/**
+ * A re-implementation of httpx's `LineDecoder` in Python that handles incrementally
+ * reading lines from text.
+ *
+ *
+ */
+class LineDecoder {
+    // prettier-ignore
+    static NEWLINE_CHARS = new Set(['\n', '\r']);
+    static NEWLINE_REGEXP = /\r\n|[\n\r]/g;
+    #buffer;
+    #carriageReturnIndex;
+    constructor() {
+        this.#buffer = new Uint8Array();
+        this.#carriageReturnIndex = null;
+    }
+    decode(chunk) {
+        if (chunk == null) {
+            return [];
+        }
+        const binaryChunk = chunk instanceof ArrayBuffer ? new Uint8Array(chunk)
+            : typeof chunk === 'string' ? (0, bytes_1.encodeUTF8)(chunk)
+                : chunk;
+        this.#buffer = (0, bytes_1.concatBytes)([this.#buffer, binaryChunk]);
+        const lines = [];
+        let patternIndex;
+        while ((patternIndex = findNewlineIndex(this.#buffer, this.#carriageReturnIndex)) != null) {
+            if (patternIndex.carriage && this.#carriageReturnIndex == null) {
+                // skip until we either get a corresponding `\n`, a new `\r` or nothing
+                this.#carriageReturnIndex = patternIndex.index;
+                continue;
+            }
+            // we got double \r or \rtext\n
+            if (this.#carriageReturnIndex != null &&
+                (patternIndex.index !== this.#carriageReturnIndex + 1 || patternIndex.carriage)) {
+                lines.push((0, bytes_1.decodeUTF8)(this.#buffer.subarray(0, this.#carriageReturnIndex - 1)));
+                this.#buffer = this.#buffer.subarray(this.#carriageReturnIndex);
+                this.#carriageReturnIndex = null;
+                continue;
+            }
+            const endIndex = this.#carriageReturnIndex !== null ? patternIndex.preceding - 1 : patternIndex.preceding;
+            const line = (0, bytes_1.decodeUTF8)(this.#buffer.subarray(0, endIndex));
+            lines.push(line);
+            this.#buffer = this.#buffer.subarray(patternIndex.index);
+            this.#carriageReturnIndex = null;
+        }
+        return lines;
+    }
+    flush() {
+        if (!this.#buffer.length) {
+            return [];
+        }
+        return this.decode('\n');
+    }
+}
+exports.LineDecoder = LineDecoder;
+/**
+ * This function searches the buffer for the end patterns, (\r or \n)
+ * and returns an object with the index preceding the matched newline and the
+ * index after the newline char. `null` is returned if no new line is found.
+ *
+ * ```ts
+ * findNewLineIndex('abc\ndef') -> { preceding: 2, index: 3 }
+ * ```
+ */
+function findNewlineIndex(buffer, startIndex) {
+    const newline = 0x0a; // \n
+    const carriage = 0x0d; // \r
+    for (let i = startIndex ?? 0; i < buffer.length; i++) {
+        if (buffer[i] === newline) {
+            return { preceding: i, index: i + 1, carriage: false };
+        }
+        if (buffer[i] === carriage) {
+            return { preceding: i, index: i + 1, carriage: true };
+        }
+    }
+    return null;
+}
+function findDoubleNewlineIndex(buffer) {
+    // This function searches the buffer for the end patterns (\r\r, \n\n, \r\n\r\n)
+    // and returns the index right after the first occurrence of any pattern,
+    // or -1 if none of the patterns are found.
+    const newline = 0x0a; // \n
+    const carriage = 0x0d; // \r
+    for (let i = 0; i < buffer.length - 1; i++) {
+        if (buffer[i] === newline && buffer[i + 1] === newline) {
+            // \n\n
+            return i + 2;
+        }
+        if (buffer[i] === carriage && buffer[i + 1] === carriage) {
+            // \r\r
+            return i + 2;
+        }
+        if (buffer[i] === carriage &&
+            buffer[i + 1] === newline &&
+            i + 3 < buffer.length &&
+            buffer[i + 2] === carriage &&
+            buffer[i + 3] === newline) {
+            // \r\n\r\n
+            return i + 4;
+        }
+    }
+    return -1;
+}

package/dist/vendor/internal/detect-platform.cjs

@@ -0,0 +1,159 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlatformHeaders = exports.isRunningInBrowser = void 0;
+const version_1 = require("../version");
+const isRunningInBrowser = () => {
+    return (
+    // @ts-ignore
+    typeof window !== 'undefined' &&
+        // @ts-ignore
+        typeof window.document !== 'undefined' &&
+        // @ts-ignore
+        typeof navigator !== 'undefined');
+};
+exports.isRunningInBrowser = isRunningInBrowser;
+/**
+ * Note this does not detect 'browser'; for that, use getBrowserInfo().
+ */
+function getDetectedPlatform() {
+    if (typeof Deno !== 'undefined' && Deno.build != null) {
+        return 'deno';
+    }
+    if (typeof EdgeRuntime !== 'undefined') {
+        return 'edge';
+    }
+    if (Object.prototype.toString.call(typeof globalThis.process !== 'undefined' ? globalThis.process : 0) === '[object process]') {
+        return 'node';
+    }
+    return 'unknown';
+}
+const getPlatformProperties = () => {
+    const detectedPlatform = getDetectedPlatform();
+    if (detectedPlatform === 'deno') {
+        return {
+            'X-Stainless-Lang': 'js',
+            'X-Stainless-Package-Version': version_1.VERSION,
+            'X-Stainless-OS': normalizePlatform(Deno.build.os),
+            'X-Stainless-Arch': normalizeArch(Deno.build.arch),
+            'X-Stainless-Runtime': 'deno',
+            'X-Stainless-Runtime-Version': typeof Deno.version === 'string' ? Deno.version : Deno.version?.deno ?? 'unknown',
+        };
+    }
+    if (typeof EdgeRuntime !== 'undefined') {
+        return {
+            'X-Stainless-Lang': 'js',
+            'X-Stainless-Package-Version': version_1.VERSION,
+            'X-Stainless-OS': 'Unknown',
+            'X-Stainless-Arch': `other:${EdgeRuntime}`,
+            'X-Stainless-Runtime': 'edge',
+            'X-Stainless-Runtime-Version': globalThis.process?.version ?? 'unknown',
+        };
+    }
+    // Check if Node.js
+    if (detectedPlatform === 'node') {
+        return {
+            'X-Stainless-Lang': 'js',
+            'X-Stainless-Package-Version': version_1.VERSION,
+            'X-Stainless-OS': normalizePlatform(globalThis.process.platform ?? 'unknown'),
+            'X-Stainless-Arch': normalizeArch(globalThis.process.arch ?? 'unknown'),
+            'X-Stainless-Runtime': 'node',
+            'X-Stainless-Runtime-Version': globalThis.process.version ?? 'unknown',
+        };
+    }
+    const browserInfo = getBrowserInfo();
+    if (browserInfo) {
+        return {
+            'X-Stainless-Lang': 'js',
+            'X-Stainless-Package-Version': version_1.VERSION,
+            'X-Stainless-OS': 'Unknown',
+            'X-Stainless-Arch': 'unknown',
+            'X-Stainless-Runtime': `browser:${browserInfo.browser}`,
+            'X-Stainless-Runtime-Version': browserInfo.version,
+        };
+    }
+    // TODO add support for Cloudflare workers, etc.
+    return {
+        'X-Stainless-Lang': 'js',
+        'X-Stainless-Package-Version': version_1.VERSION,
+        'X-Stainless-OS': 'Unknown',
+        'X-Stainless-Arch': 'unknown',
+        'X-Stainless-Runtime': 'unknown',
+        'X-Stainless-Runtime-Version': 'unknown',
+    };
+};
+// Note: modified from https://github.com/JS-DevTools/host-environment/blob/b1ab79ecde37db5d6e163c050e54fe7d287d7c92/src/isomorphic.browser.ts
+function getBrowserInfo() {
+    if (typeof navigator === 'undefined' || !navigator) {
+        return null;
+    }
+    // NOTE: The order matters here!
+    const browserPatterns = [
+        { key: 'edge', pattern: /Edge(?:\W+(\d+)\.(\d+)(?:\.(\d+))?)?/ },
+        { key: 'ie', pattern: /MSIE(?:\W+(\d+)\.(\d+)(?:\.(\d+))?)?/ },
+        { key: 'ie', pattern: /Trident(?:.*rv\:(\d+)\.(\d+)(?:\.(\d+))?)?/ },
+        { key: 'chrome', pattern: /Chrome(?:\W+(\d+)\.(\d+)(?:\.(\d+))?)?/ },
+        { key: 'firefox', pattern: /Firefox(?:\W+(\d+)\.(\d+)(?:\.(\d+))?)?/ },
+        { key: 'safari', pattern: /(?:Version\W+(\d+)\.(\d+)(?:\.(\d+))?)?(?:\W+Mobile\S*)?\W+Safari/ },
+    ];
+    // Find the FIRST matching browser
+    for (const { key, pattern } of browserPatterns) {
+        const match = pattern.exec(navigator.userAgent);
+        if (match) {
+            const major = match[1] || 0;
+            const minor = match[2] || 0;
+            const patch = match[3] || 0;
+            return { browser: key, version: `${major}.${minor}.${patch}` };
+        }
+    }
+    return null;
+}
+const normalizeArch = (arch) => {
+    // Node docs:
+    // - https://nodejs.org/api/process.html#processarch
+    // Deno docs:
+    // - https://doc.deno.land/deno/stable/~/Deno.build
+    if (arch === 'x32')
+        return 'x32';
+    if (arch === 'x86_64' || arch === 'x64')
+        return 'x64';
+    if (arch === 'arm')
+        return 'arm';
+    if (arch === 'aarch64' || arch === 'arm64')
+        return 'arm64';
+    if (arch)
+        return `other:${arch}`;
+    return 'unknown';
+};
+const normalizePlatform = (platform) => {
+    // Node platforms:
+    // - https://nodejs.org/api/process.html#processplatform
+    // Deno platforms:
+    platform = platform.toLowerCase();
+    // NOTE: this iOS check is untested and may not work
+    // Node does not work natively on IOS, there is a fork at
+    // https://github.com/nodejs-mobile/nodejs-mobile
+    // however it is unknown at the time of writing how to detect if it is running
+    if (platform.includes('ios'))
+        return 'iOS';
+    if (platform === 'android')
+        return 'Android';
+    if (platform === 'darwin')
+        return 'MacOS';
+    if (platform === 'win32')
+        return 'Windows';
+    if (platform === 'freebsd')
+        return 'FreeBSD';
+    if (platform === 'openbsd')
+        return 'OpenBSD';
+    if (platform === 'linux')
+        return 'Linux';
+    if (platform)
+        return `Other:${platform}`;
+    return 'Unknown';
+};
+let _platformHeaders;
+const getPlatformHeaders = () => {
+    return (_platformHeaders ??= getPlatformProperties());
+};
+exports.getPlatformHeaders = getPlatformHeaders;

package/dist/vendor/internal/errors.cjs

@@ -0,0 +1,42 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castToError = void 0;
+exports.isAbortError = isAbortError;
+function isAbortError(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        // Spec-compliant fetch implementations
+        (('name' in err && err.name === 'AbortError') ||
+            // Expo fetch
+            ('message' in err && String(err.message).includes('FetchRequestCanceledException'))));
+}
+const castToError = (err) => {
+    if (err instanceof Error)
+        return err;
+    if (typeof err === 'object' && err !== null) {
+        try {
+            const tag = Object.prototype.toString.call(err);
+            // cross-realm errors (e.g. undici's abort `DOMException` under jest) fail `instanceof Error`
+            if (tag === '[object Error]' || tag === '[object DOMException]') {
+                // @ts-ignore - not all envs have native support for cause yet
+                const error = new Error(err.message, err.cause ? { cause: err.cause } : {});
+                if (err.stack)
+                    error.stack = err.stack;
+                // @ts-ignore - not all envs have native support for cause yet
+                if (err.cause && !error.cause)
+                    error.cause = err.cause;
+                if (err.name)
+                    error.name = err.name;
+                return error;
+            }
+        }
+        catch { }
+        try {
+            return new Error(JSON.stringify(err));
+        }
+        catch { }
+    }
+    return new Error(err);
+};
+exports.castToError = castToError;