swarm-mail 0.1.0 → 0.1.2

package/dist/streams/effect/deferred.d.ts

@@ -0,0 +1,108 @@
+/**
+ * DurableDeferred Service - Distributed Promises
+ *
+ * Creates a "distributed promise" that can be resolved from anywhere.
+ * Useful for request/response patterns over streams.
+ *
+ * @example
+ * ```typescript
+ * const response = await DurableDeferred.create<Response>({ ttlSeconds: 60 })
+ * await actor.append({ payload: message, replyTo: response.url })
+ * return response.value // blocks until resolved or timeout
+ * ```
+ *
+ * Implementation:
+ * - Uses Effect.Deferred internally for blocking await
+ * - Stores pending promises in 'deferred' table with TTL
+ * - Polls database for resolution (could be upgraded to NOTIFY/LISTEN)
+ * - Cleans up expired entries automatically
+ */
+import { Context, Effect, Layer } from "effect";
+/**
+ * Timeout error when deferred expires before resolution
+ */
+export declare class TimeoutError extends Error {
+    readonly url: string;
+    readonly ttlSeconds: number;
+    readonly _tag = "TimeoutError";
+    constructor(url: string, ttlSeconds: number);
+}
+/**
+ * Not found error when deferred URL doesn't exist
+ */
+export declare class NotFoundError extends Error {
+    readonly url: string;
+    readonly _tag = "NotFoundError";
+    constructor(url: string);
+}
+/**
+ * Handle for a pending deferred promise
+ */
+export interface DeferredHandle<T> {
+    /** Unique URL/identifier for this deferred */
+    readonly url: string;
+    /** Blocks until resolved/rejected or timeout */
+    readonly value: Effect.Effect<T, TimeoutError | NotFoundError>;
+}
+/**
+ * Configuration for creating a deferred
+ */
+export interface DeferredConfig {
+    /** Time-to-live in seconds before timeout */
+    readonly ttlSeconds: number;
+    /** Optional project path for database isolation */
+    readonly projectPath?: string;
+}
+declare const DurableDeferred_base: Context.TagClass<DurableDeferred, "DurableDeferred", {
+    /**
+     * Create a new deferred promise
+     *
+     * @returns Handle with URL and value getter
+     */
+    readonly create: <T>(config: DeferredConfig) => Effect.Effect<DeferredHandle<T>>;
+    /**
+     * Resolve a deferred with a value
+     *
+     * @param url - Deferred identifier
+     * @param value - Resolution value
+     */
+    readonly resolve: <T>(url: string, value: T, projectPath?: string) => Effect.Effect<void, NotFoundError>;
+    /**
+     * Reject a deferred with an error
+     *
+     * @param url - Deferred identifier
+     * @param error - Error to reject with
+     */
+    readonly reject: (url: string, error: Error, projectPath?: string) => Effect.Effect<void, NotFoundError>;
+    /**
+     * Await a deferred's resolution (internal - use handle.value instead)
+     */
+    readonly await: <T>(url: string, ttlSeconds: number, projectPath?: string) => Effect.Effect<T, TimeoutError | NotFoundError>;
+}>;
+/**
+ * DurableDeferred service for distributed promises
+ */
+export declare class DurableDeferred extends DurableDeferred_base {
+}
+/**
+ * Live implementation of DurableDeferred service
+ */
+export declare const DurableDeferredLive: Layer.Layer<DurableDeferred, never, never>;
+/**
+ * Create a deferred promise
+ */
+export declare function createDeferred<T>(config: DeferredConfig): Effect.Effect<DeferredHandle<T>, never, DurableDeferred>;
+/**
+ * Resolve a deferred
+ */
+export declare function resolveDeferred<T>(url: string, value: T, projectPath?: string): Effect.Effect<void, NotFoundError, DurableDeferred>;
+/**
+ * Reject a deferred
+ */
+export declare function rejectDeferred(url: string, error: Error, projectPath?: string): Effect.Effect<void, NotFoundError, DurableDeferred>;
+/**
+ * Cleanup expired deferred entries (call periodically)
+ */
+export declare function cleanupDeferreds(projectPath?: string): Effect.Effect<number>;
+export {};
+//# sourceMappingURL=deferred.d.ts.map

