llama-stack-client 0.4.3 → 0.4.5

package/dist/resources/vector-io.d.ts

@@ -0,0 +1,375 @@
+import { APIResource } from "../resource.js";
+import * as Core from "../core.js";
+export declare class VectorIo extends APIResource {
+    /**
+     * Insert embedded chunks into a vector database.
+     */
+    insert(body: VectorIoInsertParams, options?: Core.RequestOptions): Core.APIPromise<void>;
+    /**
+     * Query chunks from a vector database.
+     */
+    query(body: VectorIoQueryParams, options?: Core.RequestOptions): Core.APIPromise<QueryChunksResponse>;
+}
+/**
+ * Response from querying chunks in a vector database.
+ */
+export interface QueryChunksResponse {
+    chunks: Array<QueryChunksResponse.Chunk>;
+    scores: Array<number>;
+}
+export declare namespace QueryChunksResponse {
+    /**
+     * A chunk of content with its embedding vector for vector database operations.
+     * Inherits all fields from Chunk and adds embedding-related fields.
+     */
+    interface Chunk {
+        chunk_id: string;
+        /**
+         * `ChunkMetadata` is backend metadata for a `Chunk` that is used to store
+         * additional information about the chunk that will not be used in the context
+         * during inference, but is required for backend functionality. The `ChunkMetadata`
+         * is set during chunk creation in `MemoryToolRuntimeImpl().insert()`and is not
+         * expected to change after. Use `Chunk.metadata` for metadata that will be used in
+         * the context during inference.
+         */
+        chunk_metadata: Chunk.ChunkMetadata;
+        /**
+         * A image content item
+         */
+        content: string | Chunk.ImageContentItemOutput | Chunk.TextContentItem | Array<Chunk.ImageContentItemOutput | Chunk.TextContentItem>;
+        embedding: Array<number>;
+        embedding_dimension: number;
+        embedding_model: string;
+        metadata?: {
+            [key: string]: unknown;
+        };
+    }
+    namespace Chunk {
+        /**
+         * `ChunkMetadata` is backend metadata for a `Chunk` that is used to store
+         * additional information about the chunk that will not be used in the context
+         * during inference, but is required for backend functionality. The `ChunkMetadata`
+         * is set during chunk creation in `MemoryToolRuntimeImpl().insert()`and is not
+         * expected to change after. Use `Chunk.metadata` for metadata that will be used in
+         * the context during inference.
+         */
+        interface ChunkMetadata {
+            chunk_id?: string | null;
+            chunk_tokenizer?: string | null;
+            chunk_window?: string | null;
+            content_token_count?: number | null;
+            created_timestamp?: number | null;
+            document_id?: string | null;
+            metadata_token_count?: number | null;
+            source?: string | null;
+            updated_timestamp?: number | null;
+        }
+        /**
+         * A image content item
+         */
+        interface ImageContentItemOutput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            image: ImageContentItemOutput.Image;
+            type?: 'image';
+        }
+        namespace ImageContentItemOutput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            interface Image {
+                data?: string | null;
+                /**
+                 * A URL reference to external content.
+                 */
+                url?: Image.URL | null;
+            }
+            namespace Image {
+                /**
+                 * A URL reference to external content.
+                 */
+                interface URL {
+                    uri: string;
+                }
+            }
+        }
+        /**
+         * A text content item
+         */
+        interface TextContentItem {
+            text: string;
+            type?: 'text';
+        }
+        /**
+         * A image content item
+         */
+        interface ImageContentItemOutput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            image: ImageContentItemOutput.Image;
+            type?: 'image';
+        }
+        namespace ImageContentItemOutput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            interface Image {
+                data?: string | null;
+                /**
+                 * A URL reference to external content.
+                 */
+                url?: Image.URL | null;
+            }
+            namespace Image {
+                /**
+                 * A URL reference to external content.
+                 */
+                interface URL {
+                    uri: string;
+                }
+            }
+        }
+        /**
+         * A text content item
+         */
+        interface TextContentItem {
+            text: string;
+            type?: 'text';
+        }
+    }
+}
+export interface VectorIoInsertParams {
+    /**
+     * The list of embedded chunks to insert.
+     */
+    chunks: Array<VectorIoInsertParams.Chunk>;
+    /**
+     * The ID of the vector store to insert chunks into.
+     */
+    vector_store_id: string;
+    /**
+     * Time-to-live in seconds for the inserted chunks.
+     */
+    ttl_seconds?: number | null;
+}
+export declare namespace VectorIoInsertParams {
+    /**
+     * A chunk of content with its embedding vector for vector database operations.
+     * Inherits all fields from Chunk and adds embedding-related fields.
+     */
+    interface Chunk {
+        chunk_id: string;
+        /**
+         * `ChunkMetadata` is backend metadata for a `Chunk` that is used to store
+         * additional information about the chunk that will not be used in the context
+         * during inference, but is required for backend functionality. The `ChunkMetadata`
+         * is set during chunk creation in `MemoryToolRuntimeImpl().insert()`and is not
+         * expected to change after. Use `Chunk.metadata` for metadata that will be used in
+         * the context during inference.
+         */
+        chunk_metadata: Chunk.ChunkMetadata;
+        /**
+         * A image content item
+         */
+        content: string | Chunk.ImageContentItemInput | Chunk.TextContentItem | Array<Chunk.ImageContentItemInput | Chunk.TextContentItem>;
+        embedding: Array<number>;
+        embedding_dimension: number;
+        embedding_model: string;
+        metadata?: {
+            [key: string]: unknown;
+        };
+    }
+    namespace Chunk {
+        /**
+         * `ChunkMetadata` is backend metadata for a `Chunk` that is used to store
+         * additional information about the chunk that will not be used in the context
+         * during inference, but is required for backend functionality. The `ChunkMetadata`
+         * is set during chunk creation in `MemoryToolRuntimeImpl().insert()`and is not
+         * expected to change after. Use `Chunk.metadata` for metadata that will be used in
+         * the context during inference.
+         */
+        interface ChunkMetadata {
+            chunk_id?: string | null;
+            chunk_tokenizer?: string | null;
+            chunk_window?: string | null;
+            content_token_count?: number | null;
+            created_timestamp?: number | null;
+            document_id?: string | null;
+            metadata_token_count?: number | null;
+            source?: string | null;
+            updated_timestamp?: number | null;
+        }
+        /**
+         * A image content item
+         */
+        interface ImageContentItemInput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            image: ImageContentItemInput.Image;
+            type?: 'image';
+        }
+        namespace ImageContentItemInput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            interface Image {
+                data?: string | null;
+                /**
+                 * A URL reference to external content.
+                 */
+                url?: Image.URL | null;
+            }
+            namespace Image {
+                /**
+                 * A URL reference to external content.
+                 */
+                interface URL {
+                    uri: string;
+                }
+            }
+        }
+        /**
+         * A text content item
+         */
+        interface TextContentItem {
+            text: string;
+            type?: 'text';
+        }
+        /**
+         * A image content item
+         */
+        interface ImageContentItemInput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            image: ImageContentItemInput.Image;
+            type?: 'image';
+        }
+        namespace ImageContentItemInput {
+            /**
+             * A URL or a base64 encoded string
+             */
+            interface Image {
+                data?: string | null;
+                /**
+                 * A URL reference to external content.
+                 */
+                url?: Image.URL | null;
+            }
+            namespace Image {
+                /**
+                 * A URL reference to external content.
+                 */
+                interface URL {
+                    uri: string;
+                }
+            }
+        }
+        /**
+         * A text content item
+         */
+        interface TextContentItem {
+            text: string;
+            type?: 'text';
+        }
+    }
+}
+export interface VectorIoQueryParams {
+    /**
+     * The query content to search for.
+     */
+    query: string | VectorIoQueryParams.ImageContentItemInput | VectorIoQueryParams.TextContentItem | Array<VectorIoQueryParams.ImageContentItemInput | VectorIoQueryParams.TextContentItem>;
+    /**
+     * The ID of the vector store to query.
+     */
+    vector_store_id: string;
+    /**
+     * Additional query parameters.
+     */
+    params?: {
+        [key: string]: unknown;
+    } | null;
+}
+export declare namespace VectorIoQueryParams {
+    /**
+     * A image content item
+     */
+    interface ImageContentItemInput {
+        /**
+         * A URL or a base64 encoded string
+         */
+        image: ImageContentItemInput.Image;
+        type?: 'image';
+    }
+    namespace ImageContentItemInput {
+        /**
+         * A URL or a base64 encoded string
+         */
+        interface Image {
+            data?: string | null;
+            /**
+             * A URL reference to external content.
+             */
+            url?: Image.URL | null;
+        }
+        namespace Image {
+            /**
+             * A URL reference to external content.
+             */
+            interface URL {
+                uri: string;
+            }
+        }
+    }
+    /**
+     * A text content item
+     */
+    interface TextContentItem {
+        text: string;
+        type?: 'text';
+    }
+    /**
+     * A image content item
+     */
+    interface ImageContentItemInput {
+        /**
+         * A URL or a base64 encoded string
+         */
+        image: ImageContentItemInput.Image;
+        type?: 'image';
+    }
+    namespace ImageContentItemInput {
+        /**
+         * A URL or a base64 encoded string
+         */
+        interface Image {
+            data?: string | null;
+            /**
+             * A URL reference to external content.
+             */
+            url?: Image.URL | null;
+        }
+        namespace Image {
+            /**
+             * A URL reference to external content.
+             */
+            interface URL {
+                uri: string;
+            }
+        }
+    }
+    /**
+     * A text content item
+     */
+    interface TextContentItem {
+        text: string;
+        type?: 'text';
+    }
+}
+export declare namespace VectorIo {
+    export { type QueryChunksResponse as QueryChunksResponse, type VectorIoInsertParams as VectorIoInsertParams, type VectorIoQueryParams as VectorIoQueryParams, };
+}
+//# sourceMappingURL=vector-io.d.ts.map

