mojentic 1.0.0

package/dist/context/shared-working-memory.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Shared Working Memory - Context that agents can read from and write to
+ */
+/**
+ * SharedWorkingMemory provides a shared context that agents can read from and write to.
+ *
+ * This enables agents to maintain state across multiple interactions and share
+ * information with each other. Memory is stored as a plain object that can be
+ * retrieved and updated through deep merging.
+ *
+ * @example
+ * ```typescript
+ * const memory = new SharedWorkingMemory({
+ *   user: {
+ *     name: 'Alice',
+ *     age: 30
+ *   }
+ * });
+ *
+ * // Retrieve current memory
+ * const current = memory.getWorkingMemory();
+ * console.log(current.user.name); // 'Alice'
+ *
+ * // Merge new information
+ * memory.mergeToWorkingMemory({
+ *   user: {
+ *     city: 'New York'
+ *   }
+ * });
+ *
+ * // Memory now contains both original and new data
+ * const updated = memory.getWorkingMemory();
+ * console.log(updated.user); // { name: 'Alice', age: 30, city: 'New York' }
+ * ```
+ */
+export declare class SharedWorkingMemory {
+    private _workingMemory;
+    /**
+     * Create a new SharedWorkingMemory instance.
+     *
+     * @param initialWorkingMemory - Initial memory object (default: empty object)
+     */
+    constructor(initialWorkingMemory?: Record<string, unknown>);
+    /**
+     * Get the current working memory.
+     *
+     * @returns A copy of the current working memory object
+     */
+    getWorkingMemory(): Record<string, unknown>;
+    /**
+     * Merge new information into the working memory.
+     *
+     * This performs a deep merge, recursively updating nested objects while
+     * replacing primitives and arrays. This allows partial updates to complex
+     * memory structures without losing existing data.
+     *
+     * @param workingMemory - The memory object to merge in
+     *
+     * @example
+     * ```typescript
+     * // Initial memory
+     * const memory = new SharedWorkingMemory({
+     *   user: { name: 'Bob', preferences: { theme: 'dark' } }
+     * });
+     *
+     * // Merge new preference without losing existing ones
+     * memory.mergeToWorkingMemory({
+     *   user: { preferences: { language: 'en' } }
+     * });
+     *
+     * // Result: { user: { name: 'Bob', preferences: { theme: 'dark', language: 'en' } } }
+     * ```
+     */
+    mergeToWorkingMemory(workingMemory: Record<string, unknown>): void;
+}
+//# sourceMappingURL=shared-working-memory.d.ts.map

package/dist/context/shared-working-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-working-memory.d.ts","sourceRoot":"","sources":["../../src/context/shared-working-memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,cAAc,CAA0B;IAEhD;;;;OAIG;gBACS,oBAAoB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAK9D;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI3C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGnE"}

package/dist/context/shared-working-memory.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Shared Working Memory - Context that agents can read from and write to
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedWorkingMemory = void 0;
+/**
+ * Deep merge utility that recursively merges objects.
+ * Arrays and primitives are replaced, not merged.
+ *
+ * @param target - The target object to merge into
+ * @param source - The source object to merge from
+ * @returns The merged object
+ */
+function deepMerge(target, source) {
+    // eslint-disable-next-line security/detect-object-injection
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        // eslint-disable-next-line security/detect-object-injection
+        const sourceValue = source[key];
+        // eslint-disable-next-line security/detect-object-injection
+        const targetValue = result[key];
+        if (sourceValue &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)) {
+            // Recursively merge nested objects
+            // eslint-disable-next-line security/detect-object-injection
+            result[key] = deepMerge(targetValue, sourceValue);
+        }
+        else {
+            // Replace primitives, arrays, and nulls
+            // eslint-disable-next-line security/detect-object-injection
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+}
+/**
+ * SharedWorkingMemory provides a shared context that agents can read from and write to.
+ *
+ * This enables agents to maintain state across multiple interactions and share
+ * information with each other. Memory is stored as a plain object that can be
+ * retrieved and updated through deep merging.
+ *
+ * @example
+ * ```typescript
+ * const memory = new SharedWorkingMemory({
+ *   user: {
+ *     name: 'Alice',
+ *     age: 30
+ *   }
+ * });
+ *
+ * // Retrieve current memory
+ * const current = memory.getWorkingMemory();
+ * console.log(current.user.name); // 'Alice'
+ *
+ * // Merge new information
+ * memory.mergeToWorkingMemory({
+ *   user: {
+ *     city: 'New York'
+ *   }
+ * });
+ *
+ * // Memory now contains both original and new data
+ * const updated = memory.getWorkingMemory();
+ * console.log(updated.user); // { name: 'Alice', age: 30, city: 'New York' }
+ * ```
+ */
+class SharedWorkingMemory {
+    _workingMemory;
+    /**
+     * Create a new SharedWorkingMemory instance.
+     *
+     * @param initialWorkingMemory - Initial memory object (default: empty object)
+     */
+    constructor(initialWorkingMemory = {}) {
+        // Make a shallow copy to avoid sharing reference with caller
+        this._workingMemory = { ...initialWorkingMemory };
+    }
+    /**
+     * Get the current working memory.
+     *
+     * @returns A copy of the current working memory object
+     */
+    getWorkingMemory() {
+        return { ...this._workingMemory };
+    }
+    /**
+     * Merge new information into the working memory.
+     *
+     * This performs a deep merge, recursively updating nested objects while
+     * replacing primitives and arrays. This allows partial updates to complex
+     * memory structures without losing existing data.
+     *
+     * @param workingMemory - The memory object to merge in
+     *
+     * @example
+     * ```typescript
+     * // Initial memory
+     * const memory = new SharedWorkingMemory({
+     *   user: { name: 'Bob', preferences: { theme: 'dark' } }
+     * });
+     *
+     * // Merge new preference without losing existing ones
+     * memory.mergeToWorkingMemory({
+     *   user: { preferences: { language: 'en' } }
+     * });
+     *
+     * // Result: { user: { name: 'Bob', preferences: { theme: 'dark', language: 'en' } } }
+     * ```
+     */
+    mergeToWorkingMemory(workingMemory) {
+        this._workingMemory = deepMerge(this._workingMemory, workingMemory);
+    }
+}
+exports.SharedWorkingMemory = SharedWorkingMemory;
+//# sourceMappingURL=shared-working-memory.js.map

