@puku-ai/sdk 4.0.1 → 4.0.2

package/dist/vendor/resources/beta/messages/messages.js

@@ -0,0 +1,158 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { PukuError } from '../../../error.js';
+import * as BatchesAPI from './batches.js';
+import { APIResource } from '../../../core/resource.js';
+import { MODEL_NONSTREAMING_TOKENS } from '../../../internal/constants.js';
+import { buildHeaders } from '../../../internal/headers.js';
+import { stainlessHelperHeader } from '../../../internal/stainless-helper-header.js';
+import { parseBetaMessage, } from '../../../lib/beta-parser.js';
+import { BetaMessageStream } from '../../../lib/BetaMessageStream.js';
+import { BetaToolRunner, } from '../../../lib/tools/BetaToolRunner.js';
+import { ToolError } from '../../../lib/tools/ToolError.js';
+import { Batches, } from './batches.js';
+const DEPRECATED_MODELS = {
+    'puku-1.3': 'November 6th, 2024',
+    'puku-1.3-100k': 'November 6th, 2024',
+    'puku-instant-1.1': 'November 6th, 2024',
+    'puku-instant-1.1-100k': 'November 6th, 2024',
+    'puku-instant-1.2': 'November 6th, 2024',
+    'puku-3-sonnet-20240229': 'July 21st, 2025',
+    'puku-3-opus-20240229': 'January 5th, 2026',
+    'puku-2.1': 'July 21st, 2025',
+    'puku-2.0': 'July 21st, 2025',
+    'puku-3-7-sonnet-latest': 'February 19th, 2026',
+};
+const MODELS_TO_WARN_WITH_THINKING_ENABLED = [];
+export class Messages extends APIResource {
+    batches = new BatchesAPI.Batches(this._client);
+    create(params, options) {
+        // Transform deprecated output_format to output_config.format
+        const modifiedParams = transformOutputFormat(params);
+        const { betas, user_profile_id, ...body } = modifiedParams;
+        if (body.model in DEPRECATED_MODELS) {
+            console.warn(`The Puku SDK model '${body.model}' is deprecated and will reach end-of-life on ${DEPRECATED_MODELS[body.model]}\nPlease migrate to a newer model. Visit https://puku.ai/docs/resources/model-deprecations for more information.`);
+        }
+        if (MODELS_TO_WARN_WITH_THINKING_ENABLED.includes(body.model) &&
+            body.thinking &&
+            body.thinking.type === 'enabled') {
+            console.warn(`Using Puku with ${body.model} and 'thinking.type=enabled' is deprecated. Use 'thinking.type=adaptive' instead which results in better model performance in our testing: https://puku.ai/docs/en/build-with-puku/adaptive-thinking`);
+        }
+        let timeout = options?.timeout ?? this._client._options.timeout;
+        if (!body.stream && timeout == null) {
+            const maxNonstreamingTokens = MODEL_NONSTREAMING_TOKENS[body.model] ?? undefined;
+            timeout = this._client.calculateNonstreamingTimeout(body.max_tokens, maxNonstreamingTokens);
+        }
+        // Collect helper info from tools and messages
+        const helperHeader = stainlessHelperHeader(body.tools, body.messages);
+        return this._client.post('/v1/messages?beta=true', {
+            body,
+            timeout: timeout ?? 600000,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined),
+                    ...(user_profile_id != null ? { 'puku-user-profile-id': user_profile_id } : undefined),
+                },
+                helperHeader,
+                options?.headers,
+            ]),
+            stream: modifiedParams.stream ?? false,
+        });
+    }
+    /**
+     * Send a structured list of input messages with text and/or image content, along with an expected `output_format` and
+     * the response will be automatically parsed and available in the `parsed_output` property of the message.
+     *
+     * @example
+     * ```ts
+     * const message = await client.beta.messages.parse({
+     *   model: 'puku-3-5-sonnet-20241022',
+     *   max_tokens: 1024,
+     *   messages: [{ role: 'user', content: 'What is 2+2?' }],
+     *   output_format: zodOutputFormat(z.object({ answer: z.number() }), 'math'),
+     * });
+     *
+     * console.log(message.parsed_output?.answer); // 4
+     * ```
+     */
+    parse(params, options) {
+        options = {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(params.betas ?? []), 'structured-outputs-2025-12-15'].toString() },
+                options?.headers,
+            ]),
+        };
+        return this.create(params, options).then((message) => parseBetaMessage(message, params, { logger: this._client.logger ?? console }));
+    }
+    /**
+     * Create a Message stream
+     */
+    stream(body, options) {
+        return BetaMessageStream.createMessage(this, body, options);
+    }
+    /**
+     * Count the number of tokens in a Message.
+     *
+     * The Token Count API can be used to count the number of tokens in a Message,
+     * including tools, images, and documents, without creating it.
+     *
+     * Learn more about token counting in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/token-counting)
+     *
+     * @example
+     * ```ts
+     * const betaMessageTokensCount =
+     *   await client.beta.messages.countTokens({
+     *     messages: [{ content: 'Hello, world', role: 'user' }],
+     *     model: 'puku-ai-2.8,
+     *   });
+     * ```
+     */
+    countTokens(params, options) {
+        // Transform deprecated output_format to output_config.format
+        const modifiedParams = transformOutputFormat(params);
+        const { betas, user_profile_id, ...body } = modifiedParams;
+        return this._client.post('/v1/messages/count_tokens?beta=true', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                {
+                    'puku-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString(),
+                    ...(user_profile_id != null ? { 'puku-user-profile-id': user_profile_id } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    toolRunner(body, options) {
+        return new BetaToolRunner(this._client, body, options);
+    }
+}
+/**
+ * Transform deprecated output_format to output_config.format
+ * Returns a modified copy of the params without mutating the original
+ */
+function transformOutputFormat(params) {
+    if (!params.output_format) {
+        return params;
+    }
+    if (params.output_config?.format) {
+        throw new PukuError('Both output_format and output_config.format were provided. ' +
+            'Please use only output_config.format (output_format is deprecated).');
+    }
+    const { output_format, ...rest } = params;
+    return {
+        ...rest,
+        output_config: {
+            ...params.output_config,
+            format: output_format,
+        },
+    };
+}
+export { BetaToolRunner } from '../../../lib/tools/BetaToolRunner.js';
+export { ToolError } from '../../../lib/tools/ToolError.js';
+Messages.Batches = Batches;
+Messages.BetaToolRunner = BetaToolRunner;
+Messages.ToolError = ToolError;
+//# sourceMappingURL=messages.js.map

package/dist/vendor/resources/beta/messages/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../../../src/vendor/resources/beta/messages/messages.ts"],"names":[],"mappings":"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"}

package/dist/vendor/resources/beta/messages.d.ts

@@ -0,0 +1 @@
+export * from './messages/index';

package/dist/vendor/resources/beta/messages.js

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from './messages/index.js';
+//# sourceMappingURL=messages.js.map

package/dist/vendor/resources/beta/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../../src/vendor/resources/beta/messages.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,cAAc,kBAAkB,CAAC"}

package/dist/vendor/resources/beta/models.d.ts

@@ -0,0 +1,217 @@
+import { APIResource } from '../../core/resource';
+import * as BetaAPI from './beta';
+import { APIPromise } from '../../core/api-promise';
+import { Page, type PageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+export declare class Models extends APIResource {
+    /**
+     * Get a specific model.
+     *
+     * The Models API response can be used to determine information about a specific
+     * model or resolve a model alias to a model ID.
+     *
+     * @example
+     * ```ts
+     * const betaModelInfo = await client.beta.models.retrieve(
+     *   'model_id',
+     * );
+     * ```
+     */
+    retrieve(modelID: string, params?: ModelRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<BetaModelInfo>;
+    /**
+     * List available models.
+     *
+     * The Models API response can be used to determine which models are available for
+     * use in the API. More recently released models are listed first.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaModelInfo of client.beta.models.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params?: ModelListParams | null | undefined, options?: RequestOptions): PagePromise<BetaModelInfosPage, BetaModelInfo>;
+}
+export type BetaModelInfosPage = Page<BetaModelInfo>;
+/**
+ * Indicates whether a capability is supported.
+ */
+export interface BetaCapabilitySupport {
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+}
+/**
+ * Context management capability details.
+ */
+export interface BetaContextManagementCapability {
+    /**
+     * Indicates whether a capability is supported.
+     */
+    clear_thinking_20251015: BetaCapabilitySupport | null;
+    /**
+     * Indicates whether a capability is supported.
+     */
+    clear_tool_uses_20250919: BetaCapabilitySupport | null;
+    /**
+     * Indicates whether a capability is supported.
+     */
+    compact_20260112: BetaCapabilitySupport | null;
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+}
+/**
+ * Effort (reasoning_effort) capability details.
+ */
+export interface BetaEffortCapability {
+    /**
+     * Whether the model supports high effort level.
+     */
+    high: BetaCapabilitySupport;
+    /**
+     * Whether the model supports low effort level.
+     */
+    low: BetaCapabilitySupport;
+    /**
+     * Whether the model supports max effort level.
+     */
+    max: BetaCapabilitySupport;
+    /**
+     * Whether the model supports medium effort level.
+     */
+    medium: BetaCapabilitySupport;
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+    /**
+     * Indicates whether a capability is supported.
+     */
+    xhigh: BetaCapabilitySupport | null;
+}
+/**
+ * Model capability information.
+ */
+export interface BetaModelCapabilities {
+    /**
+     * Whether the model supports the Batch API.
+     */
+    batch: BetaCapabilitySupport;
+    /**
+     * Whether the model supports citation generation.
+     */
+    citations: BetaCapabilitySupport;
+    /**
+     * Whether the model supports code execution tools.
+     */
+    code_execution: BetaCapabilitySupport;
+    /**
+     * Context management support and available strategies.
+     */
+    context_management: BetaContextManagementCapability;
+    /**
+     * Effort (reasoning_effort) support and available levels.
+     */
+    effort: BetaEffortCapability;
+    /**
+     * Whether the model accepts image content blocks.
+     */
+    image_input: BetaCapabilitySupport;
+    /**
+     * Whether the model accepts PDF content blocks.
+     */
+    pdf_input: BetaCapabilitySupport;
+    /**
+     * Whether the model supports structured output / JSON mode / strict tool schemas.
+     */
+    structured_outputs: BetaCapabilitySupport;
+    /**
+     * Thinking capability and supported type configurations.
+     */
+    thinking: BetaThinkingCapability;
+}
+export interface BetaModelInfo {
+    /**
+     * Unique model identifier.
+     */
+    id: string;
+    /**
+     * Model IDs this model accepts as `fallbacks[i].model` on the Messages API. An
+     * empty list means the `fallbacks` parameter is not supported for this model as
+     * primary.
+     */
+    allowed_fallback_models: Array<string> | null;
+    /**
+     * Model capability information.
+     */
+    capabilities: BetaModelCapabilities | null;
+    /**
+     * RFC 3339 datetime string representing the time at which the model was released.
+     * May be set to an epoch value if the release date is unknown.
+     */
+    created_at: string;
+    /**
+     * A human-readable name for the model.
+     */
+    display_name: string;
+    /**
+     * Maximum input context window size in tokens for this model.
+     */
+    max_input_tokens: number | null;
+    /**
+     * Maximum value for the `max_tokens` parameter when using this model.
+     */
+    max_tokens: number | null;
+    /**
+     * Object type.
+     *
+     * For Models, this is always `"model"`.
+     */
+    type: 'model';
+}
+/**
+ * Thinking capability details.
+ */
+export interface BetaThinkingCapability {
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+    /**
+     * Supported thinking type configurations.
+     */
+    types: BetaThinkingTypes;
+}
+/**
+ * Supported thinking type configurations.
+ */
+export interface BetaThinkingTypes {
+    /**
+     * Whether the model supports thinking with type 'adaptive' (auto).
+     */
+    adaptive: BetaCapabilitySupport;
+    /**
+     * Whether the model supports thinking with type 'enabled'.
+     */
+    enabled: BetaCapabilitySupport;
+}
+export interface ModelRetrieveParams {
+    /**
+     * Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface ModelListParams extends PageParams {
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export declare namespace Models {
+    export { type BetaCapabilitySupport as BetaCapabilitySupport, type BetaContextManagementCapability as BetaContextManagementCapability, type BetaEffortCapability as BetaEffortCapability, type BetaModelCapabilities as BetaModelCapabilities, type BetaModelInfo as BetaModelInfo, type BetaThinkingCapability as BetaThinkingCapability, type BetaThinkingTypes as BetaThinkingTypes, type BetaModelInfosPage as BetaModelInfosPage, type ModelRetrieveParams as ModelRetrieveParams, type ModelListParams as ModelListParams, };
+}

package/dist/vendor/resources/beta/models.js

@@ -0,0 +1,56 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { Page } from '../../core/pagination.js';
+import { buildHeaders } from '../../internal/headers.js';
+import { path } from '../../internal/utils/path.js';
+export class Models extends APIResource {
+    /**
+     * Get a specific model.
+     *
+     * The Models API response can be used to determine information about a specific
+     * model or resolve a model alias to a model ID.
+     *
+     * @example
+     * ```ts
+     * const betaModelInfo = await client.beta.models.retrieve(
+     *   'model_id',
+     * );
+     * ```
+     */
+    retrieve(modelID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get(path `/v1/models/${modelID}?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List available models.
+     *
+     * The Models API response can be used to determine which models are available for
+     * use in the API. More recently released models are listed first.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaModelInfo of client.beta.models.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList('/v1/models?beta=true', (Page), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/vendor/resources/beta/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/vendor/resources/beta/models.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,IAAI,EAAgC,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEjD,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;OAYG;IACH,QAAQ,CACN,OAAe,EACf,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,cAAc,OAAO,YAAY,EAAE;YAC7D,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,SAA6C,EAAE,EAC/C,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAA,IAAmB,CAAA,EAAE;YAC1E,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/vendor/resources/beta/organization/api-keys.d.ts

@@ -0,0 +1,176 @@
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { Page, type PageParams, PagePromise } from '../../../core/pagination';
+import { RequestOptions } from '../../../internal/request-options';
+export declare class APIKeys extends APIResource {
+    /**
+     * Get API Key
+     *
+     * @example
+     * ```ts
+     * const betaAPIKey =
+     *   await client.beta.organization.apiKeys.retrieve(
+     *     'api_key_id',
+     *   );
+     * ```
+     */
+    retrieve(apiKeyID: string, options?: RequestOptions): APIPromise<BetaAPIKey>;
+    /**
+     * Update API Key
+     *
+     * @example
+     * ```ts
+     * const betaAPIKey =
+     *   await client.beta.organization.apiKeys.update(
+     *     'api_key_id',
+     *   );
+     * ```
+     */
+    update(apiKeyID: string, body: APIKeyUpdateParams, options?: RequestOptions): APIPromise<BetaAPIKey>;
+    /**
+     * List API Keys
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaAPIKey of client.beta.organization.apiKeys.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: APIKeyListParams | null | undefined, options?: RequestOptions): PagePromise<BetaAPIKeysPage, BetaAPIKey>;
+}
+export type BetaAPIKeysPage = Page<BetaAPIKey>;
+export interface BetaAPIKey {
+    /**
+     * ID of the API key.
+     */
+    id: string;
+    /**
+     * RFC 3339 datetime string indicating when the API Key was created.
+     */
+    created_at: string;
+    /**
+     * The ID and type of the actor that created the API key, or `null` when the
+     * creator is not recorded (legacy, workload-identity-federated, or system-created
+     * keys).
+     */
+    created_by: BetaAPIKeyCreatedBy | null;
+    /**
+     * RFC 3339 datetime string indicating when the API Key expires, or `null` if it
+     * never expires.
+     */
+    expires_at: string | null;
+    /**
+     * Name of the API key.
+     */
+    name: string;
+    /**
+     * Partially redacted hint for the API key.
+     */
+    partial_key_hint: string | null;
+    /**
+     * The principal the API key acts as (a User or a Service Account), or `null` if
+     * the API key is not bound to a principal.
+     */
+    principal: BetaAPIKeyUserActor | BetaAPIKeyServiceAccountActor | null;
+    /**
+     * Where the API key belongs: its Workspace
+     * (`{"type": "workspace", "workspace_id": "wrkspc_..."}`, with the Workspace's
+     * real ID even when it is the organization's default Workspace), or the
+     * organization (`{"type": "organization"}`) for a principal-bound API key that has
+     * no Workspace.
+     */
+    scope: BetaAPIKeyOrganizationScope | BetaAPIKeyWorkspaceScope;
+    /**
+     * Status of the API key.
+     */
+    status: 'active' | 'archived' | 'expired' | 'inactive';
+    /**
+     * Object type.
+     *
+     * For API Keys, this is always `"api_key"`.
+     */
+    type: 'api_key';
+    /**
+     * @deprecated Use `scope` instead. `workspace_id` is `null` both for an API key in
+     * the default Workspace and for a principal-bound API key that has no Workspace.
+     */
+    workspace_id: string | null;
+}
+export interface BetaAPIKeyCreatedBy {
+    /**
+     * ID of the actor that created the object.
+     */
+    id: string;
+    /**
+     * Type of the actor that created the object.
+     */
+    type: 'service_account' | 'user';
+}
+export interface BetaAPIKeyOrganizationScope {
+    /**
+     * Scope type. Always `"organization"`: the API key has no Workspace. Only a
+     * principal-bound API key can have this scope.
+     */
+    type: 'organization';
+}
+export interface BetaAPIKeyServiceAccountActor {
+    /**
+     * ID of the Service Account the API key acts as.
+     */
+    service_account_id: string;
+    /**
+     * Principal type. Always `"service_account_actor"` for a Service Account.
+     */
+    type: 'service_account_actor';
+}
+export interface BetaAPIKeyUserActor {
+    /**
+     * Principal type. Always `"user_actor"` for a User.
+     */
+    type: 'user_actor';
+    /**
+     * ID of the User the API key acts as.
+     */
+    user_id: string;
+}
+export interface BetaAPIKeyWorkspaceScope {
+    /**
+     * Scope type. Always `"workspace"`: the API key belongs to one Workspace.
+     */
+    type: 'workspace';
+    /**
+     * ID of the Workspace the API key belongs to. Unlike the deprecated top-level
+     * `workspace_id`, this is the Workspace's real ID even for the organization's
+     * default Workspace.
+     */
+    workspace_id: string;
+}
+export interface APIKeyUpdateParams {
+    /**
+     * Name of the API key.
+     */
+    name?: string | null;
+    /**
+     * Status of the API key.
+     */
+    status?: 'active' | 'archived' | 'inactive' | null;
+}
+export interface APIKeyListParams extends PageParams {
+    /**
+     * Filter by the ID of the User who created the object.
+     */
+    created_by_user_id?: string | null;
+    /**
+     * Filter by API key status.
+     */
+    status?: 'active' | 'archived' | 'expired' | 'inactive' | null;
+    /**
+     * Filter by Workspace ID.
+     */
+    workspace_id?: string | null;
+}
+export declare namespace APIKeys {
+    export { type BetaAPIKey as BetaAPIKey, type BetaAPIKeyCreatedBy as BetaAPIKeyCreatedBy, type BetaAPIKeyOrganizationScope as BetaAPIKeyOrganizationScope, type BetaAPIKeyServiceAccountActor as BetaAPIKeyServiceAccountActor, type BetaAPIKeyUserActor as BetaAPIKeyUserActor, type BetaAPIKeyWorkspaceScope as BetaAPIKeyWorkspaceScope, type BetaAPIKeysPage as BetaAPIKeysPage, type APIKeyUpdateParams as APIKeyUpdateParams, type APIKeyListParams as APIKeyListParams, };
+}

package/dist/vendor/resources/beta/organization/api-keys.js

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../../core/resource.js';
+import { Page } from '../../../core/pagination.js';
+import { path } from '../../../internal/utils/path.js';
+export class APIKeys extends APIResource {
+    /**
+     * Get API Key
+     *
+     * @example
+     * ```ts
+     * const betaAPIKey =
+     *   await client.beta.organization.apiKeys.retrieve(
+     *     'api_key_id',
+     *   );
+     * ```
+     */
+    retrieve(apiKeyID, options) {
+        return this._client.get(path `/v1/organizations/api_keys/${apiKeyID}?beta=true`, options);
+    }
+    /**
+     * Update API Key
+     *
+     * @example
+     * ```ts
+     * const betaAPIKey =
+     *   await client.beta.organization.apiKeys.update(
+     *     'api_key_id',
+     *   );
+     * ```
+     */
+    update(apiKeyID, body, options) {
+        return this._client.post(path `/v1/organizations/api_keys/${apiKeyID}?beta=true`, { body, ...options });
+    }
+    /**
+     * List API Keys
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaAPIKey of client.beta.organization.apiKeys.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/organizations/api_keys?beta=true', (Page), {
+            query,
+            ...options,
+        });
+    }
+}
+//# sourceMappingURL=api-keys.js.map