package/dist/resources/vector-io.d.ts.map

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

package/dist/resources/vector-io.js

@@ -0,0 +1,31 @@
+"use strict";
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorIo = void 0;
+const resource_1 = require("../resource.js");
+class VectorIo extends resource_1.APIResource {
+    /**
+     * Insert embedded chunks into a vector database.
+     */
+    insert(body, options) {
+        return this._client.post('/v1/vector-io/insert', {
+            body,
+            ...options,
+            headers: { Accept: '*/*', ...options?.headers },
+        });
+    }
+    /**
+     * Query chunks from a vector database.
+     */
+    query(body, options) {
+        return this._client.post('/v1/vector-io/query', { body, ...options });
+    }
+}
+exports.VectorIo = VectorIo;
+//# sourceMappingURL=vector-io.js.map

package/dist/resources/vector-io.mjs

@@ -0,0 +1,27 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../resource.mjs";
+export class VectorIo extends APIResource {
+    /**
+     * Insert embedded chunks into a vector database.
+     */
+    insert(body, options) {
+        return this._client.post('/v1/vector-io/insert', {
+            body,
+            ...options,
+            headers: { Accept: '*/*', ...options?.headers },
+        });
+    }
+    /**
+     * Query chunks from a vector database.
+     */
+    query(body, options) {
+        return this._client.post('/v1/vector-io/query', { body, ...options });
+    }
+}
+//# sourceMappingURL=vector-io.mjs.map

