@soulcraft/brainy 0.9.5

package/dist/types/augmentations.d.ts

@@ -0,0 +1,324 @@
+/** Common types for the augmentation system */
+/**
+ * Enum representing all types of augmentations available in the Brainy system.
+ */
+export declare enum AugmentationType {
+    SENSE = "sense",
+    CONDUIT = "conduit",
+    COGNITION = "cognition",
+    MEMORY = "memory",
+    PERCEPTION = "perception",
+    DIALOG = "dialog",
+    ACTIVATION = "activation",
+    WEBSOCKET = "webSocket"
+}
+export type WebSocketConnection = {
+    connectionId: string;
+    url: string;
+    status: 'connected' | 'disconnected' | 'error';
+    send?: (data: string | ArrayBufferLike | Blob | ArrayBufferView) => Promise<void>;
+    close?: () => Promise<void>;
+    _streamMessageHandler?: (event: {
+        data: unknown;
+    }) => void;
+    _messageHandlerWrapper?: (data: unknown) => void;
+};
+type DataCallback<T> = (data: T) => void;
+export type AugmentationResponse<T> = {
+    success: boolean;
+    data: T;
+    error?: string;
+};
+/**
+ * Base interface for all Brainy augmentations.
+ * All augmentations must implement these core properties.
+ */
+export interface IAugmentation {
+    /** A unique identifier for the augmentation (e.g., "my-reasoner-v1") */
+    readonly name: string;
+    /** A human-readable description of the augmentation's purpose */
+    readonly description: string;
+    /** Whether this augmentation is enabled */
+    enabled: boolean;
+    /**
+     * Initializes the augmentation. This method is called when Brainy starts up.
+     * @returns A Promise that resolves when initialization is complete
+     */
+    initialize(): Promise<void>;
+    shutDown(): Promise<void>;
+    getStatus(): Promise<'active' | 'inactive' | 'error'>;
+    [key: string]: any;
+}
+/**
+ * Interface for WebSocket support.
+ * Augmentations that implement this interface can communicate via WebSockets.
+ */
+export interface IWebSocketSupport extends IAugmentation {
+    /**
+     * Establishes a WebSocket connection.
+     * @param url The WebSocket server URL to connect to
+     * @param protocols Optional subprotocols
+     * @returns A Promise resolving to a connection handle or status
+     */
+    connectWebSocket(url: string, protocols?: string | string[]): Promise<WebSocketConnection>;
+    /**
+     * Sends data through an established WebSocket connection.
+     * @param connectionId The identifier of the established connection
+     * @param data The data to send (will be serialized if not a string)
+     */
+    sendWebSocketMessage(connectionId: string, data: unknown): Promise<void>;
+    /**
+     * Registers a callback for incoming WebSocket messages.
+     * @param connectionId The identifier of the established connection
+     * @param callback The function to call when a message is received
+     */
+    onWebSocketMessage(connectionId: string, callback: DataCallback<unknown>): Promise<void>;
+    /**
+     * Removes a callback for incoming WebSocket messages.
+     * @param connectionId The identifier of the established connection
+     * @param callback The function to remove from the callbacks
+     */
+    offWebSocketMessage(connectionId: string, callback: DataCallback<unknown>): Promise<void>;
+    /**
+     * Closes an established WebSocket connection.
+     * @param connectionId The identifier of the established connection
+     * @param code Optional close code
+     * @param reason Optional close reason
+     */
+    closeWebSocket(connectionId: string, code?: number, reason?: string): Promise<void>;
+}
+export declare namespace BrainyAugmentations {
+    /**
+     * Interface for Senses augmentations.
+     * These augmentations ingest and process raw, unstructured data into nouns and verbs.
+     */
+    interface ISenseAugmentation extends IAugmentation {
+        /**
+         * Processes raw input data into structured nouns and verbs.
+         * @param rawData The raw, unstructured data (e.g., text, image buffer, audio stream)
+         * @param dataType The type of raw data (e.g., 'text', 'image', 'audio')
+         */
+        processRawData(rawData: Buffer | string, dataType: string): Promise<AugmentationResponse<{
+            nouns: string[];
+            verbs: string[];
+        }>>;
+        /**
+         * Registers a listener for real-time data feeds.
+         * @param feedUrl The URL or identifier of the real-time feed
+         * @param callback A function to call with processed data
+         */
+        listenToFeed(feedUrl: string, callback: DataCallback<{
+            nouns: string[];
+            verbs: string[];
+        }>): Promise<void>;
+    }
+    /**
+     * Interface for Conduits augmentations.
+     * These augmentations establish and manage high-bandwidth, dedicated channels for structured, programmatic two-way data exchange.
+     */
+    interface IConduitAugmentation extends IAugmentation {
+        /**
+         * Establishes a connection for programmatic data exchange.
+         * @param targetSystemId The identifier of the external system to connect to
+         * @param config Configuration details for the connection (e.g., API keys, endpoints)
+         */
+        establishConnection(targetSystemId: string, config: Record<string, unknown>): Promise<AugmentationResponse<WebSocketConnection>>;
+        /**
+         * Reads structured data directly from Brainy's knowledge graph.
+         * @param query A structured query (e.g., graph query language, object path)
+         * @param options Optional query options (e.g., depth, filters)
+         */
+        readData(query: Record<string, unknown>, options?: Record<string, unknown>): Promise<AugmentationResponse<unknown>>;
+        /**
+         * Writes or updates structured data directly into Brainy's knowledge graph.
+         * @param data The structured data to write/update
+         * @param options Optional write options (e.g., merge, overwrite)
+         */
+        writeData(data: Record<string, unknown>, options?: Record<string, unknown>): Promise<AugmentationResponse<unknown>>;
+        /**
+         * Monitors a specific data stream or event within Brainy for external systems.
+         * @param streamId The identifier of the data stream or event
+         * @param callback A function to call when new data/events occur
+         */
+        monitorStream(streamId: string, callback: DataCallback<unknown>): Promise<void>;
+    }
+    /**
+     * Interface for Cognitions augmentations.
+     * These augmentations enable advanced reasoning, inference, and logical operations.
+     */
+    interface ICognitionAugmentation extends IAugmentation {
+        /**
+         * Performs a reasoning operation based on current knowledge.
+         * @param query The specific reasoning task or question
+         * @param context Optional additional context for the reasoning
+         */
+        reason(query: string, context?: Record<string, unknown>): AugmentationResponse<{
+            inference: string;
+            confidence: number;
+        }>;
+        /**
+         * Infers relationships or new facts from existing data.
+         * @param dataSubset A subset of data to infer from
+         */
+        infer(dataSubset: Record<string, unknown>): AugmentationResponse<Record<string, unknown>>;
+        /**
+         * Executes a logical operation or rule set.
+         * @param ruleId The identifier of the rule or logic to apply
+         * @param input Data to apply the logic to
+         */
+        executeLogic(ruleId: string, input: Record<string, unknown>): AugmentationResponse<boolean>;
+    }
+    /**
+     * Interface for Memory augmentations.
+     * These augmentations provide storage capabilities for data in different formats (e.g., fileSystem, in-memory).
+     */
+    interface IMemoryAugmentation extends IAugmentation {
+        /**
+         * Stores data in the memory system.
+         * @param key The unique identifier for the data
+         * @param data The data to store
+         * @param options Optional storage options (e.g., expiration, format)
+         */
+        storeData(key: string, data: unknown, options?: Record<string, unknown>): Promise<AugmentationResponse<boolean>>;
+        /**
+         * Retrieves data from the memory system.
+         * @param key The unique identifier for the data
+         * @param options Optional retrieval options (e.g., format, version)
+         */
+        retrieveData(key: string, options?: Record<string, unknown>): Promise<AugmentationResponse<unknown>>;
+        /**
+         * Updates existing data in the memory system.
+         * @param key The unique identifier for the data
+         * @param data The updated data
+         * @param options Optional update options (e.g., merge, overwrite)
+         */
+        updateData(key: string, data: unknown, options?: Record<string, unknown>): Promise<AugmentationResponse<boolean>>;
+        /**
+         * Deletes data from the memory system.
+         * @param key The unique identifier for the data
+         * @param options Optional deletion options
+         */
+        deleteData(key: string, options?: Record<string, unknown>): Promise<AugmentationResponse<boolean>>;
+        /**
+         * Lists available data keys in the memory system.
+         * @param pattern Optional pattern to filter keys (e.g., prefix, regex)
+         * @param options Optional listing options (e.g., limit, offset)
+         */
+        listDataKeys(pattern?: string, options?: Record<string, unknown>): Promise<AugmentationResponse<string[]>>;
+        /**
+         * Searches for data in the memory system using vector similarity.
+         * @param query The query vector or data to search for
+         * @param k Number of results to return
+         * @param options Optional search options
+         */
+        search(query: unknown, k?: number, options?: Record<string, unknown>): Promise<AugmentationResponse<Array<{
+            id: string;
+            score: number;
+            data: unknown;
+        }>>>;
+    }
+    /**
+     * Interface for Perceptions augmentations.
+     * These augmentations interpret, contextualize, and visualize identified nouns and verbs.
+     */
+    interface IPerceptionAugmentation extends IAugmentation {
+        /**
+         * Interprets and contextualizes processed nouns and verbs.
+         * @param nouns The list of identified nouns
+         * @param verbs The list of identified verbs
+         * @param context Optional additional context for interpretation
+         */
+        interpret(nouns: string[], verbs: string[], context?: Record<string, unknown>): AugmentationResponse<Record<string, unknown>>;
+        /**
+         * Organizes and filters information.
+         * @param data The data to organize (e.g., interpreted perceptions)
+         * @param criteria Optional criteria for filtering/prioritization
+         */
+        organize(data: Record<string, unknown>, criteria?: Record<string, unknown>): AugmentationResponse<Record<string, unknown>>;
+        /**
+         * Generates a visualization based on the provided data.
+         * @param data The data to visualize (e.g., interpreted patterns)
+         * @param visualizationType The desired type of visualization (e.g., 'graph', 'chart')
+         */
+        generateVisualization(data: Record<string, unknown>, visualizationType: string): AugmentationResponse<string | Buffer | Record<string, unknown>>;
+    }
+    /**
+     * Interface for Dialogs augmentations.
+     * These augmentations facilitate natural language understanding and generation for conversational interaction.
+     */
+    interface IDialogAugmentation extends IAugmentation {
+        /**
+         * Processes a user's natural language input (query).
+         * @param naturalLanguageQuery The raw text query from the user
+         * @param sessionId An optional session ID for conversational context
+         */
+        processUserInput(naturalLanguageQuery: string, sessionId?: string): AugmentationResponse<{
+            intent: string;
+            nouns: string[];
+            verbs: string[];
+            context: Record<string, unknown>;
+        }>;
+        /**
+         * Generates a natural language response based on Brainy's knowledge and interpreted input.
+         * @param interpretedInput The output from `processUserInput` or similar
+         * @param knowledgeContext Relevant knowledge retrieved from Brainy
+         * @param sessionId An optional session ID for conversational context
+         */
+        generateResponse(interpretedInput: Record<string, unknown>, knowledgeContext: Record<string, unknown>, sessionId?: string): AugmentationResponse<string>;
+        /**
+         * Manages and updates conversational context.
+         * @param sessionId The session ID
+         * @param contextUpdate The data to update the context with
+         */
+        manageContext(sessionId: string, contextUpdate: Record<string, unknown>): Promise<void>;
+    }
+    /**
+     * Interface for Activations augmentations.
+     * These augmentations dictate how Brainy initiates actions, responses, or data manipulations.
+     */
+    interface IActivationAugmentation extends IAugmentation {
+        /**
+         * Triggers an action based on a processed command or internal state.
+         * @param actionName The name of the action to trigger
+         * @param parameters Optional parameters for the action
+         */
+        triggerAction(actionName: string, parameters?: Record<string, unknown>): AugmentationResponse<unknown>;
+        /**
+         * Generates an expressive output or response from Brainy.
+         * @param knowledgeId The identifier of the knowledge to express
+         * @param format The desired output format (e.g., 'text', 'json')
+         */
+        generateOutput(knowledgeId: string, format: string): AugmentationResponse<string | Record<string, unknown>>;
+        /**
+         * Interacts with an external system or API.
+         * @param systemId The identifier of the external system
+         * @param payload The data to send to the external system
+         */
+        interactExternal(systemId: string, payload: Record<string, unknown>): AugmentationResponse<unknown>;
+    }
+}
+/** Direct exports of augmentation interfaces for easier imports */
+export interface ISenseAugmentation extends BrainyAugmentations.ISenseAugmentation {
+}
+export interface IConduitAugmentation extends BrainyAugmentations.IConduitAugmentation {
+}
+export interface ICognitionAugmentation extends BrainyAugmentations.ICognitionAugmentation {
+}
+export interface IMemoryAugmentation extends BrainyAugmentations.IMemoryAugmentation {
+}
+export interface IPerceptionAugmentation extends BrainyAugmentations.IPerceptionAugmentation {
+}
+export interface IDialogAugmentation extends BrainyAugmentations.IDialogAugmentation {
+}
+export interface IActivationAugmentation extends BrainyAugmentations.IActivationAugmentation {
+}
+/** WebSocket-enabled augmentation interfaces */
+export type IWebSocketSenseAugmentation = BrainyAugmentations.ISenseAugmentation & IWebSocketSupport;
+export type IWebSocketConduitAugmentation = BrainyAugmentations.IConduitAugmentation & IWebSocketSupport;
+export type IWebSocketCognitionAugmentation = BrainyAugmentations.ICognitionAugmentation & IWebSocketSupport;
+export type IWebSocketMemoryAugmentation = BrainyAugmentations.IMemoryAugmentation & IWebSocketSupport;
+export type IWebSocketPerceptionAugmentation = BrainyAugmentations.IPerceptionAugmentation & IWebSocketSupport;
+export type IWebSocketDialogAugmentation = BrainyAugmentations.IDialogAugmentation & IWebSocketSupport;
+export type IWebSocketActivationAugmentation = BrainyAugmentations.IActivationAugmentation & IWebSocketSupport;
+export {};
+//# sourceMappingURL=augmentations.d.ts.map

