@puku-ai/sdk 4.0.0 → 4.0.2

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

@@ -0,0 +1,150 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../../core/resource.js';
+import * as EventsAPI from './events.js';
+import { Events, } from './events.js';
+import * as ResourcesAPI from './resources.js';
+import { Resources, } from './resources.js';
+import * as ThreadsAPI from './threads/threads.js';
+import { Threads, } from './threads/threads.js';
+import { BidirectionalPageCursor, } from '../../../core/pagination.js';
+import { buildHeaders } from '../../../internal/headers.js';
+import { path } from '../../../internal/utils/path.js';
+export class Sessions extends APIResource {
+    events = new EventsAPI.Events(this._client);
+    resources = new ResourcesAPI.Resources(this._client);
+    threads = new ThreadsAPI.Threads(this._client);
+    /**
+     * Create Session
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSession =
+     *   await client.beta.sessions.create({
+     *     agent: 'agent_011CZkYpogX7uDKUyvBTophP',
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1/sessions?beta=true', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get Session
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSession =
+     *   await client.beta.sessions.retrieve(
+     *     'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *   );
+     * ```
+     */
+    retrieve(sessionID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get(path `/v1/sessions/${sessionID}?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Update Session
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSession =
+     *   await client.beta.sessions.update(
+     *     'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *   );
+     * ```
+     */
+    update(sessionID, params, options) {
+        const { betas, ...body } = params;
+        return this._client.post(path `/v1/sessions/${sessionID}?beta=true`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List Sessions
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsSession of client.beta.sessions.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList('/v1/sessions?beta=true', (BidirectionalPageCursor), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete Session
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeletedSession =
+     *   await client.beta.sessions.delete(
+     *     'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *   );
+     * ```
+     */
+    delete(sessionID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.delete(path `/v1/sessions/${sessionID}?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Archive Session
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSession =
+     *   await client.beta.sessions.archive(
+     *     'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     *   );
+     * ```
+     */
+    archive(sessionID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.post(path `/v1/sessions/${sessionID}/archive?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+Sessions.Events = Events;
+Sessions.Resources = Resources;
+Sessions.Threads = Threads;
+//# sourceMappingURL=sessions.js.map

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

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

package/dist/vendor/resources/beta/sessions/threads/events.d.ts

@@ -0,0 +1,77 @@
+import { APIResource } from '../../../../core/resource';
+import * as BetaAPI from '../../beta';
+import * as EventsAPI from '../events';
+import { BetaManagedAgentsSessionEventsPageCursor } from '../events';
+import * as SessionsAPI from '../sessions';
+import * as ThreadsAPI from './threads';
+import { APIPromise } from '../../../../core/api-promise';
+import { type PageCursorParams, PagePromise } from '../../../../core/pagination';
+import { Stream } from '../../../../core/streaming';
+import { RequestOptions } from '../../../../internal/request-options';
+export declare class Events extends APIResource {
+    /**
+     * List Session Thread Events
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsSessionEvent of client.beta.sessions.threads.events.list(
+     *   'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *   { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(threadID: string, params: EventListParams, options?: RequestOptions): PagePromise<BetaManagedAgentsSessionEventsPageCursor, EventsAPI.BetaManagedAgentsSessionEvent>;
+    /**
+     * Stream Session Thread Events
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsStreamSessionThreadEvents =
+     *   await client.beta.sessions.threads.events.stream(
+     *     'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    stream(threadID: string, params: EventStreamParams, options?: RequestOptions): APIPromise<Stream<ThreadsAPI.BetaManagedAgentsStreamSessionThreadEvents>>;
+}
+export interface EventListParams extends PageCursorParams {
+    /**
+     * Path param: Path parameter session_id
+     */
+    session_id: string;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface EventStreamParams {
+    /**
+     * Path param: Path parameter session_id
+     */
+    session_id: string;
+    /**
+     * Query param: When set, this connection also receives streaming deltas
+     * (`event_start`, `event_delta`) while an event is being produced, before the
+     * event itself arrives. Deltas are best-effort; when the final event is produced
+     * it carries the complete content. A model request that ends early (an error or
+     * interrupt) produces no final event — its terminal `span.model_request_end`
+     * closes the preview. Accepts one or more event types to preview and may be
+     * repeated: `agent.message` streams `content_delta` fragments; `agent.thinking` is
+     * start-only — a signal that the agent has begun extended thinking, concluded by
+     * the `agent.thinking` event itself. Only previews of the requested event types
+     * are sent.
+     */
+    event_deltas?: Array<SessionsAPI.BetaManagedAgentsDeltaType>;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export declare namespace Events {
+    export { type EventListParams as EventListParams, type EventStreamParams as EventStreamParams };
+}
+export { type BetaManagedAgentsSessionEventsPageCursor };

package/dist/vendor/resources/beta/sessions/threads/events.js

@@ -0,0 +1,57 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../../../core/resource.js';
+import { PageCursor } from '../../../../core/pagination.js';
+import { buildHeaders } from '../../../../internal/headers.js';
+import { path } from '../../../../internal/utils/path.js';
+export class Events extends APIResource {
+    /**
+     * List Session Thread Events
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsSessionEvent of client.beta.sessions.threads.events.list(
+     *   'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *   { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(threadID, params, options) {
+        const { session_id, betas, ...query } = params;
+        return this._client.getAPIList(path `/v1/sessions/${session_id}/threads/${threadID}/events?beta=true`, (PageCursor), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Stream Session Thread Events
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsStreamSessionThreadEvents =
+     *   await client.beta.sessions.threads.events.stream(
+     *     'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    stream(threadID, params, options) {
+        const { session_id, betas, ...query } = params;
+        return this._client.get(path `/v1/sessions/${session_id}/threads/${threadID}/stream?beta=true`, {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+            stream: true,
+        });
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/vendor/resources/beta/sessions/threads/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../../../src/vendor/resources/beta/sessions/threads/events.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAOxD,OAAO,EAAE,UAAU,EAAsC,MAAM,6BAA6B,CAAC;AAE7F,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAEvD,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,QAAgB,EAChB,MAAuB,EACvB,OAAwB;QAExB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,gBAAgB,UAAU,YAAY,QAAQ,mBAAmB,EACrE,CAAA,UAAmD,CAAA,EACnD;YACE,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC3E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,QAAgB,EAChB,MAAyB,EACzB,OAAwB;QAExB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,UAAU,YAAY,QAAQ,mBAAmB,EAAE;YAC7F,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC3E,OAAO,EAAE,OAAO;aACjB,CAAC;YACF,MAAM,EAAE,IAAI;SACb,CAA8E,CAAC;IAClF,CAAC;CACF"}

package/dist/vendor/resources/beta/sessions/threads/index.d.ts

@@ -0,0 +1,2 @@
+export { Events, type EventListParams, type EventStreamParams } from './events';
+export { Threads, type BetaManagedAgentsSessionThread, type BetaManagedAgentsSessionThreadStats, type BetaManagedAgentsSessionThreadStatus, type BetaManagedAgentsSessionThreadUsage, type BetaManagedAgentsStreamSessionThreadEvents, type ThreadRetrieveParams, type ThreadListParams, type ThreadArchiveParams, type BetaManagedAgentsSessionThreadsPageCursor, } from './threads';

package/dist/vendor/resources/beta/sessions/threads/index.js

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Events } from './events.js';
+export { Threads, } from './threads.js';
+//# sourceMappingURL=index.js.map

package/dist/vendor/resources/beta/sessions/threads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/vendor/resources/beta/sessions/threads/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,MAAM,EAAgD,MAAM,UAAU,CAAC;AAChF,OAAO,EACL,OAAO,GAUR,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,195 @@
+import { APIResource } from '../../../../core/resource';
+import * as BetaAPI from '../../beta';
+import * as AgentsAPI from '../../agents/agents';
+import * as EventsAPI from '../events';
+import * as SessionsAPI from '../sessions';
+import * as ThreadsEventsAPI from './events';
+import { EventListParams, EventStreamParams, Events } from './events';
+import { APIPromise } from '../../../../core/api-promise';
+import { PageCursor, type PageCursorParams, PagePromise } from '../../../../core/pagination';
+import { RequestOptions } from '../../../../internal/request-options';
+export declare class Threads extends APIResource {
+    events: ThreadsEventsAPI.Events;
+    /**
+     * Get Session Thread
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSessionThread =
+     *   await client.beta.sessions.threads.retrieve(
+     *     'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    retrieve(threadID: string, params: ThreadRetrieveParams, options?: RequestOptions): APIPromise<BetaManagedAgentsSessionThread>;
+    /**
+     * List Session Threads
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsSessionThread of client.beta.sessions.threads.list(
+     *   'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(sessionID: string, params?: ThreadListParams | null | undefined, options?: RequestOptions): PagePromise<BetaManagedAgentsSessionThreadsPageCursor, BetaManagedAgentsSessionThread>;
+    /**
+     * Archive Session Thread
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSessionThread =
+     *   await client.beta.sessions.threads.archive(
+     *     'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    archive(threadID: string, params: ThreadArchiveParams, options?: RequestOptions): APIPromise<BetaManagedAgentsSessionThread>;
+}
+export type BetaManagedAgentsSessionThreadsPageCursor = PageCursor<BetaManagedAgentsSessionThread>;
+/**
+ * An execution thread within a `session`. Each session has one primary thread plus
+ * zero or more child threads spawned by the coordinator.
+ */
+export interface BetaManagedAgentsSessionThread {
+    /**
+     * Unique identifier for this thread.
+     */
+    id: string;
+    /**
+     * The resolved agent a session thread runs: a saved-agent snapshot, the platform
+     * advisor entry, or an inline-defined (ephemeral) agent snapshot.
+     */
+    agent: AgentsAPI.BetaManagedAgentsSessionThreadAgent | AgentsAPI.BetaManagedAgentsAdvisor;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    archived_at: string | null;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    created_at: string;
+    /**
+     * Parent thread that spawned this thread. Null for the primary thread.
+     */
+    parent_thread_id: string | null;
+    /**
+     * The session this thread belongs to.
+     */
+    session_id: string;
+    /**
+     * Timing statistics for a session thread.
+     */
+    stats: BetaManagedAgentsSessionThreadStats | null;
+    /**
+     * SessionThreadStatus enum
+     */
+    status: BetaManagedAgentsSessionThreadStatus;
+    type: 'session_thread';
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    updated_at: string;
+    /**
+     * Cumulative token usage for a session thread across all turns.
+     */
+    usage: BetaManagedAgentsSessionThreadUsage | null;
+}
+/**
+ * Timing statistics for a session thread.
+ */
+export interface BetaManagedAgentsSessionThreadStats {
+    /**
+     * Cumulative time in seconds the thread spent actively running. Excludes idle
+     * time.
+     */
+    active_seconds?: number;
+    /**
+     * Elapsed time since thread creation in seconds. For archived threads, frozen at
+     * the final update.
+     */
+    duration_seconds?: number;
+    /**
+     * Time in seconds for the thread to begin running. Zero for child threads, which
+     * start immediately.
+     */
+    startup_seconds?: number;
+}
+/**
+ * SessionThreadStatus enum
+ */
+export type BetaManagedAgentsSessionThreadStatus = 'running' | 'idle' | 'rescheduling' | 'terminated';
+/**
+ * Cumulative token usage for a session thread across all turns.
+ */
+export interface BetaManagedAgentsSessionThreadUsage {
+    /**
+     * Cumulative time in seconds this thread spent in running status. Equal to
+     * `stats.active_seconds`; surfaced here so a thread's usage carries every quantity
+     * its cost is priced on.
+     */
+    active_seconds?: number;
+    /**
+     * Prompt-cache creation token usage broken down by cache lifetime.
+     */
+    cache_creation?: SessionsAPI.BetaManagedAgentsCacheCreationUsage;
+    /**
+     * Total tokens read from prompt cache.
+     */
+    cache_read_input_tokens?: number;
+    /**
+     * Total input tokens consumed across all turns.
+     */
+    input_tokens?: number;
+    /**
+     * A monetary amount in a specific currency.
+     */
+    list_cost?: BetaAPI.BetaMonetaryAmount | null;
+    /**
+     * Total output tokens generated across all turns.
+     */
+    output_tokens?: number;
+    /**
+     * Cumulative count of server-executed tool invocations, broken down by tool.
+     */
+    server_tool_use?: SessionsAPI.BetaManagedAgentsServerToolUsage | null;
+}
+/**
+ * Server-sent event in a single thread's stream.
+ */
+export type BetaManagedAgentsStreamSessionThreadEvents = EventsAPI.BetaManagedAgentsUserMessageEvent | EventsAPI.BetaManagedAgentsUserInterruptEvent | EventsAPI.BetaManagedAgentsUserToolConfirmationEvent | EventsAPI.BetaManagedAgentsUserCustomToolResultEvent | EventsAPI.BetaManagedAgentsAgentCustomToolUseEvent | EventsAPI.BetaManagedAgentsAgentMessageEvent | EventsAPI.BetaManagedAgentsAgentThinkingEvent | EventsAPI.BetaManagedAgentsAgentMCPToolUseEvent | EventsAPI.BetaManagedAgentsAgentMCPToolResultEvent | EventsAPI.BetaManagedAgentsAgentToolUseEvent | EventsAPI.BetaManagedAgentsAgentToolResultEvent | EventsAPI.BetaManagedAgentsAgentThreadMessageReceivedEvent | EventsAPI.BetaManagedAgentsAgentThreadMessageSentEvent | EventsAPI.BetaManagedAgentsAgentThreadContextCompactedEvent | EventsAPI.BetaManagedAgentsSessionErrorEvent | EventsAPI.BetaManagedAgentsSessionStatusRescheduledEvent | EventsAPI.BetaManagedAgentsSessionStatusRunningEvent | EventsAPI.BetaManagedAgentsSessionStatusIdleEvent | EventsAPI.BetaManagedAgentsSessionStatusTerminatedEvent | EventsAPI.BetaManagedAgentsSessionThreadCreatedEvent | EventsAPI.BetaManagedAgentsSpanOutcomeEvaluationStartEvent | EventsAPI.BetaManagedAgentsSpanOutcomeEvaluationEndEvent | EventsAPI.BetaManagedAgentsSpanModelRequestStartEvent | EventsAPI.BetaManagedAgentsSpanModelRequestEndEvent | EventsAPI.BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent | EventsAPI.BetaManagedAgentsUserDefineOutcomeEvent | EventsAPI.BetaManagedAgentsSessionDeletedEvent | EventsAPI.BetaManagedAgentsSessionThreadStatusRunningEvent | EventsAPI.BetaManagedAgentsSessionThreadStatusIdleEvent | EventsAPI.BetaManagedAgentsSessionThreadStatusTerminatedEvent | SessionsAPI.BetaManagedAgentsUserToolResultEvent | EventsAPI.BetaManagedAgentsSessionThreadStatusRescheduledEvent | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent | SessionsAPI.BetaManagedAgentsStartEvent | SessionsAPI.BetaManagedAgentsDeltaEvent | SessionsAPI.BetaManagedAgentsSystemMessageEvent | SessionsAPI.BetaManagedAgentsSessionUsageEvent;
+export interface ThreadRetrieveParams {
+    /**
+     * Path param: Path parameter session_id
+     */
+    session_id: string;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface ThreadListParams extends PageCursorParams {
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface ThreadArchiveParams {
+    /**
+     * Path param: Path parameter session_id
+     */
+    session_id: string;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export declare namespace Threads {
+    export { type BetaManagedAgentsSessionThread as BetaManagedAgentsSessionThread, type BetaManagedAgentsSessionThreadStats as BetaManagedAgentsSessionThreadStats, type BetaManagedAgentsSessionThreadStatus as BetaManagedAgentsSessionThreadStatus, type BetaManagedAgentsSessionThreadUsage as BetaManagedAgentsSessionThreadUsage, type BetaManagedAgentsStreamSessionThreadEvents as BetaManagedAgentsStreamSessionThreadEvents, type BetaManagedAgentsSessionThreadsPageCursor as BetaManagedAgentsSessionThreadsPageCursor, type ThreadRetrieveParams as ThreadRetrieveParams, type ThreadListParams as ThreadListParams, type ThreadArchiveParams as ThreadArchiveParams, };
+    export { Events as Events, type EventListParams as EventListParams, type EventStreamParams as EventStreamParams, };
+}

package/dist/vendor/resources/beta/sessions/threads/threads.js

@@ -0,0 +1,80 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../../../core/resource.js';
+import * as ThreadsEventsAPI from './events.js';
+import { Events } from './events.js';
+import { PageCursor } from '../../../../core/pagination.js';
+import { buildHeaders } from '../../../../internal/headers.js';
+import { path } from '../../../../internal/utils/path.js';
+export class Threads extends APIResource {
+    events = new ThreadsEventsAPI.Events(this._client);
+    /**
+     * Get Session Thread
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSessionThread =
+     *   await client.beta.sessions.threads.retrieve(
+     *     'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    retrieve(threadID, params, options) {
+        const { session_id, betas } = params;
+        return this._client.get(path `/v1/sessions/${session_id}/threads/${threadID}?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List Session Threads
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsSessionThread of client.beta.sessions.threads.list(
+     *   'sesn_011CZkZAtmR3yMPDzynEDxu7',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(sessionID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList(path `/v1/sessions/${sessionID}/threads?beta=true`, (PageCursor), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Archive Session Thread
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsSessionThread =
+     *   await client.beta.sessions.threads.archive(
+     *     'sthr_011CZkZVWa6oIjw0rgXZpnBt',
+     *     { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
+     *   );
+     * ```
+     */
+    archive(threadID, params, options) {
+        const { session_id, betas } = params;
+        return this._client.post(path `/v1/sessions/${session_id}/threads/${threadID}/archive?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+Threads.Events = Events;
+//# sourceMappingURL=threads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../../../../../src/vendor/resources/beta/sessions/threads/threads.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAKxD,OAAO,KAAK,gBAAgB,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAsC,MAAM,EAAE,MAAM,UAAU,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAsC,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAEvD,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC,MAAM,GAA4B,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5E;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,QAAgB,EAChB,MAA4B,EAC5B,OAAwB;QAExB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,UAAU,YAAY,QAAQ,YAAY,EAAE;YACtF,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC3E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,SAAiB,EACjB,SAA8C,EAAE,EAChD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,gBAAgB,SAAS,oBAAoB,EACjD,CAAA,UAA0C,CAAA,EAC1C;YACE,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC3E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CACL,QAAgB,EAChB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gBAAgB,UAAU,YAAY,QAAQ,oBAAoB,EAAE;YAC/F,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC3E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AA8MD,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC"}

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

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

package/dist/vendor/resources/beta/sessions/threads.js

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,2 @@
+export { Skills, type BetaDeletedSkill, type BetaSkill, type BetaSkillSource, type SkillCreateParams, type SkillRetrieveParams, type SkillListParams, type SkillDeleteParams, type BetaSkillsPageCursor, } from './skills';
+export { Versions, type BetaDeletedSkillVersion, type BetaSkillVersion, type VersionCreateParams, type VersionRetrieveParams, type VersionListParams, type VersionDeleteParams, type VersionDownloadParams, type BetaSkillVersionsPageCursor, } from './versions';

package/dist/vendor/resources/beta/skills/index.js

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Skills, } from './skills.js';
+export { Versions, } from './versions.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/vendor/resources/beta/skills/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,MAAM,GASP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,GAST,MAAM,YAAY,CAAC"}