universal-llm-client 3.0.0

package/dist/auditor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Universal LLM Client v3 — Auditor (Observability)
+ *
+ * Every LLM interaction (request, response, tool call, retry, failover)
+ * is recorded through the Auditor interface. Frameworks inject their own
+ * Auditor for dashboards, cost tracking, or behavioral scoring.
+ */
+import type { TokenUsageInfo, ToolExecutionResult } from './interfaces.js';
+export type AuditEventType = 'request' | 'response' | 'stream_start' | 'stream_end' | 'tool_call' | 'tool_result' | 'error' | 'retry' | 'failover';
+export interface AuditEvent {
+    /** Unix timestamp in ms */
+    timestamp: number;
+    /** Event type */
+    type: AuditEventType;
+    /** Provider that generated this event */
+    provider?: string;
+    /** Model name */
+    model?: string;
+    /** Duration in ms (for request/response pairs) */
+    duration?: number;
+    /** Token usage (for response events) */
+    usage?: TokenUsageInfo;
+    /** Tool execution details (for tool_call/tool_result events) */
+    toolExecution?: ToolExecutionResult;
+    /** Error message (for error/retry events) */
+    error?: string;
+    /** Arbitrary metadata for framework-specific data */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Interface for LLM observability.
+ *
+ * Implement this to capture all LLM lifecycle events.
+ * The library calls `record()` at every interaction point.
+ */
+export interface Auditor {
+    /** Record an audit event */
+    record(event: AuditEvent): void;
+    /** Flush any buffered events (optional) */
+    flush?(): Promise<void>;
+}
+/**
+ * Zero-overhead auditor that discards all events.
+ * Used as the default when no auditor is configured.
+ */
+export declare class NoopAuditor implements Auditor {
+    record(_event: AuditEvent): void;
+}
+/**
+ * Structured console logging auditor.
+ * Useful for development and debugging.
+ */
+export declare class ConsoleAuditor implements Auditor {
+    private prefix;
+    constructor(prefix?: string);
+    record(event: AuditEvent): void;
+}
+/**
+ * Buffered auditor that collects events for batch processing.
+ * Useful for custom sinks (OpenTelemetry, DataDog, databases, etc.)
+ */
+export declare class BufferedAuditor implements Auditor {
+    private events;
+    private maxBufferSize;
+    private onFlush?;
+    constructor(options?: {
+        maxBufferSize?: number;
+        onFlush?: (events: AuditEvent[]) => Promise<void>;
+    });
+    record(event: AuditEvent): void;
+    /** Get all buffered events */
+    getEvents(): ReadonlyArray<AuditEvent>;
+    /** Flush buffered events to the configured sink */
+    flush(): Promise<void>;
+    /** Clear all buffered events without flushing */
+    clear(): void;
+}
+//# sourceMappingURL=auditor.d.ts.map

package/dist/auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["../src/auditor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAM3E,MAAM,MAAM,cAAc,GACpB,SAAS,GACT,UAAU,GACV,cAAc,GACd,YAAY,GACZ,WAAW,GACX,aAAa,GACb,OAAO,GACP,OAAO,GACP,UAAU,CAAC;AAEjB,MAAM,WAAW,UAAU;IACvB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,gEAAgE;IAChE,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACpB,4BAA4B;IAC5B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,2CAA2C;IAC3C,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAMD;;;GAGG;AACH,qBAAa,WAAY,YAAW,OAAO;IACvC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;CAGnC;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC1C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,MAAgB;IAIpC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAkDlC;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC3C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAC,CAA0C;gBAE9C,OAAO,GAAE;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAChD;IAKN,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQ/B,8BAA8B;IAC9B,SAAS,IAAI,aAAa,CAAC,UAAU,CAAC;IAItC,mDAAmD;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,iDAAiD;IACjD,KAAK,IAAI,IAAI;CAGhB"}

package/dist/auditor.js

@@ -0,0 +1,104 @@
+/**
+ * Universal LLM Client v3 — Auditor (Observability)
+ *
+ * Every LLM interaction (request, response, tool call, retry, failover)
+ * is recorded through the Auditor interface. Frameworks inject their own
+ * Auditor for dashboards, cost tracking, or behavioral scoring.
+ */
+// ============================================================================
+// Built-in Auditors
+// ============================================================================
+/**
+ * Zero-overhead auditor that discards all events.
+ * Used as the default when no auditor is configured.
+ */
+export class NoopAuditor {
+    record(_event) {
+        // Intentionally empty
+    }
+}
+/**
+ * Structured console logging auditor.
+ * Useful for development and debugging.
+ */
+export class ConsoleAuditor {
+    prefix;
+    constructor(prefix = '[LLM]') {
+        this.prefix = prefix;
+    }
+    record(event) {
+        const parts = [
+            this.prefix,
+            event.type.toUpperCase(),
+            event.provider ? `[${event.provider}]` : '',
+            event.model ? `(${event.model})` : '',
+        ].filter(Boolean);
+        switch (event.type) {
+            case 'request':
+                console.log(parts.join(' '), '→');
+                break;
+            case 'response':
+                console.log(parts.join(' '), event.duration ? `${event.duration}ms` : '', event.usage ? `${event.usage.totalTokens} tokens` : '');
+                break;
+            case 'stream_start':
+                console.log(parts.join(' '), 'streaming...');
+                break;
+            case 'stream_end':
+                console.log(parts.join(' '), 'done', event.duration ? `${event.duration}ms` : '');
+                break;
+            case 'tool_call':
+                console.log(parts.join(' '), event.toolExecution?.tool_call_id ?? '');
+                break;
+            case 'tool_result':
+                console.log(parts.join(' '), event.toolExecution?.error ? '❌' : '✅', event.toolExecution?.duration ? `${event.toolExecution.duration}ms` : '');
+                break;
+            case 'error':
+                console.error(parts.join(' '), event.error ?? 'Unknown error');
+                break;
+            case 'retry':
+                console.warn(parts.join(' '), event.error ?? '', event.metadata ?? '');
+                break;
+            case 'failover':
+                console.warn(parts.join(' '), '→', event.metadata?.['nextProvider'] ?? '');
+                break;
+        }
+    }
+}
+/**
+ * Buffered auditor that collects events for batch processing.
+ * Useful for custom sinks (OpenTelemetry, DataDog, databases, etc.)
+ */
+export class BufferedAuditor {
+    events = [];
+    maxBufferSize;
+    onFlush;
+    constructor(options = {}) {
+        this.maxBufferSize = options.maxBufferSize ?? 1000;
+        this.onFlush = options.onFlush;
+    }
+    record(event) {
+        this.events.push(event);
+        if (this.events.length >= this.maxBufferSize) {
+            // Auto-flush when buffer is full (fire and forget)
+            this.flush().catch(() => { });
+        }
+    }
+    /** Get all buffered events */
+    getEvents() {
+        return this.events;
+    }
+    /** Flush buffered events to the configured sink */
+    async flush() {
+        if (this.events.length === 0)
+            return;
+        const batch = this.events.splice(0);
+        if (this.onFlush) {
+            await this.onFlush(batch);
+        }
+    }
+    /** Clear all buffered events without flushing */
+    clear() {
+        this.events.length = 0;
+    }
+}
+//# sourceMappingURL=auditor.js.map

package/dist/auditor.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Universal LLM Client v3 — Base LLM Client
+ *
+ * Abstract base class for all LLM providers.
+ * Handles tool registration, execution, and the autonomous
+ * multi-turn tool execution loop.
+ */
+import type { LLMClientOptions, LLMChatMessage, LLMChatResponse, LLMToolDefinition, LLMToolCall, LLMFunction, ToolRegistry, ToolHandler, ToolExecutionResult, ChatOptions, ModelMetadata } from './interfaces.js';
+import type { DecodedEvent } from './stream-decoder.js';
+import type { Auditor } from './auditor.js';
+export declare abstract class BaseLLMClient {
+    protected options: LLMClientOptions;
+    protected toolRegistry: ToolRegistry;
+    protected auditor: Auditor;
+    protected debug: boolean;
+    constructor(options: LLMClientOptions, auditor?: Auditor);
+    /** Send a chat request and get a response */
+    abstract chat(messages: LLMChatMessage[], options?: ChatOptions): Promise<LLMChatResponse>;
+    /** Stream a chat response as decoded events */
+    abstract chatStream(messages: LLMChatMessage[], options?: ChatOptions): AsyncGenerator<DecodedEvent, LLMChatResponse | void, unknown>;
+    /** Get available models */
+    abstract getModels(): Promise<string[]>;
+    /** Generate embeddings for text */
+    abstract embed(text: string): Promise<number[]>;
+    /** Generate embeddings for multiple texts */
+    embedArray(texts: string[]): Promise<number[][]>;
+    /**
+     * Get metadata about a model (context length, architecture, etc.)
+     * Override per-provider for accurate data.
+     */
+    getModelInfo(_modelName?: string): Promise<ModelMetadata>;
+    /**
+     * Sanitize tool name for LLM compatibility.
+     * LLM APIs require function names matching [a-zA-Z0-9_-].
+     * Module-prefixed names like "@core/computer:list_windows" are cleaned.
+     */
+    private sanitizeToolName;
+    /** Register a tool/function callable by the model */
+    registerTool(name: string, description: string, parameters: LLMFunction['parameters'], handler: ToolHandler): void;
+    /** Register multiple tools at once */
+    registerTools(tools: Array<{
+        name: string;
+        description: string;
+        parameters: LLMFunction['parameters'];
+        handler: ToolHandler;
+    }>): void;
+    /** Get all registered tool definitions (deduplicated by sanitized name) */
+    getToolDefinitions(): LLMToolDefinition[];
+    /** Execute a single tool call with fuzzy name matching */
+    executeTool(toolCall: LLMToolCall): Promise<ToolExecutionResult>;
+    /** Execute multiple tool calls in parallel */
+    executeTools(toolCalls: LLMToolCall[]): Promise<ToolExecutionResult[]>;
+    /**
+     * Chat with automatic tool execution.
+     * Continues until the model stops calling tools or max iterations reached.
+     * Returns the complete execution trace in `toolExecutions`.
+     */
+    chatWithTools(messages: LLMChatMessage[], options?: ChatOptions & {
+        maxIterations?: number;
+    }): Promise<LLMChatResponse>;
+    /** Set the model name at runtime */
+    setModel(modelName: string): void;
+    /** Get the current model name */
+    get model(): string;
+    /** Get the base URL */
+    get url(): string;
+    /** Set the auditor instance */
+    setAuditor(auditor: Auditor): void;
+    protected debugLog(message: string, data?: unknown): void;
+    /**
+     * Generate a unique ID for tool calls when the provider doesn't provide one.
+     */
+    protected generateToolCallId(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,240 @@
+/**
+ * Universal LLM Client v3 — Base LLM Client
+ *
+ * Abstract base class for all LLM providers.
+ * Handles tool registration, execution, and the autonomous
+ * multi-turn tool execution loop.
+ */
+import { NoopAuditor } from './auditor.js';
+// ============================================================================
+// Abstract Base Client
+// ============================================================================
+export class BaseLLMClient {
+    options;
+    toolRegistry = {};
+    auditor;
+    debug;
+    constructor(options, auditor) {
+        this.options = options;
+        this.auditor = auditor ?? new NoopAuditor();
+        this.debug = options.debug ?? false;
+    }
+    /** Generate embeddings for multiple texts */
+    async embedArray(texts) {
+        return Promise.all(texts.map(t => this.embed(t)));
+    }
+    /**
+     * Get metadata about a model (context length, architecture, etc.)
+     * Override per-provider for accurate data.
+     */
+    async getModelInfo(_modelName) {
+        return { contextLength: 8192 }; // Conservative default
+    }
+    // ========================================================================
+    // Tool Registration
+    // ========================================================================
+    /**
+     * Sanitize tool name for LLM compatibility.
+     * LLM APIs require function names matching [a-zA-Z0-9_-].
+     * Module-prefixed names like "@core/computer:list_windows" are cleaned.
+     */
+    sanitizeToolName(name) {
+        return name
+            .replace(/^@[^:]+:/, '') // Strip module prefix
+            .replace(/[^a-zA-Z0-9_-]/g, '_') // Replace illegal chars
+            .replace(/_+/g, '_') // Collapse
+            .replace(/^_|_$/g, ''); // Trim
+    }
+    /** Register a tool/function callable by the model */
+    registerTool(name, description, parameters, handler) {
+        const safeName = this.sanitizeToolName(name);
+        this.toolRegistry[name] = {
+            definition: { name: safeName, description, parameters },
+            handler,
+        };
+        // Index by sanitized name for reverse lookup
+        if (safeName !== name && !this.toolRegistry[safeName]) {
+            this.toolRegistry[safeName] = this.toolRegistry[name];
+        }
+        this.debugLog(`Registered tool: ${name} (LLM name: ${safeName})`);
+    }
+    /** Register multiple tools at once */
+    registerTools(tools) {
+        for (const tool of tools) {
+            this.registerTool(tool.name, tool.description, tool.parameters, tool.handler);
+        }
+    }
+    /** Get all registered tool definitions (deduplicated by sanitized name) */
+    getToolDefinitions() {
+        const seen = new Set();
+        const defs = [];
+        for (const { definition } of Object.values(this.toolRegistry)) {
+            if (seen.has(definition.name))
+                continue;
+            seen.add(definition.name);
+            defs.push({ type: 'function', function: definition });
+        }
+        return defs;
+    }
+    // ========================================================================
+    // Tool Execution
+    // ========================================================================
+    /** Execute a single tool call with fuzzy name matching */
+    async executeTool(toolCall) {
+        const toolName = toolCall.function.name;
+        const start = Date.now();
+        let tool = this.toolRegistry[toolName];
+        // Fuzzy lookup: try suffix match (LLM stripped module prefix)
+        if (!tool) {
+            const entries = Object.entries(this.toolRegistry);
+            const bySuffix = entries.find(([k]) => k.endsWith(`:${toolName}`));
+            if (bySuffix) {
+                tool = bySuffix[1];
+                this.debugLog(`Fuzzy tool match: "${toolName}" → "${bySuffix[0]}"`);
+            }
+            // Try prefix match: if only one tool in that module, use it
+            if (!tool) {
+                const byPrefix = entries.filter(([k]) => k.startsWith(`${toolName}:`));
+                if (byPrefix.length === 1) {
+                    tool = byPrefix[0][1];
+                    this.debugLog(`Fuzzy tool match (single): "${toolName}" → "${byPrefix[0][0]}"`);
+                }
+            }
+        }
+        if (!tool) {
+            const result = {
+                tool_call_id: toolCall.id,
+                output: null,
+                error: `Unknown tool: ${toolName}`,
+                duration: Date.now() - start,
+            };
+            this.auditor.record({
+                timestamp: Date.now(),
+                type: 'tool_result',
+                toolExecution: result,
+                error: result.error,
+            });
+            return result;
+        }
+        this.auditor.record({
+            timestamp: Date.now(),
+            type: 'tool_call',
+            metadata: { toolName, arguments: toolCall.function.arguments },
+        });
+        try {
+            const args = JSON.parse(toolCall.function.arguments);
+            const output = await tool.handler(args);
+            const result = {
+                tool_call_id: toolCall.id,
+                output,
+                duration: Date.now() - start,
+            };
+            this.auditor.record({
+                timestamp: Date.now(),
+                type: 'tool_result',
+                toolExecution: result,
+            });
+            return result;
+        }
+        catch (error) {
+            const result = {
+                tool_call_id: toolCall.id,
+                output: null,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - start,
+            };
+            this.auditor.record({
+                timestamp: Date.now(),
+                type: 'tool_result',
+                toolExecution: result,
+                error: result.error,
+            });
+            return result;
+        }
+    }
+    /** Execute multiple tool calls in parallel */
+    async executeTools(toolCalls) {
+        return Promise.all(toolCalls.map(tc => this.executeTool(tc)));
+    }
+    // ========================================================================
+    // Chat with Tools (multi-turn autonomous loop)
+    // ========================================================================
+    /**
+     * Chat with automatic tool execution.
+     * Continues until the model stops calling tools or max iterations reached.
+     * Returns the complete execution trace in `toolExecutions`.
+     */
+    async chatWithTools(messages, options) {
+        const maxIterations = options?.maxIterations ?? 10;
+        const conversationMessages = [...messages];
+        const allToolExecutions = [];
+        let iterations = 0;
+        while (iterations < maxIterations) {
+            const response = await this.chat(conversationMessages, {
+                ...options,
+                tools: this.getToolDefinitions(),
+            });
+            // If no tool calls, return with full trace
+            if (!response.message.tool_calls?.length) {
+                return {
+                    ...response,
+                    toolExecutions: allToolExecutions.length > 0 ? allToolExecutions : undefined,
+                };
+            }
+            // Add assistant message with tool calls
+            conversationMessages.push(response.message);
+            // Execute tools in parallel
+            const toolResults = await this.executeTools(response.message.tool_calls);
+            allToolExecutions.push(...toolResults);
+            // Add tool results as messages
+            for (const result of toolResults) {
+                conversationMessages.push({
+                    role: 'tool',
+                    content: typeof result.output === 'string'
+                        ? result.output
+                        : JSON.stringify(result.output),
+                    tool_call_id: result.tool_call_id,
+                });
+            }
+            iterations++;
+        }
+        // Max iterations — final call without tools
+        const finalResponse = await this.chat(conversationMessages);
+        return {
+            ...finalResponse,
+            toolExecutions: allToolExecutions,
+        };
+    }
+    // ========================================================================
+    // Helpers
+    // ========================================================================
+    /** Set the model name at runtime */
+    setModel(modelName) {
+        this.options.model = modelName;
+        this.debugLog(`Model switched to: ${modelName}`);
+    }
+    /** Get the current model name */
+    get model() {
+        return this.options.model;
+    }
+    /** Get the base URL */
+    get url() {
+        return this.options.url;
+    }
+    /** Set the auditor instance */
+    setAuditor(auditor) {
+        this.auditor = auditor;
+    }
+    debugLog(message, data) {
+        if (this.debug) {
+            console.log(`[LLM:${this.options.model}] ${message}`, data ?? '');
+        }
+    }
+    /**
+     * Generate a unique ID for tool calls when the provider doesn't provide one.
+     */
+    generateToolCallId() {
+        return `call_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+    }
+}
+//# 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/http.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Universal LLM Client v3 — HTTP Utilities
+ *
+ * Zero-dependency HTTP layer using native fetch.
+ * Works on Node 22+, Bun, Deno, and browsers.
+ */
+import type { LLMClientOptions } from './interfaces.js';
+export interface HttpRequestOptions {
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeout?: number;
+    signal?: AbortSignal;
+}
+export interface HttpResponse<T = unknown> {
+    ok: boolean;
+    status: number;
+    data: T;
+}
+/**
+ * Make an HTTP request with timeout and error handling.
+ * Uses native fetch (available in all target runtimes).
+ */
+export declare function httpRequest<T = unknown>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Make a streaming HTTP request.
+ * Yields raw string chunks as they arrive.
+ */
+export declare function httpStream(url: string, options?: HttpRequestOptions): AsyncGenerator<string, void, unknown>;
+/**
+ * Parse NDJSON (newline-delimited JSON) stream.
+ * Used by Ollama's streaming API.
+ */
+export declare function parseNDJSON<T = unknown>(stream: AsyncGenerator<string>): AsyncGenerator<T, void, unknown>;
+/**
+ * Parse Server-Sent Events stream.
+ * Used by OpenAI-compatible APIs and LlamaCpp/vLLM.
+ */
+export declare function parseSSE(stream: AsyncGenerator<string>): AsyncGenerator<{
+    event?: string;
+    data: string;
+}, void, unknown>;
+/**
+ * Build standard headers for LLM API requests.
+ */
+export declare function buildHeaders(options: LLMClientOptions): Record<string, string>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMxD,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACX;AAMD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CA4C1B;AAMD;;;GAGG;AACH,wBAAuB,UAAU,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GACjC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAoDvC;AAMD;;;GAGG;AACH,wBAAuB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC1C,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAC/B,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CA4BlC;AAED;;;GAGG;AACH,wBAAuB,QAAQ,CAC3B,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAC/B,cAAc,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CA6BjE;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU9E"}