telnyx 2.1.1 → 3.0.0-alpha

package/resources/ai/conversations/conversations.d.mts

@@ -0,0 +1,224 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as InsightsAPI from "./insights.mjs";
+import { InsightCreateParams, InsightDeleteResponse, InsightListParams, InsightListResponse, InsightTemplate, InsightTemplateDetail, InsightUpdateParams, Insights } from "./insights.mjs";
+import * as MessagesAPI from "./messages.mjs";
+import { MessageCreateParams, MessageCreateResponse, MessageListResponse, Messages } from "./messages.mjs";
+import * as InsightGroupsAPI from "./insight-groups/insight-groups.mjs";
+import { InsightGroupDeleteResponse, InsightGroupInsightGroupsParams, InsightGroupRetrieveInsightGroupsParams, InsightGroupRetrieveInsightGroupsResponse, InsightGroupUpdateParams, InsightGroups, InsightTemplateGroup, InsightTemplateGroupDetail } from "./insight-groups/insight-groups.mjs";
+import * as RunsAPI from "../assistants/tests/test-suites/runs.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Conversations extends APIResource {
+    insightGroups: InsightGroupsAPI.InsightGroups;
+    insights: InsightsAPI.Insights;
+    messages: MessagesAPI.Messages;
+    /**
+     * Create a new AI Conversation.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.create();
+     * ```
+     */
+    create(body: ConversationCreateParams, options?: RequestOptions): APIPromise<Conversation>;
+    /**
+     * Retrieve a specific AI conversation by its ID.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.retrieve(
+     *   'conversation_id',
+     * );
+     * ```
+     */
+    retrieve(conversationID: string, options?: RequestOptions): APIPromise<ConversationRetrieveResponse>;
+    /**
+     * Update metadata for a specific conversation.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.update(
+     *   'conversation_id',
+     * );
+     * ```
+     */
+    update(conversationID: string, body: ConversationUpdateParams, options?: RequestOptions): APIPromise<ConversationUpdateResponse>;
+    /**
+     * Retrieve a list of all AI conversations configured by the user. Supports
+     * [PostgREST-style query parameters](https://postgrest.org/en/stable/api.html#horizontal-filtering-rows)
+     * for filtering. Examples are included for the standard metadata fields, but you
+     * can filter on any field in the metadata JSON object. For example, to filter by a
+     * custom field `metadata->custom_field`, use `metadata->custom_field=eq.value`.
+     *
+     * @example
+     * ```ts
+     * const conversations = await client.ai.conversations.list();
+     * ```
+     */
+    list(query?: ConversationListParams | null | undefined, options?: RequestOptions): APIPromise<ConversationListResponse>;
+    /**
+     * Delete a specific conversation by its ID.
+     *
+     * @example
+     * ```ts
+     * await client.ai.conversations.delete('conversation_id');
+     * ```
+     */
+    delete(conversationID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Retrieve insights for a specific conversation
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.conversations.retrieveConversationsInsights(
+     *     'conversation_id',
+     *   );
+     * ```
+     */
+    retrieveConversationsInsights(conversationID: string, options?: RequestOptions): APIPromise<ConversationRetrieveConversationsInsightsResponse>;
+}
+export interface Conversation {
+    id: string;
+    /**
+     * The datetime the conversation was created.
+     */
+    created_at: string;
+    /**
+     * The datetime of the latest message in the conversation.
+     */
+    last_message_at: string;
+    /**
+     * Metadata associated with the conversation. Telnyx provides several pieces of
+     * metadata, but customers can also add their own.
+     */
+    metadata: {
+        [key: string]: string;
+    };
+    name?: string;
+}
+export interface ConversationRetrieveResponse {
+    data?: Conversation;
+}
+export interface ConversationUpdateResponse {
+    data?: Conversation;
+}
+export interface ConversationListResponse {
+    data: Array<Conversation>;
+}
+export interface ConversationRetrieveConversationsInsightsResponse {
+    data: Array<ConversationRetrieveConversationsInsightsResponse.Data>;
+    meta: RunsAPI.Meta;
+}
+export declare namespace ConversationRetrieveConversationsInsightsResponse {
+    interface Data {
+        /**
+         * Unique identifier for the conversation insight.
+         */
+        id: string;
+        /**
+         * List of insights extracted from the conversation.
+         */
+        conversation_insights: Array<Data.ConversationInsight>;
+        /**
+         * Timestamp of when the object was created.
+         */
+        created_at: string;
+        /**
+         * Current status of the insight generation for the conversation.
+         */
+        status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    }
+    namespace Data {
+        interface ConversationInsight {
+            /**
+             * Unique identifier for the insight configuration.
+             */
+            insight_id: string;
+            /**
+             * Insight result from the conversation. If the insight has a JSON schema, this
+             * will be stringified JSON object.
+             */
+            result: string;
+        }
+    }
+}
+export interface ConversationCreateParams {
+    /**
+     * Metadata associated with the conversation.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    name?: string;
+}
+export interface ConversationUpdateParams {
+    /**
+     * Metadata associated with the conversation.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export interface ConversationListParams {
+    /**
+     * Filter by conversation ID (e.g. id=eq.123)
+     */
+    id?: string;
+    /**
+     * Filter by creation datetime (e.g., `created_at=gte.2025-01-01`)
+     */
+    created_at?: string;
+    /**
+     * Filter by last message datetime (e.g., `last_message_at=lte.2025-06-01`)
+     */
+    last_message_at?: string;
+    /**
+     * Limit the number of returned conversations (e.g., `limit=10`)
+     */
+    limit?: number;
+    /**
+     * Filter by assistant ID (e.g., `metadata->assistant_id=eq.assistant-123`)
+     */
+    'metadata->assistant_id'?: string;
+    /**
+     * Filter by call control ID (e.g., `metadata->call_control_id=eq.v3:123`)
+     */
+    'metadata->call_control_id'?: string;
+    /**
+     * Filter by the phone number, SIP URI, or other identifier for the agent (e.g.,
+     * `metadata->telnyx_agent_target=eq.+13128675309`)
+     */
+    'metadata->telnyx_agent_target'?: string;
+    /**
+     * Filter by conversation channel (e.g.,
+     * `metadata->telnyx_conversation_channel=eq.phone_call`)
+     */
+    'metadata->telnyx_conversation_channel'?: string;
+    /**
+     * Filter by the phone number, SIP URI, or other identifier for the end user (e.g.,
+     * `metadata->telnyx_end_user_target=eq.+13128675309`)
+     */
+    'metadata->telnyx_end_user_target'?: string;
+    /**
+     * Filter by conversation Name (e.g. `name=like.Voice%`)
+     */
+    name?: string;
+    /**
+     * Apply OR conditions using PostgREST syntax (e.g.,
+     * `or=(created_at.gte.2025-04-01,last_message_at.gte.2025-04-01)`)
+     */
+    or?: string;
+    /**
+     * Order the results by specific fields (e.g., `order=created_at.desc` or
+     * `order=last_message_at.asc`)
+     */
+    order?: string;
+}
+export declare namespace Conversations {
+    export { type Conversation as Conversation, type ConversationRetrieveResponse as ConversationRetrieveResponse, type ConversationUpdateResponse as ConversationUpdateResponse, type ConversationListResponse as ConversationListResponse, type ConversationRetrieveConversationsInsightsResponse as ConversationRetrieveConversationsInsightsResponse, type ConversationCreateParams as ConversationCreateParams, type ConversationUpdateParams as ConversationUpdateParams, type ConversationListParams as ConversationListParams, };
+    export { InsightGroups as InsightGroups, type InsightTemplateGroup as InsightTemplateGroup, type InsightTemplateGroupDetail as InsightTemplateGroupDetail, type InsightGroupDeleteResponse as InsightGroupDeleteResponse, type InsightGroupRetrieveInsightGroupsResponse as InsightGroupRetrieveInsightGroupsResponse, type InsightGroupUpdateParams as InsightGroupUpdateParams, type InsightGroupInsightGroupsParams as InsightGroupInsightGroupsParams, type InsightGroupRetrieveInsightGroupsParams as InsightGroupRetrieveInsightGroupsParams, };
+    export { Insights as Insights, type InsightTemplate as InsightTemplate, type InsightTemplateDetail as InsightTemplateDetail, type InsightListResponse as InsightListResponse, type InsightDeleteResponse as InsightDeleteResponse, type InsightCreateParams as InsightCreateParams, type InsightUpdateParams as InsightUpdateParams, type InsightListParams as InsightListParams, };
+    export { Messages as Messages, type MessageCreateResponse as MessageCreateResponse, type MessageListResponse as MessageListResponse, type MessageCreateParams as MessageCreateParams, };
+}
+//# sourceMappingURL=conversations.d.mts.map

package/resources/ai/conversations/conversations.d.mts.map

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

package/resources/ai/conversations/conversations.d.ts

@@ -0,0 +1,224 @@
+import { APIResource } from "../../../core/resource.js";
+import * as InsightsAPI from "./insights.js";
+import { InsightCreateParams, InsightDeleteResponse, InsightListParams, InsightListResponse, InsightTemplate, InsightTemplateDetail, InsightUpdateParams, Insights } from "./insights.js";
+import * as MessagesAPI from "./messages.js";
+import { MessageCreateParams, MessageCreateResponse, MessageListResponse, Messages } from "./messages.js";
+import * as InsightGroupsAPI from "./insight-groups/insight-groups.js";
+import { InsightGroupDeleteResponse, InsightGroupInsightGroupsParams, InsightGroupRetrieveInsightGroupsParams, InsightGroupRetrieveInsightGroupsResponse, InsightGroupUpdateParams, InsightGroups, InsightTemplateGroup, InsightTemplateGroupDetail } from "./insight-groups/insight-groups.js";
+import * as RunsAPI from "../assistants/tests/test-suites/runs.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Conversations extends APIResource {
+    insightGroups: InsightGroupsAPI.InsightGroups;
+    insights: InsightsAPI.Insights;
+    messages: MessagesAPI.Messages;
+    /**
+     * Create a new AI Conversation.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.create();
+     * ```
+     */
+    create(body: ConversationCreateParams, options?: RequestOptions): APIPromise<Conversation>;
+    /**
+     * Retrieve a specific AI conversation by its ID.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.retrieve(
+     *   'conversation_id',
+     * );
+     * ```
+     */
+    retrieve(conversationID: string, options?: RequestOptions): APIPromise<ConversationRetrieveResponse>;
+    /**
+     * Update metadata for a specific conversation.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.update(
+     *   'conversation_id',
+     * );
+     * ```
+     */
+    update(conversationID: string, body: ConversationUpdateParams, options?: RequestOptions): APIPromise<ConversationUpdateResponse>;
+    /**
+     * Retrieve a list of all AI conversations configured by the user. Supports
+     * [PostgREST-style query parameters](https://postgrest.org/en/stable/api.html#horizontal-filtering-rows)
+     * for filtering. Examples are included for the standard metadata fields, but you
+     * can filter on any field in the metadata JSON object. For example, to filter by a
+     * custom field `metadata->custom_field`, use `metadata->custom_field=eq.value`.
+     *
+     * @example
+     * ```ts
+     * const conversations = await client.ai.conversations.list();
+     * ```
+     */
+    list(query?: ConversationListParams | null | undefined, options?: RequestOptions): APIPromise<ConversationListResponse>;
+    /**
+     * Delete a specific conversation by its ID.
+     *
+     * @example
+     * ```ts
+     * await client.ai.conversations.delete('conversation_id');
+     * ```
+     */
+    delete(conversationID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Retrieve insights for a specific conversation
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.conversations.retrieveConversationsInsights(
+     *     'conversation_id',
+     *   );
+     * ```
+     */
+    retrieveConversationsInsights(conversationID: string, options?: RequestOptions): APIPromise<ConversationRetrieveConversationsInsightsResponse>;
+}
+export interface Conversation {
+    id: string;
+    /**
+     * The datetime the conversation was created.
+     */
+    created_at: string;
+    /**
+     * The datetime of the latest message in the conversation.
+     */
+    last_message_at: string;
+    /**
+     * Metadata associated with the conversation. Telnyx provides several pieces of
+     * metadata, but customers can also add their own.
+     */
+    metadata: {
+        [key: string]: string;
+    };
+    name?: string;
+}
+export interface ConversationRetrieveResponse {
+    data?: Conversation;
+}
+export interface ConversationUpdateResponse {
+    data?: Conversation;
+}
+export interface ConversationListResponse {
+    data: Array<Conversation>;
+}
+export interface ConversationRetrieveConversationsInsightsResponse {
+    data: Array<ConversationRetrieveConversationsInsightsResponse.Data>;
+    meta: RunsAPI.Meta;
+}
+export declare namespace ConversationRetrieveConversationsInsightsResponse {
+    interface Data {
+        /**
+         * Unique identifier for the conversation insight.
+         */
+        id: string;
+        /**
+         * List of insights extracted from the conversation.
+         */
+        conversation_insights: Array<Data.ConversationInsight>;
+        /**
+         * Timestamp of when the object was created.
+         */
+        created_at: string;
+        /**
+         * Current status of the insight generation for the conversation.
+         */
+        status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    }
+    namespace Data {
+        interface ConversationInsight {
+            /**
+             * Unique identifier for the insight configuration.
+             */
+            insight_id: string;
+            /**
+             * Insight result from the conversation. If the insight has a JSON schema, this
+             * will be stringified JSON object.
+             */
+            result: string;
+        }
+    }
+}
+export interface ConversationCreateParams {
+    /**
+     * Metadata associated with the conversation.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    name?: string;
+}
+export interface ConversationUpdateParams {
+    /**
+     * Metadata associated with the conversation.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export interface ConversationListParams {
+    /**
+     * Filter by conversation ID (e.g. id=eq.123)
+     */
+    id?: string;
+    /**
+     * Filter by creation datetime (e.g., `created_at=gte.2025-01-01`)
+     */
+    created_at?: string;
+    /**
+     * Filter by last message datetime (e.g., `last_message_at=lte.2025-06-01`)
+     */
+    last_message_at?: string;
+    /**
+     * Limit the number of returned conversations (e.g., `limit=10`)
+     */
+    limit?: number;
+    /**
+     * Filter by assistant ID (e.g., `metadata->assistant_id=eq.assistant-123`)
+     */
+    'metadata->assistant_id'?: string;
+    /**
+     * Filter by call control ID (e.g., `metadata->call_control_id=eq.v3:123`)
+     */
+    'metadata->call_control_id'?: string;
+    /**
+     * Filter by the phone number, SIP URI, or other identifier for the agent (e.g.,
+     * `metadata->telnyx_agent_target=eq.+13128675309`)
+     */
+    'metadata->telnyx_agent_target'?: string;
+    /**
+     * Filter by conversation channel (e.g.,
+     * `metadata->telnyx_conversation_channel=eq.phone_call`)
+     */
+    'metadata->telnyx_conversation_channel'?: string;
+    /**
+     * Filter by the phone number, SIP URI, or other identifier for the end user (e.g.,
+     * `metadata->telnyx_end_user_target=eq.+13128675309`)
+     */
+    'metadata->telnyx_end_user_target'?: string;
+    /**
+     * Filter by conversation Name (e.g. `name=like.Voice%`)
+     */
+    name?: string;
+    /**
+     * Apply OR conditions using PostgREST syntax (e.g.,
+     * `or=(created_at.gte.2025-04-01,last_message_at.gte.2025-04-01)`)
+     */
+    or?: string;
+    /**
+     * Order the results by specific fields (e.g., `order=created_at.desc` or
+     * `order=last_message_at.asc`)
+     */
+    order?: string;
+}
+export declare namespace Conversations {
+    export { type Conversation as Conversation, type ConversationRetrieveResponse as ConversationRetrieveResponse, type ConversationUpdateResponse as ConversationUpdateResponse, type ConversationListResponse as ConversationListResponse, type ConversationRetrieveConversationsInsightsResponse as ConversationRetrieveConversationsInsightsResponse, type ConversationCreateParams as ConversationCreateParams, type ConversationUpdateParams as ConversationUpdateParams, type ConversationListParams as ConversationListParams, };
+    export { InsightGroups as InsightGroups, type InsightTemplateGroup as InsightTemplateGroup, type InsightTemplateGroupDetail as InsightTemplateGroupDetail, type InsightGroupDeleteResponse as InsightGroupDeleteResponse, type InsightGroupRetrieveInsightGroupsResponse as InsightGroupRetrieveInsightGroupsResponse, type InsightGroupUpdateParams as InsightGroupUpdateParams, type InsightGroupInsightGroupsParams as InsightGroupInsightGroupsParams, type InsightGroupRetrieveInsightGroupsParams as InsightGroupRetrieveInsightGroupsParams, };
+    export { Insights as Insights, type InsightTemplate as InsightTemplate, type InsightTemplateDetail as InsightTemplateDetail, type InsightListResponse as InsightListResponse, type InsightDeleteResponse as InsightDeleteResponse, type InsightCreateParams as InsightCreateParams, type InsightUpdateParams as InsightUpdateParams, type InsightListParams as InsightListParams, };
+    export { Messages as Messages, type MessageCreateResponse as MessageCreateResponse, type MessageListResponse as MessageListResponse, type MessageCreateParams as MessageCreateParams, };
+}
+//# sourceMappingURL=conversations.d.ts.map

package/resources/ai/conversations/conversations.d.ts.map

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

package/resources/ai/conversations/conversations.js

@@ -0,0 +1,107 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Conversations = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const resource_1 = require("../../../core/resource.js");
+const InsightsAPI = tslib_1.__importStar(require("./insights.js"));
+const insights_1 = require("./insights.js");
+const MessagesAPI = tslib_1.__importStar(require("./messages.js"));
+const messages_1 = require("./messages.js");
+const InsightGroupsAPI = tslib_1.__importStar(require("./insight-groups/insight-groups.js"));
+const insight_groups_1 = require("./insight-groups/insight-groups.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Conversations extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.insightGroups = new InsightGroupsAPI.InsightGroups(this._client);
+        this.insights = new InsightsAPI.Insights(this._client);
+        this.messages = new MessagesAPI.Messages(this._client);
+    }
+    /**
+     * Create a new AI Conversation.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.create();
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/ai/conversations', { body, ...options });
+    }
+    /**
+     * Retrieve a specific AI conversation by its ID.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.retrieve(
+     *   'conversation_id',
+     * );
+     * ```
+     */
+    retrieve(conversationID, options) {
+        return this._client.get((0, path_1.path) `/ai/conversations/${conversationID}`, options);
+    }
+    /**
+     * Update metadata for a specific conversation.
+     *
+     * @example
+     * ```ts
+     * const conversation = await client.ai.conversations.update(
+     *   'conversation_id',
+     * );
+     * ```
+     */
+    update(conversationID, body, options) {
+        return this._client.put((0, path_1.path) `/ai/conversations/${conversationID}`, { body, ...options });
+    }
+    /**
+     * Retrieve a list of all AI conversations configured by the user. Supports
+     * [PostgREST-style query parameters](https://postgrest.org/en/stable/api.html#horizontal-filtering-rows)
+     * for filtering. Examples are included for the standard metadata fields, but you
+     * can filter on any field in the metadata JSON object. For example, to filter by a
+     * custom field `metadata->custom_field`, use `metadata->custom_field=eq.value`.
+     *
+     * @example
+     * ```ts
+     * const conversations = await client.ai.conversations.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/ai/conversations', { query, ...options });
+    }
+    /**
+     * Delete a specific conversation by its ID.
+     *
+     * @example
+     * ```ts
+     * await client.ai.conversations.delete('conversation_id');
+     * ```
+     */
+    delete(conversationID, options) {
+        return this._client.delete((0, path_1.path) `/ai/conversations/${conversationID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Retrieve insights for a specific conversation
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.conversations.retrieveConversationsInsights(
+     *     'conversation_id',
+     *   );
+     * ```
+     */
+    retrieveConversationsInsights(conversationID, options) {
+        return this._client.get((0, path_1.path) `/ai/conversations/${conversationID}/conversations-insights`, options);
+    }
+}
+exports.Conversations = Conversations;
+Conversations.InsightGroups = insight_groups_1.InsightGroups;
+Conversations.Insights = insights_1.Insights;
+Conversations.Messages = messages_1.Messages;
+//# sourceMappingURL=conversations.js.map

package/resources/ai/conversations/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../../src/resources/ai/conversations/conversations.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,mEAA0C;AAC1C,4CASoB;AACpB,mEAA0C;AAC1C,4CAAuG;AACvG,6FAAoE;AACpE,uEASyC;AAGzC,0DAAyD;AAEzD,0DAAoD;AAEpD,MAAa,aAAc,SAAQ,sBAAW;IAA9C;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAiG1E,CAAC;IA/FC;;;;;;;OAOG;IACH,MAAM,CAAC,IAA8B,EAAE,OAAwB;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,cAAsB,EACtB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,cAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,EAAE,EAAE;YACpE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,6BAA6B,CAC3B,cAAsB,EACtB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,yBAAyB,EAAE,OAAO,CAAC,CAAC;IACrG,CAAC;CACF;AApGD,sCAoGC;AAoKD,aAAa,CAAC,aAAa,GAAG,8BAAa,CAAC;AAC5C,aAAa,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAClC,aAAa,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}