@kadi.build/core 0.0.1-alpha.1 → 0.0.1-alpha.10

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Errors Module
+ *
+ * Re-exports error types and utilities from types/errors.ts
+ * This module provides a convenient import point for error handling.
+ */
+export { KadiError, ErrorCode, isKadiError, isError, success, failure } from '../types/errors.js';
+export type { ErrorContext, ErrorJSON, Result } from '../types/errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACR,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,YAAY,EACZ,SAAS,EACT,MAAM,EACP,MAAM,oBAAoB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,8 @@
+/**
+ * Errors Module
+ *
+ * Re-exports error types and utilities from types/errors.ts
+ * This module provides a convenient import point for error handling.
+ */
+export { KadiError, ErrorCode, isKadiError, isError, success, failure } from '../types/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACR,MAAM,oBAAoB,CAAC"}

package/dist/events/EventHub.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Event Hub
+ *
+ * Unified pub/sub event system that works consistently across all transports.
+ * Supports wildcard pattern matching for flexible event subscriptions.
+ *
+ * @module events/EventHub
+ */
+import type { EventPattern, EventName, EventCallback, UnsubscribeFunction, PublishOptions, EventSubscription, SubscriptionOptions } from '../types/index.js';
+/**
+ * Event Hub class
+ *
+ * Single responsibility: Manage event subscriptions and publication.
+ * Works uniformly across all transport types (native, stdio, broker).
+ *
+ * @example
+ * ```typescript
+ * const hub = new EventHub('my-agent');
+ *
+ * // Subscribe to events
+ * const unsubscribe = hub.subscribe('user.*', (data) => {
+ *   console.log('User event:', data);
+ * });
+ *
+ * // Publish an event
+ * hub.publish('user.login', { userId: '123', timestamp: Date.now() });
+ *
+ * // Unsubscribe
+ * unsubscribe();
+ * ```
+ */
+export declare class EventHub {
+    /**
+     * Source identifier (agent/ability name)
+     */
+    private source;
+    /**
+     * Event subscriptions map (pattern -> Set of callbacks)
+     * Uses unknown for data type since different subscriptions may have different data types
+     */
+    private readonly subscriptions;
+    /**
+     * Subscription ID counter
+     */
+    private subscriptionIdCounter;
+    /**
+     * Create a new EventHub
+     *
+     * @param source - Identifier for this event source (agent/ability name)
+     */
+    constructor(source: string);
+    /**
+     * Update the source identifier
+     *
+     * This is useful when the agent/ability name is determined after construction.
+     *
+     * @param newSource - New source identifier
+     */
+    setSource(newSource: string): void;
+    /**
+     * Subscribe to events matching a pattern
+     *
+     * Patterns support wildcards:
+     * - `user.login` - exact match
+     * - `user.*` - all events starting with "user."
+     * - `*.error` - all error events
+     * - `*` - all events
+     *
+     * @template TData - Expected event data type
+     *
+     * @param pattern - Event pattern to match
+     * @param callback - Function to call when matching events occur
+     * @param options - Optional subscription options
+     * @returns Function to unsubscribe
+     *
+     * @throws {KadiError} If pattern or callback is invalid
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = hub.subscribe('user.login', (data) => {
+     *   console.log('User logged in:', data);
+     * });
+     * ```
+     */
+    subscribe<TData = unknown>(pattern: EventPattern, callback: EventCallback<TData>, options?: SubscriptionOptions): UnsubscribeFunction;
+    /**
+     * Publish an event to all matching subscribers
+     *
+     * @template TData - Event data type
+     *
+     * @param eventName - Event name/channel
+     * @param data - Event data payload
+     * @param options - Optional publishing options
+     *
+     * @example
+     * ```typescript
+     * hub.publish('user.logout', {
+     *   userId: '123',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    publish<TData = unknown>(eventName: EventName, data: TData, options?: PublishOptions): void;
+    /**
+     * Unsubscribe from a pattern
+     *
+     * @param pattern - Pattern to unsubscribe from
+     * @param callback - Optional specific callback to remove (removes all if not specified)
+     *
+     * @example
+     * ```typescript
+     * hub.unsubscribe('user.*');
+     * ```
+     */
+    unsubscribe(pattern: EventPattern, callback?: EventCallback): void;
+    /**
+     * Get all active subscriptions
+     *
+     * @returns Array of all active subscriptions
+     */
+    getSubscriptions(): EventSubscription[];
+    /**
+     * Get subscription count
+     *
+     * @returns Number of active subscriptions
+     */
+    get subscriptionCount(): number;
+    /**
+     * Clear all subscriptions
+     *
+     * @example
+     * ```typescript
+     * hub.clear();
+     * ```
+     */
+    clear(): void;
+    /**
+     * Find subscriptions matching an event name
+     *
+     * @param eventName - Event name to match
+     * @returns Set of matching subscriptions
+     */
+    private findMatchingSubscriptions;
+    /**
+     * Check if an event name matches a pattern
+     *
+     * Supports wildcard matching:
+     * - Exact match: 'user.login' matches 'user.login'
+     * - Prefix wildcard: 'user.*' matches 'user.login', 'user.logout', etc.
+     * - Suffix wildcard: '*.error' matches 'user.error', 'system.error', etc.
+     * - Full wildcard: '*' matches any event
+     *
+     * @param eventName - Event name to test
+     * @param pattern - Pattern to match against
+     * @returns true if event matches pattern
+     */
+    private matchesPattern;
+    /**
+     * Deliver an event to a subscription
+     *
+     * @param subscription - Subscription to deliver to
+     * @param payload - Event payload
+     */
+    private deliverEvent;
+    /**
+     * Unsubscribe by subscription ID
+     *
+     * @param id - Subscription ID to remove
+     */
+    private unsubscribeById;
+}
+//# sourceMappingURL=EventHub.d.ts.map