package/dist/context/shared-working-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-working-memory.js","sourceRoot":"","sources":["../../src/context/shared-working-memory.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;;;;;;GAOG;AACH,SAAS,SAAS,CAChB,MAA+B,EAC/B,MAA+B;IAE/B,4DAA4D;IAC5D,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,4DAA4D;QAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,4DAA4D;QAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,IACE,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3B,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;YACD,mCAAmC;YACnC,4DAA4D;YAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,WAAsC,EACtC,WAAsC,CACvC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,4DAA4D;YAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAa,mBAAmB;IACtB,cAAc,CAA0B;IAEhD;;;;OAIG;IACH,YAAY,uBAAgD,EAAE;QAC5D,6DAA6D;QAC7D,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,oBAAoB,CAAC,aAAsC;QACzD,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IACtE,CAAC;CACF;AAjDD,kDAiDC"}

package/dist/error.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Error types for Mojentic framework
+ */
+/**
+ * Base error class for all Mojentic errors
+ */
+export declare class MojenticError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+/**
+ * Error for gateway-related issues (network, API, etc.)
+ */
+export declare class GatewayError extends MojenticError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+/**
+ * Error for tool execution failures
+ */
+export declare class ToolError extends MojenticError {
+    readonly toolName?: string | undefined;
+    constructor(message: string, toolName?: string | undefined);
+}
+/**
+ * Error for validation failures
+ */
+export declare class ValidationError extends MojenticError {
+    readonly field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+/**
+ * Error for parsing/serialization issues
+ */
+export declare class ParseError extends MojenticError {
+    constructor(message: string);
+}
+/**
+ * Error for timeout issues
+ */
+export declare class TimeoutError extends MojenticError {
+    constructor(message?: string);
+}
+/**
+ * Result type for operations that can fail
+ * Inspired by Rust's Result<T, E> but adapted for TypeScript
+ */
+export type Result<T, E = Error> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+/**
+ * Create a successful Result
+ */
+export declare function Ok<T>(value: T): Result<T, never>;
+/**
+ * Create a failed Result
+ */
+export declare function Err<E = Error>(error: E): Result<never, E>;
+/**
+ * Check if a Result is Ok
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is {
+    ok: true;
+    value: T;
+};
+/**
+ * Check if a Result is Err
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is {
+    ok: false;
+    error: E;
+};
+/**
+ * Unwrap a Result, throwing if it's an error
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Unwrap a Result or return a default value
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * Map a Result's value if it's Ok
+ */
+export declare function mapResult<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+/**
+ * Map a Result's error if it's Err
+ */
+export declare function mapError<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAMhC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;aAG3B,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;CAMtC;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,aAAa;aAGxB,QAAQ,CAAC,EAAE,MAAM;gBADjC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA;CAMpC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;aAG9B,KAAK,CAAC,EAAE,MAAM;gBAD9B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA;CAMjC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,GAAE,MAA8B;CAKpD;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEpF;;GAEG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAEjF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAEnF;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAKpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAKvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAK1F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAKzF"}

package/dist/error.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Error types for Mojentic framework
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = exports.ParseError = exports.ValidationError = exports.ToolError = exports.GatewayError = exports.MojenticError = void 0;
+exports.Ok = Ok;
+exports.Err = Err;
+exports.isOk = isOk;
+exports.isErr = isErr;
+exports.unwrap = unwrap;
+exports.unwrapOr = unwrapOr;
+exports.mapResult = mapResult;
+exports.mapError = mapError;
+/**
+ * Base error class for all Mojentic errors
+ */
+class MojenticError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'MojenticError';
+        Object.setPrototypeOf(this, MojenticError.prototype);
+    }
+}
+exports.MojenticError = MojenticError;
+/**
+ * Error for gateway-related issues (network, API, etc.)
+ */
+class GatewayError extends MojenticError {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message, 'GATEWAY_ERROR');
+        this.statusCode = statusCode;
+        this.name = 'GatewayError';
+        Object.setPrototypeOf(this, GatewayError.prototype);
+    }
+}
+exports.GatewayError = GatewayError;
+/**
+ * Error for tool execution failures
+ */
+class ToolError extends MojenticError {
+    toolName;
+    constructor(message, toolName) {
+        super(message, 'TOOL_ERROR');
+        this.toolName = toolName;
+        this.name = 'ToolError';
+        Object.setPrototypeOf(this, ToolError.prototype);
+    }
+}
+exports.ToolError = ToolError;
+/**
+ * Error for validation failures
+ */
+class ValidationError extends MojenticError {
+    field;
+    constructor(message, field) {
+        super(message, 'VALIDATION_ERROR');
+        this.field = field;
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error for parsing/serialization issues
+ */
+class ParseError extends MojenticError {
+    constructor(message) {
+        super(message, 'PARSE_ERROR');
+        this.name = 'ParseError';
+        Object.setPrototypeOf(this, ParseError.prototype);
+    }
+}
+exports.ParseError = ParseError;
+/**
+ * Error for timeout issues
+ */
+class TimeoutError extends MojenticError {
+    constructor(message = 'Operation timed out') {
+        super(message, 'TIMEOUT_ERROR');
+        this.name = 'TimeoutError';
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Create a successful Result
+ */
+function Ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Create a failed Result
+ */
+function Err(error) {
+    return { ok: false, error };
+}
+/**
+ * Check if a Result is Ok
+ */
+function isOk(result) {
+    return result.ok === true;
+}
+/**
+ * Check if a Result is Err
+ */
+function isErr(result) {
+    return result.ok === false;
+}
+/**
+ * Unwrap a Result, throwing if it's an error
+ */
+function unwrap(result) {
+    if (isOk(result)) {
+        return result.value;
+    }
+    throw result.error;
+}
+/**
+ * Unwrap a Result or return a default value
+ */
+function unwrapOr(result, defaultValue) {
+    if (isOk(result)) {
+        return result.value;
+    }
+    return defaultValue;
+}
+/**
+ * Map a Result's value if it's Ok
+ */
+function mapResult(result, fn) {
+    if (isOk(result)) {
+        return Ok(fn(result.value));
+    }
+    return result;
+}
+/**
+ * Map a Result's error if it's Err
+ */
+function mapError(result, fn) {
+    if (isErr(result)) {
+        return Err(fn(result.error));
+    }
+    return result;
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

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

package/dist/examples/react/decisioning-agent.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Decision-making agent for the ReAct pattern.
+ *
+ * This agent evaluates the current context and decides on the next action to take.
+ */
+import { BaseAsyncAgent } from '../../agents/base-async-agent';
+import { Event } from '../../agents/event';
+import { Result } from '../../error';
+import { LlmBroker } from '../../llm/broker';
+/**
+ * Agent responsible for deciding the next action in the ReAct loop.
+ *
+ * This agent evaluates the current context, plan, and history to determine
+ * whether to continue planning, take an action, or finish and summarize.
+ */
+export declare class DecisioningAgent implements BaseAsyncAgent {
+    private readonly llm;
+    private static readonly MAX_ITERATIONS;
+    private readonly tools;
+    /**
+     * Initialize the decisioning agent.
+     *
+     * @param llm - The LLM broker to use for generating decisions
+     */
+    constructor(llm: LlmBroker);
+    /**
+     * Process a decisioning event and determine the next action.
+     *
+     * @param event - The decisioning event containing current context
+     * @returns Result containing one of: InvokeToolCall, FinishAndSummarize, InvokeThinking, or FailureOccurred event
+     */
+    receiveEventAsync(event: Event): Promise<Result<Event[], Error>>;
+    /**
+     * Generate the prompt for the decision-making LLM.
+     *
+     * @param event - The decisioning event containing current context
+     * @returns The formatted prompt string
+     */
+    private buildPrompt;
+    /**
+     * Format a text block with separators for visual clarity.
+     *
+     * @param text - The text to format
+     * @returns Formatted text with separator lines
+     */
+    private formatBlock;
+}
+//# sourceMappingURL=decisioning-agent.d.ts.map

package/dist/examples/react/decisioning-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisioning-agent.d.ts","sourceRoot":"","sources":["../../../src/examples/react/decisioning-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAM,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA4B7C;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IASzC,OAAO,CAAC,QAAQ,CAAC,GAAG;IARhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAM;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAElC;;;;OAIG;gBAC0B,GAAG,EAAE,SAAS;IAI3C;;;;;OAKG;IACG,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAsJtE;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAiBnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAGpB"}