@animalabs/agent-framework 0.19.0 → 0.20.0

package/dist/src/mcpl/push-coalescer.d.ts

@@ -0,0 +1,318 @@
+/**
+ * RFC-006 event coalescing (mcpl PR #5, revision 7): replace-if-unread, deferred
+ * rendering, and atomic retraction, for both delivery lanes.
+ *
+ * The design keeps content IN context. A plain occurrence is delivered through
+ * the ordinary channel/push path the moment it is admitted, exactly as today;
+ * the coalescer only remembers WHERE it landed. A later occurrence of the same
+ * subject edits or removes that message in place while it is still unread
+ * (above the agent's consumed watermark, not folded by compression), and
+ * appends once it has been read. Nothing is staged, journaled or capped: on
+ * any uncertainty (restart, branch switch, eviction) the host behaves as an
+ * append-only host would, which is what the RFC's principle 4 asks for.
+ *
+ * Only deferred batches (§5) wait outside context, because a notice has no
+ * model-visible content until `push/render` produces it.
+ *
+ * All host effects go through {@link CoalescerHost}; this class is pure
+ * bookkeeping and is unit-tested without a framework.
+ */
+import type { McplContentBlock, PushEventResult } from './types.js';
+export declare const PUSH_COALESCING_SUPPORT: {
+    readonly pushEvents: true;
+    readonly channelsIncoming: true;
+    readonly deferred: true;
+    readonly channelScopedPush: true;
+    readonly retryWindowMs: 3600000;
+};
+export declare const COALESCE_OUTCOMES: readonly ["first", "replaced", "appended", "retracted", "noted", "consumed"];
+export type CoalesceOutcome = typeof COALESCE_OUTCOMES[number];
+export declare class CoalesceError extends Error {
+    readonly field: string;
+    readonly code: number;
+    constructor(field: string, message: string, code?: number);
+}
+/** Where an unread occurrence currently lives. */
+export interface CoalescingPlacement {
+    agent: string;
+    /** Stored message id in that agent's context manager. */
+    messageId?: string;
+    /** Entry id in the framework's deferred-write queue (turn-alive deferral). */
+    deferredId?: string;
+}
+export interface CoalescingScope {
+    kind: 'featureSet' | 'channel';
+    id: string;
+}
+/** One admitted occurrence, normalized from either lane. */
+export interface CoalescedOccurrence<E = unknown> {
+    serverId: string;
+    /** Host-owned binding identity (§3.2): stable across reconnects to the same
+     *  configured peer, different when the id is reassigned to another one. */
+    binding: string;
+    /** Declaring feature set (push lane), echoed in push/render. */
+    featureSet?: string;
+    scope: CoalescingScope;
+    key: string;
+    eventId: string;
+    timestamp: string;
+    retract: boolean;
+    deferred: boolean;
+    initial: boolean;
+    data?: unknown;
+    tags?: string[];
+    /** Wire content (fallback for deferred; the notice for retract). */
+    content: McplContentBlock[];
+    /** Stable platform identity for channel subjects (§3.1). */
+    identity?: {
+        messageId?: string;
+        author?: {
+            id: string;
+            name: string;
+        };
+        threadId?: string;
+    };
+    /** The event the ordinary path would have queued — the host delivers it. */
+    event: E;
+    /** Set by the coalescer: deliver into this agent only (§3.2 audience may
+     *  narrow, never widen — a replacement or notice follows the prior delivery). */
+    deliverTo?: string;
+}
+export interface DeferredNotice {
+    eventId: string;
+    timestamp: string;
+    data?: unknown;
+}
+export interface PushRenderParams {
+    featureSet: string;
+    channelId?: string;
+    key: string;
+    eventId: string;
+    notices: DeferredNotice[];
+    dropped: number;
+}
+export interface PushRenderResult {
+    content: McplContentBlock[];
+    timestamp?: string;
+}
+interface DeferredBatch<E> {
+    /** Latest notice; its content is the fallback, its tags/event drive delivery. */
+    latest: CoalescedOccurrence<E>;
+    notices: DeferredNotice[];
+    dropped: number;
+    /** Set on a batch restored from a snapshot whose render may have started. */
+    noRender?: boolean;
+}
+interface Rendering<E> {
+    batch: DeferredBatch<E>;
+    cancelled: boolean;
+    done: Promise<void>;
+}
+interface SubjectState<E> {
+    history: 'none' | 'some' | 'unknown';
+    occupant?: {
+        eventId: string;
+        placement: CoalescingPlacement;
+    };
+    batch?: DeferredBatch<E>;
+    rendering?: Rendering<E>;
+    consumedEventId?: string;
+    identity?: CoalescedOccurrence['identity'];
+    /** Agent that received the last delivery; replacements and notices follow it. */
+    audienceAgent?: string;
+    touchedAt: number;
+}
+export interface CoalescingSnapshot {
+    version: 1;
+    receipts: Array<[string, {
+        result: PushEventResult;
+        at: number;
+    }]>;
+    subjects: Array<{
+        subject: string;
+        history: SubjectState<unknown>['history'];
+        consumedEventId?: string;
+        identity?: CoalescedOccurrence['identity'];
+        occupant?: {
+            eventId: string;
+            placement: CoalescingPlacement;
+        };
+        audienceAgent?: string;
+        batch?: {
+            latest: CoalescedOccurrence<unknown>;
+            notices: DeferredNotice[];
+            dropped: number;
+            rendering?: boolean;
+        };
+    }>;
+}
+/** One receipt, written synchronously at acceptance (bridges the snapshot throttle). */
+export interface CoalescingReceiptRecord {
+    key: string;
+    result: PushEventResult;
+    at: number;
+    subject: string;
+    /** History the subject was created with, for a subject first seen by this receipt. */
+    born?: SubjectState<unknown>['history'];
+    /** The subject's pending batch AFTER this acceptance: the accepted work
+     *  itself (so a crash before the snapshot flush cannot lose it while keeping
+     *  the receipt that suppresses its retry), or `null` when the acceptance
+     *  left no batch — a retraction or plain replacement must be recoverable
+     *  too. Records replay in order, so the last one per subject wins. */
+    batch: {
+        latest: CoalescedOccurrence<unknown>;
+        notices: DeferredNotice[];
+        dropped: number;
+    } | null;
+}
+export interface CoalescerHost<E> {
+    /** True iff the placement still exists and no model request has included it. */
+    isUnread(placement: CoalescingPlacement): boolean;
+    /** False when the unread occurrence could not be removed (it may still be read). */
+    remove(placement: CoalescingPlacement): boolean;
+    /** Ordinary delivery of the event; undefined when routing delivered nowhere.
+     *  A replacement is delivered as a fresh message after the unread prior was
+     *  removed: it lands where a fresh event lands (§4.1 allows either place). */
+    deliver(occurrence: CoalescedOccurrence<E>, materialized?: McplContentBlock[], assemblingFor?: string): Promise<CoalescingPlacement | undefined>;
+    /** Queue a wake for a batch that has no model-visible content yet. */
+    wakeForBatch(occurrence: CoalescedOccurrence<E>): Promise<void>;
+    /** Withdraw unstarted wakes whose sole cause is this subject. */
+    cancelWake(subject: string): void;
+    /** The batch's audience still holds the authority it was admitted under. */
+    authorized(occurrence: CoalescedOccurrence<E>): boolean;
+    /** Agents that read this occurrence's delivery target (may spawn a fork). */
+    audience(occurrence: CoalescedOccurrence<E>): Promise<string[]>;
+    render(occurrence: CoalescedOccurrence<E>, params: PushRenderParams): Promise<PushRenderResult>;
+    audit(record: Record<string, unknown>): void;
+    /** Persist (throttled by the host); the thunk builds the snapshot lazily. */
+    save(snapshot: () => CoalescingSnapshot): void;
+    /** Persist the snapshot NOW (a render is about to start: that boundary must
+     *  be recoverable before the RPC is issued, §3.2). Throws on failure. */
+    saveNow?(snapshot: CoalescingSnapshot): void;
+    /** Persist one receipt now, before the acceptance is acknowledged. Throws
+     *  on failure, which fails the acceptance (the producer retries). */
+    recordReceipt?(record: CoalescingReceiptRecord): void;
+    /** Make every write so far DURABLE (fsync, group-committed by the host).
+     *  Awaited before an acceptance is acknowledged and before push/render is
+     *  issued: a kill after either boundary must find the receipt, the
+     *  accepted work, and the render-start on disk. Rejects on failure. */
+    commit?(): Promise<void>;
+    /** Recovery: is this occurrence's content in a context (its durable
+     *  delivery identity — subject + eventId in message metadata — is found
+     *  there)? A published occurrence is read from recovery on (the watermark
+     *  restarts at the head), whatever a stale record says about its history. */
+    wasPublished?(subject: string, eventId: string): boolean;
+    now?(): number;
+}
+export interface CoalescerOptions {
+    retryWindowMs?: number;
+    /** Base delay before re-waking a batch whose render-start commit failed
+     *  (doubles per attempt, capped at 60× base). Default 1 s. */
+    recoveryBackoffMs?: number;
+    maxSubjects?: number;
+    maxNotices?: number;
+    maxContentBytes?: number;
+    maxDataBytes?: number;
+}
+export declare function coalescingSubjectKey(serverId: string, binding: string, scope: CoalescingScope, key: string): string;
+export declare function coalescingReceiptKey(serverId: string, binding: string, eventId: string): string;
+/** Validate wire content before it is stored, rendered or converted. */
+export declare function validateCoalescedContent(content: unknown, maxBytes?: number): asserts content is McplContentBlock[];
+/** Validate the `coalesce` member of either lane (§13). */
+export declare function validateCoalesceMember(c: unknown, lane: 'push' | 'channel', maxDataBytes?: number): asserts c is NonNullable<import('./types.js').PushEventParams['coalesce']>;
+export declare class PushCoalescer<E = unknown> {
+    private readonly host;
+    private readonly options;
+    private readonly subjects;
+    /** `committed`: the durability barrier succeeded after this receipt was
+     *  written. An uncommitted receipt deduplicates effects but is not an
+     *  acknowledgement until a commit succeeds. */
+    private readonly receipts;
+    private readonly retryWindowMs;
+    private readonly maxSubjects;
+    private readonly maxNotices;
+    /** Outstanding push/render RPCs per server, including cancelled ones (§10.7). */
+    private readonly rendersInFlight;
+    /**
+     * The ONE critical section. Every state transition — an admission, the
+     * freezing of a batch for rendering, the settlement of a render's result —
+     * runs under it, awaits included (fork spawn, durability commit, delivery).
+     * Only the push/render RPC itself runs outside, so it stays cancellable.
+     * An admission therefore never observes a half-done assembly transition,
+     * and an assembly never acts on a batch an admission moved on from.
+     */
+    private serial;
+    /** Liveness after a failed freeze: a bounded, backed-off re-wake per
+     *  subject. `attempt` outlives the armed timer: it counts consecutive
+     *  failures and resets only on success or disposal of the pending work. */
+    private readonly recovery;
+    private suspended;
+    constructor(host: CoalescerHost<E>, options?: CoalescerOptions);
+    private now;
+    private locked;
+    /** The unread occupant's or batch's placement/identity, for routing continuity. */
+    identity(subject: string): CoalescedOccurrence['identity'] | undefined;
+    pendingBatches(): number;
+    /** §10.7: a server handling push/render must not issue inference/request —
+     *  including a render whose batch was cancelled while the RPC is outstanding. */
+    isRendering(serverId: string): boolean;
+    receipt(serverId: string, binding: string, eventId: string): PushEventResult | undefined;
+    private receiptEntry;
+    /** Acknowledge a receipt: durable first. A receipt whose commit failed is
+     *  committed now (no effects are repeated); if that fails again, so does
+     *  the acknowledgement, and the producer retries once more. */
+    private acknowledge;
+    /**
+     * Admit an occurrence that has already passed the lane's ordinary checks and
+     * the coalesce-member validation. Returns the wire result, performing the
+     * host effects (replace / remove / deliver) synchronously so a create, edit
+     * and delete cannot overtake one another.
+     */
+    accept(occurrence: CoalescedOccurrence<E>): Promise<PushEventResult>;
+    private admit;
+    private subjectFor;
+    /** Re-check the occupant against the host: consumed occupants become history. */
+    private refreshOccupant;
+    private scheduleRecovery;
+    /** Disarm the timer only (a producer retry wakes now; the count stands). */
+    private disarmRecovery;
+    /** Success or disposal of the pending work: forget the failure series. */
+    private clearRecovery;
+    private dropBatches;
+    private retract;
+    private acceptPlain;
+    private acceptDeferred;
+    /**
+     * Render and materialize every pending batch whose audience includes
+     * `agentName`. Called by the host at a turn's assembly boundary, before the
+     * compile. Bounded by the host's render timeout; a failed or late render
+     * materializes the admitted fallback (§5.3).
+     */
+    assemble(agentName: string): Promise<void>;
+    /**
+     * Under the lock: decide whether `subject`'s batch renders for `agentName`,
+     * freeze it, make the render-start durable, re-check authority, and start
+     * the RPC. Returns the render's completion (shared by every assembly that
+     * waits on this batch, vector 25) or undefined when nothing was started.
+     */
+    private freeze;
+    private render;
+    restore(snapshot: CoalescingSnapshot | null | undefined): void;
+    /**
+     * A batch restored as RENDERING may already have been published (its
+     * result or fallback is a durable context message; only the completion
+     * snapshot was lost). Recovery then marks it consumed instead of
+     * delivering the fallback a second time.
+     */
+    private settlePublished;
+    /** Apply receipts written since the last snapshot (crash-window bridge). */
+    restoreReceipts(records: CoalescingReceiptRecord[]): void;
+    snapshot(): CoalescingSnapshot;
+    /** Batches whose wake should be re-queued after a restart (their fallback is pending). */
+    pendingBatchOccurrences(): CoalescedOccurrence<E>[];
+    suspend(): void;
+    private persist;
+    private prune;
+}
+export {};
+//# sourceMappingURL=push-coalescer.d.ts.map

