@a5c-ai/agent-comm-mux 5.0.1-staging.04ca6ab00d21

package/dist/remote-runner.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Retry policy defaults for @a5c-ai/agent-mux.
+ */
+import type { RetryPolicy } from './types.js';
+/** The fully-resolved retry policy with all defaults applied. */
+export type ResolvedRetryPolicy = Required<RetryPolicy>;
+/**
+ * The default retry policy used when no custom policy is specified.
+ * Frozen to prevent accidental mutation.
+ *
+ * @see 01-core-types-and-client.md §5.1.1
+ */
+export declare const DEFAULT_RETRY_POLICY: Readonly<ResolvedRetryPolicy>;

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,mBAAmB,CAM7D,CAAC"}

package/dist/retry.js

@@ -0,0 +1,17 @@
+/**
+ * Retry policy defaults for @a5c-ai/agent-mux.
+ */
+/**
+ * The default retry policy used when no custom policy is specified.
+ * Frozen to prevent accidental mutation.
+ *
+ * @see 01-core-types-and-client.md §5.1.1
+ */
+export const DEFAULT_RETRY_POLICY = Object.freeze({
+    maxAttempts: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30_000,
+    jitterFactor: 0.1,
+    retryOn: Object.freeze(['RATE_LIMITED', 'AGENT_CRASH', 'TIMEOUT']),
+});
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAkC,MAAM,CAAC,MAAM,CAAC;IAC/E,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,GAAG;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,aAAa,EAAE,SAAS,CAAC,CAAgB;CAClF,CAAC,CAAC"}

package/dist/run-handle-cost.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Cost / token accumulation helpers for RunHandleImpl.
+ *
+ * Pure functions extracted so the main run-handle implementation stays
+ * focused on orchestration (state machine, iterators, thenable). No behavior
+ * change — these are the exact mutations previously inlined in
+ * RunHandleImpl._accumulate and RunHandleImpl._buildResult.
+ */
+import type { CostEvent, TokenUsageEvent } from './events.js';
+import type { TokenUsageSummary } from './run-handle.js';
+export interface CostAccumulator {
+    totalUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    thinkingTokens: number;
+    cachedTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+}
+export interface TokenAccumulator {
+    inputTokens: number;
+    outputTokens: number;
+    thinkingTokens: number;
+    cachedTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+}
+/** Fold a `token_usage` event into the running accumulator. */
+export declare function accumulateTokenUsage(acc: TokenAccumulator, event: TokenUsageEvent): void;
+/**
+ * Fold a `cost` event into the running accumulator. Returns the new
+ * accumulator (which may be a freshly allocated record on the first call).
+ */
+export declare function accumulateCost(current: CostAccumulator | null, event: CostEvent): CostAccumulator;
+/** Build the token usage summary, or null when no usage was seen. */
+export declare function buildTokenUsageSummary(acc: TokenAccumulator): TokenUsageSummary | null;

package/dist/run-handle-cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-handle-cost.d.ts","sourceRoot":"","sources":["../src/run-handle-cost.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAc,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAOxF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,eAAe,CAqBjG;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,IAAI,CActF"}

package/dist/run-handle-cost.js

