@kadi.build/core 0.0.1-alpha.3 → 0.0.1-alpha.5

package/dist/messages/BrokerMessages.js

@@ -0,0 +1,125 @@
+/**
+ * TypeScript implementation of Broker message builders
+ * Replaces the JavaScript BrokerMessageBuilder functionality
+ */
+import { JsonRpcBuilder } from './MessageBuilder.js';
+/**
+ * KADI Protocol message types (from kadi-broker)
+ */
+export const KadiMessages = {
+    // Session Management
+    SESSION_HELLO: 'kadi.session.hello',
+    SESSION_AUTHENTICATE: 'kadi.session.authenticate',
+    SESSION_PING: 'kadi.session.ping',
+    SESSION_GOODBYE: 'kadi.session.goodbye',
+    // Agent Management
+    AGENT_REGISTER: 'kadi.agent.register',
+    AGENT_UPDATE: 'kadi.agent.update',
+    AGENT_UNREGISTER: 'kadi.agent.unregister',
+    // Ability Operations
+    ABILITY_INVOKE: 'kadi.ability.invoke',
+    ABILITY_RESULT: 'kadi.ability.result',
+    ABILITY_QUEUED: 'kadi.ability.queued', // Notification that request is queued
+    ABILITY_CANCEL: 'kadi.ability.cancel',
+    ABILITY_LIST: 'kadi.ability.list',
+    // Event System - Real-time publish-subscribe messaging
+    EVENT_SUBSCRIBE: 'kadi.event.subscribe', // Subscribe to event channels
+    EVENT_UNSUBSCRIBE: 'kadi.event.unsubscribe', // Unsubscribe from event channels
+    EVENT_PUBLISH: 'kadi.event.publish', // Publish an event to channels
+    EVENT_DELIVERY: 'kadi.event.delivery', // Notification of event delivery
+    EVENT_LIST: 'kadi.event.list', // List current subscriptions
+    // Observer Protocol
+    OBSERVE_SUBSCRIBE: 'kadi.observe.subscribe',
+    OBSERVE_SNAPSHOT: 'kadi.observe.snapshot',
+    OBSERVE_EVENT: 'kadi.observe.event',
+    // Errors
+    ERROR: 'kadi.error'
+};
+/**
+ * Legacy compatibility mapping for older method names
+ */
+const _LegacyMethodMap = {
+    hello: KadiMessages.SESSION_HELLO,
+    authenticate: KadiMessages.SESSION_AUTHENTICATE,
+    registerCapabilities: KadiMessages.AGENT_REGISTER,
+    ping: KadiMessages.SESSION_PING,
+    listTools: KadiMessages.ABILITY_LIST,
+    callAbility: KadiMessages.ABILITY_INVOKE,
+    abilityResult: KadiMessages.ABILITY_RESULT
+};
+/**
+ * Broker message builder for KADI protocol messages
+ */
+export class BrokerMessageBuilder {
+    /**
+     * Create hello message
+     */
+    static hello(params) {
+        return new JsonRpcBuilder(KadiMessages.SESSION_HELLO, params);
+    }
+    /**
+     * Create authenticate message
+     */
+    static authenticate(params) {
+        return new JsonRpcBuilder(KadiMessages.SESSION_AUTHENTICATE, params);
+    }
+    /**
+     * Create registerCapabilities message (maps to AGENT_REGISTER)
+     */
+    static registerCapabilities(params) {
+        return new JsonRpcBuilder(KadiMessages.AGENT_REGISTER, params);
+    }
+    /**
+     * Create ping notification
+     */
+    static ping() {
+        return new JsonRpcBuilder(KadiMessages.SESSION_PING, undefined, true);
+    }
+    /**
+     * Create listTools message (maps to ABILITY_LIST)
+     */
+    static listTools() {
+        return new JsonRpcBuilder(KadiMessages.ABILITY_LIST);
+    }
+    /**
+     * Create callAbility message (maps to ABILITY_INVOKE)
+     */
+    static callAbility(params) {
+        return new JsonRpcBuilder(KadiMessages.ABILITY_INVOKE, params);
+    }
+    /**
+     * Create abilityResult message
+     */
+    static abilityResult(params) {
+        return new JsonRpcBuilder(KadiMessages.ABILITY_RESULT, params);
+    }
+    /**
+     * Create agent register message (modern API)
+     */
+    static agentRegister(params) {
+        return new JsonRpcBuilder(KadiMessages.AGENT_REGISTER, params);
+    }
+    /**
+     * Create ability invoke message (modern API)
+     */
+    static abilityInvoke(params) {
+        return new JsonRpcBuilder(KadiMessages.ABILITY_INVOKE, params);
+    }
+    /**
+     * Create ability list message (modern API)
+     */
+    static abilityList() {
+        return new JsonRpcBuilder(KadiMessages.ABILITY_LIST);
+    }
+    /**
+     * Create session goodbye message
+     */
+    static goodbye() {
+        return new JsonRpcBuilder(KadiMessages.SESSION_GOODBYE, undefined, true);
+    }
+}
+// Export as default for compatibility with existing code
+export const Broker = BrokerMessageBuilder;
+// Export IdFactory for compatibility
+export { IdFactory, JsonRpcBuilder } from './MessageBuilder.js';
+//# sourceMappingURL=BrokerMessages.js.map