package/dist/src/mcpl/push-coalescer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-coalescer.d.ts","sourceRoot":"","sources":["../../../src/mcpl/push-coalescer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE,eAAO,MAAM,uBAAuB;;;;;;CAG1B,CAAC;AAEX,eAAO,MAAM,iBAAiB,8EAA+E,CAAC;AAC9G,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAI/D,qBAAa,aAAc,SAAQ,KAAK;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAmB,QAAQ,CAAC,IAAI;gBAA7C,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAW,IAAI,SAAS;CAI5E;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAE/E,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB;+EAC2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,eAAe,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oEAAoE;IACpE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F,4EAA4E;IAC5E,KAAK,EAAE,CAAC,CAAC;IACT;qFACiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;AAEtF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,gBAAgB;IAAG,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAErF,UAAU,aAAa,CAAC,CAAC;IACvB,iFAAiF;IACjF,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,SAAS,CAAC,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED,UAAU,YAAY,CAAC,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAC/D,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC3C,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACnE,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC3C,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,mBAAmB,CAAA;SAAE,CAAC;QAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAAC,OAAO,EAAE,cAAc,EAAE,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACnH,CAAC,CAAC;CACJ;AACD,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;IACxC;;;;0EAIsE;IACtE,KAAK,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpG;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAClD,oFAAoF;IACpF,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAChD;;kFAE8E;IAC9E,OAAO,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,gBAAgB,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IACjJ,sEAAsE;IACtE,YAAY,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,iEAAiE;IACjE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,4EAA4E;IAC5E,UAAU,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IACxD,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,6EAA6E;IAC7E,IAAI,CAAC,QAAQ,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;IAC/C;6EACyE;IACzE,OAAO,CAAC,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC7C;yEACqE;IACrE,aAAa,CAAC,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACtD;;;2EAGuE;IACvE,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB;;;iFAG6E;IAC7E,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,GAAG,CAAC,IAAI,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;kEAC8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnH;AACD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/F;AAQD,wEAAwE;AACxE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,EAAE,CAWxH;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,OAAO,EACV,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,SAAO,GAClB,OAAO,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,YAAY,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAqB5E;AAED,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IA0BxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAoB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAzB7E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D;;mDAE+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkF;IAC3G,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAuC;IACrD;;+EAE2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiF;IAC1G,OAAO,CAAC,SAAS,CAAS;gBAEG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAmB,OAAO,GAAE,gBAAqB;IAMpG,OAAO,CAAC,GAAG;IAEX,OAAO,CAAC,MAAM;IAUd,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,GAAG,SAAS;IAItE,cAAc,IAAI,MAAM;IAMxB;qFACiF;IACjF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKxF,OAAO,CAAC,YAAY;IAOpB;;mEAE+D;YACjD,WAAW;IAiBzB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;YAItD,KAAK;IAoDnB,OAAO,CAAC,UAAU;IAWlB,iFAAiF;IACjF,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,gBAAgB;IAqBxB,4EAA4E;IAC5E,OAAO,CAAC,cAAc;IAKtB,0EAA0E;IAC1E,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;YAaL,OAAO;YA0BP,WAAW;YA2BX,cAAc;IAkC5B;;;;;OAKG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchD;;;;;OAKG;YACW,MAAM;YAoDN,MAAM;IA6DpB,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IA2B9D;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAavB,4EAA4E;IAC5E,eAAe,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,IAAI;IAgCzD,QAAQ,IAAI,kBAAkB;IAe9B,0FAA0F;IAC1F,uBAAuB,IAAI,mBAAmB,CAAC,CAAC,CAAC,EAAE;IAInD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,OAAO;IAEf,OAAO,CAAC,KAAK;CAWd"}