package/dist/streams/effect/deferred.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred.d.ts","sourceRoot":"","sources":["../../../src/streams/effect/deferred.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAsB,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAQpE;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,GAAG,EAAE,MAAM;aACX,UAAU,EAAE,MAAM;IAHpC,QAAQ,CAAC,IAAI,kBAAkB;gBAEb,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM;CAIrC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAEV,GAAG,EAAE,MAAM;IADvC,QAAQ,CAAC,IAAI,mBAAmB;gBACJ,GAAG,EAAE,MAAM;CAGxC;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;;IAYG;;;;OAIG;qBACc,CAAC,CAAC,EACjB,MAAM,EAAE,cAAc,KACnB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAErC;;;;;OAKG;sBACe,CAAC,CAAC,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,WAAW,CAAC,EAAE,MAAM,KACjB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC;IAEvC;;;;;OAKG;qBACc,CACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,WAAW,CAAC,EAAE,MAAM,KACjB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC;IAEvC;;OAEG;oBACa,CAAC,CAAC,EAChB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,KACjB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;;AA9CvD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,oBA6ClC;CAAG;AAkQN;;GAEG;AACH,eAAO,MAAM,mBAAmB,4CAK9B,CAAC;AAMH;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,cAAc,GACrB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAK1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,eAAe,CAAC,CAKrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,eAAe,CAAC,CAKrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAE5E"}

package/{src/streams/effect/index.ts → dist/streams/effect/index.d.ts}

@@ -15,3 +15,4 @@ export * from "./lock";
 export * from "./mailbox";
 export * from "./ask";
 export * from "./layers";
+//# sourceMappingURL=index.d.ts.map

package/dist/streams/effect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/streams/effect/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}

package/{src/streams/effect/layers.ts → dist/streams/effect/layers.d.ts}

