@puku-ai/sdk 4.0.3 → 4.0.4

package/dist/vendor/lib/tools/ToolError.cjs

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolError = void 0;
+/**
+ * An error that can be thrown from a tool's `run` method to return structured
+ * content blocks as the error result, rather than just a string message.
+ *
+ * When the ToolRunner catches this error, it will use the `content` property
+ * as the tool result with `is_error: true`.
+ *
+ * @example
+ * ```ts
+ * const tool = {
+ *   name: 'my_tool',
+ *   run: async (input) => {
+ *     if (somethingWentWrong) {
+ *       throw new ToolError([
+ *         { type: 'text', text: 'Error details here' },
+ *         { type: 'image', source: { type: 'base64', data: '...', media_type: 'image/png' } },
+ *       ]);
+ *     }
+ *     return 'success';
+ *   },
+ * };
+ * ```
+ */
+class ToolError extends Error {
+    /**
+     * The content to return as the tool result. This will be sent back to the model
+     * with `is_error: true`.
+     */
+    content;
+    constructor(content) {
+        const message = typeof content === 'string' ? content : (content
+            .map((block) => {
+            if (block.type === 'text')
+                return block.text;
+            return `[${block.type}]`;
+        })
+            .join(' '));
+        super(message);
+        this.name = 'ToolError';
+        this.content = content;
+    }
+}
+exports.ToolError = ToolError;

package/dist/vendor/lib/transform-json-schema.cjs

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformJSONSchema = transformJSONSchema;
+const utils_1 = require("../internal/utils");
+// Supported string formats
+const SUPPORTED_STRING_FORMATS = new Set([
+    'date-time',
+    'time',
+    'date',
+    'duration',
+    'email',
+    'hostname',
+    'uri',
+    'ipv4',
+    'ipv6',
+    'uuid',
+]);
+function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+function transformJSONSchema(jsonSchema) {
+    const workingCopy = deepClone(jsonSchema);
+    return _transformJSONSchema(workingCopy);
+}
+function _transformJSONSchema(jsonSchema) {
+    const strictSchema = {};
+    const ref = (0, utils_1.pop)(jsonSchema, '$ref');
+    if (ref !== undefined) {
+        strictSchema['$ref'] = ref;
+        return strictSchema;
+    }
+    const defs = (0, utils_1.pop)(jsonSchema, '$defs');
+    if (defs !== undefined) {
+        const strictDefs = {};
+        strictSchema['$defs'] = strictDefs;
+        for (const [name, defSchema] of Object.entries(defs)) {
+            strictDefs[name] = _transformJSONSchema(defSchema);
+        }
+    }
+    const type = (0, utils_1.pop)(jsonSchema, 'type');
+    const anyOf = (0, utils_1.pop)(jsonSchema, 'anyOf');
+    const oneOf = (0, utils_1.pop)(jsonSchema, 'oneOf');
+    const allOf = (0, utils_1.pop)(jsonSchema, 'allOf');
+    if (Array.isArray(anyOf)) {
+        strictSchema['anyOf'] = anyOf.map((variant) => _transformJSONSchema(variant));
+    }
+    else if (Array.isArray(oneOf)) {
+        strictSchema['anyOf'] = oneOf.map((variant) => _transformJSONSchema(variant));
+    }
+    else if (Array.isArray(allOf)) {
+        strictSchema['allOf'] = allOf.map((entry) => _transformJSONSchema(entry));
+    }
+    else {
+        if (type === undefined) {
+            throw new Error('JSON schema must have a type defined if anyOf/oneOf/allOf are not used');
+        }
+        strictSchema['type'] = type;
+    }
+    const description = (0, utils_1.pop)(jsonSchema, 'description');
+    if (description !== undefined) {
+        strictSchema['description'] = description;
+    }
+    const title = (0, utils_1.pop)(jsonSchema, 'title');
+    if (title !== undefined) {
+        strictSchema['title'] = title;
+    }
+    if (type === 'object') {
+        const properties = (0, utils_1.pop)(jsonSchema, 'properties') || {};
+        strictSchema['properties'] = Object.fromEntries(Object.entries(properties).map(([key, propSchema]) => [
+            key,
+            _transformJSONSchema(propSchema),
+        ]));
+        (0, utils_1.pop)(jsonSchema, 'additionalProperties');
+        strictSchema['additionalProperties'] = false;
+        const required = (0, utils_1.pop)(jsonSchema, 'required');
+        if (required !== undefined) {
+            strictSchema['required'] = required;
+        }
+    }
+    else if (type === 'string') {
+        const format = (0, utils_1.pop)(jsonSchema, 'format');
+        if (format !== undefined && SUPPORTED_STRING_FORMATS.has(format)) {
+            strictSchema['format'] = format;
+        }
+        else if (format !== undefined) {
+            jsonSchema['format'] = format;
+        }
+    }
+    else if (type === 'array') {
+        const items = (0, utils_1.pop)(jsonSchema, 'items');
+        if (items !== undefined) {
+            strictSchema['items'] = _transformJSONSchema(items);
+        }
+        const minItems = (0, utils_1.pop)(jsonSchema, 'minItems');
+        if (minItems !== undefined && (minItems === 0 || minItems === 1)) {
+            strictSchema['minItems'] = minItems;
+        }
+        else if (minItems !== undefined) {
+            jsonSchema['minItems'] = minItems;
+        }
+    }
+    if (Object.keys(jsonSchema).length > 0) {
+        const existingDescription = strictSchema['description'];
+        strictSchema['description'] =
+            (existingDescription ? existingDescription + '\n\n' : '') +
+                '{' +
+                Object.entries(jsonSchema)
+                    .map(([key, value]) => `${key}: ${JSON.stringify(value)}`)
+                    .join(', ') +
+                '}';
+    }
+    return strictSchema;
+}