package/dist/messages/BrokerMessages.js.map

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

package/dist/messages/MessageBuilder.d.ts

@@ -0,0 +1,83 @@
+/**
+ * TypeScript implementation of JSON-RPC message builders
+ * Replaces the JavaScript message builder functionality
+ */
+/**
+ * Simple ID factory for generating unique message IDs
+ */
+export declare class IdFactory {
+    private counter;
+    next(): string;
+    uuid(): string;
+}
+/**
+ * JSON-RPC message builder
+ */
+export declare class JsonRpcBuilder {
+    private message;
+    constructor(method: string, params?: any, isNotification?: boolean);
+    /**
+     * Set the request ID
+     */
+    id(id: string | number): this;
+    /**
+     * Add additional parameters
+     */
+    params(additionalParams: any): this;
+    /**
+     * Build the final message
+     */
+    build(): any;
+    /**
+     * Build and stringify
+     */
+    toString(): string;
+}
+/**
+ * JSON-RPC response builder
+ */
+export declare class JsonRpcResponse {
+    private response;
+    constructor(id: string | number | null);
+    /**
+     * Set successful result
+     */
+    result(data: any): this;
+    /**
+     * Set error
+     */
+    error(code: number, message: string, data?: any): this;
+    /**
+     * Build the final response
+     */
+    build(): any;
+    /**
+     * Build and stringify
+     */
+    toString(): string;
+}
+/**
+ * Common JSON-RPC error codes
+ */
+export declare const RpcErrorCodes: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly SERVER_ERROR_START: -32099;
+    readonly SERVER_ERROR_END: -32000;
+};
+/**
+ * Helper function to create success response
+ */
+export declare function createSuccessResponse(id: string | number | null, result: any): any;
+/**
+ * Helper function to create error response
+ */
+export declare function createErrorResponse(id: string | number | null, code: number, message: string, data?: any): any;
+/**
+ * Helper function to create notification
+ */
+export declare function createNotification(method: string, params?: any): any;
+//# sourceMappingURL=MessageBuilder.d.ts.map

package/dist/messages/MessageBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBuilder.d.ts","sourceRoot":"","sources":["../../src/messages/MessageBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAK;IAEpB,IAAI,IAAI,MAAM;IAId,IAAI,IAAI,MAAM;CAGf;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAM;gBAET,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,cAAc,UAAQ;IAgBhE;;OAEG;IACH,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,MAAM,CAAC,gBAAgB,EAAE,GAAG,GAAG,IAAI;IASnC;;OAEG;IACH,KAAK,IAAI,GAAG;IAIZ;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAM;gBAEV,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOtC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAMvB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IActD;;OAEG;IACH,KAAK,IAAI,GAAG;IAIZ;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;CAQhB,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,MAAM,EAAE,GAAG,GACV,GAAG,CAEL;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,GAAG,GACT,GAAG,CAEL;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,CAEpE"}

package/dist/messages/MessageBuilder.js