@@ -0,0 +1,62 @@
+/**
+ * Cost / token accumulation helpers for RunHandleImpl.
+ *
+ * Pure functions extracted so the main run-handle implementation stays
+ * focused on orchestration (state machine, iterators, thenable). No behavior
+ * change — these are the exact mutations previously inlined in
+ * RunHandleImpl._accumulate and RunHandleImpl._buildResult.
+ */
+/** Fold a `token_usage` event into the running accumulator. */
+export function accumulateTokenUsage(acc, event) {
+    acc.inputTokens += event.inputTokens;
+    acc.outputTokens += event.outputTokens;
+    if (event.thinkingTokens)
+        acc.thinkingTokens += event.thinkingTokens;
+    if (event.cachedTokens)
+        acc.cachedTokens += event.cachedTokens;
+    // Note: TokenUsageEvent doesn't have granular cache fields yet, so we
+    // accumulate them from CostEvents instead for now
+}
+/**
+ * Fold a `cost` event into the running accumulator. Returns the new
+ * accumulator (which may be a freshly allocated record on the first call).
+ */
+export function accumulateCost(current, event) {
+    const c = event.cost;
+    if (current === null) {
+        return {
+            totalUsd: c.totalUsd,
+            inputTokens: c.inputTokens,
+            outputTokens: c.outputTokens,
+            thinkingTokens: c.thinkingTokens ?? 0,
+            cachedTokens: c.cachedTokens ?? 0,
+            cacheCreationTokens: c.cacheCreationTokens ?? 0,
+            cacheReadTokens: c.cacheReadTokens ?? 0,
+        };
+    }
+    current.totalUsd += c.totalUsd;
+    current.inputTokens += c.inputTokens;
+    current.outputTokens += c.outputTokens;
+    current.thinkingTokens += c.thinkingTokens ?? 0;
+    current.cachedTokens += c.cachedTokens ?? 0;
+    current.cacheCreationTokens += c.cacheCreationTokens ?? 0;
+    current.cacheReadTokens += c.cacheReadTokens ?? 0;
+    return current;
+}
+/** Build the token usage summary, or null when no usage was seen. */
+export function buildTokenUsageSummary(acc) {
+    const hasUsage = acc.inputTokens > 0 ||
+        acc.outputTokens > 0 ||
+        acc.thinkingTokens > 0 ||
+        acc.cachedTokens > 0;
+    if (!hasUsage)
+        return null;
+    return {
+        inputTokens: acc.inputTokens,
+        outputTokens: acc.outputTokens,
+        thinkingTokens: acc.thinkingTokens,
+        cachedTokens: acc.cachedTokens,
+        totalTokens: acc.inputTokens + acc.outputTokens + acc.thinkingTokens,
+    };
+}
+//# sourceMappingURL=run-handle-cost.js.map

package/dist/run-handle-cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-handle-cost.js","sourceRoot":"","sources":["../src/run-handle-cost.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,+DAA+D;AAC/D,MAAM,UAAU,oBAAoB,CAAC,GAAqB,EAAE,KAAsB;IAChF,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;IACrC,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;IACvC,IAAI,KAAK,CAAC,cAAc;QAAE,GAAG,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,CAAC;IACrE,IAAI,KAAK,CAAC,YAAY;QAAE,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;IAC/D,sEAAsE;IACtE,kDAAkD;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAA+B,EAAE,KAAgB;IAC9E,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;IACrB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO;YACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,CAAC;YACrC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC;YACjC,mBAAmB,EAAE,CAAC,CAAC,mBAAmB,IAAI,CAAC;YAC/C,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,CAAC;SACxC,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC/B,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC;IACrC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC;IACvC,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,MAAM,QAAQ,GACZ,GAAG,CAAC,WAAW,GAAG,CAAC;QACnB,GAAG,CAAC,YAAY,GAAG,CAAC;QACpB,GAAG,CAAC,cAAc,GAAG,CAAC;QACtB,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,WAAW,EAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,cAAc;KACrE,CAAC;AACJ,CAAC"}

package/dist/run-handle-impl.d.ts

