@puku-ai/sdk 4.0.3 → 4.0.4

package/dist/vendor/resources/beta/vaults/vaults.cjs

@@ -0,0 +1,177 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+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.Vaults = void 0;
+const resource_1 = require("../../../core/resource");
+const CredentialsAPI = __importStar(require("./credentials"));
+const credentials_1 = require("./credentials");
+const pagination_1 = require("../../../core/pagination");
+const headers_1 = require("../../../internal/headers");
+const path_1 = require("../../../internal/utils/path");
+class Vaults extends resource_1.APIResource {
+    credentials = new CredentialsAPI.Credentials(this._client);
+    /**
+     * Create Vault
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsVault =
+     *   await client.beta.vaults.create({
+     *     display_name: 'Example vault',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1/vaults?beta=true', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get Vault
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsVault =
+     *   await client.beta.vaults.retrieve(
+     *     'vlt_011CZkZDLs7fYzm1hXNPeRjv',
+     *   );
+     * ```
+     */
+    retrieve(vaultID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/vaults/${vaultID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Update Vault
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsVault =
+     *   await client.beta.vaults.update(
+     *     'vlt_011CZkZDLs7fYzm1hXNPeRjv',
+     *   );
+     * ```
+     */
+    update(vaultID, params, options) {
+        const { betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/vaults/${vaultID}?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List Vaults
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsVault of client.beta.vaults.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList('/v1/vaults?beta=true', (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete Vault
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeletedVault =
+     *   await client.beta.vaults.delete(
+     *     'vlt_011CZkZDLs7fYzm1hXNPeRjv',
+     *   );
+     * ```
+     */
+    delete(vaultID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.delete((0, path_1.path) `/v1/vaults/${vaultID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Archive Vault
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsVault =
+     *   await client.beta.vaults.archive(
+     *     'vlt_011CZkZDLs7fYzm1hXNPeRjv',
+     *   );
+     * ```
+     */
+    archive(vaultID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.post((0, path_1.path) `/v1/vaults/${vaultID}/archive?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Vaults = Vaults;
+Vaults.Credentials = credentials_1.Credentials;

package/dist/vendor/resources/beta/vaults.cjs

@@ -0,0 +1,18 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+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 });
+__exportStar(require("./vaults/index"), exports);

package/dist/vendor/resources/beta/webhooks.cjs

@@ -0,0 +1,32 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Webhooks = void 0;
+const resource_1 = require("../../core/resource");
+const standardwebhooks_1 = require("standardwebhooks");
+class Webhooks extends resource_1.APIResource {
+    /**
+     * Parses a webhook payload into an event without verifying its signature. Prefer
+     * `unwrap()` unless you have already verified the signature yourself.
+     */
+    parseUnverified(body) {
+        return JSON.parse(body);
+    }
+    /**
+     * Verifies the webhook signature from the `webhook-id`, `webhook-timestamp` and
+     * `webhook-signature` headers using your webhook signing key, then parses the
+     * payload into an event. Fails if the signature is missing or invalid.
+     */
+    unwrap(body, options) {
+        const headers = options?.headers;
+        if (headers == null)
+            throw new Error('Webhook headers are required in order to verify the signature');
+        const keyStr = options.key === undefined ? this._client.webhookKey : options.key;
+        if (!keyStr)
+            throw new Error('Webhook key must not be null or empty in order to unwrap');
+        const wh = new standardwebhooks_1.Webhook(keyStr);
+        wh.verify(body, headers);
+        return JSON.parse(body);
+    }
+}
+exports.Webhooks = Webhooks;

package/dist/vendor/resources/beta.cjs

@@ -0,0 +1,18 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+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 });
+__exportStar(require("./beta/index"), exports);

package/dist/vendor/resources/completions.cjs

@@ -0,0 +1,22 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Completions = void 0;
+const resource_1 = require("../core/resource");
+const headers_1 = require("../internal/headers");
+class Completions extends resource_1.APIResource {
+    create(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1/complete', {
+            body,
+            timeout: this._client._options.timeout ?? 600000,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+            stream: params.stream ?? false,
+        });
+    }
+}
+exports.Completions = Completions;

package/dist/vendor/resources/files.cjs

@@ -0,0 +1,51 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Files = void 0;
+const resource_1 = require("../core/resource");
+const pagination_1 = require("../core/pagination");
+const headers_1 = require("../internal/headers");
+const stainless_helper_header_1 = require("../internal/stainless-helper-header");
+const uploads_1 = require("../internal/uploads");
+const path_1 = require("../internal/utils/path");
+class Files extends resource_1.APIResource {
+    /**
+     * List Files
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/files', (pagination_1.PageCursor), { query, ...options });
+    }
+    /**
+     * Delete File
+     */
+    delete(fileID, options) {
+        return this._client.delete((0, path_1.path) `/v1/files/${fileID}`, options);
+    }
+    /**
+     * Download File
+     */
+    download(fileID, options) {
+        return this._client.get((0, path_1.path) `/v1/files/${fileID}/content`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: 'application/binary' }, options?.headers]),
+            __binaryResponse: true,
+        });
+    }
+    /**
+     * Get File Metadata
+     */
+    retrieveMetadata(fileID, options) {
+        return this._client.get((0, path_1.path) `/v1/files/${fileID}`, options);
+    }
+    /**
+     * Upload File
+     */
+    upload(body, options) {
+        return this._client.post('/v1/files', (0, uploads_1.multipartFormRequestOptions)({
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([(0, stainless_helper_header_1.stainlessHelperHeaderFromFile)(body.file), options?.headers]),
+        }, this._client));
+    }
+}
+exports.Files = Files;

package/dist/vendor/resources/index.cjs

@@ -0,0 +1,31 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+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 });
+exports.Skills = exports.Models = exports.Messages = exports.Files = exports.Completions = exports.Beta = void 0;
+__exportStar(require("./shared"), exports);
+var beta_1 = require("./beta/beta");
+Object.defineProperty(exports, "Beta", { enumerable: true, get: function () { return beta_1.Beta; } });
+var completions_1 = require("./completions");
+Object.defineProperty(exports, "Completions", { enumerable: true, get: function () { return completions_1.Completions; } });
+var files_1 = require("./files");
+Object.defineProperty(exports, "Files", { enumerable: true, get: function () { return files_1.Files; } });
+var messages_1 = require("./messages/messages");
+Object.defineProperty(exports, "Messages", { enumerable: true, get: function () { return messages_1.Messages; } });
+var models_1 = require("./models");
+Object.defineProperty(exports, "Models", { enumerable: true, get: function () { return models_1.Models; } });
+var skills_1 = require("./skills/skills");
+Object.defineProperty(exports, "Skills", { enumerable: true, get: function () { return skills_1.Skills; } });

package/dist/vendor/resources/messages/batches.cjs

@@ -0,0 +1,160 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Batches = void 0;
+const resource_1 = require("../../core/resource");
+const pagination_1 = require("../../core/pagination");
+const headers_1 = require("../../internal/headers");
+const jsonl_1 = require("../../internal/decoders/jsonl");
+const error_1 = require("../../error");
+const path_1 = require("../../internal/utils/path");
+class Batches extends resource_1.APIResource {
+    /**
+     * Send a batch of Message creation requests.
+     *
+     * The Message Batches API can be used to process multiple Messages API requests at
+     * once. Once a Message Batch is created, it begins processing immediately. Batches
+     * can take up to 24 hours to complete.
+     *
+     * Learn more about the Message Batches API in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/batch-processing)
+     *
+     * @example
+     * ```ts
+     * const messageBatch = await client.messages.batches.create({
+     *   requests: [
+     *     {
+     *       custom_id: 'my-custom-id-1',
+     *       params: {
+     *         max_tokens: 1024,
+     *         messages: [
+     *           { content: 'Hello, world', role: 'user' },
+     *         ],
+     *         model: 'puku-ai-2.8',
+     *       },
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { user_profile_id, ...body } = params;
+        return this._client.post('/v1/messages/batches', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(user_profile_id != null ? { 'puku-user-profile-id': user_profile_id } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * This endpoint is idempotent and can be used to poll for Message Batch
+     * completion. To access the results of a Message Batch, make a request to the
+     * `results_url` field in the response.
+     *
+     * Learn more about the Message Batches API in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/batch-processing)
+     *
+     * @example
+     * ```ts
+     * const messageBatch = await client.messages.batches.retrieve(
+     *   'message_batch_id',
+     * );
+     * ```
+     */
+    retrieve(messageBatchID, options) {
+        return this._client.get((0, path_1.path) `/v1/messages/batches/${messageBatchID}`, options);
+    }
+    /**
+     * List all Message Batches within a Workspace. Most recently created batches are
+     * returned first.
+     *
+     * Learn more about the Message Batches API in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/batch-processing)
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const messageBatch of client.messages.batches.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/messages/batches', (pagination_1.Page), { query, ...options });
+    }
+    /**
+     * Delete a Message Batch.
+     *
+     * Message Batches can only be deleted once they've finished processing. If you'd
+     * like to delete an in-progress batch, you must first cancel it.
+     *
+     * Learn more about the Message Batches API in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/batch-processing)
+     *
+     * @example
+     * ```ts
+     * const deletedMessageBatch =
+     *   await client.messages.batches.delete('message_batch_id');
+     * ```
+     */
+    delete(messageBatchID, options) {
+        return this._client.delete((0, path_1.path) `/v1/messages/batches/${messageBatchID}`, options);
+    }
+    /**
+     * Batches may be canceled any time before processing ends. Once cancellation is
+     * initiated, the batch enters a `canceling` state, at which time the system may
+     * complete any in-progress, non-interruptible requests before finalizing
+     * cancellation.
+     *
+     * The number of canceled requests is specified in `request_counts`. To determine
+     * which requests were canceled, check the individual results within the batch.
+     * Note that cancellation may not result in any canceled requests if they were
+     * non-interruptible.
+     *
+     * Learn more about the Message Batches API in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/batch-processing)
+     *
+     * @example
+     * ```ts
+     * const messageBatch = await client.messages.batches.cancel(
+     *   'message_batch_id',
+     * );
+     * ```
+     */
+    cancel(messageBatchID, options) {
+        return this._client.post((0, path_1.path) `/v1/messages/batches/${messageBatchID}/cancel`, options);
+    }
+    /**
+     * Streams the results of a Message Batch as a `.jsonl` file.
+     *
+     * Each line in the file is a JSON object containing the result of a single request
+     * in the Message Batch. Results are not guaranteed to be in the same order as
+     * requests. Use the `custom_id` field to match results to requests.
+     *
+     * Learn more about the Message Batches API in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/batch-processing)
+     *
+     * @example
+     * ```ts
+     * const messageBatchIndividualResponse =
+     *   await client.messages.batches.results('message_batch_id');
+     * ```
+     */
+    async results(messageBatchID, options) {
+        const batch = await this.retrieve(messageBatchID);
+        if (!batch.results_url) {
+            throw new error_1.PukuError(`No batch \`results_url\`; Has it finished processing? ${batch.processing_status} - ${batch.id}`);
+        }
+        return this._client
+            .get(batch.results_url, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: 'application/binary' }, options?.headers]),
+            stream: true,
+            __binaryResponse: true,
+        })
+            ._thenUnwrap((_, props) => jsonl_1.JSONLDecoder.fromResponse(props.response, props.controller));
+    }
+}
+exports.Batches = Batches;

package/dist/vendor/resources/messages/index.cjs

@@ -0,0 +1,8 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = exports.Batches = void 0;
+var batches_1 = require("./batches");
+Object.defineProperty(exports, "Batches", { enumerable: true, get: function () { return batches_1.Batches; } });
+var messages_1 = require("./messages");
+Object.defineProperty(exports, "Messages", { enumerable: true, get: function () { return messages_1.Messages; } });