@@ -0,0 +1,144 @@
+/**
+ * TypeScript implementation of JSON-RPC message builders
+ * Replaces the JavaScript message builder functionality
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Simple ID factory for generating unique message IDs
+ */
+export class IdFactory {
+    counter = 0;
+    next() {
+        return `${Date.now()}-${++this.counter}`;
+    }
+    uuid() {
+        return randomUUID();
+    }
+}
+/**
+ * JSON-RPC message builder
+ */
+export class JsonRpcBuilder {
+    message;
+    constructor(method, params, isNotification = false) {
+        this.message = {
+            jsonrpc: '2.0',
+            method
+        };
+        if (params !== undefined) {
+            this.message.params = params;
+        }
+        if (!isNotification) {
+            // Will be set later with id() method
+            this.message.id = null;
+        }
+    }
+    /**
+     * Set the request ID
+     */
+    id(id) {
+        this.message.id = id;
+        return this;
+    }
+    /**
+     * Add additional parameters
+     */
+    params(additionalParams) {
+        if (this.message.params) {
+            this.message.params = { ...this.message.params, ...additionalParams };
+        }
+        else {
+            this.message.params = additionalParams;
+        }
+        return this;
+    }
+    /**
+     * Build the final message
+     */
+    build() {
+        return { ...this.message };
+    }
+    /**
+     * Build and stringify
+     */
+    toString() {
+        return JSON.stringify(this.build());
+    }
+}
+/**
+ * JSON-RPC response builder
+ */
+export class JsonRpcResponse {
+    response;
+    constructor(id) {
+        this.response = {
+            jsonrpc: '2.0',
+            id
+        };
+    }
+    /**
+     * Set successful result
+     */
+    result(data) {
+        this.response.result = data;
+        delete this.response.error;
+        return this;
+    }
+    /**
+     * Set error
+     */
+    error(code, message, data) {
+        this.response.error = {
+            code,
+            message
+        };
+        if (data !== undefined) {
+            this.response.error.data = data;
+        }
+        delete this.response.result;
+        return this;
+    }
+    /**
+     * Build the final response
+     */
+    build() {
+        return { ...this.response };
+    }
+    /**
+     * Build and stringify
+     */
+    toString() {
+        return JSON.stringify(this.build());
+    }
+}
+/**
+ * Common JSON-RPC error codes
+ */
+export const RpcErrorCodes = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    SERVER_ERROR_START: -32099,
+    SERVER_ERROR_END: -32000
+};
+/**
+ * Helper function to create success response
+ */
+export function createSuccessResponse(id, result) {
+    return new JsonRpcResponse(id).result(result).build();
+}
+/**
+ * Helper function to create error response
+ */
+export function createErrorResponse(id, code, message, data) {
+    return new JsonRpcResponse(id).error(code, message, data).build();
+}
+/**
+ * Helper function to create notification
+ */
+export function createNotification(method, params) {
+    return new JsonRpcBuilder(method, params, true).build();
+}
+//# sourceMappingURL=MessageBuilder.js.map

package/dist/messages/MessageBuilder.js.map

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

