@clear-street/clearstreet 0.0.0 → 0.73.0

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

@@ -0,0 +1,338 @@
+import { APIResource } from "../../../core/resource.js";
+import * as Shared from "../../shared.js";
+import * as OmniAIAPI from "./omni-ai.js";
+import * as ResponsesAPI from "./responses.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 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.ts.map

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

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

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

@@ -0,0 +1,141 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Threads = 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 Threads extends resource_1.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, body, options) {
+        return this._client.post((0, path_1.path) `/v1/omni-ai/threads/${threadID}/messages`, { body, ...options });
+    }
+    /**
+     * 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, options) {
+        return this._client.post('/v1/omni-ai/threads', { body, ...options });
+    }
+    /**
+     * 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, query, options) {
+        return this._client.get((0, path_1.path) `/v1/omni-ai/threads/${threadID}/messages`, { query, ...options });
+    }
+    /**
+     * 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, query, options) {
+        return this._client.get((0, path_1.path) `/v1/omni-ai/threads/${threadID}`, { query, ...options });
+    }
+    /**
+     * 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, query, options) {
+        return this._client.get((0, path_1.path) `/v1/omni-ai/threads/${threadID}/response`, { query, ...options });
+    }
+    /**
+     * 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, options) {
+        return this._client.get('/v1/omni-ai/threads', { query, ...options });
+    }
+}
+exports.Threads = Threads;
+//# sourceMappingURL=threads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../../src/resources/v1/omni-ai/threads.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAMrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,CACX,QAAgB,EAChB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,uBAAuB,QAAQ,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CACV,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CACT,QAAgB,EAChB,KAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,uBAAuB,QAAQ,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CACX,QAAgB,EAChB,KAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,uBAAuB,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CACf,QAAgB,EAChB,KAAoC,EACpC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,uBAAuB,QAAQ,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,KAA6B,EAAE,OAAwB;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;CACF;AAzJD,0BAyJC"}

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

@@ -0,0 +1,137 @@
+// 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 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, body, options) {
+        return this._client.post(path `/v1/omni-ai/threads/${threadID}/messages`, { body, ...options });
+    }
+    /**
+     * 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, options) {
+        return this._client.post('/v1/omni-ai/threads', { body, ...options });
+    }
+    /**
+     * 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, query, options) {
+        return this._client.get(path `/v1/omni-ai/threads/${threadID}/messages`, { query, ...options });
+    }
+    /**
+     * 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, query, options) {
+        return this._client.get(path `/v1/omni-ai/threads/${threadID}`, { query, ...options });
+    }
+    /**
+     * 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, query, options) {
+        return this._client.get(path `/v1/omni-ai/threads/${threadID}/response`, { query, ...options });
+    }
+    /**
+     * 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, options) {
+        return this._client.get('/v1/omni-ai/threads', { query, ...options });
+    }
+}
+//# sourceMappingURL=threads.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.mjs","sourceRoot":"","sources":["../../../src/resources/v1/omni-ai/threads.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAMrD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,CACX,QAAgB,EAChB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,uBAAuB,QAAQ,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CACV,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CACT,QAAgB,EAChB,KAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,QAAQ,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CACX,QAAgB,EAChB,KAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CACf,QAAgB,EAChB,KAAoC,EACpC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,QAAQ,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,KAA6B,EAAE,OAAwB;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;CACF"}

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

@@ -0,0 +1,2 @@
+export * from "./omni-ai/index.mjs";
+//# sourceMappingURL=omni-ai.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omni-ai.d.mts","sourceRoot":"","sources":["../../src/resources/v1/omni-ai.ts"],"names":[],"mappings":"AAEA,oCAAgC"}

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

@@ -0,0 +1,2 @@
+export * from "./omni-ai/index.js";
+//# sourceMappingURL=omni-ai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omni-ai.d.ts","sourceRoot":"","sources":["../../src/resources/v1/omni-ai.ts"],"names":[],"mappings":"AAEA,mCAAgC"}

package/resources/v1/omni-ai.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../../internal/tslib.js");
+tslib_1.__exportStar(require("./omni-ai/index.js"), exports);
+//# sourceMappingURL=omni-ai.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omni-ai.js","sourceRoot":"","sources":["../../src/resources/v1/omni-ai.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6DAAgC"}

package/resources/v1/omni-ai.mjs

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"omni-ai.mjs","sourceRoot":"","sources":["../../src/resources/v1/omni-ai.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,oCAAgC"}