openai 7.28.0 → 7.30.0

package/resources/beta/agents/sessions/turns/turns.d.mts

@@ -0,0 +1,128 @@
+import { APIResource } from "../../../../../core/resource.mjs";
+import * as AgentsAPI from "../../agents.mjs";
+import * as ItemsAPI from "./items.mjs";
+import { ItemListParams, Items } from "./items.mjs";
+import { APIPromise } from "../../../../../core/api-promise.mjs";
+import { CursorPage, type CursorPageParams, PagePromise } from "../../../../../core/pagination.mjs";
+import { RequestOptions } from "../../../../../internal/request-options.mjs";
+export declare class Turns extends APIResource {
+    items: ItemsAPI.Items;
+    /**
+     * Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
+     * the turn does not belong to the session. See
+     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+     *
+     * @example
+     * ```ts
+     * const turn =
+     *   await client.beta.agents.sessions.turns.retrieve(
+     *     'turn_id',
+     *     { session_id: 'session_id' },
+     *   );
+     * ```
+     */
+    retrieve(turnID: string, params: TurnRetrieveParams, options?: RequestOptions): APIPromise<Turn>;
+    /**
+     * Lists turns by creation time and turn ID. The after cursor is exclusive in the
+     * selected order. See
+     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const turn of client.beta.agents.sessions.turns.list(
+     *   'session_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(sessionID: string, query?: (TurnListParams & ({
+        [K in 'method' | 'path' | 'query' | 'body' | 'headers' | 'maxRetries' | 'stream' | 'timeout' | 'httpAgent' | 'fetchOptions' | 'signal' | 'idempotencyKey' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    } | null | undefined)) | null | undefined, options?: RequestOptions): PagePromise<TurnsPage, Turn>;
+    list(sessionID: string, options?: {
+        [K in 'headers' | 'maxRetries' | 'timeout' | 'signal' | 'idempotencyKey' | 'query']?: RequestOptions[K];
+    } & {
+        [K in 'method' | 'path' | 'body' | 'stream' | 'httpAgent' | 'fetchOptions' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    }): PagePromise<TurnsPage, Turn>;
+}
+export type TurnsPage = CursorPage<Turn>;
+/**
+ * The canonical public representation of a session turn.
+ */
+export interface Turn {
+    /**
+     * The ID of the turn.
+     */
+    id: string;
+    /**
+     * The ID of the agent that ran the turn.
+     */
+    agent_id: string;
+    /**
+     * The Unix timestamp, in seconds, when the turn reached a terminal state.
+     */
+    completed_at: number | null;
+    /**
+     * The Unix timestamp, in seconds, used to order the turn by creation time.
+     * Subagent turns use their start time, falling back to completion time or the
+     * subagent opening time when the preceding timestamps are unavailable.
+     */
+    created_at: number;
+    /**
+     * A customer-safe error. Non-null only for a failed turn.
+     */
+    error: AgentsAPI.SessionTurnError | null;
+    /**
+     * The object type. Always `agent.session.turn`.
+     */
+    object: 'agent.session.turn';
+    /**
+     * The ID of the session that owns the turn.
+     */
+    session_id: string;
+    /**
+     * The Unix timestamp, in seconds, when the turn started.
+     */
+    started_at: number | null;
+    /**
+     * The current status of the turn.
+     *
+     * - `queued` - The turn is waiting to start.
+     * - `in_progress` - The turn is in progress.
+     * - `waiting` - The turn is waiting for external input.
+     * - `completed` - The turn completed successfully.
+     * - `failed` - The turn failed.
+     * - `cancelled` - The turn was cancelled.
+     */
+    status: 'queued' | 'in_progress' | 'waiting' | 'completed' | 'failed' | 'cancelled';
+    /**
+     * The ID of the subagent that ran the turn, if applicable.
+     */
+    subagent_id: string | null;
+    /**
+     * Best-effort token usage for the turn, or null if unknown. Recorded usage may
+     * change.
+     */
+    usage: AgentsAPI.TokenUsage | null;
+}
+export interface TurnRetrieveParams {
+    /**
+     * The ID of the session that owns the turn.
+     */
+    session_id: string;
+}
+export interface TurnListParams extends CursorPageParams {
+    /**
+     * The order in which resources are returned. Defaults to `desc`.
+     *
+     * - `asc` - Returns resources in ascending order.
+     * - `desc` - Returns resources in descending order.
+     */
+    order?: 'asc' | 'desc';
+}
+export declare namespace Turns {
+    export { type Turn as Turn, type TurnsPage as TurnsPage, type TurnRetrieveParams as TurnRetrieveParams, type TurnListParams as TurnListParams, };
+    export { Items as Items, type ItemListParams as ItemListParams };
+}
+//# sourceMappingURL=turns.d.mts.map

package/resources/beta/agents/sessions/turns/turns.d.mts.map

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

package/resources/beta/agents/sessions/turns/turns.d.ts

@@ -0,0 +1,128 @@
+import { APIResource } from "../../../../../core/resource.js";
+import * as AgentsAPI from "../../agents.js";
+import * as ItemsAPI from "./items.js";
+import { ItemListParams, Items } from "./items.js";
+import { APIPromise } from "../../../../../core/api-promise.js";
+import { CursorPage, type CursorPageParams, PagePromise } from "../../../../../core/pagination.js";
+import { RequestOptions } from "../../../../../internal/request-options.js";
+export declare class Turns extends APIResource {
+    items: ItemsAPI.Items;
+    /**
+     * Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
+     * the turn does not belong to the session. See
+     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+     *
+     * @example
+     * ```ts
+     * const turn =
+     *   await client.beta.agents.sessions.turns.retrieve(
+     *     'turn_id',
+     *     { session_id: 'session_id' },
+     *   );
+     * ```
+     */
+    retrieve(turnID: string, params: TurnRetrieveParams, options?: RequestOptions): APIPromise<Turn>;
+    /**
+     * Lists turns by creation time and turn ID. The after cursor is exclusive in the
+     * selected order. See
+     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const turn of client.beta.agents.sessions.turns.list(
+     *   'session_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(sessionID: string, query?: (TurnListParams & ({
+        [K in 'method' | 'path' | 'query' | 'body' | 'headers' | 'maxRetries' | 'stream' | 'timeout' | 'httpAgent' | 'fetchOptions' | 'signal' | 'idempotencyKey' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    } | null | undefined)) | null | undefined, options?: RequestOptions): PagePromise<TurnsPage, Turn>;
+    list(sessionID: string, options?: {
+        [K in 'headers' | 'maxRetries' | 'timeout' | 'signal' | 'idempotencyKey' | 'query']?: RequestOptions[K];
+    } & {
+        [K in 'method' | 'path' | 'body' | 'stream' | 'httpAgent' | 'fetchOptions' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    }): PagePromise<TurnsPage, Turn>;
+}
+export type TurnsPage = CursorPage<Turn>;
+/**
+ * The canonical public representation of a session turn.
+ */
+export interface Turn {
+    /**
+     * The ID of the turn.
+     */
+    id: string;
+    /**
+     * The ID of the agent that ran the turn.
+     */
+    agent_id: string;
+    /**
+     * The Unix timestamp, in seconds, when the turn reached a terminal state.
+     */
+    completed_at: number | null;
+    /**
+     * The Unix timestamp, in seconds, used to order the turn by creation time.
+     * Subagent turns use their start time, falling back to completion time or the
+     * subagent opening time when the preceding timestamps are unavailable.
+     */
+    created_at: number;
+    /**
+     * A customer-safe error. Non-null only for a failed turn.
+     */
+    error: AgentsAPI.SessionTurnError | null;
+    /**
+     * The object type. Always `agent.session.turn`.
+     */
+    object: 'agent.session.turn';
+    /**
+     * The ID of the session that owns the turn.
+     */
+    session_id: string;
+    /**
+     * The Unix timestamp, in seconds, when the turn started.
+     */
+    started_at: number | null;
+    /**
+     * The current status of the turn.
+     *
+     * - `queued` - The turn is waiting to start.
+     * - `in_progress` - The turn is in progress.
+     * - `waiting` - The turn is waiting for external input.
+     * - `completed` - The turn completed successfully.
+     * - `failed` - The turn failed.
+     * - `cancelled` - The turn was cancelled.
+     */
+    status: 'queued' | 'in_progress' | 'waiting' | 'completed' | 'failed' | 'cancelled';
+    /**
+     * The ID of the subagent that ran the turn, if applicable.
+     */
+    subagent_id: string | null;
+    /**
+     * Best-effort token usage for the turn, or null if unknown. Recorded usage may
+     * change.
+     */
+    usage: AgentsAPI.TokenUsage | null;
+}
+export interface TurnRetrieveParams {
+    /**
+     * The ID of the session that owns the turn.
+     */
+    session_id: string;
+}
+export interface TurnListParams extends CursorPageParams {
+    /**
+     * The order in which resources are returned. Defaults to `desc`.
+     *
+     * - `asc` - Returns resources in ascending order.
+     * - `desc` - Returns resources in descending order.
+     */
+    order?: 'asc' | 'desc';
+}
+export declare namespace Turns {
+    export { type Turn as Turn, type TurnsPage as TurnsPage, type TurnRetrieveParams as TurnRetrieveParams, type TurnListParams as TurnListParams, };
+    export { Items as Items, type ItemListParams as ItemListParams };
+}
+//# sourceMappingURL=turns.d.ts.map

package/resources/beta/agents/sessions/turns/turns.d.ts.map

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

package/resources/beta/agents/sessions/turns/turns.js

@@ -0,0 +1,111 @@
+"use strict";
+// File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Turns = void 0;
+const tslib_1 = require("../../../../../internal/tslib.js");
+const resource_1 = require("../../../../../core/resource.js");
+const ItemsAPI = tslib_1.__importStar(require("./items.js"));
+const items_1 = require("./items.js");
+const pagination_1 = require("../../../../../core/pagination.js");
+const headers_1 = require("../../../../../internal/headers.js");
+const path_1 = require("../../../../../internal/utils/path.js");
+function resolveResourceRequestOptions(options, buildOptions) {
+    return Promise.resolve(options).then(buildOptions);
+}
+// Recognizable options across SDK runtime versions. Keep this independent of
+// private RequestOptions fields so older handwritten runtimes still compile.
+const normalizeRequestOptionsForQueryKeys = new Set([
+    'method',
+    'path',
+    'query',
+    'body',
+    'headers',
+    'maxRetries',
+    'stream',
+    'timeout',
+    'httpAgent',
+    'fetchOptions',
+    'signal',
+    'idempotencyKey',
+    'defaultBaseURL',
+    '__metadata',
+    '__binaryRequest',
+    '__binaryResponse',
+    '__streamClass',
+    '__security',
+    '__synthesizeEventData',
+]);
+function normalizeRequestOptionsForQuery(value, queryKeys, options) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    // Optional never fields can still be explicitly undefined unless consumers
+    // enable exactOptionalPropertyTypes. Snapshot data without invoking getters.
+    const entries = Object.entries(Object.getOwnPropertyDescriptors(value)).filter(([, descriptor]) => descriptor.enumerable && (!('value' in descriptor) || descriptor.value !== undefined));
+    const keys = entries.map(([key]) => key);
+    const requestOnly = keys.some((key) => normalizeRequestOptionsForQueryKeys.has(key) && !queryKeys.includes(key));
+    if (!requestOnly)
+        return undefined;
+    // Declared query fields, including stream, must use the query argument.
+    // Mixing them with request-only options is ambiguous and could change the return type.
+    if (options !== undefined ||
+        keys.some((key) => !normalizeRequestOptionsForQueryKeys.has(key) || queryKeys.includes(key))) {
+        throw new TypeError('Query parameters and request options must be passed as separate arguments.');
+    }
+    // The query position must not gain authority to change the request destination
+    // or transport. Those overrides require the explicit request options argument.
+    if (keys.some((key) => !['headers', 'maxRetries', 'timeout', 'signal', 'idempotencyKey', 'query'].includes(key))) {
+        throw new TypeError('Pass transport overrides in the explicit request options argument.');
+    }
+    // Copy only the validated fields. Spreading value would reintroduce undefined
+    // transport overrides, and deleting them would mutate the caller's object.
+    return Object.fromEntries(entries.map(([key, descriptor]) => {
+        if ('value' in descriptor)
+            return [key, descriptor.value];
+        return [key, descriptor.get ? Reflect.apply(descriptor.get, value, []) : undefined];
+    }));
+}
+class Turns extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.items = new ItemsAPI.Items(this._client);
+    }
+    /**
+     * Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
+     * the turn does not belong to the session. See
+     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+     *
+     * @example
+     * ```ts
+     * const turn =
+     *   await client.beta.agents.sessions.turns.retrieve(
+     *     'turn_id',
+     *     { session_id: 'session_id' },
+     *   );
+     * ```
+     */
+    retrieve(turnID, params, options) {
+        const { session_id } = params;
+        return this._client.get((0, path_1.path) `/agents/sessions/${session_id}/turns/${turnID}`, resolveResourceRequestOptions(options, (options) => ({
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'OpenAI-Beta': 'agents=v1' }, options?.headers]),
+            __security: { bearerAuth: true },
+        })));
+    }
+    list(sessionID, query = {}, options) {
+        const normalizeRequestOptionsForQueryOptions = normalizeRequestOptionsForQuery(query, ['after', 'limit', 'order'], options);
+        if (normalizeRequestOptionsForQueryOptions !== undefined) {
+            options = normalizeRequestOptionsForQueryOptions;
+            query = {};
+        }
+        query = query;
+        return this._client.getAPIList((0, path_1.path) `/agents/sessions/${sessionID}/turns`, (pagination_1.CursorPage), resolveResourceRequestOptions(options, (options) => ({
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'OpenAI-Beta': 'agents=v1' }, options?.headers]),
+            __security: { bearerAuth: true },
+        })));
+    }
+}
+exports.Turns = Turns;
+Turns.Items = items_1.Items;
+//# sourceMappingURL=turns.js.map

