@puku-ai/sdk 4.0.0 → 4.0.2

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

@@ -0,0 +1,464 @@
+import { APIResource } from '../../core/resource';
+export declare class Webhooks extends APIResource {
+    /**
+     * Parses a webhook payload into an event without verifying its signature. Prefer
+     * `unwrap()` unless you have already verified the signature yourself.
+     */
+    parseUnverified(body: string): BetaWebhookEvent;
+    /**
+     * 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: string, options: {
+        headers: Record<string, string>;
+        key?: string;
+    }): BetaWebhookEvent;
+}
+export interface BetaWebhookAgentArchivedEventData {
+    /**
+     * ID of the agent that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'agent.archived';
+    workspace_id: string;
+}
+export interface BetaWebhookAgentCreatedEventData {
+    /**
+     * ID of the agent that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'agent.created';
+    workspace_id: string;
+}
+export interface BetaWebhookAgentDeletedEventData {
+    /**
+     * ID of the agent that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'agent.deleted';
+    workspace_id: string;
+}
+export interface BetaWebhookAgentUpdatedEventData {
+    /**
+     * ID of the agent that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'agent.updated';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentArchivedEventData {
+    /**
+     * ID of the deployment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment.archived';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentCreatedEventData {
+    /**
+     * ID of the deployment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment.created';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentDeletedEventData {
+    /**
+     * ID of the deployment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment.deleted';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentPausedEventData {
+    /**
+     * ID of the deployment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment.paused';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentRunFailedEventData {
+    /**
+     * ID of the deployment run that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment_run.failed';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentRunStartedEventData {
+    /**
+     * ID of the deployment run that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment_run.started';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentRunSucceededEventData {
+    /**
+     * ID of the deployment run that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment_run.succeeded';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentUnpausedEventData {
+    /**
+     * ID of the deployment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment.unpaused';
+    workspace_id: string;
+}
+export interface BetaWebhookDeploymentUpdatedEventData {
+    /**
+     * ID of the deployment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'deployment.updated';
+    workspace_id: string;
+}
+export interface BetaWebhookEnvironmentArchivedEventData {
+    /**
+     * ID of the environment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'environment.archived';
+    workspace_id: string;
+}
+export interface BetaWebhookEnvironmentCreatedEventData {
+    /**
+     * ID of the environment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'environment.created';
+    workspace_id: string;
+}
+export interface BetaWebhookEnvironmentDeletedEventData {
+    /**
+     * ID of the environment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'environment.deleted';
+    workspace_id: string;
+}
+export interface BetaWebhookEnvironmentUpdatedEventData {
+    /**
+     * ID of the environment that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'environment.updated';
+    workspace_id: string;
+}
+export interface BetaWebhookEvent {
+    /**
+     * Unique event identifier for idempotency.
+     */
+    id: string;
+    /**
+     * RFC 3339 timestamp when the event occurred.
+     */
+    created_at: string;
+    data: BetaWebhookEventData;
+    /**
+     * Object type. Always `event` for webhook payloads.
+     */
+    type: 'event';
+}
+export type BetaWebhookEventData = BetaWebhookSessionCreatedEventData | BetaWebhookSessionPendingEventData | BetaWebhookSessionRunningEventData | BetaWebhookSessionIdledEventData | BetaWebhookSessionRequiresActionEventData | BetaWebhookSessionArchivedEventData | BetaWebhookSessionDeletedEventData | BetaWebhookSessionStatusRescheduledEventData | BetaWebhookSessionStatusRunStartedEventData | BetaWebhookSessionStatusIdledEventData | BetaWebhookSessionStatusTerminatedEventData | BetaWebhookSessionThreadCreatedEventData | BetaWebhookSessionThreadIdledEventData | BetaWebhookSessionThreadTerminatedEventData | BetaWebhookSessionOutcomeEvaluationEndedEventData | BetaWebhookVaultCreatedEventData | BetaWebhookVaultArchivedEventData | BetaWebhookVaultDeletedEventData | BetaWebhookVaultCredentialCreatedEventData | BetaWebhookVaultCredentialArchivedEventData | BetaWebhookVaultCredentialDeletedEventData | BetaWebhookVaultCredentialRefreshFailedEventData | BetaWebhookSessionUpdatedEventData | BetaWebhookAgentCreatedEventData | BetaWebhookAgentArchivedEventData | BetaWebhookAgentDeletedEventData | BetaWebhookDeploymentPausedEventData | BetaWebhookDeploymentRunFailedEventData | BetaWebhookDeploymentCreatedEventData | BetaWebhookDeploymentUpdatedEventData | BetaWebhookDeploymentUnpausedEventData | BetaWebhookAgentUpdatedEventData | BetaWebhookDeploymentArchivedEventData | BetaWebhookDeploymentRunStartedEventData | BetaWebhookDeploymentDeletedEventData | BetaWebhookDeploymentRunSucceededEventData | BetaWebhookEnvironmentCreatedEventData | BetaWebhookEnvironmentUpdatedEventData | BetaWebhookEnvironmentArchivedEventData | BetaWebhookEnvironmentDeletedEventData | BetaWebhookMemoryStoreCreatedEventData | BetaWebhookMemoryStoreArchivedEventData | BetaWebhookMemoryStoreDeletedEventData | BetaWebhookSessionBudgetReachedEventData;
+export interface BetaWebhookMemoryStoreArchivedEventData {
+    /**
+     * ID of the memory store that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'memory_store.archived';
+    workspace_id: string;
+}
+export interface BetaWebhookMemoryStoreCreatedEventData {
+    /**
+     * ID of the memory store that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'memory_store.created';
+    workspace_id: string;
+}
+export interface BetaWebhookMemoryStoreDeletedEventData {
+    /**
+     * ID of the memory store that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'memory_store.deleted';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionArchivedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.archived';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionBudgetReachedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.budget_reached';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionCreatedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.created';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionDeletedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.deleted';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionIdledEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.idled';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionOutcomeEvaluationEndedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.outcome_evaluation_ended';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionPendingEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.pending';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionRequiresActionEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.requires_action';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionRunningEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.running';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionStatusIdledEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.status_idled';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionStatusRescheduledEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.status_rescheduled';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionStatusRunStartedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.status_run_started';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionStatusTerminatedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.status_terminated';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionThreadCreatedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    /**
+     * ID of the session thread this event refers to.
+     */
+    session_thread_id: string;
+    type: 'session.thread_created';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionThreadIdledEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    /**
+     * ID of the session thread this event refers to.
+     */
+    session_thread_id: string;
+    type: 'session.thread_idled';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionThreadTerminatedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    /**
+     * ID of the session thread this event refers to.
+     */
+    session_thread_id: string;
+    type: 'session.thread_terminated';
+    workspace_id: string;
+}
+export interface BetaWebhookSessionUpdatedEventData {
+    /**
+     * ID of the session that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'session.updated';
+    workspace_id: string;
+}
+export interface BetaWebhookVaultArchivedEventData {
+    /**
+     * ID of the vault that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'vault.archived';
+    workspace_id: string;
+}
+export interface BetaWebhookVaultCreatedEventData {
+    /**
+     * ID of the vault that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'vault.created';
+    workspace_id: string;
+}
+export interface BetaWebhookVaultCredentialArchivedEventData {
+    /**
+     * ID of the vault credential that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'vault_credential.archived';
+    /**
+     * ID of the vault that owns this credential.
+     */
+    vault_id: string;
+    workspace_id: string;
+}
+export interface BetaWebhookVaultCredentialCreatedEventData {
+    /**
+     * ID of the vault credential that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'vault_credential.created';
+    /**
+     * ID of the vault that owns this credential.
+     */
+    vault_id: string;
+    workspace_id: string;
+}
+export interface BetaWebhookVaultCredentialDeletedEventData {
+    /**
+     * ID of the vault credential that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'vault_credential.deleted';
+    /**
+     * ID of the vault that owns this credential.
+     */
+    vault_id: string;
+    workspace_id: string;
+}
+export interface BetaWebhookVaultCredentialRefreshFailedEventData {
+    /**
+     * ID of the vault credential that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'vault_credential.refresh_failed';
+    /**
+     * ID of the vault that owns this credential.
+     */
+    vault_id: string;
+    workspace_id: string;
+}
+export interface BetaWebhookVaultDeletedEventData {
+    /**
+     * ID of the vault that triggered the event.
+     */
+    id: string;
+    organization_id: string;
+    type: 'vault.deleted';
+    workspace_id: string;
+}
+/**
+ * @deprecated UnwrapWebhookEvent has been renamed to BetaWebhookEvent
+ */
+export type UnwrapWebhookEvent = BetaWebhookEvent;
+export declare namespace Webhooks {
+    export { type BetaWebhookAgentArchivedEventData as BetaWebhookAgentArchivedEventData, type BetaWebhookAgentCreatedEventData as BetaWebhookAgentCreatedEventData, type BetaWebhookAgentDeletedEventData as BetaWebhookAgentDeletedEventData, type BetaWebhookAgentUpdatedEventData as BetaWebhookAgentUpdatedEventData, type BetaWebhookDeploymentArchivedEventData as BetaWebhookDeploymentArchivedEventData, type BetaWebhookDeploymentCreatedEventData as BetaWebhookDeploymentCreatedEventData, type BetaWebhookDeploymentDeletedEventData as BetaWebhookDeploymentDeletedEventData, type BetaWebhookDeploymentPausedEventData as BetaWebhookDeploymentPausedEventData, type BetaWebhookDeploymentRunFailedEventData as BetaWebhookDeploymentRunFailedEventData, type BetaWebhookDeploymentRunStartedEventData as BetaWebhookDeploymentRunStartedEventData, type BetaWebhookDeploymentRunSucceededEventData as BetaWebhookDeploymentRunSucceededEventData, type BetaWebhookDeploymentUnpausedEventData as BetaWebhookDeploymentUnpausedEventData, type BetaWebhookDeploymentUpdatedEventData as BetaWebhookDeploymentUpdatedEventData, type BetaWebhookEnvironmentArchivedEventData as BetaWebhookEnvironmentArchivedEventData, type BetaWebhookEnvironmentCreatedEventData as BetaWebhookEnvironmentCreatedEventData, type BetaWebhookEnvironmentDeletedEventData as BetaWebhookEnvironmentDeletedEventData, type BetaWebhookEnvironmentUpdatedEventData as BetaWebhookEnvironmentUpdatedEventData, type BetaWebhookEvent as BetaWebhookEvent, type BetaWebhookEventData as BetaWebhookEventData, type BetaWebhookMemoryStoreArchivedEventData as BetaWebhookMemoryStoreArchivedEventData, type BetaWebhookMemoryStoreCreatedEventData as BetaWebhookMemoryStoreCreatedEventData, type BetaWebhookMemoryStoreDeletedEventData as BetaWebhookMemoryStoreDeletedEventData, type BetaWebhookSessionArchivedEventData as BetaWebhookSessionArchivedEventData, type BetaWebhookSessionBudgetReachedEventData as BetaWebhookSessionBudgetReachedEventData, type BetaWebhookSessionCreatedEventData as BetaWebhookSessionCreatedEventData, type BetaWebhookSessionDeletedEventData as BetaWebhookSessionDeletedEventData, type BetaWebhookSessionIdledEventData as BetaWebhookSessionIdledEventData, type BetaWebhookSessionOutcomeEvaluationEndedEventData as BetaWebhookSessionOutcomeEvaluationEndedEventData, type BetaWebhookSessionPendingEventData as BetaWebhookSessionPendingEventData, type BetaWebhookSessionRequiresActionEventData as BetaWebhookSessionRequiresActionEventData, type BetaWebhookSessionRunningEventData as BetaWebhookSessionRunningEventData, type BetaWebhookSessionStatusIdledEventData as BetaWebhookSessionStatusIdledEventData, type BetaWebhookSessionStatusRescheduledEventData as BetaWebhookSessionStatusRescheduledEventData, type BetaWebhookSessionStatusRunStartedEventData as BetaWebhookSessionStatusRunStartedEventData, type BetaWebhookSessionStatusTerminatedEventData as BetaWebhookSessionStatusTerminatedEventData, type BetaWebhookSessionThreadCreatedEventData as BetaWebhookSessionThreadCreatedEventData, type BetaWebhookSessionThreadIdledEventData as BetaWebhookSessionThreadIdledEventData, type BetaWebhookSessionThreadTerminatedEventData as BetaWebhookSessionThreadTerminatedEventData, type BetaWebhookSessionUpdatedEventData as BetaWebhookSessionUpdatedEventData, type BetaWebhookVaultArchivedEventData as BetaWebhookVaultArchivedEventData, type BetaWebhookVaultCreatedEventData as BetaWebhookVaultCreatedEventData, type BetaWebhookVaultCredentialArchivedEventData as BetaWebhookVaultCredentialArchivedEventData, type BetaWebhookVaultCredentialCreatedEventData as BetaWebhookVaultCredentialCreatedEventData, type BetaWebhookVaultCredentialDeletedEventData as BetaWebhookVaultCredentialDeletedEventData, type BetaWebhookVaultCredentialRefreshFailedEventData as BetaWebhookVaultCredentialRefreshFailedEventData, type BetaWebhookVaultDeletedEventData as BetaWebhookVaultDeletedEventData, type UnwrapWebhookEvent as UnwrapWebhookEvent, };
+}

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