package/dist/resources/vector-stores/file-batches.d.ts

@@ -0,0 +1,117 @@
+import { APIResource } from "../../resource.js";
+import * as Core from "../../core.js";
+import * as FilesAPI from "./files.js";
+import { VectorStoreFilesOpenAICursorPage } from "./files.js";
+import { type OpenAICursorPageParams } from "../../pagination.js";
+export declare class FileBatches extends APIResource {
+    /**
+     * Create a vector store file batch (OpenAI-compatible).
+     */
+    create(vectorStoreId: string, body: FileBatchCreateParams, options?: Core.RequestOptions): Core.APIPromise<VectorStoreFileBatches>;
+    /**
+     * Retrieve a vector store file batch (OpenAI-compatible).
+     */
+    retrieve(vectorStoreId: string, batchId: string, options?: Core.RequestOptions): Core.APIPromise<VectorStoreFileBatches>;
+    /**
+     * Cancel a vector store file batch (OpenAI-compatible).
+     */
+    cancel(vectorStoreId: string, batchId: string, options?: Core.RequestOptions): Core.APIPromise<VectorStoreFileBatches>;
+    /**
+     * List files in a vector store file batch (OpenAI-compatible).
+     */
+    listFiles(vectorStoreId: string, batchId: string, query?: FileBatchListFilesParams, options?: Core.RequestOptions): Core.PagePromise<VectorStoreFilesOpenAICursorPage, FilesAPI.VectorStoreFile>;
+    listFiles(vectorStoreId: string, batchId: string, options?: Core.RequestOptions): Core.PagePromise<VectorStoreFilesOpenAICursorPage, FilesAPI.VectorStoreFile>;
+}
+/**
+ * Response from listing files in a vector store file batch.
+ */
+export interface ListVectorStoreFilesInBatchResponse {
+    data: Array<FilesAPI.VectorStoreFile>;
+    first_id?: string | null;
+    has_more?: boolean;
+    last_id?: string | null;
+    object?: string;
+}
+/**
+ * OpenAI Vector Store File Batch object.
+ */
+export interface VectorStoreFileBatches {
+    id: string;
+    created_at: number;
+    /**
+     * File processing status counts for a vector store.
+     */
+    file_counts: VectorStoreFileBatches.FileCounts;
+    status: 'completed' | 'in_progress' | 'cancelled' | 'failed';
+    vector_store_id: string;
+    object?: string;
+}
+export declare namespace VectorStoreFileBatches {
+    /**
+     * File processing status counts for a vector store.
+     */
+    interface FileCounts {
+        cancelled: number;
+        completed: number;
+        failed: number;
+        in_progress: number;
+        total: number;
+    }
+}
+export interface FileBatchCreateParams {
+    file_ids: Array<string>;
+    attributes?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Automatic chunking strategy for vector store files.
+     */
+    chunking_strategy?: FileBatchCreateParams.VectorStoreChunkingStrategyAuto | FileBatchCreateParams.VectorStoreChunkingStrategyStatic | null;
+    [k: string]: unknown;
+}
+export declare namespace FileBatchCreateParams {
+    /**
+     * Automatic chunking strategy for vector store files.
+     */
+    interface VectorStoreChunkingStrategyAuto {
+        type?: 'auto';
+    }
+    /**
+     * Static chunking strategy with configurable parameters.
+     */
+    interface VectorStoreChunkingStrategyStatic {
+        /**
+         * Configuration for static chunking strategy.
+         */
+        static: VectorStoreChunkingStrategyStatic.Static;
+        type?: 'static';
+    }
+    namespace VectorStoreChunkingStrategyStatic {
+        /**
+         * Configuration for static chunking strategy.
+         */
+        interface Static {
+            chunk_overlap_tokens?: number;
+            max_chunk_size_tokens?: number;
+        }
+    }
+}
+export interface FileBatchListFilesParams extends OpenAICursorPageParams {
+    /**
+     * Pagination cursor (before).
+     */
+    before?: string | null;
+    /**
+     * Filter by file status.
+     */
+    filter?: string | null;
+    /**
+     * Sort order by created_at: asc or desc.
+     */
+    order?: string | null;
+}
+export declare namespace FileBatches {
+    export { type ListVectorStoreFilesInBatchResponse as ListVectorStoreFilesInBatchResponse, type VectorStoreFileBatches as VectorStoreFileBatches, type FileBatchCreateParams as FileBatchCreateParams, type FileBatchListFilesParams as FileBatchListFilesParams, };
+}
+export { VectorStoreFilesOpenAICursorPage };
+//# sourceMappingURL=file-batches.d.ts.map