package/dist/events/EventHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventHub.d.ts","sourceRoot":"","sources":["../../src/events/EventHub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EAEb,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,QAAQ;IACnB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4D;IAE1F;;OAEG;IACH,OAAO,CAAC,qBAAqB,CAAK;IAElC;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,KAAK,GAAG,OAAO,EACvB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,mBAAmB;IA2DtB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,KAAK,GAAG,OAAO,EACrB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI;IAsBP;;;;;;;;;;OAUG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI;IAwBlE;;;;OAIG;IACH,gBAAgB,IAAI,iBAAiB,EAAE;IAQvC;;;;OAIG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAM9B;IAED;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAaxB"}

package/dist/events/EventHub.js

@@ -0,0 +1,333 @@
+/**
+ * Event Hub
+ *
+ * Unified pub/sub event system that works consistently across all transports.
+ * Supports wildcard pattern matching for flexible event subscriptions.
+ *
+ * @module events/EventHub
+ */
+import { KadiError, ErrorCode } from '../types/index.js';
+/**
+ * Event Hub class
+ *
+ * Single responsibility: Manage event subscriptions and publication.
+ * Works uniformly across all transport types (native, stdio, broker).
+ *
+ * @example
+ * ```typescript
+ * const hub = new EventHub('my-agent');
+ *
+ * // Subscribe to events
+ * const unsubscribe = hub.subscribe('user.*', (data) => {
+ *   console.log('User event:', data);
+ * });
+ *
+ * // Publish an event
+ * hub.publish('user.login', { userId: '123', timestamp: Date.now() });
+ *
+ * // Unsubscribe
+ * unsubscribe();
+ * ```
+ */
+export class EventHub {
+    /**
+     * Source identifier (agent/ability name)
+     */
+    source;
+    /**
+     * Event subscriptions map (pattern -> Set of callbacks)
+     * Uses unknown for data type since different subscriptions may have different data types
+     */
+    subscriptions = new Map();
+    /**
+     * Subscription ID counter
+     */
+    subscriptionIdCounter = 0;
+    /**
+     * Create a new EventHub
+     *
+     * @param source - Identifier for this event source (agent/ability name)
+     */
+    constructor(source) {
+        this.source = source;
+    }
+    /**
+     * Update the source identifier
+     *
+     * This is useful when the agent/ability name is determined after construction.
+     *
+     * @param newSource - New source identifier
+     */
+    setSource(newSource) {
+        this.source = newSource;
+    }
+    /**
+     * Subscribe to events matching a pattern
+     *
+     * Patterns support wildcards:
+     * - `user.login` - exact match
+     * - `user.*` - all events starting with "user."
+     * - `*.error` - all error events
+     * - `*` - all events
+     *
+     * @template TData - Expected event data type
+     *
+     * @param pattern - Event pattern to match
+     * @param callback - Function to call when matching events occur
+     * @param options - Optional subscription options
+     * @returns Function to unsubscribe
+     *
+     * @throws {KadiError} If pattern or callback is invalid
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = hub.subscribe('user.login', (data) => {
+     *   console.log('User logged in:', data);
+     * });
+     * ```
+     */
+    subscribe(pattern, callback, options) {
+        // Validate pattern
+        if (!pattern || typeof pattern !== 'string') {
+            throw new KadiError('Event pattern must be a non-empty string', ErrorCode.EVENT_PATTERN_INVALID, 400, { pattern });
+        }
+        // Validate callback
+        if (typeof callback !== 'function') {
+            throw new KadiError('Event callback must be a function', ErrorCode.INVALID_INPUT, 400, { pattern });
+        }
+        // Create subscription
+        const subscription = {
+            id: `sub_${++this.subscriptionIdCounter}`,
+            pattern,
+            callback: callback,
+            createdAt: Date.now(),
+            options
+        };
+        // Add to subscriptions map
+        if (!this.subscriptions.has(pattern)) {
+            this.subscriptions.set(pattern, new Set());
+        }
+        const patternSubscriptions = this.subscriptions.get(pattern);
+        if (patternSubscriptions) {
+            // Safe cast: EventSubscription<TData> is compatible with EventSubscription<unknown>
+            // since unknown is the least restrictive type
+            patternSubscriptions.add(subscription);
+        }
+        // Set up timeout if specified
+        let timeoutId;
+        if (options?.timeout) {
+            timeoutId = setTimeout(() => {
+                this.unsubscribeById(subscription.id);
+            }, options.timeout);
+        }
+        // Return unsubscribe function
+        return () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            this.unsubscribeById(subscription.id);
+        };
+    }
+    /**
+     * Publish an event to all matching subscribers
+     *
+     * @template TData - Event data type
+     *
+     * @param eventName - Event name/channel
+     * @param data - Event data payload
+     * @param options - Optional publishing options
+     *
+     * @example
+     * ```typescript
+     * hub.publish('user.logout', {
+     *   userId: '123',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    publish(eventName, data, options) {
+        // Create event payload
+        const payload = {
+            eventName,
+            data,
+            timestamp: Date.now(),
+            source: this.source,
+            metadata: {
+                ...options,
+                correlationId: options?.correlationId
+            }
+        };
+        // Find all matching subscriptions
+        const matchingSubscriptions = this.findMatchingSubscriptions(eventName);
+        // Deliver to each subscriber
+        for (const subscription of matchingSubscriptions) {
+            this.deliverEvent(subscription, payload);
+        }
+    }
+    /**
+     * Unsubscribe from a pattern
+     *
+     * @param pattern - Pattern to unsubscribe from
+     * @param callback - Optional specific callback to remove (removes all if not specified)
+     *
+     * @example
+     * ```typescript
+     * hub.unsubscribe('user.*');
+     * ```
+     */
+    unsubscribe(pattern, callback) {
+        const patternSubscriptions = this.subscriptions.get(pattern);
+        if (!patternSubscriptions) {
+            return;
+        }
+        if (callback) {
+            // Remove specific callback
+            for (const sub of patternSubscriptions) {
+                if (sub.callback === callback) {
+                    patternSubscriptions.delete(sub);
+                }
+            }
+        }
+        else {
+            // Remove all subscriptions for this pattern
+            patternSubscriptions.clear();
+        }
+        // Clean up empty pattern entries
+        if (patternSubscriptions.size === 0) {
+            this.subscriptions.delete(pattern);
+        }
+    }
+    /**
+     * Get all active subscriptions
+     *
+     * @returns Array of all active subscriptions
+     */
+    getSubscriptions() {
+        const allSubscriptions = [];
+        for (const subs of this.subscriptions.values()) {
+            allSubscriptions.push(...Array.from(subs));
+        }
+        return allSubscriptions;
+    }
+    /**
+     * Get subscription count
+     *
+     * @returns Number of active subscriptions
+     */
+    get subscriptionCount() {
+        let count = 0;
+        for (const subs of this.subscriptions.values()) {
+            count += subs.size;
+        }
+        return count;
+    }
+    /**
+     * Clear all subscriptions
+     *
+     * @example
+     * ```typescript
+     * hub.clear();
+     * ```
+     */
+    clear() {
+        this.subscriptions.clear();
+    }
+    /**
+     * Find subscriptions matching an event name
+     *
+     * @param eventName - Event name to match
+     * @returns Set of matching subscriptions
+     */
+    findMatchingSubscriptions(eventName) {
+        const matching = new Set();
+        for (const [pattern, subs] of this.subscriptions.entries()) {
+            if (this.matchesPattern(eventName, pattern)) {
+                for (const sub of subs) {
+                    matching.add(sub);
+                }
+            }
+        }
+        return matching;
+    }
+    /**
+     * Check if an event name matches a pattern
+     *
+     * Supports wildcard matching:
+     * - Exact match: 'user.login' matches 'user.login'
+     * - Prefix wildcard: 'user.*' matches 'user.login', 'user.logout', etc.
+     * - Suffix wildcard: '*.error' matches 'user.error', 'system.error', etc.
+     * - Full wildcard: '*' matches any event
+     *
+     * @param eventName - Event name to test
+     * @param pattern - Pattern to match against
+     * @returns true if event matches pattern
+     */
+    matchesPattern(eventName, pattern) {
+        // Exact match
+        if (eventName === pattern) {
+            return true;
+        }
+        // No wildcards, no match
+        if (!pattern.includes('*')) {
+            return false;
+        }
+        // Convert pattern to regex
+        const regexPattern = pattern
+            .replace(/\./g, '\\.') // Escape dots
+            .replace(/\*/g, '.*'); // Replace * with .*
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(eventName);
+    }
+    /**
+     * Deliver an event to a subscription
+     *
+     * @param subscription - Subscription to deliver to
+     * @param payload - Event payload
+     */
+    deliverEvent(subscription, payload) {
+        try {
+            // Apply filter if provided
+            if (subscription.options?.filter && !subscription.options.filter(payload)) {
+                return;
+            }
+            // Call the callback
+            const result = subscription.callback(payload);
+            // Handle promise if callback is async
+            if (result instanceof Promise) {
+                result.catch(error => {
+                    console.error('Error in event callback:', error);
+                });
+            }
+            // Handle maxEvents option
+            if (subscription.options?.maxEvents) {
+                const currentCount = subscription._eventCount ?? 0;
+                subscription._eventCount = currentCount + 1;
+                if (subscription._eventCount >= subscription.options.maxEvents) {
+                    this.unsubscribeById(subscription.id);
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error delivering event:', error);
+        }
+    }
+    /**
+     * Unsubscribe by subscription ID
+     *
+     * @param id - Subscription ID to remove
+     */
+    unsubscribeById(id) {
+        for (const [pattern, subs] of this.subscriptions.entries()) {
+            for (const sub of subs) {
+                if (sub.id === id) {
+                    subs.delete(sub);
+                    if (subs.size === 0) {
+                        this.subscriptions.delete(pattern);
+                    }
+                    return;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=EventHub.js.map

package/dist/events/EventHub.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Events Module
+ *
+ * Exports for event pub/sub system.
+ */
+export { EventHub } from './EventHub.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,7 @@
+/**
+ * Events Module
+ *
+ * Exports for event pub/sub system.
+ */
+export { EventHub } from './EventHub.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * KADI Core V2
+ *
+ * Main entry point for the KADI framework.
+ * Provides a clean, typed, and intuitive API for building distributed systems.
+ *
+ * **Breaking Changes (v2.0.0)**:
+ * - Replaced Zod schemas with MCP (Model Context Protocol) JSON Schemas
+ * - Full MCP compliance with KADI extensions
+ * - See migration guide for upgrading from v1.x
+ *
+ * @packageDocumentation
+ */
+export { KadiClient } from './client/index.js';
+export * as Kadi from './api/index.js';
+export type { KadiClientConfig, KadiConfig, ServiceConfig, LoadAbilityOptions, TransportKind, AgentRole, ToolHandler, KadiTool, ToolDefinition, RegisteredTool, ToolTag, NetworkId, ToolDiscoveryQuery, ToolDiscoveryResult, McpTool, ToolAnnotations, EventCallback, EventPattern, EventPayload, UnsubscribeFunction, PublishOptions, BrokerConfig, BrokerConnection, HandshakeParams, HandshakeResult, ErrorContext } from './types/index.js';
+export { KadiError, isKadiError, isError, ErrorCode } from './errors/index.js';
+export { AbilityLoader, AbilityProxy } from './abilities/index.js';
+export type { LoadedAbility } from './abilities/index.js';
+export type { ValidationResult } from './validation/index.js';
+export { SchemaValidator } from './validation/index.js';
+/**
+ * Broker-specific error code subset
+ */
+export declare const BrokerErrorCodes: {
+    readonly SCHEMA_VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
+    readonly TOOL_VALIDATION_FAILED: "TOOL_VALIDATION_FAILED";
+    readonly BROKER_RESPONSE_ERROR: "BROKER_RESPONSE_ERROR";
+    readonly BROKER_TIMEOUT: "BROKER_TIMEOUT";
+    readonly BROKER_SCHEMA_COMPILATION_ERROR: "BROKER_SCHEMA_COMPILATION_ERROR";
+    readonly TOOL_NOT_FOUND: "TOOL_NOT_FOUND";
+    readonly TOOL_INVOCATION_FAILED: "TOOL_INVOCATION_FAILED";
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+/**
+ * Validate tool schemas for MCP compliance
+ *
+ * @param inputSchema - Input schema
+ * @param outputSchema - Output schema (optional)
+ * @param toolName - Tool name for error messages
+ * @returns Validation result
+ */
+export declare function validateToolSchemas(inputSchema: Record<string, unknown>, outputSchema: Record<string, unknown> | undefined, toolName: string): {
+    valid: boolean;
+    errors: string[];
+};
+export { MCP_SCHEMA_VERSION, MCP_SPEC_URL, getMcpVersionInfo, buildTool, stringProp, numberProp, integerProp, booleanProp, arrayProp, objectProp, enumProp, optional } from './schemas/index.js';
+//# 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;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAGvC,YAAY,EAEV,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,SAAS,EAGT,WAAW,EACX,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,OAAO,EACP,eAAe,EAGf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,cAAc,EAGd,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EAGf,YAAY,EACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,YAAY,EAEV,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjD,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CActC;AAED,OAAO,EAEL,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EAGjB,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACT,MAAM,oBAAoB,CAAC"}