@@ -0,0 +1,144 @@
+/**
+ * RunHandleImpl — concrete implementation of RunHandle.
+ *
+ * Implements:
+ * - Typed EventEmitter dispatch with per-type handler maps
+ * - AsyncIterator fan-out with shared replay buffer (high-water-mark bounded)
+ * - State machine (via state-machine.ts)
+ * - Thenable contract (lazy internal promise, resolves to RunResult)
+ * - Control method guards (RUN_NOT_ACTIVE, INVALID_STATE_TRANSITION)
+ * - Interaction channel wiring
+ */
+import type { AgentName } from './types.js';
+import type { AgentEvent, AgentEventType, EventOfType } from './events.js';
+import type { DeferredPromptOptions, RunHandle, RunResult } from './run-handle.js';
+import type { InteractionResponse } from './interaction.js';
+import { type RunState } from './state-machine.js';
+import { InteractionChannelImpl } from './interaction-channel-impl.js';
+/** Options for constructing a RunHandleImpl. */
+export interface RunHandleImplOptions {
+    readonly runId: string;
+    readonly agent: AgentName;
+    readonly model?: string;
+    /** Approval mode for the interaction channel. */
+    readonly approvalMode?: 'yolo' | 'prompt' | 'deny';
+    /** Maximum number of events to buffer for late async iterators. */
+    readonly bufferHighWaterMark?: number;
+    /** Whether to collect all events in RunResult.events. */
+    readonly collectEvents?: boolean;
+    /** Tags echoed back in RunResult. */
+    readonly tags?: string[];
+}
+export declare class RunHandleImpl implements RunHandle {
+    readonly runId: string;
+    readonly agent: AgentName;
+    readonly model: string | undefined;
+    private _state;
+    /** Map from event type -> array of handlers. */
+    private readonly _handlers;
+    /** Shared ordered buffer of all events emitted so far. */
+    private readonly _buffer;
+    /** Per-iterator tracking state. */
+    private readonly _iterators;
+    /** When true, the run has ended and all iterators should drain and stop. */
+    private _done;
+    /** High-water mark for the buffer. */
+    private readonly _hwm;
+    private _resultPromise;
+    private _resolveResult;
+    /** Queued result if complete() is called before the promise is created. */
+    private _pendingResult;
+    private _text;
+    private _sessionId;
+    private _cost;
+    private _startTime;
+    private _tokenUsage;
+    private _turnCount;
+    private _exitCode;
+    private _signal;
+    private _runError;
+    private _collectedEvents;
+    private readonly _collectEvents;
+    private readonly _tags;
+    readonly interaction: InteractionChannelImpl;
+    /** Logger instance for this run. */
+    private readonly logger;
+    /** OpenTelemetry span for this run. */
+    private readonly _runSpan;
+    /** Map of active tool call spans by toolCallId. */
+    private readonly _toolSpans;
+    /** Map of active subagent spans by subagentId. */
+    private readonly _subagentSpans;
+    /** Bound runtime input transport used by send()/queue()/steer(). */
+    private _inputTransport;
+    /** Bound interaction response transport used by approval/input dispatch. */
+    private _interactionTransport;
+    /** Deferred prompts waiting for a matching run boundary. */
+    private readonly _deferredPrompts;
+    /** Serializes deferred prompt delivery. */
+    private _deferredDeliveryChain;
+    /** Monotonic counter for deferred prompt bookkeeping. */
+    private _deferredPromptSeq;
+    constructor(options: RunHandleImplOptions);
+    /** Current run state. */
+    get state(): RunState;
+    /**
+     * Transition to a new state.
+     * Validates the transition and updates the internal state.
+     * Does NOT emit a state-change event — callers should emit the appropriate event then call this.
+     */
+    transitionTo(next: RunState): void;
+    /**
+     * Emit an event. Called by the adapter or test harness.
+     *
+     * 1. Accumulates relevant fields (text, token usage, cost, session ID).
+     * 2. Appends to the shared buffer (with HWM enforcement).
+     * 3. Wakes up waiting async iterators.
+     * 4. Dispatches to registered EventEmitter handlers.
+     */
+    emit(event: AgentEvent): void;
+    /**
+     * Log important events for observability.
+     */
+    private _logEvent;
+    /**
+     * Signal that the run has ended with the given exit information.
+     * Resolves the result promise and terminates all async iterators.
+     */
+    complete(exitReason: RunResult['exitReason'], exitCode: number | null, signal: string | null): void;
+    [Symbol.asyncIterator](): AsyncIterator<AgentEvent>;
+    on<T extends AgentEventType>(type: T, handler: (event: EventOfType<T>) => void): this;
+    off<T extends AgentEventType>(type: T, handler: (event: EventOfType<T>) => void): this;
+    once<T extends AgentEventType>(type: T, handler: (event: EventOfType<T>) => void): this;
+    /** Lazily create the result promise per spec §2. */
+    private _ensureResultPromise;
+    get then(): Promise<RunResult>['then'];
+    get catch(): Promise<RunResult>['catch'];
+    get finally(): Promise<RunResult>['finally'];
+    result(): Promise<RunResult>;
+    /** @internal Bind the active runtime input transport. */
+    bindInputTransport(writer: (text: string) => Promise<void>): void;
+    /** @internal Bind the active runtime interaction transport. */
+    bindInteractionTransport(writer: (id: string, response: InteractionResponse) => Promise<void>): void;
+    send(text: string): Promise<void>;
+    queue(prompt: string, options?: DeferredPromptOptions): Promise<void>;
+    approve(detail?: string): Promise<void>;
+    deny(reason?: string): Promise<void>;
+    continue(prompt: string): Promise<void>;
+    steer(prompt: string, options?: DeferredPromptOptions): Promise<void>;
+    interrupt(): Promise<void>;
+    abort(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    private _assertActive;
+    private _accumulate;
+    private _dispatchHandlers;
+    /** Emit a debug event without recursing through _dispatchHandlers for debug handlers. */
+    private _emitDebugEvent;
+    private _buildResult;
+    private _handleInteractionResponse;
+    private _sendNow;
+    private _enqueueDeferredPrompt;
+    private _triggerDeferredPromptDelivery;
+    private _boundariesForEvent;
+}

package/dist/run-handle-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-handle-impl.d.ts","sourceRoot":"","sources":["../src/run-handle-impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EACV,qBAAqB,EAErB,SAAS,EACT,SAAS,EAGV,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAsB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGhF,OAAO,EAAE,KAAK,QAAQ,EAAgC,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAgBvE,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnD,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AA4BD,qBAAa,aAAc,YAAW,SAAS;IAG7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAInC,OAAO,CAAC,MAAM,CAAuB;IAIrC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsD;IAIhF,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAE5D,4EAA4E;IAC5E,OAAO,CAAC,KAAK,CAAS;IAEtB,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAI9B,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,cAAc,CAA8C;IACpE,2EAA2E;IAC3E,OAAO,CAAC,cAAc,CAA0B;IAIhD,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,WAAW,CAAyI;IAC5J,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IAIjC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAE7C,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAM;IAE7B,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAO;IAEhC,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAEtD,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAE1D,oEAAoE;IACpE,OAAO,CAAC,eAAe,CAAkD;IAEzE,4EAA4E;IAC5E,OAAO,CAAC,qBAAqB,CAA+E;IAE5G,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwB;IAEzD,2CAA2C;IAC3C,OAAO,CAAC,sBAAsB,CAAoC;IAElE,yDAAyD;IACzD,OAAO,CAAC,kBAAkB,CAAK;gBAInB,OAAO,EAAE,oBAAoB;IAyBzC,yBAAyB;IACzB,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAOlC;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAoD7B;;OAEG;IACH,OAAO,CAAC,SAAS;IA0IjB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IA+DnG,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC;IAsCnD,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAOrF,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAQtF,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAUvF,oDAAoD;IACpD,OAAO,CAAC,oBAAoB;IAc5B,IAAI,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAGrC;IAED,IAAI,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAGvC;IAED,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAG3C;IAED,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAI5B,yDAAyD;IACzD,kBAAkB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIjE,+DAA+D;IAC/D,wBAAwB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAM9F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;IA0CnB,OAAO,CAAC,iBAAiB;IAkBzB,yFAAyF;IACzF,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,YAAY;YAsBN,0BAA0B;YAQ1B,QAAQ;YAQR,sBAAsB;IAqBpC,OAAO,CAAC,8BAA8B;IAkCtC,OAAO,CAAC,mBAAmB;CAa5B"}