package/dist/types/augmentations.d.ts.map

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

package/dist/types/brainyDataInterface.d.ts

@@ -0,0 +1,51 @@
+/**
+ * BrainyDataInterface
+ *
+ * This interface defines the methods from BrainyData that are used by serverSearchAugmentations.ts.
+ * It's used to break the circular dependency between brainyData.ts and serverSearchAugmentations.ts.
+ */
+import { Vector } from '../coreTypes.js';
+export interface BrainyDataInterface<T = unknown> {
+    /**
+     * Initialize the database
+     */
+    init(): Promise<void>;
+    /**
+     * Get a noun by ID
+     * @param id The ID of the noun to get
+     */
+    get(id: string): Promise<unknown>;
+    /**
+     * Add a vector or data to the database
+     * @param vectorOrData Vector or data to add
+     * @param metadata Optional metadata to associate with the vector
+     * @returns The ID of the added vector
+     */
+    add(vectorOrData: Vector | unknown, metadata?: T): Promise<string>;
+    /**
+     * Search for text in the database
+     * @param text The text to search for
+     * @param limit Maximum number of results to return
+     * @returns Search results
+     */
+    searchText(text: string, limit?: number): Promise<unknown[]>;
+    /**
+     * Create a relationship between two entities
+     * @param sourceId The ID of the source entity
+     * @param targetId The ID of the target entity
+     * @param relationType The type of relationship
+     * @param metadata Optional metadata about the relationship
+     * @returns The ID of the created relationship
+     */
+    relate(sourceId: string, targetId: string, relationType: string, metadata?: unknown): Promise<string>;
+    /**
+     * Find entities similar to a given entity ID
+     * @param id ID of the entity to find similar entities for
+     * @param options Additional options
+     * @returns Array of search results with similarity scores
+     */
+    findSimilar(id: string, options?: {
+        limit?: number;
+    }): Promise<unknown[]>;
+}
+//# sourceMappingURL=brainyDataInterface.d.ts.map