package/dist/vendor/pagination.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/pagination instead */
+__exportStar(require("./core/pagination"), exports);

package/dist/vendor/resource.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/resource instead */
+__exportStar(require("./core/resource"), exports);

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

@@ -0,0 +1,159 @@
+"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.Agents = void 0;
+const resource_1 = require("../../../core/resource");
+const VersionsAPI = __importStar(require("./versions"));
+const versions_1 = require("./versions");
+const pagination_1 = require("../../../core/pagination");
+const headers_1 = require("../../../internal/headers");
+const path_1 = require("../../../internal/utils/path");
+class Agents extends resource_1.APIResource {
+    versions = new VersionsAPI.Versions(this._client);
+    /**
+     * Create Agent
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsAgent =
+     *   await client.beta.agents.create({
+     *     model: 'puku-ai-2.8',
+     *     name: 'My First Agent',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1/agents?beta=true', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get Agent
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsAgent =
+     *   await client.beta.agents.retrieve(
+     *     'agent_011CZkYpogX7uDKUyvBTophP',
+     *   );
+     * ```
+     */
+    retrieve(agentID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/agents/${agentID}?beta=true`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Update Agent
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsAgent =
+     *   await client.beta.agents.update(
+     *     'agent_011CZkYpogX7uDKUyvBTophP',
+     *     { description: 'updated' },
+     *   );
+     * ```
+     */
+    update(agentID, params, options) {
+        const { betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/agents/${agentID}?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List Agents
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsAgent of client.beta.agents.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList('/v1/agents?beta=true', (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Archive Agent
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsAgent =
+     *   await client.beta.agents.archive(
+     *     'agent_011CZkYpogX7uDKUyvBTophP',
+     *   );
+     * ```
+     */
+    archive(agentID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.post((0, path_1.path) `/v1/agents/${agentID}/archive?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Agents = Agents;
+Agents.Versions = versions_1.Versions;

package/dist/vendor/resources/beta/agents/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.Versions = exports.Agents = void 0;
+var agents_1 = require("./agents");
+Object.defineProperty(exports, "Agents", { enumerable: true, get: function () { return agents_1.Agents; } });
+var versions_1 = require("./versions");
+Object.defineProperty(exports, "Versions", { enumerable: true, get: function () { return versions_1.Versions; } });

package/dist/vendor/resources/beta/agents/versions.cjs

@@ -0,0 +1,35 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Versions = void 0;
+const resource_1 = require("../../../core/resource");
+const pagination_1 = require("../../../core/pagination");
+const headers_1 = require("../../../internal/headers");
+const path_1 = require("../../../internal/utils/path");
+class Versions extends resource_1.APIResource {
+    /**
+     * List Agent Versions
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsAgent of client.beta.agents.versions.list(
+     *   'agent_011CZkYpogX7uDKUyvBTophP',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(agentID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/agents/${agentID}/versions?beta=true`, (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Versions = Versions;

package/dist/vendor/resources/beta/agents.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("./agents/index"), exports);

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

@@ -0,0 +1,105 @@
+"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.Beta = void 0;
+const resource_1 = require("../../core/resource");
+const DeploymentRunsAPI = __importStar(require("./deployment-runs"));
+const deployment_runs_1 = require("./deployment-runs");
+const DeploymentsAPI = __importStar(require("./deployments"));
+const deployments_1 = require("./deployments");
+const DreamsAPI = __importStar(require("./dreams"));
+const dreams_1 = require("./dreams");
+const FilesAPI = __importStar(require("./files"));
+const files_1 = require("./files");
+const ModelsAPI = __importStar(require("./models"));
+const models_1 = require("./models");
+const UserProfilesAPI = __importStar(require("./user-profiles"));
+const user_profiles_1 = require("./user-profiles");
+const WebhooksAPI = __importStar(require("./webhooks"));
+const webhooks_1 = require("./webhooks");
+const AgentsAPI = __importStar(require("./agents/agents"));
+const agents_1 = require("./agents/agents");
+const EnvironmentsAPI = __importStar(require("./environments/environments"));
+const environments_1 = require("./environments/environments");
+const MemoryStoresAPI = __importStar(require("./memory-stores/memory-stores"));
+const memory_stores_1 = require("./memory-stores/memory-stores");
+const MessagesAPI = __importStar(require("./messages/messages"));
+const messages_1 = require("./messages/messages");
+const OrganizationAPI = __importStar(require("./organization/organization"));
+const organization_1 = require("./organization/organization");
+const SessionsAPI = __importStar(require("./sessions/sessions"));
+const sessions_1 = require("./sessions/sessions");
+const SkillsAPI = __importStar(require("./skills/skills"));
+const skills_1 = require("./skills/skills");
+const TunnelsAPI = __importStar(require("./tunnels/tunnels"));
+const tunnels_1 = require("./tunnels/tunnels");
+const VaultsAPI = __importStar(require("./vaults/vaults"));
+const vaults_1 = require("./vaults/vaults");
+class Beta extends resource_1.APIResource {
+    models = new ModelsAPI.Models(this._client);
+    messages = new MessagesAPI.Messages(this._client);
+    agents = new AgentsAPI.Agents(this._client);
+    environments = new EnvironmentsAPI.Environments(this._client);
+    sessions = new SessionsAPI.Sessions(this._client);
+    deployments = new DeploymentsAPI.Deployments(this._client);
+    deploymentRuns = new DeploymentRunsAPI.DeploymentRuns(this._client);
+    vaults = new VaultsAPI.Vaults(this._client);
+    memoryStores = new MemoryStoresAPI.MemoryStores(this._client);
+    files = new FilesAPI.Files(this._client);
+    skills = new SkillsAPI.Skills(this._client);
+    webhooks = new WebhooksAPI.Webhooks(this._client);
+    userProfiles = new UserProfilesAPI.UserProfiles(this._client);
+    dreams = new DreamsAPI.Dreams(this._client);
+    tunnels = new TunnelsAPI.Tunnels(this._client);
+    organization = new OrganizationAPI.Organization(this._client);
+}
+exports.Beta = Beta;
+Beta.Models = models_1.Models;
+Beta.Messages = messages_1.Messages;
+Beta.Agents = agents_1.Agents;
+Beta.Environments = environments_1.Environments;
+Beta.Sessions = sessions_1.Sessions;
+Beta.Deployments = deployments_1.Deployments;
+Beta.DeploymentRuns = deployment_runs_1.DeploymentRuns;
+Beta.Vaults = vaults_1.Vaults;
+Beta.MemoryStores = memory_stores_1.MemoryStores;
+Beta.Files = files_1.Files;
+Beta.Skills = skills_1.Skills;
+Beta.Webhooks = webhooks_1.Webhooks;
+Beta.UserProfiles = user_profiles_1.UserProfiles;
+Beta.Dreams = dreams_1.Dreams;
+Beta.Tunnels = tunnels_1.Tunnels;
+Beta.Organization = organization_1.Organization;

package/dist/vendor/resources/beta/deployment-runs.cjs

@@ -0,0 +1,54 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentRuns = void 0;
+const resource_1 = require("../../core/resource");
+const pagination_1 = require("../../core/pagination");
+const headers_1 = require("../../internal/headers");
+const path_1 = require("../../internal/utils/path");
+class DeploymentRuns extends resource_1.APIResource {
+    /**
+     * Get Deployment Run
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeploymentRun =
+     *   await client.beta.deploymentRuns.retrieve(
+     *     'deployment_run_id',
+     *   );
+     * ```
+     */
+    retrieve(deploymentRunID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/deployment_runs/${deploymentRunID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List Deployment Runs
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsDeploymentRun of client.beta.deploymentRuns.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList('/v1/deployment_runs?beta=true', (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.DeploymentRuns = DeploymentRuns;