package/dist/schemas/events.schemas.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Event System Schema Validation
+ * ------------------------------
+ * Zod schemas for validating event system parameters and messages.
+ * This ensures type safety and proper input validation for all event operations.
+ *
+ * The schemas follow the established patterns in the KADI broker for consistency
+ * and integrate with the existing validation middleware.
+ */
+import { z } from 'zod';
+/**
+ * Event channel pattern validation schema.
+ *
+ * Enforces the hierarchical naming convention:
+ * - Format: namespace.event-name or namespace.category.event-name
+ * - Examples: 'system.startup', 'tool.completed', 'agent.status.changed'
+ * - Wildcards: '*' matches one segment, '#' matches multiple segments
+ *
+ * Rules:
+ * - Must start with lowercase letter
+ * - Segments separated by dots
+ * - Only lowercase letters, numbers, underscores, hyphens allowed
+ * - Wildcards * and # only allowed at end of segments
+ */
+export declare const EventChannelSchema: z.ZodString;
+/**
+ * Schema for event subscription requests (kadi.event.subscribe)
+ */
+export declare const EventSubscribeSchema: z.ZodObject<{
+    channels: z.ZodArray<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodObject<{
+        publisherId: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type EventSubscribeParams = z.infer<typeof EventSubscribeSchema>;
+/**
+ * Schema for event subscription response
+ */
+export declare const EventSubscribeResultSchema: z.ZodObject<{
+    subscribed: z.ZodArray<z.ZodString>;
+    queueName: z.ZodString;
+}, z.core.$strict>;
+export type EventSubscribeResult = z.infer<typeof EventSubscribeResultSchema>;
+/**
+ * Schema for event unsubscription requests (kadi.event.unsubscribe)
+ */
+export declare const EventUnsubscribeSchema: z.ZodObject<{
+    channels: z.ZodArray<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type EventUnsubscribeParams = z.infer<typeof EventUnsubscribeSchema>;
+/**
+ * Schema for event unsubscription response
+ */
+export declare const EventUnsubscribeResultSchema: z.ZodObject<{
+    unsubscribed: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type EventUnsubscribeResult = z.infer<typeof EventUnsubscribeResultSchema>;
+/**
+ * Schema for event publishing requests (kadi.event.publish)
+ */
+export declare const EventPublishSchema: z.ZodObject<{
+    channel: z.ZodString;
+    data: z.ZodUnknown;
+    networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type EventPublishParams = z.infer<typeof EventPublishSchema>;
+/**
+ * Schema for event publishing response
+ */
+export declare const EventPublishResultSchema: z.ZodObject<{
+    published: z.ZodBoolean;
+    eventId: z.ZodString;
+}, z.core.$strict>;
+export type EventPublishResult = z.infer<typeof EventPublishResultSchema>;
+/**
+ * Schema for event subscription listing requests (kadi.event.list)
+ */
+export declare const EventListSchema: z.ZodObject<{
+    agentId: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type EventListParams = z.infer<typeof EventListSchema>;
+/**
+ * Schema for event subscription listing response
+ */
+export declare const EventListResultSchema: z.ZodObject<{
+    subscriptions: z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        channels: z.ZodArray<z.ZodString>;
+        networks: z.ZodArray<z.ZodString>;
+        queueName: z.ZodString;
+        subscribedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type EventListResult = z.infer<typeof EventListResultSchema>;
+/**
+ * Schema for validating event messages before delivery.
+ * This ensures all events have consistent structure when delivered to subscribers.
+ */
+export declare const EventMessageSchema: z.ZodObject<{
+    channel: z.ZodString;
+    data: z.ZodUnknown;
+    timestamp: z.ZodString;
+    publisherId: z.ZodString;
+    networkId: z.ZodString;
+    metadata: z.ZodOptional<z.ZodObject<{
+        correlationId: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        eventId: z.ZodOptional<z.ZodString>;
+        publisherRole: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+}, z.core.$strict>;
+export type EventMessage = z.infer<typeof EventMessageSchema>;
+/**
+ * Validation middleware for event system methods.
+ * Extends the existing ValidationMiddleware pattern to support event operations.
+ */
+export declare class EventValidationMiddleware {
+    /**
+     * Validates parameters for event system methods using appropriate schemas
+     */
+    static validateEventParams<T>(method: string, params: unknown): T;
+    /**
+     * Validates event message structure before delivery
+     */
+    static validateEventMessage(message: unknown): EventMessage;
+    /**
+     * Provides user-friendly error messages for common validation failures
+     */
+    static getValidationHint(method: string, error: z.ZodError): string;
+}
+/**
+ * Export all schemas for use in tests and external validation
+ */
+export declare const EventSchemas: {
+    readonly EventChannel: z.ZodString;
+    readonly EventSubscribe: z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+        networkId: z.ZodOptional<z.ZodString>;
+        filter: z.ZodOptional<z.ZodObject<{
+            publisherId: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+    readonly EventUnsubscribe: z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+        networkId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly EventPublish: z.ZodObject<{
+        channel: z.ZodString;
+        data: z.ZodUnknown;
+        networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    readonly EventList: z.ZodObject<{
+        agentId: z.ZodOptional<z.ZodString>;
+        networkId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly EventMessage: z.ZodObject<{
+        channel: z.ZodString;
+        data: z.ZodUnknown;
+        timestamp: z.ZodString;
+        publisherId: z.ZodString;
+        networkId: z.ZodString;
+        metadata: z.ZodOptional<z.ZodObject<{
+            correlationId: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+            eventId: z.ZodOptional<z.ZodString>;
+            publisherRole: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$strict>;
+};
+//# sourceMappingURL=events.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/events.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,aAQuB,CAAC;AAMvD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;kBAqBtB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;kBAO5B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;kBAUxB,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,4BAA4B;;kBAK9B,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;kBAoBpB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;kBAO1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E;;GAEG;AACH,eAAO,MAAM,eAAe;;;kBAOjB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;kBAavB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;kBAiCpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D;;;GAGG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC;IAoBjE;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAI3D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM;CAyBpE;AAMD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOf,CAAC"}