package/dist/types/brainyDataInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainyDataInterface.d.ts","sourceRoot":"","sources":["../../src/types/brainyDataInterface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAErB;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEjC;;;;;OAKG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAElE;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAE5D;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAErG;;;;;OAKG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;CAC1E"}

package/dist/types/fileSystemTypes.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Type declarations for the File System Access API
+ * Extends the FileSystemDirectoryHandle interface to include the [Symbol.asyncIterator] method
+ */
+export declare const fileSystemTypesLoaded = true;
+//# sourceMappingURL=fileSystemTypes.d.ts.map

package/dist/types/fileSystemTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystemTypes.d.ts","sourceRoot":"","sources":["../../src/types/fileSystemTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,eAAO,MAAM,qBAAqB,OAAO,CAAC"}

package/dist/types/graphTypes.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Represents a high-precision timestamp with seconds and nanoseconds
+ * Used for tracking creation and update times of graph elements
+ */
+interface Timestamp {
+    seconds: number;
+    nanoseconds: number;
+}
+/**
+ * Metadata about the creator/source of a graph noun
+ * Tracks which augmentation and model created the element
+ */
+interface CreatorMetadata {
+    augmentation: string;
+    version: string;
+}
+/**
+ * Base interface for nodes (nouns) in the graph
+ * Represents entities like people, places, things, etc.
+ */
+export interface GraphNoun {
+    id: string;
+    createdBy: CreatorMetadata;
+    noun: NounType;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    label?: string;
+    data?: Record<string, any>;
+    embeddedVerbs?: EmbeddedGraphVerb[];
+    embedding?: number[];
+}
+/**
+ * Base interface for edges (verbs) in the graph
+ * Represents relationships between nouns
+ */
+export interface GraphVerb {
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+    verb: VerbType;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    data?: Record<string, any>;
+    embedding?: number[];
+    confidence?: number;
+    weight?: number;
+}
+/**
+ * Version of GraphVerb for embedded relationships
+ * Used when the source is implicit from the parent document
+ */
+export type EmbeddedGraphVerb = Omit<GraphVerb, 'source'>;
+/**
+ * Represents a person entity in the graph
+ */
+export interface Person extends GraphNoun {
+    noun: typeof NounType.Person;
+}
+/**
+ * Represents a physical location in the graph
+ */
+export interface Place extends GraphNoun {
+    noun: typeof NounType.Place;
+}
+/**
+ * Represents a physical or virtual object in the graph
+ */
+export interface Thing extends GraphNoun {
+    noun: typeof NounType.Thing;
+}
+/**
+ * Represents an event or occurrence in the graph
+ */
+export interface Event extends GraphNoun {
+    noun: typeof NounType.Event;
+}
+/**
+ * Represents an abstract concept or idea in the graph
+ */
+export interface Concept extends GraphNoun {
+    noun: typeof NounType.Concept;
+}
+export interface Group extends GraphNoun {
+    noun: typeof NounType.Group;
+}
+export interface List extends GraphNoun {
+    noun: typeof NounType.List;
+}
+/**
+ * Represents content (text, media, etc.) in the graph
+ */
+export interface Content extends GraphNoun {
+    noun: typeof NounType.Content;
+}
+/**
+ * Defines valid noun types for graph entities
+ * Used for categorizing different types of nodes
+ */
+export declare const NounType: {
+    readonly Person: "person";
+    readonly Place: "place";
+    readonly Thing: "thing";
+    readonly Event: "event";
+    readonly Concept: "concept";
+    readonly Content: "content";
+    readonly Group: "group";
+    readonly List: "list";
+    readonly Category: "category";
+};
+export type NounType = (typeof NounType)[keyof typeof NounType];
+/**
+ * Defines valid verb types for relationships
+ * Used for categorizing different types of connections
+ */
+export declare const VerbType: {
+    readonly AttributedTo: "attributedTo";
+    readonly Controls: "controls";
+    readonly Created: "created";
+    readonly Earned: "earned";
+    readonly Owns: "owns";
+    readonly MemberOf: "memberOf";
+    readonly RelatedTo: "relatedTo";
+    readonly WorksWith: "worksWith";
+    readonly FriendOf: "friendOf";
+    readonly ReportsTo: "reportsTo";
+    readonly Supervises: "supervises";
+    readonly Mentors: "mentors";
+    readonly Follows: "follows";
+    readonly Likes: "likes";
+};
+export type VerbType = (typeof VerbType)[keyof typeof VerbType];
+export {};
+//# sourceMappingURL=graphTypes.d.ts.map

package/dist/types/graphTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphTypes.d.ts","sourceRoot":"","sources":["../../src/types/graphTypes.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,UAAU,eAAe;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1B,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAA;IACnC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AAIzD;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,SAAS;IACvC,IAAI,EAAE,OAAO,QAAQ,CAAC,MAAM,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,SAAS;IACtC,IAAI,EAAE,OAAO,QAAQ,CAAC,KAAK,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,SAAS;IACtC,IAAI,EAAE,OAAO,QAAQ,CAAC,KAAK,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,SAAS;IACtC,IAAI,EAAE,OAAO,QAAQ,CAAC,KAAK,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,SAAS;IACxC,IAAI,EAAE,OAAO,QAAQ,CAAC,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,KAAM,SAAQ,SAAS;IACtC,IAAI,EAAE,OAAO,QAAQ,CAAC,KAAK,CAAA;CAC5B;AAED,MAAM,WAAW,IAAK,SAAQ,SAAS;IACrC,IAAI,EAAE,OAAO,QAAQ,CAAC,IAAI,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,SAAS;IACxC,IAAI,EAAE,OAAO,QAAQ,CAAC,OAAO,CAAA;CAC9B;AAED;;;GAGG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAA;AACV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAeX,CAAA;AACV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA"}