package/resources/beta/agents/sessions/turns/turns.js.map

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

package/resources/beta/agents/sessions/turns/turns.mjs

@@ -0,0 +1,106 @@
+// File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../../core/resource.mjs";
+import * as ItemsAPI from "./items.mjs";
+import { Items } from "./items.mjs";
+import { CursorPage } from "../../../../../core/pagination.mjs";
+import { buildHeaders } from "../../../../../internal/headers.mjs";
+import { path } from "../../../../../internal/utils/path.mjs";
+function resolveResourceRequestOptions(options, buildOptions) {
+    return Promise.resolve(options).then(buildOptions);
+}
+// Recognizable options across SDK runtime versions. Keep this independent of
+// private RequestOptions fields so older handwritten runtimes still compile.
+const normalizeRequestOptionsForQueryKeys = new Set([
+    'method',
+    'path',
+    'query',
+    'body',
+    'headers',
+    'maxRetries',
+    'stream',
+    'timeout',
+    'httpAgent',
+    'fetchOptions',
+    'signal',
+    'idempotencyKey',
+    'defaultBaseURL',
+    '__metadata',
+    '__binaryRequest',
+    '__binaryResponse',
+    '__streamClass',
+    '__security',
+    '__synthesizeEventData',
+]);
+function normalizeRequestOptionsForQuery(value, queryKeys, options) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    // Optional never fields can still be explicitly undefined unless consumers
+    // enable exactOptionalPropertyTypes. Snapshot data without invoking getters.
+    const entries = Object.entries(Object.getOwnPropertyDescriptors(value)).filter(([, descriptor]) => descriptor.enumerable && (!('value' in descriptor) || descriptor.value !== undefined));
+    const keys = entries.map(([key]) => key);
+    const requestOnly = keys.some((key) => normalizeRequestOptionsForQueryKeys.has(key) && !queryKeys.includes(key));
+    if (!requestOnly)
+        return undefined;
+    // Declared query fields, including stream, must use the query argument.
+    // Mixing them with request-only options is ambiguous and could change the return type.
+    if (options !== undefined ||
+        keys.some((key) => !normalizeRequestOptionsForQueryKeys.has(key) || queryKeys.includes(key))) {
+        throw new TypeError('Query parameters and request options must be passed as separate arguments.');
+    }
+    // The query position must not gain authority to change the request destination
+    // or transport. Those overrides require the explicit request options argument.
+    if (keys.some((key) => !['headers', 'maxRetries', 'timeout', 'signal', 'idempotencyKey', 'query'].includes(key))) {
+        throw new TypeError('Pass transport overrides in the explicit request options argument.');
+    }
+    // Copy only the validated fields. Spreading value would reintroduce undefined
+    // transport overrides, and deleting them would mutate the caller's object.
+    return Object.fromEntries(entries.map(([key, descriptor]) => {
+        if ('value' in descriptor)
+            return [key, descriptor.value];
+        return [key, descriptor.get ? Reflect.apply(descriptor.get, value, []) : undefined];
+    }));
+}
+export class Turns extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.items = new ItemsAPI.Items(this._client);
+    }
+    /**
+     * Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
+     * the turn does not belong to the session. See
+     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+     *
+     * @example
+     * ```ts
+     * const turn =
+     *   await client.beta.agents.sessions.turns.retrieve(
+     *     'turn_id',
+     *     { session_id: 'session_id' },
+     *   );
+     * ```
+     */
+    retrieve(turnID, params, options) {
+        const { session_id } = params;
+        return this._client.get(path `/agents/sessions/${session_id}/turns/${turnID}`, resolveResourceRequestOptions(options, (options) => ({
+            ...options,
+            headers: buildHeaders([{ 'OpenAI-Beta': 'agents=v1' }, options?.headers]),
+            __security: { bearerAuth: true },
+        })));
+    }
+    list(sessionID, query = {}, options) {
+        const normalizeRequestOptionsForQueryOptions = normalizeRequestOptionsForQuery(query, ['after', 'limit', 'order'], options);
+        if (normalizeRequestOptionsForQueryOptions !== undefined) {
+            options = normalizeRequestOptionsForQueryOptions;
+            query = {};
+        }
+        query = query;
+        return this._client.getAPIList(path `/agents/sessions/${sessionID}/turns`, (CursorPage), resolveResourceRequestOptions(options, (options) => ({
+            query,
+            ...options,
+            headers: buildHeaders([{ 'OpenAI-Beta': 'agents=v1' }, options?.headers]),
+            __security: { bearerAuth: true },
+        })));
+    }
+}
+Turns.Items = Items;
+//# sourceMappingURL=turns.mjs.map