@@ -0,0 +1,29 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { Webhook } from 'standardwebhooks';
+export class Webhooks extends 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 Webhook(keyStr);
+        wh.verify(body, headers);
+        return JSON.parse(body);
+    }
+}
+//# sourceMappingURL=webhooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../../src/vendor/resources/beta/webhooks.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;OAGG;IACH,eAAe,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAY,EAAE,OAA0D;QAC7E,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QACjC,IAAI,OAAO,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACtG,MAAM,MAAM,GAAkB,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAChG,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QACzF,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;IAC9C,CAAC;CACF"}

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

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

package/dist/vendor/resources/beta.js

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

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

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

package/dist/vendor/resources/completions.d.ts

@@ -0,0 +1,172 @@
+import { APIResource } from '../core/resource';
+import * as CompletionsAPI from './completions';
+import * as BetaAPI from './beta/beta';
+import * as MessagesAPI from './messages/messages';
+import { APIPromise } from '../core/api-promise';
+import { Stream } from '../core/streaming';
+import { RequestOptions } from '../internal/request-options';
+export declare class Completions extends APIResource {
+    /**
+     * [Legacy] Create a Text Completion.
+     *
+     * The Text Completions API is a legacy API. We recommend using the
+     * [Messages API](https://platform.puku.com/docs/en/api/messages) going forward.
+     *
+     * Future models and features will not be compatible with Text Completions. See our
+     * [migration guide](https://platform.puku.com/docs/en/build-with-puku/working-with-messages)
+     * for guidance in migrating from Text Completions to Messages.
+     *
+     * @example
+     * ```ts
+     * const completion = await client.completions.create({
+     *   max_tokens_to_sample: 256,
+     *   model: 'puku-2.1',
+     *   prompt: '\n\nHuman: Hello, world!\n\nAssistant:',
+     * });
+     * ```
+     */
+    create(params: CompletionCreateParamsNonStreaming, options?: RequestOptions): APIPromise<Completion>;
+    create(params: CompletionCreateParamsStreaming, options?: RequestOptions): APIPromise<Stream<Completion>>;
+    create(params: CompletionCreateParamsBase, options?: RequestOptions): APIPromise<Stream<Completion> | Completion>;
+}
+export interface Completion {
+    /**
+     * Unique object identifier.
+     *
+     * The format and length of IDs may change over time.
+     */
+    id: string;
+    /**
+     * The resulting completion up to and excluding the stop sequences.
+     */
+    completion: string;
+    /**
+     * The model that will complete your prompt.
+     *
+     * See [models](https://docs.puku.com/en/docs/models-overview) for additional
+     * details and options.
+     */
+    model: MessagesAPI.Model;
+    /**
+     * The reason that we stopped.
+     *
+     * This may be one the following values:
+     *
+     * - `"stop_sequence"`: we reached a stop sequence — either provided by you via the
+     *   `stop_sequences` parameter, or a stop sequence built into the model
+     * - `"max_tokens"`: we exceeded `max_tokens_to_sample` or the model's maximum
+     */
+    stop_reason: string | null;
+    /**
+     * Object type.
+     *
+     * For Text Completions, this is always `"completion"`.
+     */
+    type: 'completion';
+}
+export type CompletionCreateParams = CompletionCreateParamsNonStreaming | CompletionCreateParamsStreaming;
+export interface CompletionCreateParamsBase {
+    /**
+     * Body param: The maximum number of tokens to generate before stopping.
+     *
+     * Note that our models may stop _before_ reaching this maximum. This parameter
+     * only specifies the absolute maximum number of tokens to generate.
+     */
+    max_tokens_to_sample: number;
+    /**
+     * Body param: The model that will complete your prompt.
+     *
+     * See [models](https://docs.puku.com/en/docs/models-overview) for additional
+     * details and options.
+     */
+    model: MessagesAPI.Model;
+    /**
+     * Body param: The prompt that you want Puku to complete.
+     *
+     * For proper response generation you will need to format your prompt using
+     * alternating `\n\nHuman:` and `\n\nAssistant:` conversational turns. For example:
+     *
+     * ```
+     * "\n\nHuman: {userQuestion}\n\nAssistant:"
+     * ```
+     *
+     * See
+     * [prompt validation](https://platform.puku.com/docs/en/build-with-puku/working-with-messages)
+     * and our guide to
+     * [prompt design](https://platform.puku.com/docs/en/build-with-puku/prompt-engineering/overview)
+     * for more details.
+     */
+    prompt: string;
+    /**
+     * Body param: An object describing metadata about the request.
+     */
+    metadata?: MessagesAPI.Metadata;
+    /**
+     * Body param: Sequences that will cause the model to stop generating.
+     *
+     * Our models stop on `"\n\nHuman:"`, and may include additional built-in stop
+     * sequences in the future. By providing the stop_sequences parameter, you may
+     * include additional strings that will cause the model to stop generating.
+     */
+    stop_sequences?: Array<string>;
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://platform.puku.com/docs/en/build-with-puku/streaming)
+     * for details.
+     */
+    stream?: boolean;
+    /**
+     * @deprecated Deprecated. Models released after Puku Opus 4.6 do not support
+     * setting temperature. A value of 1.0 of will be accepted for backwards
+     * compatibility, all other values will be rejected with a 400 error.
+     */
+    temperature?: number;
+    /**
+     * @deprecated Deprecated. Models released after Puku Opus 4.6 do not accept
+     * top_k; any value will be rejected with a 400 error.
+     */
+    top_k?: number;
+    /**
+     * @deprecated Deprecated. Models released after Puku Opus 4.6 do not support
+     * setting top_p. A value >= 0.99 will be accepted for backwards compatibility, all
+     * other values will be rejected with a 400 error.
+     */
+    top_p?: number;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export declare namespace CompletionCreateParams {
+    /**
+     * @deprecated use `PukuAI.Messages.Metadata` instead
+     */
+    type Metadata = MessagesAPI.Metadata;
+    type CompletionCreateParamsNonStreaming = CompletionsAPI.CompletionCreateParamsNonStreaming;
+    type CompletionCreateParamsStreaming = CompletionsAPI.CompletionCreateParamsStreaming;
+}
+export interface CompletionCreateParamsNonStreaming extends CompletionCreateParamsBase {
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://platform.puku.com/docs/en/build-with-puku/streaming)
+     * for details.
+     */
+    stream?: false;
+}
+export interface CompletionCreateParamsStreaming extends CompletionCreateParamsBase {
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://platform.puku.com/docs/en/build-with-puku/streaming)
+     * for details.
+     */
+    stream: true;
+}
+export declare namespace Completions {
+    export { type Completion as Completion, type CompletionCreateParams as CompletionCreateParams, type CompletionCreateParamsNonStreaming as CompletionCreateParamsNonStreaming, type CompletionCreateParamsStreaming as CompletionCreateParamsStreaming, };
+}