@mastra/lance 0.2.3 → 0.2.4

package/dist/_tsup-dts-rollup.d.cts

@@ -1,681 +0,0 @@
-import { ArrayOperator } from '@mastra/core/vector/filter';
-import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-import { BasicOperator } from '@mastra/core/vector/filter';
-import type { BlacklistedRootOperators } from '@mastra/core/vector/filter';
-import type { Connection } from '@lancedb/lancedb';
-import type { ConnectionOptions } from '@lancedb/lancedb';
-import type { CreateIndexParams } from '@mastra/core';
-import type { CreateTableOptions } from '@lancedb/lancedb';
-import type { DeleteIndexParams } from '@mastra/core';
-import type { DeleteVectorParams } from '@mastra/core';
-import type { DescribeIndexParams } from '@mastra/core';
-import type { EvalRow } from '@mastra/core/storage';
-import type { IndexStats } from '@mastra/core';
-import { LegacyEvalsStorage } from '@mastra/core/storage';
-import { LogicalOperator } from '@mastra/core/vector/filter';
-import type { LogicalOperatorValueMap } from '@mastra/core/vector/filter';
-import type { MastraMessageContentV2 } from '@mastra/core/agent';
-import type { MastraMessageV1 } from '@mastra/core/memory';
-import type { MastraMessageV2 } from '@mastra/core/memory';
-import { MastraStorage } from '@mastra/core/storage';
-import { MastraVector } from '@mastra/core/vector';
-import { MemoryStorage } from '@mastra/core/storage';
-import { NumericOperator } from '@mastra/core/vector/filter';
-import type { OperatorValueMap } from '@mastra/core/vector/filter';
-import type { PaginationInfo } from '@mastra/core/storage';
-import type { QueryResult } from '@mastra/core';
-import type { QueryVectorParams } from '@mastra/core';
-import { RegexOperator } from '@mastra/core/vector/filter';
-import type { SchemaLike } from '@lancedb/lancedb';
-import type { ScoreRowData } from '@mastra/core/scores';
-import { ScoresStorage } from '@mastra/core/storage';
-import type { StorageColumn } from '@mastra/core/storage';
-import type { StorageDomains } from '@mastra/core/storage';
-import type { StorageGetMessagesArg } from '@mastra/core/storage';
-import type { StorageGetTracesPaginatedArg } from '@mastra/core/storage';
-import type { StoragePagination } from '@mastra/core/storage';
-import type { StorageResourceType } from '@mastra/core/storage';
-import type { StorageThreadType } from '@mastra/core/memory';
-import { StoreOperations } from '@mastra/core/storage';
-import type { Table } from '@lancedb/lancedb';
-import type { TABLE_NAMES } from '@mastra/core/storage';
-import type { TableLike } from '@lancedb/lancedb';
-import type { Trace } from '@mastra/core/telemetry';
-import { TracesStorage } from '@mastra/core/storage';
-import type { TraceType } from '@mastra/core/memory';
-import type { UpdateVectorParams } from '@mastra/core';
-import type { UpsertVectorParams } from '@mastra/core';
-import type { VectorFilter } from '@mastra/core/vector/filter';
-import type { WorkflowRuns } from '@mastra/core/storage';
-import type { WorkflowRuns as WorkflowRuns_2 } from '@mastra/core';
-import type { WorkflowRunState } from '@mastra/core/workflows';
-import type { WorkflowRunState as WorkflowRunState_2 } from '@mastra/core';
-import { WorkflowsStorage } from '@mastra/core/storage';
-
-export declare function getPrimaryKeys(tableName: TABLE_NAMES): string[];
-
-export declare function getTableSchema({ tableName, client, }: {
-    tableName: TABLE_NAMES;
-    client: Connection;
-}): Promise<SchemaLike>;
-
-declare interface HNSWConfig {
-    m?: number;
-    efConstruction?: number;
-}
-
-export declare interface IndexConfig {
-    type?: IndexType;
-    ivf?: IVFConfig;
-    hnsw?: HNSWConfig;
-}
-
-export declare type IndexType = 'ivfflat' | 'hnsw';
-
-declare interface IVFConfig {
-    lists?: number;
-}
-
-declare type LanceBlacklisted = BlacklistedRootOperators | '$like' | '$notLike' | '$contains';
-
-declare interface LanceCreateIndexParams extends CreateIndexParams {
-    indexConfig?: LanceIndexConfig;
-    tableName?: string;
-}
-
-export declare class LanceFilterTranslator extends BaseFilterTranslator<LanceVectorFilter, string> {
-    translate(filter: LanceVectorFilter): string;
-    private processFilter;
-    private processLogicalOperator;
-    private processNestedObject;
-    private processField;
-    private processOperators;
-    private formatValue;
-    private formatArrayValues;
-    normalizeArrayValues(array: unknown[]): unknown[];
-    normalizeComparisonValue(value: unknown): unknown;
-    private isOperatorObject;
-    private isNestedObject;
-    private isNormalNestedField;
-    private escapeFieldName;
-    private isSqlKeyword;
-    private isDateObject;
-    /**
-     * Override getSupportedOperators to add custom operators for LanceDB
-     */
-    protected getSupportedOperators(): {
-        custom: string[];
-        logical: LogicalOperator[];
-        basic: BasicOperator[];
-        numeric: NumericOperator[];
-        array: ArrayOperator[];
-        element: "$exists"[];
-        regex: RegexOperator[];
-    };
-}
-
-declare interface LanceIndexConfig extends IndexConfig {
-    numPartitions?: number;
-    numSubVectors?: number;
-}
-
-declare type LanceOperatorValueMap = OperatorValueMap & {
-    $like: string;
-    $notLike: string;
-    $contains: string;
-};
-
-declare interface LanceQueryVectorParams extends QueryVectorParams<LanceVectorFilter> {
-    tableName: string;
-    columns?: string[];
-    includeAllColumns?: boolean;
-}
-
-declare class LanceStorage extends MastraStorage {
-    stores: StorageDomains;
-    private lanceClient;
-    /**
-     * Creates a new instance of LanceStorage
-     * @param uri The URI to connect to LanceDB
-     * @param options connection options
-     *
-     * Usage:
-     *
-     * Connect to a local database
-     * ```ts
-     * const store = await LanceStorage.create('/path/to/db');
-     * ```
-     *
-     * Connect to a LanceDB cloud database
-     * ```ts
-     * const store = await LanceStorage.create('db://host:port');
-     * ```
-     *
-     * Connect to a cloud database
-     * ```ts
-     * const store = await LanceStorage.create('s3://bucket/db', { storageOptions: { timeout: '60s' } });
-     * ```
-     */
-    static create(name: string, uri: string, options?: ConnectionOptions): Promise<LanceStorage>;
-    /**
-     * @internal
-     * Private constructor to enforce using the create factory method
-     */
-    private constructor();
-    createTable({ tableName, schema, }: {
-        tableName: TABLE_NAMES;
-        schema: Record<string, StorageColumn>;
-    }): Promise<void>;
-    dropTable({ tableName }: {
-        tableName: TABLE_NAMES;
-    }): Promise<void>;
-    alterTable({ tableName, schema, ifNotExists, }: {
-        tableName: TABLE_NAMES;
-        schema: Record<string, StorageColumn>;
-        ifNotExists: string[];
-    }): Promise<void>;
-    clearTable({ tableName }: {
-        tableName: TABLE_NAMES;
-    }): Promise<void>;
-    insert({ tableName, record }: {
-        tableName: TABLE_NAMES;
-        record: Record<string, any>;
-    }): Promise<void>;
-    batchInsert({ tableName, records }: {
-        tableName: TABLE_NAMES;
-        records: Record<string, any>[];
-    }): Promise<void>;
-    load({ tableName, keys }: {
-        tableName: TABLE_NAMES;
-        keys: Record<string, any>;
-    }): Promise<any>;
-    getThreadById({ threadId }: {
-        threadId: string;
-    }): Promise<StorageThreadType | null>;
-    getThreadsByResourceId({ resourceId }: {
-        resourceId: string;
-    }): Promise<StorageThreadType[]>;
-    /**
-     * Saves a thread to the database. This function doesn't overwrite existing threads.
-     * @param thread - The thread to save
-     * @returns The saved thread
-     */
-    saveThread({ thread }: {
-        thread: StorageThreadType;
-    }): Promise<StorageThreadType>;
-    updateThread({ id, title, metadata, }: {
-        id: string;
-        title: string;
-        metadata: Record<string, unknown>;
-    }): Promise<StorageThreadType>;
-    deleteThread({ threadId }: {
-        threadId: string;
-    }): Promise<void>;
-    get supports(): {
-        selectByIncludeResourceScope: boolean;
-        resourceWorkingMemory: boolean;
-        hasColumn: boolean;
-        createTable: boolean;
-        deleteMessages: boolean;
-    };
-    getResourceById({ resourceId }: {
-        resourceId: string;
-    }): Promise<StorageResourceType | null>;
-    saveResource({ resource }: {
-        resource: StorageResourceType;
-    }): Promise<StorageResourceType>;
-    updateResource({ resourceId, workingMemory, metadata, }: {
-        resourceId: string;
-        workingMemory?: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<StorageResourceType>;
-    /**
-     * Processes messages to include context messages based on withPreviousMessages and withNextMessages
-     * @param records - The sorted array of records to process
-     * @param include - The array of include specifications with context parameters
-     * @returns The processed array with context messages included
-     */
-    private processMessagesWithContext;
-    getMessages(args: StorageGetMessagesArg & {
-        format?: 'v1';
-    }): Promise<MastraMessageV1[]>;
-    getMessages(args: StorageGetMessagesArg & {
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    saveMessages(args: {
-        messages: MastraMessageV1[];
-        format?: undefined | 'v1';
-    }): Promise<MastraMessageV1[]>;
-    saveMessages(args: {
-        messages: MastraMessageV2[];
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    getThreadsByResourceIdPaginated(args: {
-        resourceId: string;
-        page: number;
-        perPage: number;
-    }): Promise<PaginationInfo & {
-        threads: StorageThreadType[];
-    }>;
-    getMessagesPaginated(args: StorageGetMessagesArg & {
-        format?: 'v1' | 'v2';
-    }): Promise<PaginationInfo & {
-        messages: MastraMessageV1[] | MastraMessageV2[];
-    }>;
-    updateMessages(_args: {
-        messages: Partial<Omit<MastraMessageV2, 'createdAt'>> & {
-            id: string;
-            content?: {
-                metadata?: MastraMessageContentV2['metadata'];
-                content?: MastraMessageContentV2['content'];
-            };
-        }[];
-    }): Promise<MastraMessageV2[]>;
-    getTraceById(args: {
-        traceId: string;
-    }): Promise<TraceType>;
-    getTraces(args: {
-        name?: string;
-        scope?: string;
-        page: number;
-        perPage: number;
-        attributes?: Record<string, string>;
-    }): Promise<Trace[]>;
-    getTracesPaginated(args: StorageGetTracesPaginatedArg): Promise<PaginationInfo & {
-        traces: Trace[];
-    }>;
-    getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
-    getEvals(options: {
-        agentName?: string;
-        type?: 'test' | 'live';
-        page?: number;
-        perPage?: number;
-        fromDate?: Date;
-        toDate?: Date;
-        dateRange?: {
-            start?: Date;
-            end?: Date;
-        };
-    }): Promise<PaginationInfo & {
-        evals: EvalRow[];
-    }>;
-    getWorkflowRuns(args?: {
-        namespace?: string;
-        workflowName?: string;
-        fromDate?: Date;
-        toDate?: Date;
-        limit?: number;
-        offset?: number;
-    }): Promise<WorkflowRuns>;
-    getWorkflowRunById(args: {
-        runId: string;
-        workflowName?: string;
-    }): Promise<{
-        workflowName: string;
-        runId: string;
-        snapshot: any;
-        createdAt: Date;
-        updatedAt: Date;
-    } | null>;
-    persistWorkflowSnapshot({ workflowName, runId, snapshot, }: {
-        workflowName: string;
-        runId: string;
-        snapshot: WorkflowRunState;
-    }): Promise<void>;
-    loadWorkflowSnapshot({ workflowName, runId, }: {
-        workflowName: string;
-        runId: string;
-    }): Promise<WorkflowRunState | null>;
-    getScoreById({ id: _id }: {
-        id: string;
-    }): Promise<ScoreRowData | null>;
-    getScoresByScorerId({ scorerId, pagination, }: {
-        scorerId: string;
-        pagination: StoragePagination;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-    saveScore(_score: ScoreRowData): Promise<{
-        score: ScoreRowData;
-    }>;
-    getScoresByRunId({ runId, pagination, }: {
-        runId: string;
-        pagination: StoragePagination;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-    getScoresByEntityId({ entityId, entityType, pagination, }: {
-        pagination: StoragePagination;
-        entityId: string;
-        entityType: string;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-}
-export { LanceStorage }
-export { LanceStorage as LanceStorage_alias_1 }
-
-declare interface LanceUpsertVectorParams extends UpsertVectorParams {
-    tableName: string;
-}
-
-export declare type LanceVectorFilter = VectorFilter<keyof LanceOperatorValueMap, LanceOperatorValueMap, LogicalOperatorValueMap, LanceBlacklisted>;
-
-declare class LanceVectorStore extends MastraVector<LanceVectorFilter> {
-    private lanceClient;
-    /**
-     * Creates a new instance of LanceVectorStore
-     * @param uri The URI to connect to LanceDB
-     * @param options connection options
-     *
-     * Usage:
-     *
-     * Connect to a local database
-     * ```ts
-     * const store = await LanceVectorStore.create('/path/to/db');
-     * ```
-     *
-     * Connect to a LanceDB cloud database
-     * ```ts
-     * const store = await LanceVectorStore.create('db://host:port');
-     * ```
-     *
-     * Connect to a cloud database
-     * ```ts
-     * const store = await LanceVectorStore.create('s3://bucket/db', { storageOptions: { timeout: '60s' } });
-     * ```
-     */
-    static create(uri: string, options?: ConnectionOptions): Promise<LanceVectorStore>;
-    /**
-     * @internal
-     * Private constructor to enforce using the create factory method
-     */
-    private constructor();
-    close(): void;
-    query({ tableName, queryVector, filter, includeVector, topK, columns, includeAllColumns, }: LanceQueryVectorParams): Promise<QueryResult[]>;
-    private filterTranslator;
-    upsert({ tableName, vectors, metadata, ids }: LanceUpsertVectorParams): Promise<string[]>;
-    /**
-     * Flattens a nested object, creating new keys with underscores for nested properties.
-     * Example: { metadata: { text: 'test' } } → { metadata_text: 'test' }
-     */
-    private flattenObject;
-    createTable(tableName: string, data: Record<string, unknown>[] | TableLike, options?: Partial<CreateTableOptions>): Promise<Table>;
-    listTables(): Promise<string[]>;
-    getTableSchema(tableName: string): Promise<any>;
-    /**
-     * indexName is actually a column name in a table in lanceDB
-     */
-    createIndex({ tableName, indexName, dimension, metric, indexConfig, }: LanceCreateIndexParams): Promise<void>;
-    listIndexes(): Promise<string[]>;
-    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
-    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
-    /**
-     * Deletes all tables in the database
-     */
-    deleteAllTables(): Promise<void>;
-    deleteTable(tableName: string): Promise<void>;
-    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
-    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
-    /**
-     * Converts a flattened object with keys using underscore notation back to a nested object.
-     * Example: { name: 'test', details_text: 'test' } → { name: 'test', details: { text: 'test' } }
-     */
-    private unflattenObject;
-}
-export { LanceVectorStore }
-export { LanceVectorStore as LanceVectorStore_alias_1 }
-
-export declare function processResultWithTypeConversion(rawResult: Record<string, any> | Record<string, any>[], tableSchema: SchemaLike): Record<string, any> | Record<string, any>[];
-
-export declare class StoreLegacyEvalsLance extends LegacyEvalsStorage {
-    private client;
-    constructor({ client }: {
-        client: Connection;
-    });
-    getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
-    getEvals(options: {
-        agentName?: string;
-        type?: 'test' | 'live';
-        page?: number;
-        perPage?: number;
-        fromDate?: Date;
-        toDate?: Date;
-        dateRange?: {
-            start?: Date;
-            end?: Date;
-        };
-    }): Promise<PaginationInfo & {
-        evals: EvalRow[];
-    }>;
-}
-
-export declare class StoreMemoryLance extends MemoryStorage {
-    private client;
-    private operations;
-    constructor({ client, operations }: {
-        client: Connection;
-        operations: StoreOperationsLance;
-    });
-    getThreadById({ threadId }: {
-        threadId: string;
-    }): Promise<StorageThreadType | null>;
-    getThreadsByResourceId({ resourceId }: {
-        resourceId: string;
-    }): Promise<StorageThreadType[]>;
-    /**
-     * Saves a thread to the database. This function doesn't overwrite existing threads.
-     * @param thread - The thread to save
-     * @returns The saved thread
-     */
-    saveThread({ thread }: {
-        thread: StorageThreadType;
-    }): Promise<StorageThreadType>;
-    updateThread({ id, title, metadata, }: {
-        id: string;
-        title: string;
-        metadata: Record<string, unknown>;
-    }): Promise<StorageThreadType>;
-    deleteThread({ threadId }: {
-        threadId: string;
-    }): Promise<void>;
-    getMessages(args: StorageGetMessagesArg & {
-        format?: 'v1';
-    }): Promise<MastraMessageV1[]>;
-    getMessages(args: StorageGetMessagesArg & {
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    saveMessages(args: {
-        messages: MastraMessageV1[];
-        format?: undefined | 'v1';
-    }): Promise<MastraMessageV1[]>;
-    saveMessages(args: {
-        messages: MastraMessageV2[];
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    getThreadsByResourceIdPaginated(args: {
-        resourceId: string;
-        page?: number;
-        perPage?: number;
-    }): Promise<PaginationInfo & {
-        threads: StorageThreadType[];
-    }>;
-    /**
-     * Processes messages to include context messages based on withPreviousMessages and withNextMessages
-     * @param records - The sorted array of records to process
-     * @param include - The array of include specifications with context parameters
-     * @returns The processed array with context messages included
-     */
-    private processMessagesWithContext;
-    getMessagesPaginated(args: StorageGetMessagesArg & {
-        format?: 'v1' | 'v2';
-    }): Promise<PaginationInfo & {
-        messages: MastraMessageV1[] | MastraMessageV2[];
-    }>;
-    /**
-     * Parse message data from LanceDB record format to MastraMessageV2 format
-     */
-    private parseMessageData;
-    updateMessages(args: {
-        messages: Partial<Omit<MastraMessageV2, 'createdAt'>> & {
-            id: string;
-            content?: {
-                metadata?: MastraMessageContentV2['metadata'];
-                content?: MastraMessageContentV2['content'];
-            };
-        }[];
-    }): Promise<MastraMessageV2[]>;
-    getResourceById({ resourceId }: {
-        resourceId: string;
-    }): Promise<StorageResourceType | null>;
-    saveResource({ resource }: {
-        resource: StorageResourceType;
-    }): Promise<StorageResourceType>;
-    updateResource({ resourceId, workingMemory, metadata, }: {
-        resourceId: string;
-        workingMemory?: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<StorageResourceType>;
-}
-
-export declare class StoreOperationsLance extends StoreOperations {
-    client: Connection;
-    constructor({ client }: {
-        client: Connection;
-    });
-    protected getDefaultValue(type: StorageColumn['type']): string;
-    hasColumn(tableName: TABLE_NAMES, columnName: string): Promise<boolean>;
-    private translateSchema;
-    createTable({ tableName, schema, }: {
-        tableName: TABLE_NAMES;
-        schema: Record<string, StorageColumn>;
-    }): Promise<void>;
-    dropTable({ tableName }: {
-        tableName: TABLE_NAMES;
-    }): Promise<void>;
-    alterTable({ tableName, schema, ifNotExists, }: {
-        tableName: string;
-        schema: Record<string, StorageColumn>;
-        ifNotExists: string[];
-    }): Promise<void>;
-    clearTable({ tableName }: {
-        tableName: TABLE_NAMES;
-    }): Promise<void>;
-    insert({ tableName, record }: {
-        tableName: string;
-        record: Record<string, any>;
-    }): Promise<void>;
-    batchInsert({ tableName, records }: {
-        tableName: string;
-        records: Record<string, any>[];
-    }): Promise<void>;
-    load({ tableName, keys }: {
-        tableName: TABLE_NAMES;
-        keys: Record<string, any>;
-    }): Promise<any>;
-}
-
-export declare class StoreScoresLance extends ScoresStorage {
-    private client;
-    constructor({ client }: {
-        client: Connection;
-    });
-    saveScore(score: ScoreRowData): Promise<{
-        score: ScoreRowData;
-    }>;
-    getScoreById({ id }: {
-        id: string;
-    }): Promise<ScoreRowData | null>;
-    getScoresByScorerId({ scorerId, pagination, }: {
-        scorerId: string;
-        pagination: StoragePagination;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-    getScoresByRunId({ runId, pagination, }: {
-        runId: string;
-        pagination: StoragePagination;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-    getScoresByEntityId({ entityId, entityType, pagination, }: {
-        pagination: StoragePagination;
-        entityId: string;
-        entityType: string;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-}
-
-export declare class StoreTracesLance extends TracesStorage {
-    private client;
-    private operations;
-    constructor({ client, operations }: {
-        client: Connection;
-        operations: StoreOperationsLance;
-    });
-    saveTrace({ trace }: {
-        trace: TraceType;
-    }): Promise<TraceType>;
-    getTraceById({ traceId }: {
-        traceId: string;
-    }): Promise<TraceType>;
-    getTraces({ name, scope, page, perPage, attributes, }: {
-        name?: string;
-        scope?: string;
-        page: number;
-        perPage: number;
-        attributes?: Record<string, string>;
-    }): Promise<Trace[]>;
-    getTracesPaginated(args: StorageGetTracesPaginatedArg): Promise<PaginationInfo & {
-        traces: Trace[];
-    }>;
-    batchTraceInsert({ records }: {
-        records: Record<string, any>[];
-    }): Promise<void>;
-}
-
-export declare class StoreWorkflowsLance extends WorkflowsStorage {
-    client: Connection;
-    constructor({ client }: {
-        client: Connection;
-    });
-    persistWorkflowSnapshot({ workflowName, runId, snapshot, }: {
-        workflowName: string;
-        runId: string;
-        snapshot: WorkflowRunState_2;
-    }): Promise<void>;
-    loadWorkflowSnapshot({ workflowName, runId, }: {
-        workflowName: string;
-        runId: string;
-    }): Promise<WorkflowRunState_2 | null>;
-    getWorkflowRunById(args: {
-        runId: string;
-        workflowName?: string;
-    }): Promise<{
-        workflowName: string;
-        runId: string;
-        snapshot: any;
-        createdAt: Date;
-        updatedAt: Date;
-    } | null>;
-    getWorkflowRuns(args?: {
-        namespace?: string;
-        resourceId?: string;
-        workflowName?: string;
-        fromDate?: Date;
-        toDate?: Date;
-        limit?: number;
-        offset?: number;
-    }): Promise<WorkflowRuns_2>;
-}
-
-export declare function validateKeyTypes(keys: Record<string, any>, tableSchema: SchemaLike): void;
-
-export { }