agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2a/notifications/signature.js

@@ -0,0 +1,244 @@
+/**
+ * A2A Webhook Signature Utilities
+ *
+ * Provides HMAC-SHA256 signature generation and verification for webhook payloads.
+ * Follows the pattern: X-A2A-Signature: t={timestamp},v1={hmac}
+ *
+ * @module adapters/a2a/notifications/signature
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+import { createHmac, timingSafeEqual } from 'crypto';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Header name for A2A webhook signatures
+ */
+export const SIGNATURE_HEADER = 'X-A2A-Signature';
+/**
+ * Current signature version
+ */
+export const SIGNATURE_VERSION = 'v1';
+/**
+ * Default maximum age for signature validation (5 minutes)
+ */
+export const DEFAULT_MAX_AGE_MS = 5 * 60 * 1000;
+/**
+ * Minimum timestamp value to prevent integer overflow attacks
+ */
+export const MIN_TIMESTAMP = 1704067200000; // Jan 1, 2024
+// ============================================================================
+// Signature Generation
+// ============================================================================
+/**
+ * Generate an HMAC-SHA256 signature for a webhook payload
+ *
+ * @param payload - The JSON string payload to sign
+ * @param secret - The shared secret key
+ * @param timestamp - Unix timestamp in milliseconds
+ * @returns The hex-encoded HMAC-SHA256 signature
+ *
+ * @example
+ * ```typescript
+ * const signature = generateSignature(
+ *   JSON.stringify({ event: 'task.completed', taskId: '123' }),
+ *   'webhook-secret-key',
+ *   Date.now()
+ * );
+ * // Returns: 'a1b2c3d4e5f6...' (64 character hex string)
+ * ```
+ */
+export function generateSignature(payload, secret, timestamp) {
+    if (!payload) {
+        throw new Error('Payload is required for signature generation');
+    }
+    if (!secret) {
+        throw new Error('Secret is required for signature generation');
+    }
+    if (timestamp < MIN_TIMESTAMP) {
+        throw new Error(`Invalid timestamp: must be after ${new Date(MIN_TIMESTAMP).toISOString()}`);
+    }
+    // Create signed payload: timestamp.payload
+    const signedPayload = `${timestamp}.${payload}`;
+    // Generate HMAC-SHA256
+    const hmac = createHmac('sha256', secret);
+    hmac.update(signedPayload, 'utf8');
+    return hmac.digest('hex');
+}
+/**
+ * Generate the complete signature header value
+ *
+ * @param payload - The JSON string payload to sign
+ * @param secret - The shared secret key
+ * @param timestamp - Optional timestamp (defaults to current time)
+ * @returns The complete header value in format: t={timestamp},v1={signature}
+ *
+ * @example
+ * ```typescript
+ * const headerValue = generateSignatureHeader(
+ *   JSON.stringify({ event: 'task.completed' }),
+ *   'webhook-secret-key'
+ * );
+ * // Returns: 't=1704067200000,v1=a1b2c3d4e5f6...'
+ * ```
+ */
+export function generateSignatureHeader(payload, secret, timestamp) {
+    const ts = timestamp ?? Date.now();
+    const signature = generateSignature(payload, secret, ts);
+    return `t=${ts},${SIGNATURE_VERSION}=${signature}`;
+}
+// ============================================================================
+// Signature Verification
+// ============================================================================
+/**
+ * Parse a signature header value into its components
+ *
+ * @param header - The signature header value
+ * @returns Parsed signature components or null if invalid format
+ *
+ * @example
+ * ```typescript
+ * const parsed = parseSignatureHeader('t=1704067200000,v1=abc123...');
+ * // Returns: { timestamp: 1704067200000, v1: 'abc123...' }
+ * ```
+ */
+export function parseSignatureHeader(header) {
+    if (!header || typeof header !== 'string') {
+        return null;
+    }
+    const parts = header.split(',');
+    let timestamp;
+    let v1;
+    for (const part of parts) {
+        const [key, ...valueParts] = part.split('=');
+        const value = valueParts.join('='); // Handle '=' in value
+        if (key === 't') {
+            timestamp = parseInt(value, 10);
+            if (isNaN(timestamp)) {
+                return null;
+            }
+        }
+        else if (key === 'v1') {
+            v1 = value;
+        }
+    }
+    if (timestamp === undefined || !v1) {
+        return null;
+    }
+    return { timestamp, v1 };
+}
+/**
+ * Verify a webhook signature using timing-safe comparison
+ *
+ * @param payload - The raw JSON string payload
+ * @param signature - The signature header value to verify
+ * @param secret - The shared secret key
+ * @param maxAge - Maximum age of signature in milliseconds (default: 5 minutes)
+ * @returns Verification result with validity status and any errors
+ *
+ * @example
+ * ```typescript
+ * const result = verifySignature(
+ *   '{"event":"task.completed"}',
+ *   't=1704067200000,v1=abc123...',
+ *   'webhook-secret-key'
+ * );
+ *
+ * if (result.valid) {
+ *   console.log('Signature verified');
+ * } else {
+ *   console.error('Verification failed:', result.error);
+ * }
+ * ```
+ */
+export function verifySignature(payload, signature, secret, maxAge = DEFAULT_MAX_AGE_MS) {
+    // Parse the signature header
+    const parsed = parseSignatureHeader(signature);
+    if (!parsed) {
+        return {
+            valid: false,
+            error: 'Invalid signature format: expected t={timestamp},v1={signature}',
+        };
+    }
+    const { timestamp, v1: providedSignature } = parsed;
+    // Check timestamp validity
+    if (timestamp < MIN_TIMESTAMP) {
+        return {
+            valid: false,
+            error: `Invalid timestamp: must be after ${new Date(MIN_TIMESTAMP).toISOString()}`,
+            timestamp,
+        };
+    }
+    // Check signature age
+    const now = Date.now();
+    const ageMs = now - timestamp;
+    if (ageMs > maxAge) {
+        return {
+            valid: false,
+            error: `Signature expired: age ${ageMs}ms exceeds maximum ${maxAge}ms`,
+            timestamp,
+            ageMs,
+        };
+    }
+    // Check for future timestamps (allow 1 minute clock skew)
+    if (ageMs < -60000) {
+        return {
+            valid: false,
+            error: 'Signature timestamp is too far in the future',
+            timestamp,
+            ageMs,
+        };
+    }
+    // Generate expected signature
+    let expectedSignature;
+    try {
+        expectedSignature = generateSignature(payload, secret, timestamp);
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: `Failed to generate expected signature: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            timestamp,
+            ageMs,
+        };
+    }
+    // Timing-safe comparison to prevent timing attacks
+    const providedBuffer = Buffer.from(providedSignature, 'utf8');
+    const expectedBuffer = Buffer.from(expectedSignature, 'utf8');
+    // Length check (must be same length for timingSafeEqual)
+    if (providedBuffer.length !== expectedBuffer.length) {
+        return {
+            valid: false,
+            error: 'Signature mismatch',
+            timestamp,
+            ageMs,
+        };
+    }
+    const valid = timingSafeEqual(providedBuffer, expectedBuffer);
+    if (!valid) {
+        return {
+            valid: false,
+            error: 'Signature mismatch',
+            timestamp,
+            ageMs,
+        };
+    }
+    return {
+        valid: true,
+        timestamp,
+        ageMs,
+    };
+}
+/**
+ * Simple boolean check for signature validity (convenience wrapper)
+ *
+ * @param payload - The raw JSON string payload
+ * @param signature - The signature header value to verify
+ * @param secret - The shared secret key
+ * @param maxAge - Maximum age of signature in milliseconds
+ * @returns true if signature is valid, false otherwise
+ */
+export function isValidSignature(payload, signature, secret, maxAge) {
+    return verifySignature(payload, signature, secret, maxAge).valid;
+}
+//# sourceMappingURL=signature.js.map

package/v3/dist/adapters/a2a/notifications/signature.js.map

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

package/v3/dist/adapters/a2a/notifications/subscription-store.d.ts

@@ -0,0 +1,243 @@
+/**
+ * A2A Webhook Subscription Store
+ *
+ * Manages webhook subscriptions for task notifications with CRUD operations,
+ * statistics tracking, and automatic cleanup of expired subscriptions.
+ *
+ * @module adapters/a2a/notifications/subscription-store
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+import type { WebhookConfig, WebhookEvent } from './webhook-service.js';
+/**
+ * Webhook subscription status
+ */
+export type SubscriptionStatus = 'active' | 'paused' | 'failed' | 'expired';
+/**
+ * Webhook subscription record
+ */
+export interface Subscription {
+    /** Unique subscription identifier */
+    readonly id: string;
+    /** Task ID this subscription is for */
+    readonly taskId: string;
+    /** Context ID (optional, for multi-turn subscriptions) */
+    readonly contextId?: string;
+    /** Webhook configuration */
+    readonly webhookConfig: WebhookConfig;
+    /** Current subscription status */
+    status: SubscriptionStatus;
+    /** Subscription creation timestamp */
+    readonly createdAt: Date;
+    /** Last delivery attempt timestamp */
+    lastDeliveryAt?: Date;
+    /** Last successful delivery timestamp */
+    lastSuccessAt?: Date;
+    /** Total number of delivery attempts */
+    deliveryCount: number;
+    /** Number of failed deliveries */
+    failureCount: number;
+    /** Consecutive failure count (resets on success) */
+    consecutiveFailures: number;
+    /** Last error message */
+    lastError?: string;
+    /** Subscription expiration timestamp */
+    expiresAt?: Date;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Subscription creation options
+ */
+export interface CreateSubscriptionOptions {
+    /** Explicit subscription ID (auto-generated if not provided) */
+    id?: string;
+    /** Context ID for multi-turn conversations */
+    contextId?: string;
+    /** Subscription expiration time */
+    expiresAt?: Date;
+    /** Initial metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Subscription update options
+ */
+export interface UpdateSubscriptionOptions {
+    /** Update status */
+    status?: SubscriptionStatus;
+    /** Update webhook config */
+    webhookConfig?: Partial<WebhookConfig>;
+    /** Update last delivery timestamp */
+    lastDeliveryAt?: Date;
+    /** Update last success timestamp */
+    lastSuccessAt?: Date;
+    /** Increment delivery count */
+    incrementDeliveryCount?: boolean;
+    /** Increment failure count */
+    incrementFailureCount?: boolean;
+    /** Set consecutive failures */
+    consecutiveFailures?: number;
+    /** Update last error */
+    lastError?: string | null;
+    /** Update expiration */
+    expiresAt?: Date | null;
+    /** Merge metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Subscription query options
+ */
+export interface SubscriptionQueryOptions {
+    /** Filter by task ID */
+    taskId?: string;
+    /** Filter by context ID */
+    contextId?: string;
+    /** Filter by status */
+    status?: SubscriptionStatus | SubscriptionStatus[];
+    /** Filter by event type */
+    event?: WebhookEvent;
+    /** Maximum results */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+    /** Include expired subscriptions */
+    includeExpired?: boolean;
+}
+/**
+ * Subscription store statistics
+ */
+export interface SubscriptionStats {
+    /** Total subscriptions */
+    total: number;
+    /** Subscriptions by status */
+    byStatus: Record<SubscriptionStatus, number>;
+    /** Total deliveries attempted */
+    totalDeliveries: number;
+    /** Total failed deliveries */
+    totalFailures: number;
+    /** Unique tasks with subscriptions */
+    uniqueTasks: number;
+    /** Unique contexts with subscriptions */
+    uniqueContexts: number;
+}
+/**
+ * Store configuration
+ */
+export interface SubscriptionStoreConfig {
+    /** Maximum subscriptions per task */
+    maxSubscriptionsPerTask?: number;
+    /** Maximum total subscriptions */
+    maxTotalSubscriptions?: number;
+    /** Default subscription TTL in milliseconds */
+    defaultTtlMs?: number;
+    /** Consecutive failures before marking failed */
+    maxConsecutiveFailures?: number;
+    /** Enable automatic cleanup of expired/failed subscriptions */
+    enableAutoCleanup?: boolean;
+    /** Cleanup interval in milliseconds */
+    cleanupIntervalMs?: number;
+}
+export declare const DEFAULT_SUBSCRIPTION_STORE_CONFIG: Required<SubscriptionStoreConfig>;
+/**
+ * In-memory subscription store with indexing and automatic cleanup
+ */
+export declare class SubscriptionStore {
+    private readonly config;
+    private readonly subscriptions;
+    private readonly taskIndex;
+    private readonly contextIndex;
+    private readonly statusIndex;
+    private cleanupTimer?;
+    constructor(config?: SubscriptionStoreConfig);
+    /**
+     * Create a new subscription
+     */
+    create(taskId: string, webhookConfig: WebhookConfig, options?: CreateSubscriptionOptions): Subscription;
+    /**
+     * Get a subscription by ID
+     */
+    get(subscriptionId: string): Subscription | null;
+    /**
+     * Get a subscription for a specific task (first active one)
+     */
+    getForTask(taskId: string): Subscription | null;
+    /**
+     * Check if a subscription exists
+     */
+    has(subscriptionId: string): boolean;
+    /**
+     * Update a subscription
+     */
+    update(subscriptionId: string, updates: UpdateSubscriptionOptions): Subscription | null;
+    /**
+     * Record a successful delivery
+     */
+    recordSuccess(subscriptionId: string): Subscription | null;
+    /**
+     * Record a failed delivery
+     */
+    recordFailure(subscriptionId: string, error: string): Subscription | null;
+    /**
+     * Delete a subscription
+     */
+    delete(subscriptionId: string): boolean;
+    /**
+     * Delete all subscriptions for a task
+     */
+    deleteForTask(taskId: string): number;
+    /**
+     * List subscriptions for a task
+     */
+    listByTask(taskId: string): Subscription[];
+    /**
+     * List subscriptions for a context
+     */
+    listByContext(contextId: string): Subscription[];
+    /**
+     * List active subscriptions for a task
+     */
+    listActiveByTask(taskId: string): Subscription[];
+    /**
+     * Query subscriptions with filtering
+     */
+    query(options?: SubscriptionQueryOptions): Subscription[];
+    /**
+     * Get all active subscriptions that should receive a specific event
+     */
+    getSubscribersForEvent(taskId: string, event: WebhookEvent): Subscription[];
+    /**
+     * Get subscription statistics
+     */
+    getStats(): SubscriptionStats;
+    /**
+     * Get total subscription count
+     */
+    get size(): number;
+    /**
+     * Clean up expired subscriptions
+     */
+    cleanupExpired(): number;
+    /**
+     * Clean up failed subscriptions
+     */
+    cleanupFailed(): number;
+    /**
+     * Clear all subscriptions
+     */
+    clear(): void;
+    /**
+     * Destroy the store
+     */
+    destroy(): void;
+    private generateId;
+    private addToTaskIndex;
+    private removeFromTaskIndex;
+    private addToContextIndex;
+    private removeFromContextIndex;
+    private startCleanupTimer;
+    private stopCleanupTimer;
+}
+/**
+ * Create a new subscription store
+ */
+export declare function createSubscriptionStore(config?: SubscriptionStoreConfig): SubscriptionStore;
+//# sourceMappingURL=subscription-store.d.ts.map

package/v3/dist/adapters/a2a/notifications/subscription-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-store.d.ts","sourceRoot":"","sources":["../../../../src/adapters/a2a/notifications/subscription-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMxE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,kCAAkC;IAClC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oBAAoB;IACpB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,qCAAqC;IACrC,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,oCAAoC;IACpC,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,+BAA+B;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wBAAwB;IACxB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,MAAM,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IACnD,2BAA2B;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAC7C,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,uBAAuB,CAO/E,CAAC;AAMF;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAC/E,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,MAAM,GAAE,uBAA4B;IAmBhD;;OAEG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,yBAA8B,GACtC,YAAY;IA+Cf;;OAEG;IACH,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIhD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAiB/C;;OAEG;IACH,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,YAAY,GAAG,IAAI;IA2DvF;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAW1D;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAezE;;OAEG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAmBvC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAoBrC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAY1C;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAYhD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAIhD;;OAEG;IACH,KAAK,CAAC,OAAO,GAAE,wBAA6B,GAAG,YAAY,EAAE;IAgD7D;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE;IAkB3E;;OAEG;IACH,QAAQ,IAAI,iBAAiB;IA8B7B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMD;;OAEG;IACH,cAAc,IAAI,MAAM;IAuBxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAavB;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;CAMzB;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,uBAA4B,GAAG,iBAAiB,CAE/F"}