@chanl/sdk 2.0.1

package/dist/client.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChanlSDK = void 0;
+const audio_1 = require("./modules/audio");
+const transcript_1 = require("./modules/transcript");
+const scorecard_1 = require("./modules/scorecard");
+const workspace_1 = require("./modules/workspace");
+const alerts_1 = require("./modules/alerts");
+const auth_1 = require("./modules/auth");
+const health_1 = require("./modules/health");
+const prompts_1 = require("./modules/prompts");
+const tools_1 = require("./modules/tools");
+const toolsets_1 = require("./modules/toolsets");
+const scenarios_1 = require("./modules/scenarios");
+const agents_1 = require("./modules/agents");
+const personas_1 = require("./modules/personas");
+const calls_1 = require("./modules/calls");
+const mcp_1 = require("./modules/mcp");
+const knowledge_1 = require("./modules/knowledge");
+const memory_1 = require("./modules/memory");
+const chat_1 = require("./modules/chat");
+class ChanlSDK {
+    constructor(config) {
+        this.config = {
+            timeout: 30000,
+            debug: false,
+            retry: {
+                maxRetries: 3,
+                retryDelay: 1000,
+                backoffMultiplier: 2,
+            },
+            ...config,
+        };
+        // Initialize modules
+        this.audio = new audio_1.AudioModule(this);
+        this.transcript = new transcript_1.TranscriptModule(this);
+        this.scorecard = new scorecard_1.ScorecardModule(this);
+        this.workspace = new workspace_1.WorkspaceModule(this);
+        this.alerts = new alerts_1.AlertModule(this);
+        this.auth = new auth_1.AuthModule(this);
+        this.health = new health_1.HealthModule(this);
+        this.prompts = new prompts_1.PromptsModule(this);
+        this.tools = new tools_1.ToolsModule(this);
+        this.toolsets = new toolsets_1.ToolsetsModule(this);
+        this.scenarios = new scenarios_1.ScenariosModule(this);
+        this.agents = new agents_1.AgentsModule(this);
+        this.personas = new personas_1.PersonasModule(this);
+        this.calls = new calls_1.CallsModule(this);
+        this.mcp = new mcp_1.McpModule(this);
+        this.knowledge = new knowledge_1.KnowledgeModule(this);
+        this.memory = new memory_1.MemoryModule(this);
+        this.chat = new chat_1.ChatModule(this);
+    }
+    /**
+     * Make a request to the API
+     */
+    async request(method, url, data, config) {
+        // Check if data is FormData (Node.js form-data package or native FormData)
+        const isNodeFormData = data != null &&
+            typeof data
+                .getHeaders === "function";
+        const isNativeFormData = typeof FormData !== "undefined" && data instanceof FormData;
+        const isFormData = isNodeFormData || isNativeFormData;
+        // Build full URL
+        const fullUrl = new URL(url, this.config.baseUrl).toString();
+        // Build headers
+        const headers = {
+            ...this.config.headers,
+            ...config?.headers,
+        };
+        // Set Content-Type for non-FormData requests (FormData sets its own boundary)
+        if (!isFormData && !headers["Content-Type"]) {
+            headers["Content-Type"] = "application/json";
+        }
+        // Remove Content-Type for FormData to let fetch/runtime set it with boundary
+        if (isFormData) {
+            delete headers["Content-Type"];
+        }
+        // Add authentication
+        if (this.config.apiKey) {
+            headers["X-API-Key"] = this.config.apiKey;
+        }
+        else if (this.config.jwtToken) {
+            headers["Authorization"] = `Bearer ${this.config.jwtToken}`;
+        }
+        // Add workspace context
+        if (this.config.workspaceId) {
+            headers["x-workspace-id"] = this.config.workspaceId;
+        }
+        // Setup timeout via AbortController
+        const timeout = config?.timeout ?? this.config.timeout ?? 30000;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        // Build fetch options
+        const fetchOptions = {
+            method,
+            headers,
+            signal: controller.signal,
+        };
+        // Attach body if present
+        if (data != null) {
+            if (isFormData) {
+                // Pass FormData directly (works for both Node.js form-data and native FormData)
+                fetchOptions.body = data;
+            }
+            else {
+                fetchOptions.body = JSON.stringify(data);
+            }
+        }
+        try {
+            const response = await fetch(fullUrl, fetchOptions);
+            if (!response.ok) {
+                // Try to parse error body for a meaningful message
+                let errorMessage = "API Error";
+                try {
+                    const errorBody = (await response.json());
+                    errorMessage =
+                        errorBody.error?.message || errorBody.message || "API Error";
+                }
+                catch {
+                    // JSON parse failed, use status text
+                    errorMessage = response.statusText || "API Error";
+                }
+                throw new Error(errorMessage);
+            }
+            // Handle 204 No Content
+            if (response.status === 204) {
+                return {};
+            }
+            const json = await response.json();
+            const body = json;
+            // Normalize response shape to { success, data, message, timestamp }.
+            // API responses come in several shapes depending on the service/gateway:
+            //   1. { success, data, message, timestamp } — standard ResponseInterceptor
+            //   2. { data: { ... } }                    — partial wrapper (no success)
+            //   3. { agents, pagination }               — raw unwrapped
+            let normalized;
+            if (body['success'] !== undefined) {
+                // Case 1: fully wrapped
+                normalized = json;
+            }
+            else if (body['data'] !== undefined && Object.keys(body).length <= 3) {
+                // Case 2: has { data } wrapper but no success — add success
+                normalized = {
+                    success: true,
+                    data: body['data'],
+                    message: body['message'] || 'Success',
+                    timestamp: body['timestamp'] || new Date().toISOString(),
+                };
+            }
+            else {
+                // Case 3: raw unwrapped — wrap entire body as data
+                normalized = {
+                    success: true,
+                    data: json,
+                    message: 'Success',
+                    timestamp: new Date().toISOString(),
+                };
+            }
+            // Normalize _id → id in response data
+            if (normalized.data !== undefined) {
+                normalized.data = this.normalizeIds(normalized.data);
+            }
+            // Unwrap single-entity responses: { agent: {...} } → {...}
+            // API get-by-id endpoints return { entityName: { ...entity } }.
+            // Unwrap so consumers get the entity directly as `data`.
+            if (normalized.data !== null && typeof normalized.data === 'object' && !Array.isArray(normalized.data)) {
+                const dataObj = normalized.data;
+                const keys = Object.keys(dataObj);
+                const singleKey = keys.length === 1 ? keys[0] : undefined;
+                if (singleKey) {
+                    const value = dataObj[singleKey];
+                    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                        normalized.data = value;
+                    }
+                }
+            }
+            return normalized;
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === "AbortError") {
+                throw new Error(`Request timeout after ${timeout}ms`);
+            }
+            // Re-throw errors we already created above, or wrap unknown errors
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error("Network Error");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Make a streaming request that returns the raw Response.
+     *
+     * Unlike `request()`, this does NOT parse JSON or apply timeout.
+     * The caller reads `response.body` via `getReader()`.
+     * Used for SSE / chunked-transfer endpoints (e.g., chat streaming).
+     */
+    async requestStream(method, url, data) {
+        const fullUrl = new URL(url, this.config.baseUrl).toString();
+        const headers = {
+            ...this.config.headers,
+            'Content-Type': 'application/json',
+            'Accept': 'text/event-stream',
+        };
+        if (this.config.apiKey) {
+            headers['X-API-Key'] = this.config.apiKey;
+        }
+        else if (this.config.jwtToken) {
+            headers['Authorization'] = `Bearer ${this.config.jwtToken}`;
+        }
+        if (this.config.workspaceId) {
+            headers['x-workspace-id'] = this.config.workspaceId;
+        }
+        const fetchOptions = {
+            method,
+            headers,
+        };
+        if (data != null) {
+            fetchOptions.body = JSON.stringify(data);
+        }
+        const response = await fetch(fullUrl, fetchOptions);
+        if (!response.ok) {
+            let errorMessage = 'API Error';
+            try {
+                const errorBody = (await response.json());
+                errorMessage =
+                    errorBody.error?.message || errorBody.message || 'API Error';
+            }
+            catch {
+                errorMessage = response.statusText || 'API Error';
+            }
+            throw new Error(errorMessage);
+        }
+        return response;
+    }
+    /**
+     * Recursively normalize _id → id in response data.
+     * Skips if id already exists to avoid overwriting.
+     */
+    normalizeIds(data) {
+        if (data === null || data === undefined || typeof data !== "object") {
+            return data;
+        }
+        if (Array.isArray(data)) {
+            return data.map((item) => this.normalizeIds(item));
+        }
+        const obj = data;
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (key === "_id" && !("id" in obj)) {
+                result["id"] = value;
+            }
+            else if (key === "_id" && "id" in obj) {
+                // Skip _id when id already exists
+                continue;
+            }
+            else {
+                result[key] = this.normalizeIds(value);
+            }
+        }
+        return result;
+    }
+    /**
+     * Update authentication credentials
+     */
+    updateAuth(authConfig) {
+        if (authConfig.apiKey) {
+            this.config.apiKey = authConfig.apiKey;
+            delete this.config.jwtToken;
+        }
+        else if (authConfig.jwtToken) {
+            this.config.jwtToken = authConfig.jwtToken;
+            delete this.config.apiKey;
+        }
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Enable/disable debug logging
+     */
+    setDebug(enabled) {
+        this.config.debug = enabled;
+    }
+}
+exports.ChanlSDK = ChanlSDK;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Custom Error Classes for @chanl-ai/sdk
+ *
+ * TDD Phase: RED - These errors define the error handling contract
+ *
+ * Design Principles:
+ * - Error transparency: Include code, message, and context for debugging
+ * - HTTP status awareness: Map API response codes to specific error types
+ * - Serializable details: Allow JSON serialization for logging
+ */
+/**
+ * Options type for ChanlError constructor
+ * Uses explicit `| undefined` to be compatible with exactOptionalPropertyTypes
+ */
+interface ChanlErrorOptions {
+    code?: string | undefined;
+    statusCode?: number | undefined;
+    details?: Record<string, unknown> | undefined;
+    cause?: Error | undefined;
+    requestId?: string | undefined;
+}
+/**
+ * Base error class for all Chanl SDK errors
+ */
+export declare class ChanlError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: string;
+    /** HTTP status code if from API response */
+    readonly statusCode?: number;
+    /** Additional error details for debugging */
+    readonly details?: Record<string, unknown>;
+    /** Original error if wrapping another error */
+    readonly cause?: Error;
+    /** Request ID from API for tracing */
+    readonly requestId?: string;
+    constructor(message: string, options?: ChanlErrorOptions);
+    /**
+     * Convert error to JSON for logging/serialization
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when a requested resource is not found (404)
+ */
+export declare class NotFoundError extends ChanlError {
+    /** The type of resource that was not found */
+    readonly resourceType: string;
+    /** The identifier that was used to look up the resource */
+    readonly resourceId: string;
+    constructor(resourceType: string, resourceId: string, options?: {
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+}
+/**
+ * Error thrown when input validation fails (400)
+ */
+export declare class ValidationError extends ChanlError {
+    /** Field-level validation errors */
+    readonly fieldErrors?: Record<string, string[]>;
+    constructor(message: string, options?: {
+        fieldErrors?: Record<string, string[]> | undefined;
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+    /**
+     * Get validation errors for a specific field
+     */
+    getFieldErrors(field: string): string[];
+    /**
+     * Check if a specific field has validation errors
+     */
+    hasFieldError(field: string): boolean;
+}
+/**
+ * Error thrown when authentication fails (401)
+ */
+export declare class AuthenticationError extends ChanlError {
+    constructor(message?: string, options?: {
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+}
+/**
+ * Error thrown when authorization fails (403)
+ */
+export declare class AuthorizationError extends ChanlError {
+    /** The action that was attempted */
+    readonly action?: string;
+    /** The resource that was being accessed */
+    readonly resource?: string;
+    constructor(message?: string, options?: {
+        action?: string | undefined;
+        resource?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+}
+/**
+ * Error thrown when there's a conflict (409)
+ */
+export declare class ConflictError extends ChanlError {
+    /** The conflicting resource identifier */
+    readonly conflictingResource?: string;
+    constructor(message: string, options?: {
+        conflictingResource?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+}
+/**
+ * Error thrown when rate limit is exceeded (429)
+ */
+export declare class RateLimitError extends ChanlError {
+    /** When the rate limit resets (Unix timestamp) */
+    readonly retryAfter?: number;
+    constructor(message?: string, options?: {
+        retryAfter?: number | undefined;
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+}
+/**
+ * Error thrown when API server fails (5xx)
+ */
+export declare class ServerError extends ChanlError {
+    constructor(message?: string, options?: {
+        statusCode?: number | undefined;
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+}
+/**
+ * Error thrown for network/connection issues
+ */
+export declare class NetworkError extends ChanlError {
+    constructor(message?: string, options?: {
+        cause?: Error | undefined;
+        details?: Record<string, unknown> | undefined;
+    });
+}
+/**
+ * Error thrown when request times out
+ */
+export declare class TimeoutError extends ChanlError {
+    /** Timeout duration in milliseconds */
+    readonly timeoutMs?: number;
+    constructor(message?: string, options?: {
+        timeoutMs?: number | undefined;
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+    });
+}
+/**
+ * Type guard to check if error is a ChanlError
+ */
+export declare function isChanlError(error: unknown): error is ChanlError;
+/**
+ * Type guard to check if error is a NotFoundError
+ */
+export declare function isNotFoundError(error: unknown): error is NotFoundError;
+/**
+ * Type guard to check if error is a ValidationError
+ */
+export declare function isValidationError(error: unknown): error is ValidationError;
+/**
+ * Type guard to check if error is an AuthenticationError
+ */
+export declare function isAuthenticationError(error: unknown): error is AuthenticationError;
+/**
+ * Factory function to create appropriate error from API response
+ */
+export declare function createErrorFromResponse(statusCode: number, message: string, options?: {
+    details?: Record<string, unknown> | undefined;
+    requestId?: string | undefined;
+    fieldErrors?: Record<string, string[]> | undefined;
+}): ChanlError;
+export {};
+//# 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;;;;;;;;;GASG;AAEH;;;GAGG;AACH,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,2CAA2C;IAC3C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,6CAA6C;IAC7C,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,+CAA+C;IAC/C,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;IAC9B,sCAAsC;IACtC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAyB5D;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAWlC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,8CAA8C;IAC9C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,2DAA2D;IAC3D,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAGjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CAkBT;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,oCAAoC;IACpC,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAGrD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;QACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;IAqBR;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGtC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBAE/C,OAAO,SAA4B,EACnC,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CAUT;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,oCAAoC;IACpC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,2CAA2C;IAC3C,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGhC,OAAO,SAAsB,EAC7B,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CA0BT;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,0CAA0C;IAC1C,SAAgB,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CAoBT;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,kDAAkD;IAClD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,OAAO,SAAwB,EAC/B,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CAoBT;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAEvC,OAAO,SAA0B,EACjC,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CAUT;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAExC,OAAO,SAAkB,EACzB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC1C;CAST;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,uCAAuC;IACvC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,SAAoB,EAC3B,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CAmBT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAE9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;CAC/C,GACL,UAAU,CA2BZ"}