@puku-ai/sdk 4.0.3 → 4.0.5

package/dist/vendor/resources/beta/organization/workspaces/service-accounts.cjs

@@ -0,0 +1,188 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceAccounts = 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 ServiceAccounts extends resource_1.APIResource {
+    /**
+     * **Requires an OAuth access token with the `org:admin` scope**, from
+     * `ant auth login --scope org:admin` or a workload identity federation rule; Admin
+     * API keys are not accepted. See
+     * [Manage WIF with the Admin API](/docs/en/manage-puku/wif-admin-api).
+     *
+     * Retrieve a service account's membership in a workspace.
+     *
+     * Returns the membership record, including the service account's `workspace_role`
+     * in this workspace. Archived workspaces return 400. For the default workspace,
+     * returns the implicit (`implicit: true`) membership when no explicit membership
+     * exists; an explicitly added membership is returned with its assigned role. An
+     * archived service account returns 404.
+     *
+     * @example
+     * ```ts
+     * const betaServiceAccountWorkspaceMember =
+     *   await client.beta.organization.workspaces.serviceAccounts.retrieve(
+     *     'service_account_id',
+     *     { workspace_id: 'workspace_id' },
+     *   );
+     * ```
+     */
+    retrieve(serviceAccountID, params, options) {
+        const { workspace_id, betas } = params;
+        return this._client.get((0, path_1.path) `/v1/organizations/workspaces/${workspace_id}/service_accounts/${serviceAccountID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * **Requires an OAuth access token with the `org:admin` scope**, from
+     * `ant auth login --scope org:admin` or a workload identity federation rule; Admin
+     * API keys are not accepted. See
+     * [Manage WIF with the Admin API](/docs/en/manage-puku/wif-admin-api).
+     *
+     * Change a service account's role in a workspace.
+     *
+     * The new `workspace_role` replaces the current one. Only explicit memberships can
+     * be updated; to set a role on the implicit default-workspace membership, add the
+     * service account explicitly with
+     * `POST /workspaces/{workspace_id}/service_accounts`. Archived workspaces
+     * return 400. Archived service accounts cannot be updated and are rejected.
+     *
+     * @example
+     * ```ts
+     * const betaServiceAccountWorkspaceMember =
+     *   await client.beta.organization.workspaces.serviceAccounts.update(
+     *     'service_account_id',
+     *     {
+     *       workspace_id: 'workspace_id',
+     *       workspace_role: 'workspace_admin',
+     *     },
+     *   );
+     * ```
+     */
+    update(serviceAccountID, params, options) {
+        const { workspace_id, betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/organizations/workspaces/${workspace_id}/service_accounts/${serviceAccountID}?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * **Requires an OAuth access token with the `org:admin` scope**, from
+     * `ant auth login --scope org:admin` or a workload identity federation rule; Admin
+     * API keys are not accepted. See
+     * [Manage WIF with the Admin API](/docs/en/manage-puku/wif-admin-api).
+     *
+     * List the service accounts that are members of a workspace.
+     *
+     * Each entry includes the service account's `workspace_role`. Use `limit` and the
+     * `next_page` cursor to paginate. Archived workspaces return 400; use
+     * `GET /service_accounts/{id}/workspaces` to audit memberships of an archived
+     * workspace. The implicit default-workspace membership is not included in this
+     * list. Memberships of archived service accounts are omitted from the results.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaServiceAccountWorkspaceMember of client.beta.organization.workspaces.serviceAccounts.list(
+     *   'workspace_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(workspaceID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/organizations/workspaces/${workspaceID}/service_accounts?beta=true`, (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * **Requires an OAuth access token with the `org:admin` scope**, from
+     * `ant auth login --scope org:admin` or a workload identity federation rule; Admin
+     * API keys are not accepted. See
+     * [Manage WIF with the Admin API](/docs/en/manage-puku/wif-admin-api).
+     *
+     * Add a service account to a workspace with the given `workspace_role`.
+     *
+     * The role determines what the service account can do in the workspace and which
+     * workspace-scoped permissions it can be granted when authenticating through
+     * federation. Every service account is already an implicit `workspace_user` member
+     * of the default workspace; adding it explicitly assigns a chosen role. If the
+     * service account is already an explicit member of the workspace, its
+     * `workspace_role` is replaced with the value supplied here. Archived workspaces
+     * return 400. Archived service accounts cannot be added and are rejected.
+     *
+     * @example
+     * ```ts
+     * const betaServiceAccountWorkspaceMember =
+     *   await client.beta.organization.workspaces.serviceAccounts.add(
+     *     'workspace_id',
+     *     {
+     *       service_account_id: 'service_account_id',
+     *       workspace_role: 'workspace_admin',
+     *     },
+     *   );
+     * ```
+     */
+    add(workspaceID, params, options) {
+        const { betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/organizations/workspaces/${workspaceID}/service_accounts?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * **Requires an OAuth access token with the `org:admin` scope**, from
+     * `ant auth login --scope org:admin` or a workload identity federation rule; Admin
+     * API keys are not accepted. See
+     * [Manage WIF with the Admin API](/docs/en/manage-puku/wif-admin-api).
+     *
+     * Remove a service account from a workspace.
+     *
+     * Removal is idempotent (returns 200 even if the membership was already removed).
+     * A DELETE against the implicit default-workspace membership returns 200 but is a
+     * no-op and the membership persists; deleting an explicit default-workspace row
+     * reverts to the implicit `workspace_user` membership. Archived workspaces
+     * return 400.
+     *
+     * @example
+     * ```ts
+     * const serviceAccount =
+     *   await client.beta.organization.workspaces.serviceAccounts.remove(
+     *     'service_account_id',
+     *     { workspace_id: 'workspace_id' },
+     *   );
+     * ```
+     */
+    remove(serviceAccountID, params, options) {
+        const { workspace_id, betas } = params;
+        return this._client.delete((0, path_1.path) `/v1/organizations/workspaces/${workspace_id}/service_accounts/${serviceAccountID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.ServiceAccounts = ServiceAccounts;

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

@@ -0,0 +1,140 @@
+"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.Workspaces = void 0;
+const resource_1 = require("../../../../core/resource");
+const MembersAPI = __importStar(require("./members"));
+const members_1 = require("./members");
+const RateLimitsAPI = __importStar(require("./rate-limits"));
+const rate_limits_1 = require("./rate-limits");
+const ServiceAccountsAPI = __importStar(require("./service-accounts"));
+const service_accounts_1 = require("./service-accounts");
+const pagination_1 = require("../../../../core/pagination");
+const headers_1 = require("../../../../internal/headers");
+const path_1 = require("../../../../internal/utils/path");
+class Workspaces extends resource_1.APIResource {
+    rateLimits = new RateLimitsAPI.RateLimits(this._client);
+    members = new MembersAPI.Members(this._client);
+    serviceAccounts = new ServiceAccountsAPI.ServiceAccounts(this._client);
+    /**
+     * Create Workspace
+     *
+     * @example
+     * ```ts
+     * const betaWorkspace =
+     *   await client.beta.organization.workspaces.create({
+     *     name: 'x',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1/organizations/workspaces?beta=true', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get Workspace
+     *
+     * @example
+     * ```ts
+     * const betaWorkspace =
+     *   await client.beta.organization.workspaces.retrieve(
+     *     'workspace_id',
+     *   );
+     * ```
+     */
+    retrieve(workspaceID, options) {
+        return this._client.get((0, path_1.path) `/v1/organizations/workspaces/${workspaceID}?beta=true`, options);
+    }
+    /**
+     * Update Workspace
+     *
+     * @example
+     * ```ts
+     * const betaWorkspace =
+     *   await client.beta.organization.workspaces.update(
+     *     'workspace_id',
+     *   );
+     * ```
+     */
+    update(workspaceID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/organizations/workspaces/${workspaceID}?beta=true`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * List Workspaces
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaWorkspace of client.beta.organization.workspaces.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/organizations/workspaces?beta=true', (pagination_1.Page), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Archive Workspace
+     *
+     * @example
+     * ```ts
+     * const betaWorkspace =
+     *   await client.beta.organization.workspaces.archive(
+     *     'workspace_id',
+     *   );
+     * ```
+     */
+    archive(workspaceID, options) {
+        return this._client.post((0, path_1.path) `/v1/organizations/workspaces/${workspaceID}/archive?beta=true`, options);
+    }
+}
+exports.Workspaces = Workspaces;
+Workspaces.RateLimits = rate_limits_1.RateLimits;
+Workspaces.Members = members_1.Members;
+Workspaces.ServiceAccounts = service_accounts_1.ServiceAccounts;

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

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

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

@@ -0,0 +1,119 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionToolRunner = exports.Events = 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");
+const SessionToolRunner_1 = require("../../../lib/tools/SessionToolRunner");
+class Events extends resource_1.APIResource {
+    /**
+     * List Events
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsSessionEvent of client.beta.sessions.events.list(
+     *   'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(sessionID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/sessions/${sessionID}/events?beta=true`, (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Send Events
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSendSessionEvents =
+     *   await client.beta.sessions.events.send(
+     *     'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *     {
+     *       events: [
+     *         {
+     *           content: [
+     *             {
+     *               text: 'Where is my order #1234?',
+     *               type: 'text',
+     *             },
+     *           ],
+     *           type: 'user.message',
+     *         },
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    send(sessionID, params, options) {
+        const { betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/sessions/${sessionID}/events?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Stream Events
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsStreamSessionEvents =
+     *   await client.beta.sessions.events.stream(
+     *     'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *   );
+     * ```
+     */
+    stream(sessionID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/sessions/${sessionID}/events/stream?beta=true`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+            stream: true,
+        });
+    }
+    /**
+     * Attach to a session and dispatch every incoming `agent.tool_use` and
+     * `agent.custom_tool_use` event to a local tool registry, sending the matching
+     * result back (`user.tool_result` / `user.custom_tool_result`). The
+     * sessions-side counterpart to `client.beta.messages.toolRunner`: yields one
+     * entry per completed tool call so callers can observe each dispatch (and
+     * `break` to abort cleanly).
+     *
+     * @example
+     * ```ts
+     * import { betaAgentToolset20260401 } from '@puku-ai/sdk/tools/agent-toolset/node';
+     *
+     * for await (const call of client.beta.sessions.events.toolRunner(work.data.id, {
+     *   tools: [...betaAgentToolset20260401({ workdir }), myTool],
+     * })) {
+     *   console.log(`${call.name} -> ${call.isError ? 'error' : 'ok'}`);
+     * }
+     * ```
+     */
+    toolRunner(sessionID, opts) {
+        return new SessionToolRunner_1.SessionToolRunner(sessionID, { ...opts, client: this._client });
+    }
+}
+exports.Events = Events;
+var SessionToolRunner_2 = require("../../../lib/tools/SessionToolRunner");
+Object.defineProperty(exports, "SessionToolRunner", { enumerable: true, get: function () { return SessionToolRunner_2.SessionToolRunner; } });
+Events.SessionToolRunner = SessionToolRunner_1.SessionToolRunner;

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

@@ -0,0 +1,12 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Threads = exports.Sessions = exports.Resources = exports.Events = void 0;
+var events_1 = require("./events");
+Object.defineProperty(exports, "Events", { enumerable: true, get: function () { return events_1.Events; } });
+var resources_1 = require("./resources");
+Object.defineProperty(exports, "Resources", { enumerable: true, get: function () { return resources_1.Resources; } });
+var sessions_1 = require("./sessions");
+Object.defineProperty(exports, "Sessions", { enumerable: true, get: function () { return sessions_1.Sessions; } });
+var index_1 = require("./threads/index");
+Object.defineProperty(exports, "Threads", { enumerable: true, get: function () { return index_1.Threads; } });

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

@@ -0,0 +1,131 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Resources = 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 Resources extends resource_1.APIResource {
+    /**
+     * Get Session Resource
+     *
+     * @example
+     * ```ts
+     * const resource =
+     *   await client.beta.sessions.resources.retrieve(
+     *     'sesrsc_011CZkZBJq5dWxk9fVLNcPht',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    retrieve(resourceID, params, options) {
+        const { session_id, betas } = params;
+        return this._client.get((0, path_1.path) `/v1/sessions/${session_id}/resources/${resourceID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Update Session Resource
+     *
+     * @example
+     * ```ts
+     * const resource =
+     *   await client.beta.sessions.resources.update(
+     *     'sesrsc_011CZkZBJq5dWxk9fVLNcPht',
+     *     {
+     *       session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *       authorization_token: 'ghp_exampletoken',
+     *     },
+     *   );
+     * ```
+     */
+    update(resourceID, params, options) {
+        const { session_id, betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/sessions/${session_id}/resources/${resourceID}?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List Session Resources
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsSessionResource of client.beta.sessions.resources.list(
+     *   'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(sessionID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/sessions/${sessionID}/resources?beta=true`, (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete Session Resource
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeleteSessionResource =
+     *   await client.beta.sessions.resources.delete(
+     *     'sesrsc_011CZkZBJq5dWxk9fVLNcPht',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    delete(resourceID, params, options) {
+        const { session_id, betas } = params;
+        return this._client.delete((0, path_1.path) `/v1/sessions/${session_id}/resources/${resourceID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Add Session Resource
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsFileResource =
+     *   await client.beta.sessions.resources.add(
+     *     'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *     {
+     *       file_id: 'file_011CNha8iCJcU1wXNR6q4V8w',
+     *       type: 'file',
+     *     },
+     *   );
+     * ```
+     */
+    add(sessionID, params, options) {
+        const { betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/sessions/${sessionID}/resources?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Resources = Resources;