@@ -19,44 +19,23 @@
  * }).pipe(Effect.provide(DurableCursorDeferredLive));
  * ```
  */
-
 import { Layer } from "effect";
-import { DurableCursor, DurableCursorLive } from "./cursor";
-import { DurableDeferred, DurableDeferredLive } from "./deferred";
-import { DurableLock, DurableLockLive } from "./lock";
-import { DurableMailbox, DurableMailboxLive } from "./mailbox";
-
-// ============================================================================
-// Layer Wrappers (convert Context.make to Layer.succeed)
-// ============================================================================
-
-/**
- * Cursor service as Layer
- */
-const CursorLayer = Layer.succeed(DurableCursor, DurableCursorLive);
-
-/**
- * Mailbox service as Layer (with cursor dependency)
- */
-const MailboxLayer = Layer.mergeAll(CursorLayer, DurableMailboxLive);
-
+import { DurableCursor } from "./cursor";
+import { DurableDeferred } from "./deferred";
+import { DurableLock } from "./lock";
+import { DurableMailbox } from "./mailbox";
 /**
  * Minimal layer with just Cursor and Deferred
  *
  * Use when you only need event consumption and distributed promises.
  */
-export const DurableCursorDeferredLive = Layer.mergeAll(
-  CursorLayer,
-  DurableDeferredLive,
-);
-
+export declare const DurableCursorDeferredLive: Layer.Layer<DurableCursor | DurableDeferred, never, never>;
 /**
  * Mailbox layer with dependencies
  *
  * Provides DurableMailbox + DurableCursor (required dependency).
  */
-export const DurableMailboxWithDepsLive = MailboxLayer;
-
+export declare const DurableMailboxWithDepsLive: Layer.Layer<DurableCursor | DurableMailbox, never, never>;
 /**
  * Ask pattern layer (Mailbox + Deferred)
  *
@@ -64,10 +43,6 @@ export const DurableMailboxWithDepsLive = MailboxLayer;
  * - DurableMailbox (with DurableCursor dependency)
  * - DurableDeferred
  */
-export const DurableAskLive = Layer.mergeAll(DurableDeferredLive, MailboxLayer);
-
-// ============================================================================
-// Re-exports for convenience
-// ============================================================================
-
+export declare const DurableAskLive: Layer.Layer<DurableCursor | DurableMailbox | DurableDeferred, never, never>;
 export { DurableCursor, DurableDeferred, DurableLock, DurableMailbox };
+//# sourceMappingURL=layers.d.ts.map

package/dist/streams/effect/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../../src/streams/effect/layers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAqB,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAuB,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,WAAW,EAAmB,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,cAAc,EAAsB,MAAM,WAAW,CAAC;AAgB/D;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,4DAGrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,2DAAe,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,6EAAoD,CAAC;AAMhF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC"}

package/dist/streams/effect/lock.d.ts

@@ -0,0 +1,137 @@
+/**
+ * DurableLock - Distributed Mutual Exclusion via CAS
+ *
+ * Uses seq=0 CAS (Compare-And-Swap) pattern for distributed locking.
+ * Provides acquire/release/withLock methods with TTL expiry and contention handling.
+ *
+ * Based on Kyle Matthews' pattern from Agent Mail.
+ *
+ * @example
+ * ```typescript
+ * // Using Effect API
+ * const program = Effect.gen(function* (_) {
+ *   const lock = yield* _(acquireLock("my-resource", { ttlSeconds: 30 }))
+ *   try {
+ *     // Critical section
+ *   } finally {
+ *     yield* _(lock.release())
+ *   }
+ * }).pipe(Effect.provide(DurableLockLive))
+ *
+ * // Or use withLock helper
+ * const program = Effect.gen(function* (_) {
+ *   const lock = yield* _(DurableLock)
+ *   yield* _(lock.withLock("my-resource", Effect.succeed(42)))
+ * }).pipe(Effect.provide(DurableLockLive))
+ * ```
+ */
+import { Context, Effect, Layer } from "effect";
+/**
+ * Configuration for lock acquisition
+ */
+export interface LockConfig {
+    /**
+     * Time-to-live in seconds before lock auto-expires
+     * @default 30
+     */
+    ttlSeconds?: number;
+    /**
+     * Maximum retry attempts when lock is contended
+     * @default 10
+     */
+    maxRetries?: number;
+    /**
+     * Base delay in milliseconds for exponential backoff
+     * @default 50
+     */
+    baseDelayMs?: number;
+    /**
+     * Project path for database instance
+     */
+    projectPath?: string;
+    /**
+     * Custom holder ID (defaults to generated UUID)
+     */
+    holderId?: string;
+}
+/**
+ * Handle representing an acquired lock
+ */
+export interface LockHandle {
+    /** Resource being locked */
+    readonly resource: string;
+    /** Holder ID who owns the lock */
+    readonly holder: string;
+    /** Sequence number when acquired */
+    readonly seq: number;
+    /** Timestamp when lock was acquired */
+    readonly acquiredAt: number;
+    /** Timestamp when lock expires */
+    readonly expiresAt: number;
+    /** Release the lock */
+    readonly release: () => Effect.Effect<void, LockError>;
+}
+/**
+ * Lock errors
+ */
+export type LockError = {
+    readonly _tag: "LockTimeout";
+    readonly resource: string;
+} | {
+    readonly _tag: "LockContention";
+    readonly resource: string;
+} | {
+    readonly _tag: "LockNotHeld";
+    readonly resource: string;
+    readonly holder: string;
+} | {
+    readonly _tag: "DatabaseError";
+    readonly error: Error;
+};
+declare const DurableLock_base: Context.TagClass<DurableLock, "DurableLock", {
+    /**
+     * Acquire a lock on a resource
+     *
+     * Uses CAS (seq=0) pattern:
+     * - INSERT if no lock exists
+     * - UPDATE if expired or we already hold it
+     *
+     * Retries with exponential backoff on contention.
+     */
+    readonly acquire: (resource: string, config?: LockConfig) => Effect.Effect<LockHandle, LockError>;
+    /**
+     * Release a lock
+     *
+     * Only succeeds if the holder matches.
+     */
+    readonly release: (resource: string, holder: string, projectPath?: string) => Effect.Effect<void, LockError>;
+    /**
+     * Execute an effect with automatic lock acquisition and release
+     *
+     * Guarantees lock release even on error (Effect.ensuring).
+     */
+    readonly withLock: <A, E, R>(resource: string, effect: Effect.Effect<A, E, R>, config?: LockConfig) => Effect.Effect<A, E | LockError, R | DurableLock>;
+}>;
+/**
+ * DurableLock service for distributed mutual exclusion
+ */
+export declare class DurableLock extends DurableLock_base {
+}
+/**
+ * Live implementation of DurableLock service
+ */
+export declare const DurableLockLive: Layer.Layer<DurableLock, never, never>;
+/**
+ * Acquire a lock (convenience Effect wrapper)
+ */
+export declare function acquireLock(resource: string, config?: LockConfig): Effect.Effect<LockHandle, LockError, DurableLock>;
+/**
+ * Release a lock (convenience Effect wrapper)
+ */
+export declare function releaseLock(resource: string, holder: string, projectPath?: string): Effect.Effect<void, LockError, DurableLock>;
+/**
+ * Execute with lock (convenience Effect wrapper)
+ */
+export declare function withLock<A, E, R>(resource: string, effect: Effect.Effect<A, E, R>, config?: LockConfig): Effect.Effect<A, E | LockError, R | DurableLock>;
+export {};
+//# sourceMappingURL=lock.d.ts.map

package/dist/streams/effect/lock.d.ts.map

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

package/dist/streams/effect/mailbox.d.ts

@@ -0,0 +1,98 @@
+/**
+ * DurableMailbox - Actor-style messaging with envelope pattern
+ *
+ * Combines DurableCursor (positioned consumption) with Envelope pattern for
+ * request/response messaging between agents.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const mailbox = yield* DurableMailbox;
+ *   const myMailbox = yield* mailbox.create({ agent: "worker-1" });
+ *
+ *   // Send message with optional reply channel
+ *   yield* myMailbox.send("worker-2", {
+ *     payload: { task: "process-data" },
+ *     replyTo: "deferred:xyz"
+ *   });
+ *
+ *   // Receive messages
+ *   for await (const envelope of myMailbox.receive()) {
+ *     yield* handleMessage(envelope.payload);
+ *     if (envelope.replyTo) {
+ *       yield* DurableDeferred.resolve(envelope.replyTo, result);
+ *     }
+ *     yield* envelope.commit();
+ *   }
+ * });
+ * ```
+ */
+import { Context, Effect, Layer } from "effect";
+import { DurableCursor } from "./cursor";
+/**
+ * Envelope wrapping a message with metadata
+ */
+export interface Envelope<T = unknown> {
+    /** Message payload */
+    readonly payload: T;
+    /** Optional URL of DurableDeferred for response */
+    readonly replyTo?: string;
+    /** Agent who sent the message */
+    readonly sender: string;
+    /** Original message ID */
+    readonly messageId: number;
+    /** Thread ID for conversation tracking */
+    readonly threadId?: string;
+    /** Commit this message position */
+    readonly commit: () => Effect.Effect<void>;
+}
+/**
+ * Configuration for creating a mailbox
+ */
+export interface MailboxConfig {
+    /** Agent name (mailbox owner) */
+    readonly agent: string;
+    /** Project key for scoping messages */
+    readonly projectKey: string;
+    /** Optional project path for database location */
+    readonly projectPath?: string;
+    /** Batch size for reading messages (default: 100) */
+    readonly batchSize?: number;
+}
+/**
+ * Mailbox instance for an agent
+ */
+export interface Mailbox {
+    /** Agent name */
+    readonly agent: string;
+    /** Send a message to another agent */
+    readonly send: <T>(to: string | string[], envelope: {
+        payload: T;
+        replyTo?: string;
+        threadId?: string;
+        importance?: "low" | "normal" | "high" | "urgent";
+    }) => Effect.Effect<void>;
+    /** Receive messages as async iterable */
+    readonly receive: <T = unknown>() => AsyncIterable<Envelope<T>>;
+    /** Peek at next message without consuming */
+    readonly peek: <T = unknown>() => Effect.Effect<Envelope<T> | null>;
+}
+/**
+ * DurableMailbox service interface
+ */
+export interface DurableMailboxService {
+    /** Create a new mailbox instance */
+    readonly create: (config: MailboxConfig) => Effect.Effect<Mailbox, never, DurableCursor>;
+}
+declare const DurableMailbox_base: Context.TagClass<DurableMailbox, "DurableMailbox", DurableMailboxService>;
+/**
+ * DurableMailbox Context.Tag
+ */
+export declare class DurableMailbox extends DurableMailbox_base {
+}
+/**
+ * Live implementation of DurableMailbox service
+ */
+export declare const DurableMailboxLive: Layer.Layer<DurableMailbox, never, never>;
+export {};
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/streams/effect/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../src/streams/effect/mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,aAAa,EAAe,MAAM,UAAU,CAAC;AAQtD;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EACf,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EACrB,QAAQ,EAAE;QACR,OAAO,EAAE,CAAC,CAAC;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;KACnD,KACE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,CACf,MAAM,EAAE,aAAa,KAClB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;CACnD;;AAMD;;GAEG;AACH,qBAAa,cAAe,SAAQ,mBAGjC;CAAG;AAwMN;;GAEG;AACH,eAAO,MAAM,kBAAkB,2CAE7B,CAAC"}