package/resources/beta/agents/sessions/turns/turns.mjs.map

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

package/resources/beta/agents/sessions/turns.d.mts

@@ -1,124 +1,2 @@
-import { APIResource } from "../../../../core/resource.mjs";
-import * as AgentsAPI from "../agents.mjs";
-import { APIPromise } from "../../../../core/api-promise.mjs";
-import { CursorPage, type CursorPageParams, PagePromise } from "../../../../core/pagination.mjs";
-import { RequestOptions } from "../../../../internal/request-options.mjs";
-export declare class Turns extends APIResource {
-    /**
-     * Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
-     * the turn does not belong to the session. See
-     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
-     *
-     * @example
-     * ```ts
-     * const turn =
-     *   await client.beta.agents.sessions.turns.retrieve(
-     *     'turn_id',
-     *     { session_id: 'session_id' },
-     *   );
-     * ```
-     */
-    retrieve(turnID: string, params: TurnRetrieveParams, options?: RequestOptions): APIPromise<Turn>;
-    /**
-     * Lists turns by creation time and turn ID. The after cursor is exclusive in the
-     * selected order. See
-     * [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
-     *
-     * @example
-     * ```ts
-     * // Automatically fetches more pages as needed.
-     * for await (const turn of client.beta.agents.sessions.turns.list(
-     *   'session_id',
-     * )) {
-     *   // ...
-     * }
-     * ```
-     */
-    list(sessionID: string, query?: (TurnListParams & ({
-        [K in 'method' | 'path' | 'query' | 'body' | 'headers' | 'maxRetries' | 'stream' | 'timeout' | 'httpAgent' | 'fetchOptions' | 'signal' | 'idempotencyKey' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
-    } | null | undefined)) | null | undefined, options?: RequestOptions): PagePromise<TurnsPage, Turn>;
-    list(sessionID: string, options?: {
-        [K in 'headers' | 'maxRetries' | 'timeout' | 'signal' | 'idempotencyKey' | 'query']?: RequestOptions[K];
-    } & {
-        [K in 'method' | 'path' | 'body' | 'stream' | 'httpAgent' | 'fetchOptions' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
-    }): PagePromise<TurnsPage, Turn>;
-}
-export type TurnsPage = CursorPage<Turn>;
-/**
- * The canonical public representation of a session turn.
- */
-export interface Turn {
-    /**
-     * The ID of the turn.
-     */
-    id: string;
-    /**
-     * The ID of the agent that ran the turn.
-     */
-    agent_id: string;
-    /**
-     * The Unix timestamp, in seconds, when the turn reached a terminal state.
-     */
-    completed_at: number | null;
-    /**
-     * The Unix timestamp, in seconds, used to order the turn by creation time.
-     * Subagent turns use their start time, falling back to completion time or the
-     * subagent opening time when the preceding timestamps are unavailable.
-     */
-    created_at: number;
-    /**
-     * A customer-safe error. Non-null only for a failed turn.
-     */
-    error: AgentsAPI.SessionTurnError | null;
-    /**
-     * The object type. Always `agent.session.turn`.
-     */
-    object: 'agent.session.turn';
-    /**
-     * The ID of the session that owns the turn.
-     */
-    session_id: string;
-    /**
-     * The Unix timestamp, in seconds, when the turn started.
-     */
-    started_at: number | null;
-    /**
-     * The current status of the turn.
-     *
-     * - `queued` - The turn is waiting to start.
-     * - `in_progress` - The turn is in progress.
-     * - `waiting` - The turn is waiting for external input.
-     * - `completed` - The turn completed successfully.
-     * - `failed` - The turn failed.
-     * - `cancelled` - The turn was cancelled.
-     */
-    status: 'queued' | 'in_progress' | 'waiting' | 'completed' | 'failed' | 'cancelled';
-    /**
-     * The ID of the subagent that ran the turn, if applicable.
-     */
-    subagent_id: string | null;
-    /**
-     * Best-effort token usage for the turn, or null if unknown. Recorded usage may
-     * change.
-     */
-    usage: AgentsAPI.TokenUsage | null;
-}
-export interface TurnRetrieveParams {
-    /**
-     * The ID of the session that owns the turn.
-     */
-    session_id: string;
-}
-export interface TurnListParams extends CursorPageParams {
-    /**
-     * The order in which resources are returned. Defaults to `desc`.
-     *
-     * - `asc` - Returns resources in ascending order.
-     * - `desc` - Returns resources in descending order.
-     */
-    order?: 'asc' | 'desc';
-}
-export declare namespace Turns {
-    export { type Turn as Turn, type TurnsPage as TurnsPage, type TurnRetrieveParams as TurnRetrieveParams, type TurnListParams as TurnListParams, };
-}
+export * from "./turns/index.mjs";
 //# sourceMappingURL=turns.d.mts.map

package/resources/beta/agents/sessions/turns.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"turns.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/sessions/turns.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turns.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/sessions/turns.ts"],"names":[],"mappings":"AAEA,kCAA8B"}