package/dist/resources/vector-stores/file-batches.d.ts.map

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

package/dist/resources/vector-stores/file-batches.js

@@ -0,0 +1,42 @@
+"use strict";
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorStoreFilesOpenAICursorPage = exports.FileBatches = void 0;
+const resource_1 = require("../../resource.js");
+const core_1 = require("../../core.js");
+const files_1 = require("./files.js");
+Object.defineProperty(exports, "VectorStoreFilesOpenAICursorPage", { enumerable: true, get: function () { return files_1.VectorStoreFilesOpenAICursorPage; } });
+class FileBatches extends resource_1.APIResource {
+    /**
+     * Create a vector store file batch (OpenAI-compatible).
+     */
+    create(vectorStoreId, body, options) {
+        return this._client.post(`/v1/vector_stores/${vectorStoreId}/file_batches`, { body, ...options });
+    }
+    /**
+     * Retrieve a vector store file batch (OpenAI-compatible).
+     */
+    retrieve(vectorStoreId, batchId, options) {
+        return this._client.get(`/v1/vector_stores/${vectorStoreId}/file_batches/${batchId}`, options);
+    }
+    /**
+     * Cancel a vector store file batch (OpenAI-compatible).
+     */
+    cancel(vectorStoreId, batchId, options) {
+        return this._client.post(`/v1/vector_stores/${vectorStoreId}/file_batches/${batchId}/cancel`, options);
+    }
+    listFiles(vectorStoreId, batchId, query = {}, options) {
+        if ((0, core_1.isRequestOptions)(query)) {
+            return this.listFiles(vectorStoreId, batchId, {}, query);
+        }
+        return this._client.getAPIList(`/v1/vector_stores/${vectorStoreId}/file_batches/${batchId}/files`, files_1.VectorStoreFilesOpenAICursorPage, { query, ...options });
+    }
+}
+exports.FileBatches = FileBatches;
+//# sourceMappingURL=file-batches.js.map

