@clear-street/clearstreet 0.0.0 → 0.73.0

package/resources/v1/omni-ai/responses.d.ts

@@ -0,0 +1,158 @@
+import { APIResource } from "../../../core/resource.js";
+import * as Shared from "../../shared.js";
+import * as OmniAIAPI from "./omni-ai.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Thread-centric AI assistant for conversational trading. Create threads to start conversations, poll response objects for in-progress output, and read finalized messages from thread history. Thread/message/response endpoints require an explicit account_id. Entitlement endpoints are caller-scoped and use account_ids.
+ */
+export declare class Responses extends APIResource {
+    /**
+     * Cancel a response.
+     *
+     * Requests cancellation of a queued or running response. If the response has
+     * already reached a terminal status, this is an idempotent success. A canceled
+     * turn still produces a final assistant message with outcome `canceled` in the
+     * thread history.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.responses.cancelResponse(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    cancelResponse(responseID: string, params: ResponseCancelResponseParams, options?: RequestOptions): APIPromise<ResponseCancelResponseResponse>;
+    /**
+     * Poll a response for assistant output.
+     *
+     * Returns the current snapshot of an in-progress or completed response. While the
+     * status is `queued` or `running`, the content may be partial and may include
+     * `thinking` parts. Poll this endpoint periodically until the status reaches a
+     * terminal value (`succeeded`, `failed`, or `canceled`).
+     *
+     * Once terminal, the finalized assistant message is available in thread history
+     * via `GET /omni-ai/threads/{thread_id}/messages`.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.responses.getResponseByID(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    getResponseByID(responseID: string, query: ResponseGetResponseByIDParams, options?: RequestOptions): APIPromise<ResponseGetResponseByIDResponse>;
+}
+export interface CancelResponsePayload {
+    canceled: boolean;
+}
+/**
+ * Shared sanitized error payload.
+ */
+export interface ErrorStatus {
+    code: string;
+    message: string;
+    details?: unknown | null;
+}
+/**
+ * Dynamic pollable response.
+ */
+export interface Response {
+    id: string;
+    /**
+     * Dynamic lifecycle status for a pollable response.
+     */
+    status: ResponseStatus;
+    thread_id: string;
+    user_message_id: string;
+    /**
+     * Dynamic response content container. May include thinking parts.
+     */
+    content?: ResponseContent | null;
+    /**
+     * Shared sanitized error payload.
+     */
+    error?: ErrorStatus | null;
+    output_message_id?: string | null;
+}
+/**
+ * Dynamic response content container. May include thinking parts.
+ */
+export interface ResponseContent {
+    parts: Array<ResponseContentPart>;
+}
+/**
+ * Dynamic content part visible on a pollable response.
+ */
+export type ResponseContentPart = ResponseContentPart.ContentPartText | ResponseContentPart.ContentPartThinking | ResponseContentPart.ContentPartStructuredAction | ResponseContentPart.ContentPartChart | ResponseContentPart.ContentPartSuggestedActions | ResponseContentPart.ContentPartCustom;
+export declare namespace ResponseContentPart {
+    /**
+     * Text content part.
+     */
+    interface ContentPartText extends OmniAIAPI.ContentPartTextPayload {
+        type: 'text';
+    }
+    /**
+     * Thinking content part shown on dynamic response polling.
+     */
+    interface ContentPartThinking extends OmniAIAPI.ContentPartThinkingPayload {
+        type: 'thinking';
+    }
+    /**
+     * Structured action content part.
+     */
+    interface ContentPartStructuredAction extends OmniAIAPI.ContentPartStructuredActionPayload {
+        type: 'structured_action';
+    }
+    /**
+     * Chart payload content part.
+     */
+    interface ContentPartChart extends OmniAIAPI.ContentPartChartPayload {
+        type: 'chart';
+    }
+    /**
+     * Suggested actions payload content part.
+     */
+    interface ContentPartSuggestedActions extends OmniAIAPI.ContentPartSuggestedActionsPayload {
+        type: 'suggested_actions';
+    }
+    /**
+     * Escape-hatch custom payload content part.
+     */
+    interface ContentPartCustom extends OmniAIAPI.ContentPartCustomPayload {
+        type: 'custom';
+    }
+}
+/**
+ * Dynamic lifecycle status for a pollable response.
+ */
+export type ResponseStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled';
+export interface ResponseCancelResponseResponse extends Shared.BaseResponse {
+    data: CancelResponsePayload;
+}
+export interface ResponseGetResponseByIDResponse extends Shared.BaseResponse {
+    /**
+     * Dynamic pollable response.
+     */
+    data: Response;
+}
+export interface ResponseCancelResponseParams {
+    /**
+     * Account ID for the request
+     */
+    account_id: number;
+}
+export interface ResponseGetResponseByIDParams {
+    /**
+     * Account ID for the request
+     */
+    account_id: number;
+}
+export declare namespace Responses {
+    export { type CancelResponsePayload as CancelResponsePayload, type ErrorStatus as ErrorStatus, type Response as Response, type ResponseContent as ResponseContent, type ResponseContentPart as ResponseContentPart, type ResponseStatus as ResponseStatus, type ResponseCancelResponseResponse as ResponseCancelResponseResponse, type ResponseGetResponseByIDResponse as ResponseGetResponseByIDResponse, type ResponseCancelResponseParams as ResponseCancelResponseParams, type ResponseGetResponseByIDParams as ResponseGetResponseByIDParams, };
+}
+//# sourceMappingURL=responses.d.ts.map

package/resources/v1/omni-ai/responses.d.ts.map

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

package/resources/v1/omni-ai/responses.js

@@ -0,0 +1,60 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Responses = void 0;
+const resource_1 = require("../../../core/resource.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Thread-centric AI assistant for conversational trading. Create threads to start conversations, poll response objects for in-progress output, and read finalized messages from thread history. Thread/message/response endpoints require an explicit account_id. Entitlement endpoints are caller-scoped and use account_ids.
+ */
+class Responses extends resource_1.APIResource {
+    /**
+     * Cancel a response.
+     *
+     * Requests cancellation of a queued or running response. If the response has
+     * already reached a terminal status, this is an idempotent success. A canceled
+     * turn still produces a final assistant message with outcome `canceled` in the
+     * thread history.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.responses.cancelResponse(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    cancelResponse(responseID, params, options) {
+        const { account_id } = params;
+        return this._client.delete((0, path_1.path) `/v1/omni-ai/responses/${responseID}`, {
+            query: { account_id },
+            ...options,
+        });
+    }
+    /**
+     * Poll a response for assistant output.
+     *
+     * Returns the current snapshot of an in-progress or completed response. While the
+     * status is `queued` or `running`, the content may be partial and may include
+     * `thinking` parts. Poll this endpoint periodically until the status reaches a
+     * terminal value (`succeeded`, `failed`, or `canceled`).
+     *
+     * Once terminal, the finalized assistant message is available in thread history
+     * via `GET /omni-ai/threads/{thread_id}/messages`.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.responses.getResponseByID(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    getResponseByID(responseID, query, options) {
+        return this._client.get((0, path_1.path) `/v1/omni-ai/responses/${responseID}`, { query, ...options });
+    }
+}
+exports.Responses = Responses;
+//# sourceMappingURL=responses.js.map

package/resources/v1/omni-ai/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../../src/resources/v1/omni-ai/responses.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAKrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CACZ,UAAkB,EAClB,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,yBAAyB,UAAU,EAAE,EAAE;YACpE,KAAK,EAAE,EAAE,UAAU,EAAE;YACrB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CACb,UAAkB,EAClB,KAAoC,EACpC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,yBAAyB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF;AAzDD,8BAyDC"}

package/resources/v1/omni-ai/responses.mjs

@@ -0,0 +1,56 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+/**
+ * Thread-centric AI assistant for conversational trading. Create threads to start conversations, poll response objects for in-progress output, and read finalized messages from thread history. Thread/message/response endpoints require an explicit account_id. Entitlement endpoints are caller-scoped and use account_ids.
+ */
+export class Responses extends APIResource {
+    /**
+     * Cancel a response.
+     *
+     * Requests cancellation of a queued or running response. If the response has
+     * already reached a terminal status, this is an idempotent success. A canceled
+     * turn still produces a final assistant message with outcome `canceled` in the
+     * thread history.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.responses.cancelResponse(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    cancelResponse(responseID, params, options) {
+        const { account_id } = params;
+        return this._client.delete(path `/v1/omni-ai/responses/${responseID}`, {
+            query: { account_id },
+            ...options,
+        });
+    }
+    /**
+     * Poll a response for assistant output.
+     *
+     * Returns the current snapshot of an in-progress or completed response. While the
+     * status is `queued` or `running`, the content may be partial and may include
+     * `thinking` parts. Poll this endpoint periodically until the status reaches a
+     * terminal value (`succeeded`, `failed`, or `canceled`).
+     *
+     * Once terminal, the finalized assistant message is available in thread history
+     * via `GET /omni-ai/threads/{thread_id}/messages`.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.responses.getResponseByID(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    getResponseByID(responseID, query, options) {
+        return this._client.get(path `/v1/omni-ai/responses/${responseID}`, { query, ...options });
+    }
+}
+//# sourceMappingURL=responses.mjs.map

package/resources/v1/omni-ai/responses.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.mjs","sourceRoot":"","sources":["../../../src/resources/v1/omni-ai/responses.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAKrD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CACZ,UAAkB,EAClB,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,yBAAyB,UAAU,EAAE,EAAE;YACpE,KAAK,EAAE,EAAE,UAAU,EAAE;YACrB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CACb,UAAkB,EAClB,KAAoC,EACpC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,yBAAyB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF"}

package/resources/v1/omni-ai/threads.d.mts

@@ -0,0 +1,338 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as Shared from "../../shared.mjs";
+import * as OmniAIAPI from "./omni-ai.mjs";
+import * as ResponsesAPI from "./responses.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Thread-centric AI assistant for conversational trading. Create threads to start conversations, poll response objects for in-progress output, and read finalized messages from thread history. Thread/message/response endpoints require an explicit account_id. Entitlement endpoints are caller-scoped and use account_ids.
+ */
+export declare class Threads extends APIResource {
+    /**
+     * Continue an existing conversation thread.
+     *
+     * Appends a new user message to the thread and starts an assistant response. Only
+     * one response may be active per thread at a time — if the previous turn is still
+     * in progress, this endpoint returns **409 Conflict**. Wait for the active
+     * response to reach a terminal status before submitting the next turn.
+     *
+     * Poll the returned `response_id` via `GET /omni-ai/responses/{response_id}` for
+     * assistant output.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.threads.createMessage(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 19816, text: 'Compare that to AMD.' },
+     *   );
+     * ```
+     */
+    createMessage(threadID: string, body: ThreadCreateMessageParams, options?: RequestOptions): APIPromise<ThreadCreateMessageResponse>;
+    /**
+     * Create a new conversation thread.
+     *
+     * Atomically creates a new thread and submits the first user turn. The response
+     * contains a `response_id` that should be polled via
+     * `GET /omni-ai/responses/{response_id}` for assistant output.
+     *
+     * Two creation modes are supported:
+     *
+     * - **instant** — provide `text` with a natural-language prompt.
+     * - **deep_insights** — provide a `target` ticker and optional `thesis` for
+     *   long-form research.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.threads.createThread({
+     *     account_id: 19816,
+     *     type: 'instant',
+     *   });
+     * ```
+     */
+    createThread(body: ThreadCreateThreadParams, options?: RequestOptions): APIPromise<ThreadCreateThreadResponse>;
+    /**
+     * List finalized messages in a thread.
+     *
+     * Returns the latest page of **finalized** messages by default, with messages
+     * within each page ordered chronologically. Messages from in-progress assistant
+     * turns are excluded — use `GET /omni-ai/threads/{thread_id}/response` or
+     * `GET /omni-ai/responses/{response_id}` for live output.
+     *
+     * If the last finalized message has role `USER`, an active response likely exists
+     * and should be polled separately.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.omniAI.threads.getMessages(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { account_id: 0 },
+     * );
+     * ```
+     */
+    getMessages(threadID: string, query: ThreadGetMessagesParams, options?: RequestOptions): APIPromise<ThreadGetMessagesResponse>;
+    /**
+     * Get a specific thread.
+     *
+     * Returns metadata (title, timestamps) for a single thread. Does not include
+     * messages — use `GET /omni-ai/threads/{thread_id}/messages` for conversation
+     * history.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.threads.getThreadByID(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    getThreadByID(threadID: string, query: ThreadGetThreadByIDParams, options?: RequestOptions): APIPromise<ThreadGetThreadByIDResponse>;
+    /**
+     * Get the active response for a thread.
+     *
+     * Convenience endpoint to look up the currently active response for a thread
+     * without knowing the `response_id`. Useful when reloading a thread whose last
+     * finalized message is a `USER` message — this indicates an assistant turn is
+     * likely in progress.
+     *
+     * Returns **404** if no active response exists (the thread is idle).
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.omniAI.threads.getThreadResponse(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { account_id: 0 },
+     *   );
+     * ```
+     */
+    getThreadResponse(threadID: string, query: ThreadGetThreadResponseParams, options?: RequestOptions): APIPromise<ThreadGetThreadResponseResponse>;
+    /**
+     * List conversation threads.
+     *
+     * Returns thread metadata ordered by most recently created first. Use `page_size`
+     * and `page_token` for pagination. Thread objects contain only metadata (title,
+     * timestamps) — use the messages endpoint for conversation history.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.omniAI.threads.getThreads({
+     *   account_id: 0,
+     * });
+     * ```
+     */
+    getThreads(query: ThreadGetThreadsParams, options?: RequestOptions): APIPromise<ThreadGetThreadsResponse>;
+}
+/**
+ * Response payload for continuing a thread with a new message.
+ */
+export interface CreateMessageResponse {
+    response_id: string;
+    thread_id: string;
+    user_message_id: string;
+}
+/**
+ * Response payload for thread creation.
+ */
+export interface CreateThreadResponse {
+    response_id: string;
+    thread_id: string;
+    user_message_id: string;
+}
+/**
+ * Final immutable message.
+ */
+export interface Message {
+    id: string;
+    /**
+     * Finalized immutable message content container. Never includes thinking parts.
+     */
+    content: MessageContent;
+    created_at: string;
+    /**
+     * Immutable terminal outcome for a finalized assistant message.
+     */
+    outcome: MessageOutcome;
+    /**
+     * Finalized message role in the public contract.
+     */
+    role: MessageRole;
+    seq: number;
+    thread_id: string;
+    /**
+     * Shared sanitized error payload.
+     */
+    error?: ResponsesAPI.ErrorStatus | null;
+}
+/**
+ * Finalized immutable message content container. Never includes thinking parts.
+ */
+export interface MessageContent {
+    parts: Array<MessageContentPart>;
+}
+/**
+ * Final immutable content part visible on persisted messages.
+ */
+export type MessageContentPart = MessageContentPart.ContentPartText | MessageContentPart.ContentPartStructuredAction | MessageContentPart.ContentPartChart | MessageContentPart.ContentPartSuggestedActions | MessageContentPart.ContentPartCustom;
+export declare namespace MessageContentPart {
+    /**
+     * Text content part.
+     */
+    interface ContentPartText extends OmniAIAPI.ContentPartTextPayload {
+        type: 'text';
+    }
+    /**
+     * Structured action content part.
+     */
+    interface ContentPartStructuredAction extends OmniAIAPI.ContentPartStructuredActionPayload {
+        type: 'structured_action';
+    }
+    /**
+     * Chart payload content part.
+     */
+    interface ContentPartChart extends OmniAIAPI.ContentPartChartPayload {
+        type: 'chart';
+    }
+    /**
+     * Suggested actions payload content part.
+     */
+    interface ContentPartSuggestedActions extends OmniAIAPI.ContentPartSuggestedActionsPayload {
+        type: 'suggested_actions';
+    }
+    /**
+     * Escape-hatch custom payload content part.
+     */
+    interface ContentPartCustom extends OmniAIAPI.ContentPartCustomPayload {
+        type: 'custom';
+    }
+}
+export type MessageList = Array<Message>;
+/**
+ * Immutable terminal outcome for a finalized assistant message.
+ */
+export type MessageOutcome = 'completed' | 'errored' | 'canceled';
+/**
+ * Finalized message role in the public contract.
+ */
+export type MessageRole = 'USER' | 'ASSISTANT';
+/**
+ * Thread metadata returned by list/get thread endpoints.
+ */
+export interface Thread {
+    id: string;
+    created_at: string;
+    title: string;
+    updated_at: string;
+}
+export type ThreadList = Array<Thread>;
+export interface ThreadCreateMessageResponse extends Shared.BaseResponse {
+    /**
+     * Response payload for continuing a thread with a new message.
+     */
+    data: CreateMessageResponse;
+}
+export interface ThreadCreateThreadResponse extends Shared.BaseResponse {
+    /**
+     * Response payload for thread creation.
+     */
+    data: CreateThreadResponse;
+}
+export interface ThreadGetMessagesResponse extends Shared.BaseResponse {
+    data: MessageList;
+}
+export interface ThreadGetThreadByIDResponse extends Shared.BaseResponse {
+    /**
+     * Thread metadata returned by list/get thread endpoints.
+     */
+    data: Thread;
+}
+export interface ThreadGetThreadResponseResponse extends Shared.BaseResponse {
+    /**
+     * Dynamic pollable response.
+     */
+    data: ResponsesAPI.Response;
+}
+export interface ThreadGetThreadsResponse extends Shared.BaseResponse {
+    data: ThreadList;
+}
+export interface ThreadCreateMessageParams {
+    account_id: number;
+    text: string;
+    capabilities?: Array<'PREFILL_ORDER' | 'OPEN_CHART' | 'OPEN_SCREENER' | 'OPEN_ENTITLEMENT_CONSENT'>;
+}
+export interface ThreadCreateThreadParams {
+    account_id: number;
+    /**
+     * Thread creation mode.
+     */
+    type: 'instant' | 'deep_insights';
+    capabilities?: Array<'PREFILL_ORDER' | 'OPEN_CHART' | 'OPEN_SCREENER' | 'OPEN_ENTITLEMENT_CONSENT'>;
+    /**
+     * Deep-insights target payload.
+     */
+    target?: ThreadCreateThreadParams.Target | null;
+    text?: string | null;
+    thesis?: string | null;
+}
+export declare namespace ThreadCreateThreadParams {
+    /**
+     * Deep-insights target payload.
+     */
+    interface Target {
+        ticker: string;
+        /**
+         * Deep-insights target type. Launch supports ticker-only.
+         */
+        type: 'ticker';
+    }
+}
+export interface ThreadGetMessagesParams {
+    /**
+     * Account ID for the request
+     */
+    account_id: number;
+    /**
+     * The number of items to return per page. Only used when page_token is not
+     * provided.
+     */
+    page_size?: number;
+    /**
+     * Token for retrieving the next or previous page of results. Contains encoded
+     * pagination state; when provided, page_size is ignored.
+     */
+    page_token?: string;
+}
+export interface ThreadGetThreadByIDParams {
+    /**
+     * Account ID for the request
+     */
+    account_id: number;
+}
+export interface ThreadGetThreadResponseParams {
+    /**
+     * Account ID for the request
+     */
+    account_id: number;
+}
+export interface ThreadGetThreadsParams {
+    /**
+     * Account ID for the request
+     */
+    account_id: number;
+    /**
+     * The number of items to return per page. Only used when page_token is not
+     * provided.
+     */
+    page_size?: number;
+    /**
+     * Token for retrieving the next or previous page of results. Contains encoded
+     * pagination state; when provided, page_size is ignored.
+     */
+    page_token?: string;
+}
+export declare namespace Threads {
+    export { type CreateMessageResponse as CreateMessageResponse, type CreateThreadResponse as CreateThreadResponse, type Message as Message, type MessageContent as MessageContent, type MessageContentPart as MessageContentPart, type MessageList as MessageList, type MessageOutcome as MessageOutcome, type MessageRole as MessageRole, type Thread as Thread, type ThreadList as ThreadList, type ThreadCreateMessageResponse as ThreadCreateMessageResponse, type ThreadCreateThreadResponse as ThreadCreateThreadResponse, type ThreadGetMessagesResponse as ThreadGetMessagesResponse, type ThreadGetThreadByIDResponse as ThreadGetThreadByIDResponse, type ThreadGetThreadResponseResponse as ThreadGetThreadResponseResponse, type ThreadGetThreadsResponse as ThreadGetThreadsResponse, type ThreadCreateMessageParams as ThreadCreateMessageParams, type ThreadCreateThreadParams as ThreadCreateThreadParams, type ThreadGetMessagesParams as ThreadGetMessagesParams, type ThreadGetThreadByIDParams as ThreadGetThreadByIDParams, type ThreadGetThreadResponseParams as ThreadGetThreadResponseParams, type ThreadGetThreadsParams as ThreadGetThreadsParams, };
+}
+//# sourceMappingURL=threads.d.mts.map

package/resources/v1/omni-ai/threads.d.mts.map

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