agent-inbox 0.0.1 → 0.1.1

package/dist/federation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/federation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/federation/index.js

@@ -0,0 +1,6 @@
+export { parseAddress, formatAddress, isRemoteAddress, isBroadcastAddress } from "./address.js";
+export { ConnectionManager } from "./connection-manager.js";
+export { DeliveryQueue } from "./delivery-queue.js";
+export { RoutingEngine } from "./routing-engine.js";
+export { TrustManager } from "./trust.js";
+//# sourceMappingURL=index.js.map

package/dist/federation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/federation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/federation/routing-engine.d.ts

@@ -0,0 +1,74 @@
+import { EventEmitter } from "node:events";
+import type { FederatedAddress, FederationRoutingConfig, RoutingEntry, WarmAgentStatus } from "../types.js";
+/**
+ * Federation routing engine with configurable strategies.
+ *
+ * - table: In-memory routing table populated from federation exposure data
+ * - broadcast: Forward to all peers, first responder wins
+ * - hierarchical: Local table first, then delegate to upstream hubs
+ */
+export declare class RoutingEngine {
+    private events;
+    private table;
+    private config;
+    constructor(events: EventEmitter, config?: Partial<FederationRoutingConfig>);
+    /**
+     * Resolve a federated address to a peer system ID.
+     * Returns null if no route found.
+     */
+    resolveRoute(addr: FederatedAddress): string | null;
+    /**
+     * Look up an agent in the routing table.
+     * Respects TTL — expired entries are not returned.
+     */
+    lookupAgent(agentId: string): string | null;
+    /**
+     * Update the routing table with exposure data from a peer.
+     * Called when federation/connect completes or peer sends updates.
+     */
+    updateFromExposure(peerId: string, agents: Array<{
+        agentId: string;
+        status?: WarmAgentStatus;
+    }>): void;
+    /**
+     * Update status for a specific agent in the routing table.
+     */
+    updateAgentStatus(agentId: string, status: WarmAgentStatus): void;
+    /**
+     * Remove all routing entries for a peer (e.g., on disconnect).
+     */
+    removePeer(peerId: string): number;
+    /**
+     * Get all known peers from the routing table.
+     */
+    knownPeers(): string[];
+    /**
+     * Get all routing entries (for debugging/inspection).
+     */
+    getTable(): RoutingEntry[];
+    /**
+     * Get the routing strategy in use.
+     */
+    getStrategy(): FederationRoutingConfig["strategy"];
+    /**
+     * Get configured upstream hubs (for hierarchical strategy).
+     */
+    getUpstream(): string[];
+    /**
+     * Whether to query peers on cache miss (for table strategy).
+     */
+    shouldRefreshOnMiss(): boolean;
+    /**
+     * Get broadcast timeout (for broadcast strategy).
+     */
+    getBroadcastTimeout(): number;
+    /**
+     * Clean expired entries from the routing table.
+     */
+    cleanup(): number;
+    /**
+     * Clear all state.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=routing-engine.d.ts.map

package/dist/federation/routing-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-engine.d.ts","sourceRoot":"","sources":["../../src/federation/routing-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,eAAe,EAChB,MAAM,aAAa,CAAC;AASrB;;;;;;GAMG;AACH,qBAAa,aAAa;IAKtB,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,MAAM,CAA0B;gBAG9B,MAAM,EAAE,YAAY,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAK3C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI;IAcnD;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiB3C;;;OAGG;IACH,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,CAAA;KAAE,CAAC,GAC3D,IAAI;IAaP;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAQjE;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAWlC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAQtB;;OAEG;IACH,QAAQ,IAAI,YAAY,EAAE;IAI1B;;OAEG;IACH,WAAW,IAAI,uBAAuB,CAAC,UAAU,CAAC;IAIlD;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,OAAO,IAAI,MAAM;IAejB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/federation/routing-engine.js

@@ -0,0 +1,158 @@
+const DEFAULT_CONFIG = {
+    strategy: "table",
+    tableTTL: 300_000, // 5 minutes
+    refreshOnMiss: true,
+    broadcastTimeout: 5_000,
+};
+/**
+ * Federation routing engine with configurable strategies.
+ *
+ * - table: In-memory routing table populated from federation exposure data
+ * - broadcast: Forward to all peers, first responder wins
+ * - hierarchical: Local table first, then delegate to upstream hubs
+ */
+export class RoutingEngine {
+    events;
+    table = new Map();
+    config;
+    constructor(events, config) {
+        this.events = events;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Resolve a federated address to a peer system ID.
+     * Returns null if no route found.
+     */
+    resolveRoute(addr) {
+        // If the address specifies a system directly, use it
+        if (addr.system) {
+            return addr.system;
+        }
+        // Otherwise, look up the agent in the routing table
+        if (addr.agent) {
+            return this.lookupAgent(addr.agent);
+        }
+        return null;
+    }
+    /**
+     * Look up an agent in the routing table.
+     * Respects TTL — expired entries are not returned.
+     */
+    lookupAgent(agentId) {
+        const entry = this.table.get(agentId);
+        if (!entry)
+            return null;
+        // Check TTL
+        const age = Date.now() - new Date(entry.lastSeen).getTime();
+        if (age > (this.config.tableTTL ?? DEFAULT_CONFIG.tableTTL)) {
+            this.table.delete(agentId);
+            return null;
+        }
+        // Only route to active or away agents
+        if (entry.status === "expired")
+            return null;
+        return entry.peerId;
+    }
+    /**
+     * Update the routing table with exposure data from a peer.
+     * Called when federation/connect completes or peer sends updates.
+     */
+    updateFromExposure(peerId, agents) {
+        const now = new Date().toISOString();
+        for (const agent of agents) {
+            this.table.set(agent.agentId, {
+                agentId: agent.agentId,
+                peerId,
+                lastSeen: now,
+                status: agent.status ?? "active",
+            });
+        }
+        this.events.emit("routing.updated", { peerId, agentCount: agents.length });
+    }
+    /**
+     * Update status for a specific agent in the routing table.
+     */
+    updateAgentStatus(agentId, status) {
+        const entry = this.table.get(agentId);
+        if (entry) {
+            entry.status = status;
+            entry.lastSeen = new Date().toISOString();
+        }
+    }
+    /**
+     * Remove all routing entries for a peer (e.g., on disconnect).
+     */
+    removePeer(peerId) {
+        let removed = 0;
+        for (const [agentId, entry] of this.table.entries()) {
+            if (entry.peerId === peerId) {
+                this.table.delete(agentId);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Get all known peers from the routing table.
+     */
+    knownPeers() {
+        const peers = new Set();
+        for (const entry of this.table.values()) {
+            peers.add(entry.peerId);
+        }
+        return Array.from(peers);
+    }
+    /**
+     * Get all routing entries (for debugging/inspection).
+     */
+    getTable() {
+        return Array.from(this.table.values());
+    }
+    /**
+     * Get the routing strategy in use.
+     */
+    getStrategy() {
+        return this.config.strategy;
+    }
+    /**
+     * Get configured upstream hubs (for hierarchical strategy).
+     */
+    getUpstream() {
+        return this.config.upstream ?? [];
+    }
+    /**
+     * Whether to query peers on cache miss (for table strategy).
+     */
+    shouldRefreshOnMiss() {
+        return this.config.refreshOnMiss ?? true;
+    }
+    /**
+     * Get broadcast timeout (for broadcast strategy).
+     */
+    getBroadcastTimeout() {
+        return this.config.broadcastTimeout ?? 5_000;
+    }
+    /**
+     * Clean expired entries from the routing table.
+     */
+    cleanup() {
+        const ttl = this.config.tableTTL ?? DEFAULT_CONFIG.tableTTL;
+        const now = Date.now();
+        let removed = 0;
+        for (const [agentId, entry] of this.table.entries()) {
+            const age = now - new Date(entry.lastSeen).getTime();
+            if (age > ttl) {
+                this.table.delete(agentId);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Clear all state.
+     */
+    destroy() {
+        this.table.clear();
+    }
+}
+//# sourceMappingURL=routing-engine.js.map

package/dist/federation/routing-engine.js.map

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

package/dist/federation/trust.d.ts

@@ -0,0 +1,39 @@
+import type { FederationTrustPolicy } from "../types.js";
+/**
+ * Federation trust enforcement.
+ *
+ * Layer 1 (implemented): Server allow-list
+ * Layer 2 (stub): Scope-based permissions
+ * Layer 3 (stub): Token-based auth
+ */
+export declare class TrustManager {
+    private policy;
+    constructor(policy?: Partial<FederationTrustPolicy>);
+    /**
+     * Check if a system is allowed to connect (Layer 1).
+     * If allowedServers is empty, all servers are allowed (open federation).
+     */
+    canConnect(systemId: string): boolean;
+    /**
+     * Check if routing from a remote system to a local scope is allowed (Layer 2 — stub).
+     * Currently always returns true.
+     */
+    canRoute(fromSystem: string, toScope: string): boolean;
+    /**
+     * Validate authentication credentials for a system (Layer 3 — stub).
+     * Currently always returns true unless requireAuth is explicitly set.
+     */
+    validateAuth(systemId: string, _credentials?: {
+        method?: string;
+        token?: string;
+    }): boolean;
+    /**
+     * Update the trust policy at runtime.
+     */
+    updatePolicy(updates: Partial<FederationTrustPolicy>): void;
+    /**
+     * Get current policy (for inspection/debugging).
+     */
+    getPolicy(): Readonly<FederationTrustPolicy>;
+}
+//# sourceMappingURL=trust.d.ts.map

package/dist/federation/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../src/federation/trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQzD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAInD;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKrC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAOtD;;;OAGG;IACH,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO;IAQV;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,qBAAqB,CAAC;CAG7C"}

package/dist/federation/trust.js

@@ -0,0 +1,64 @@
+const DEFAULT_POLICY = {
+    allowedServers: [],
+    scopePermissions: {},
+    requireAuth: false,
+};
+/**
+ * Federation trust enforcement.
+ *
+ * Layer 1 (implemented): Server allow-list
+ * Layer 2 (stub): Scope-based permissions
+ * Layer 3 (stub): Token-based auth
+ */
+export class TrustManager {
+    policy;
+    constructor(policy) {
+        this.policy = { ...DEFAULT_POLICY, ...policy };
+    }
+    /**
+     * Check if a system is allowed to connect (Layer 1).
+     * If allowedServers is empty, all servers are allowed (open federation).
+     */
+    canConnect(systemId) {
+        if (this.policy.allowedServers.length === 0)
+            return true;
+        return this.policy.allowedServers.includes(systemId);
+    }
+    /**
+     * Check if routing from a remote system to a local scope is allowed (Layer 2 — stub).
+     * Currently always returns true.
+     */
+    canRoute(fromSystem, toScope) {
+        // Stub: check scope permissions when implemented
+        const allowed = this.policy.scopePermissions[toScope];
+        if (!allowed)
+            return true; // No restrictions defined = allow all
+        return allowed.includes(fromSystem);
+    }
+    /**
+     * Validate authentication credentials for a system (Layer 3 — stub).
+     * Currently always returns true unless requireAuth is explicitly set.
+     */
+    validateAuth(systemId, _credentials) {
+        if (!this.policy.requireAuth)
+            return true;
+        // Stub: when implemented, validate credentials against authTokens
+        const expectedToken = this.policy.authTokens?.[systemId];
+        if (!expectedToken)
+            return true; // No token configured = allow
+        return _credentials?.token === expectedToken;
+    }
+    /**
+     * Update the trust policy at runtime.
+     */
+    updatePolicy(updates) {
+        Object.assign(this.policy, updates);
+    }
+    /**
+     * Get current policy (for inspection/debugging).
+     */
+    getPolicy() {
+        return this.policy;
+    }
+}
+//# sourceMappingURL=trust.js.map

package/dist/federation/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/federation/trust.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAA0B;IAC5C,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,EAAE;IACpB,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAwB;IAEtC,YAAY,MAAuC;QACjD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,QAAgB;QACzB,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,UAAkB,EAAE,OAAe;QAC1C,iDAAiD;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,CAAC,sCAAsC;QACjE,OAAO,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,YAAY,CACV,QAAgB,EAChB,YAAkD;QAElD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC1C,kEAAkE;QAClE,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,CAAC,8BAA8B;QAC/D,OAAO,YAAY,EAAE,KAAK,KAAK,aAAa,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAuC;QAClD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,2 +1,60 @@
-
-export {  }
+import { EventEmitter } from "node:events";
+import { MessageRouter } from "./router/message-router.js";
+import { TraceabilityLayer } from "./traceability/traceability.js";
+import { IpcServer } from "./ipc/ipc-server.js";
+import { MapClient } from "./map/map-client.js";
+import { MailJsonRpcServer } from "./jsonrpc/mail-server.js";
+import { PushNotifier } from "./push/notifier.js";
+import { ConnectionManager } from "./federation/connection-manager.js";
+import { WarmRegistry } from "./registry/warm-registry.js";
+import type { InboxConfig } from "./types.js";
+import type { Storage } from "./storage/interface.js";
+export { InMemoryStorage } from "./storage/memory.js";
+export { SqliteStorage } from "./storage/sqlite.js";
+export { MessageRouter, normalizeContent } from "./router/message-router.js";
+export { TraceabilityLayer } from "./traceability/traceability.js";
+export { IpcServer } from "./ipc/ipc-server.js";
+export { MapClient } from "./map/map-client.js";
+export { InboxMcpServer } from "./mcp/mcp-server.js";
+export { MailJsonRpcServer } from "./jsonrpc/mail-server.js";
+export { PushNotifier, formatInboxMarkdown } from "./push/notifier.js";
+export { ConnectionManager } from "./federation/connection-manager.js";
+export type { DeliveryResult, IncomingMessageHandler } from "./federation/connection-manager.js";
+export type { MapConnection, MapAgentConnectionClass, IncomingMapMessage } from "./map/map-client.js";
+export { WarmRegistry } from "./registry/warm-registry.js";
+export { RoutingEngine } from "./federation/routing-engine.js";
+export { DeliveryQueue } from "./federation/delivery-queue.js";
+export { TrustManager } from "./federation/trust.js";
+export { parseAddress, formatAddress, isRemoteAddress, isBroadcastAddress, } from "./federation/address.js";
+export type * from "./types.js";
+export type { Storage, InboxQuery, ThreadQuery } from "./storage/interface.js";
+export interface AgentInbox {
+    storage: Storage;
+    router: MessageRouter;
+    traceability: TraceabilityLayer;
+    ipcServer: IpcServer;
+    mapClient: MapClient;
+    jsonRpc: MailJsonRpcServer;
+    notifier: PushNotifier;
+    federation: ConnectionManager | null;
+    registry: WarmRegistry | null;
+    events: EventEmitter;
+    stop(): Promise<void>;
+}
+export interface CreateOptions {
+    config?: Partial<InboxConfig>;
+    /** Use SQLite storage at this path (":memory:" for in-memory SQLite) */
+    sqlitePath?: string;
+    /** HTTP port for JSON-RPC endpoint (0 = disabled) */
+    httpPort?: number;
+    /** Webhook URLs for push notifications */
+    webhooks?: string[];
+    /** Enable federation with peer systems */
+    enableFederation?: boolean;
+    /** Use an externally-managed MAP connection instead of creating one.
+     *  When provided, Agent Inbox borrows this connection for messaging
+     *  but does not own its lifecycle (won't disconnect it on stop()). */
+    connection?: import("./map/map-client.js").MapConnection;
+}
+export declare function createAgentInbox(opts?: CreateOptions): Promise<AgentInbox>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,mBAAmB,YAAY,CAAC;AAChC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAmC/E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,iBAAiB,CAAC;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;0EAEsE;IACtE,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,aAAa,CAAC;CAC1D;AAED,wBAAsB,gBAAgB,CACpC,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,UAAU,CAAC,CA2IrB"}