package/dist/resources/vector-stores/file-batches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-batches.js","sourceRoot":"","sources":["../../src/resources/vector-stores/file-batches.ts"],"names":[],"mappings":";AAAA,qDAAqD;AACrD,uBAAuB;AACvB,EAAE;AACF,gFAAgF;AAChF,0CAA0C;AAC1C,EAAE;AACF,sFAAsF;;;AAEtF,gDAA6C;AAC7C,wCAA8C;AAG9C,sCAA2D;AAkMlD,iHAlMA,wCAAgC,OAkMA;AA/LzC,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;OAEG;IACH,MAAM,CACJ,aAAqB,EACrB,IAA2B,EAC3B,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,aAAa,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,aAAqB,EACrB,OAAe,EACf,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,aAAa,iBAAiB,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACjG,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,aAAqB,EACrB,OAAe,EACf,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,aAAa,iBAAiB,OAAO,SAAS,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC;IAgBD,SAAS,CACP,aAAqB,EACrB,OAAe,EACf,QAAwD,EAAE,EAC1D,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;SAC1D;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,qBAAqB,aAAa,iBAAiB,OAAO,QAAQ,EAClE,wCAAgC,EAChC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;CACF;AA/DD,kCA+DC"}

package/dist/resources/vector-stores/file-batches.mjs

@@ -0,0 +1,38 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../resource.mjs";
+import { isRequestOptions } from "../../core.mjs";
+import { VectorStoreFilesOpenAICursorPage } from "./files.mjs";
+export class FileBatches extends APIResource {
+    /**
+     * Create a vector store file batch (OpenAI-compatible).
+     */
+    create(vectorStoreId, body, options) {
+        return this._client.post(`/v1/vector_stores/${vectorStoreId}/file_batches`, { body, ...options });
+    }
+    /**
+     * Retrieve a vector store file batch (OpenAI-compatible).
+     */
+    retrieve(vectorStoreId, batchId, options) {
+        return this._client.get(`/v1/vector_stores/${vectorStoreId}/file_batches/${batchId}`, options);
+    }
+    /**
+     * Cancel a vector store file batch (OpenAI-compatible).
+     */
+    cancel(vectorStoreId, batchId, options) {
+        return this._client.post(`/v1/vector_stores/${vectorStoreId}/file_batches/${batchId}/cancel`, options);
+    }
+    listFiles(vectorStoreId, batchId, query = {}, options) {
+        if (isRequestOptions(query)) {
+            return this.listFiles(vectorStoreId, batchId, {}, query);
+        }
+        return this._client.getAPIList(`/v1/vector_stores/${vectorStoreId}/file_batches/${batchId}/files`, VectorStoreFilesOpenAICursorPage, { query, ...options });
+    }
+}
+export { VectorStoreFilesOpenAICursorPage };
+//# sourceMappingURL=file-batches.mjs.map

package/dist/resources/vector-stores/file-batches.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-batches.mjs","sourceRoot":"","sources":["../../src/resources/vector-stores/file-batches.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,uBAAuB;AACvB,EAAE;AACF,gFAAgF;AAChF,0CAA0C;AAC1C,EAAE;AACF,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAGpB,EAAE,gCAAgC,EAAE;AAG3C,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,MAAM,CACJ,aAAqB,EACrB,IAA2B,EAC3B,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,aAAa,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,aAAqB,EACrB,OAAe,EACf,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,aAAa,iBAAiB,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACjG,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,aAAqB,EACrB,OAAe,EACf,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,aAAa,iBAAiB,OAAO,SAAS,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC;IAgBD,SAAS,CACP,aAAqB,EACrB,OAAe,EACf,QAAwD,EAAE,EAC1D,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;SAC1D;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,qBAAqB,aAAa,iBAAiB,OAAO,QAAQ,EAClE,gCAAgC,EAChC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;CACF;AAgID,OAAO,EAAE,gCAAgC,EAAE,CAAC"}