@wundr.io/langgraph-orchestrator 1.0.3

package/dist/edges/loop-edge.js

@@ -0,0 +1,503 @@
+"use strict";
+/**
+ * Loop Edge - Cyclic edges for iterative workflows
+ * @module @wundr.io/langgraph-orchestrator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoopConfigSchema = exports.LoopEdgeBuilder = void 0;
+exports.loopEdge = loopEdge;
+exports.createForLoop = createForLoop;
+exports.createWhileLoop = createWhileLoop;
+exports.createDoWhileLoop = createDoWhileLoop;
+exports.createRetryLoop = createRetryLoop;
+exports.createPaginationLoop = createPaginationLoop;
+exports.validateLoopConfig = validateLoopConfig;
+const zod_1 = require("zod");
+/**
+ * Builder for loop edges with fluent API
+ */
+class LoopEdgeBuilder {
+    from;
+    to;
+    maxIterations = 100;
+    counterField = '__loopCounter';
+    condition;
+    exitNode;
+    onMaxIterations = 'exit';
+    /**
+     * Create a new loop edge builder
+     * @param from - Source node name
+     * @param to - Target node name (can be same as from for self-loop)
+     */
+    constructor(from, to) {
+        this.from = from;
+        this.to = to ?? from; // Default to self-loop
+    }
+    /**
+     * Set maximum iterations
+     * @param max - Maximum number of loop iterations
+     * @returns this for chaining
+     */
+    maxIter(max) {
+        this.maxIterations = max;
+        return this;
+    }
+    /**
+     * Set the counter field name in state
+     * @param field - Field name for storing iteration count
+     * @returns this for chaining
+     */
+    counter(field) {
+        this.counterField = field;
+        return this;
+    }
+    /**
+     * Set condition to continue looping
+     * @param condition - Condition that must be true to continue
+     * @returns this for chaining
+     */
+    while(condition) {
+        this.condition = condition;
+        return this;
+    }
+    /**
+     * Continue while field equals value
+     * @param field - Field to check
+     * @param value - Expected value
+     * @returns this for chaining
+     */
+    whileEquals(field, value) {
+        return this.while({ type: 'equals', field, value });
+    }
+    /**
+     * Continue while field is less than value
+     * @param field - Field to check
+     * @param value - Maximum value
+     * @returns this for chaining
+     */
+    whileLessThan(field, value) {
+        return this.while({ type: 'less_than', field, value });
+    }
+    /**
+     * Continue while custom condition is true
+     * @param evaluate - Custom evaluator function
+     * @returns this for chaining
+     */
+    whileCustom(evaluate) {
+        return this.while({
+            type: 'custom',
+            evaluate: evaluate,
+        });
+    }
+    /**
+     * Set the exit node when loop completes
+     * @param node - Node to transition to after loop
+     * @returns this for chaining
+     */
+    exitTo(node) {
+        this.exitNode = node;
+        return this;
+    }
+    /**
+     * Set behavior when max iterations reached
+     * @param behavior - What to do on max iterations
+     * @returns this for chaining
+     */
+    onMax(behavior) {
+        this.onMaxIterations = behavior;
+        return this;
+    }
+    /**
+     * Build the loop edge configuration
+     * @returns LoopConfig object
+     */
+    build() {
+        if (!this.condition) {
+            throw new Error('Loop condition is required. Call while() before build()');
+        }
+        return {
+            maxIterations: this.maxIterations,
+            counterField: this.counterField,
+            condition: this.condition,
+            onMaxIterations: this.onMaxIterations,
+            exitNode: this.exitNode,
+        };
+    }
+    /**
+     * Build as EdgeDefinition
+     * @returns EdgeDefinition for the loop
+     */
+    buildEdge() {
+        if (!this.condition) {
+            throw new Error('Loop condition is required. Call while() before buildEdge()');
+        }
+        return {
+            from: this.from,
+            to: this.to,
+            type: 'loop',
+            condition: this.createLoopCondition(),
+            metadata: {
+                maxIterations: this.maxIterations,
+                counterField: this.counterField,
+                onMaxIterations: this.onMaxIterations,
+                exitNode: this.exitNode,
+            },
+        };
+    }
+    /**
+     * Create the composite loop condition
+     */
+    createLoopCondition() {
+        const originalCondition = this.condition;
+        const maxIterations = this.maxIterations;
+        const counterField = this.counterField;
+        const onMaxIterations = this.onMaxIterations;
+        return {
+            type: 'custom',
+            evaluate: async (state, context) => {
+                // Get current iteration count
+                const currentCount = state.data[counterField] ?? 0;
+                // Check max iterations
+                if (currentCount >= maxIterations) {
+                    if (onMaxIterations === 'error') {
+                        throw new Error(`Loop exceeded maximum iterations (${maxIterations})`);
+                    }
+                    return false; // Exit loop
+                }
+                // Evaluate the actual condition
+                return await evaluateCondition(originalCondition, state, context);
+            },
+        };
+    }
+}
+exports.LoopEdgeBuilder = LoopEdgeBuilder;
+/**
+ * Create a loop edge builder
+ *
+ * @example
+ * ```typescript
+ * const loopEdge = loopEdge('process')
+ *   .maxIter(10)
+ *   .whileLessThan('data.retryCount', 3)
+ *   .exitTo('success')
+ *   .onMax('exit')
+ *   .buildEdge();
+ *
+ * graph.addLoopEdge(loopEdge.from, loopEdge.to, loopEdge.condition!);
+ * ```
+ *
+ * @param from - Source node name
+ * @param to - Optional target node (defaults to from for self-loop)
+ * @returns LoopEdgeBuilder
+ */
+function loopEdge(from, to) {
+    return new LoopEdgeBuilder(from, to);
+}
+/**
+ * Create a for-loop style edge
+ *
+ * @example
+ * ```typescript
+ * const forLoop = createForLoop({
+ *   from: 'process-item',
+ *   iterations: 5,
+ *   counterField: 'data.itemIndex',
+ *   exitNode: 'complete'
+ * });
+ * ```
+ *
+ * @param options - For loop configuration
+ * @returns EdgeDefinition for the loop
+ */
+function createForLoop(options) {
+    const counterField = options.counterField ?? '__forLoopCounter';
+    return {
+        from: options.from,
+        to: options.to ?? options.from,
+        type: 'loop',
+        condition: {
+            type: 'custom',
+            evaluate: async (state) => {
+                const current = state.data[counterField] ?? 0;
+                return current < options.iterations;
+            },
+        },
+        metadata: {
+            loopType: 'for',
+            iterations: options.iterations,
+            counterField,
+            exitNode: options.exitNode,
+        },
+    };
+}
+/**
+ * Create a while-loop style edge
+ *
+ * @example
+ * ```typescript
+ * const whileLoop = createWhileLoop({
+ *   from: 'check',
+ *   to: 'process',
+ *   condition: conditions.lessThan('data.errorCount', 5),
+ *   exitNode: 'done',
+ *   maxIterations: 100
+ * });
+ * ```
+ *
+ * @param options - While loop configuration
+ * @returns EdgeDefinition for the loop
+ */
+function createWhileLoop(options) {
+    const maxIterations = options.maxIterations ?? 1000;
+    return {
+        from: options.from,
+        to: options.to ?? options.from,
+        type: 'loop',
+        condition: {
+            type: 'custom',
+            evaluate: async (state, context) => {
+                // Check iteration guard
+                const iterations = context.graph?.config?.maxIterations ?? maxIterations;
+                if (state.metadata.stepCount >= iterations) {
+                    return false;
+                }
+                return await evaluateCondition(options.condition, state, context);
+            },
+        },
+        metadata: {
+            loopType: 'while',
+            exitNode: options.exitNode,
+            maxIterations,
+        },
+    };
+}
+/**
+ * Create a do-while loop (executes at least once)
+ *
+ * @example
+ * ```typescript
+ * const doWhileLoop = createDoWhileLoop({
+ *   from: 'retry',
+ *   condition: conditions.equals('data.success', false),
+ *   exitNode: 'complete',
+ *   maxIterations: 5
+ * });
+ * ```
+ *
+ * @param options - Do-while loop configuration
+ * @returns EdgeDefinition for the loop
+ */
+function createDoWhileLoop(options) {
+    const maxIterations = options.maxIterations ?? 1000;
+    return {
+        from: options.from,
+        to: options.to ?? options.from,
+        type: 'loop',
+        condition: {
+            type: 'custom',
+            evaluate: async (state, context) => {
+                // Check iteration guard
+                const iterations = context.graph?.config?.maxIterations ?? maxIterations;
+                if (state.metadata.stepCount >= iterations) {
+                    return false;
+                }
+                // First iteration always executes (check if this is first time through)
+                const loopCount = state.data['__doWhileCount'] ?? 0;
+                if (loopCount === 0) {
+                    return true;
+                }
+                return await evaluateCondition(options.condition, state, context);
+            },
+        },
+        metadata: {
+            loopType: 'do-while',
+            exitNode: options.exitNode,
+            maxIterations,
+        },
+    };
+}
+/**
+ * Create a retry loop with exponential backoff
+ *
+ * @example
+ * ```typescript
+ * const retryLoop = createRetryLoop({
+ *   from: 'api-call',
+ *   maxRetries: 3,
+ *   exitOnSuccess: 'process-result',
+ *   exitOnFailure: 'handle-error',
+ *   successCondition: conditions.equals('data.success', true)
+ * });
+ * ```
+ *
+ * @param options - Retry loop configuration
+ * @returns EdgeDefinition for the loop
+ */
+function createRetryLoop(options) {
+    const retryCountField = options.retryCountField ?? '__retryCount';
+    return {
+        from: options.from,
+        to: options.to ?? options.from,
+        type: 'loop',
+        condition: {
+            type: 'custom',
+            evaluate: async (state, context) => {
+                const retryCount = state.data[retryCountField] ?? 0;
+                // Check if we've succeeded
+                const succeeded = await evaluateCondition(options.successCondition, state, context);
+                if (succeeded) {
+                    return false; // Exit loop to success node
+                }
+                // Check if we've exhausted retries
+                if (retryCount >= options.maxRetries) {
+                    return false; // Exit loop to failure node
+                }
+                // Continue retrying
+                return true;
+            },
+        },
+        metadata: {
+            loopType: 'retry',
+            maxRetries: options.maxRetries,
+            retryCountField,
+            exitOnSuccess: options.exitOnSuccess,
+            exitOnFailure: options.exitOnFailure,
+        },
+    };
+}
+/**
+ * Create a pagination loop for iterating through paged data
+ *
+ * @example
+ * ```typescript
+ * const paginationLoop = createPaginationLoop({
+ *   from: 'fetch-page',
+ *   pageField: 'data.currentPage',
+ *   hasMoreField: 'data.hasMore',
+ *   exitNode: 'process-all'
+ * });
+ * ```
+ *
+ * @param options - Pagination loop configuration
+ * @returns EdgeDefinition for the loop
+ */
+function createPaginationLoop(options) {
+    const pageField = options.pageField ?? '__currentPage';
+    const maxPages = options.maxPages ?? 1000;
+    return {
+        from: options.from,
+        to: options.to ?? options.from,
+        type: 'loop',
+        condition: {
+            type: 'custom',
+            evaluate: async (state) => {
+                const currentPage = state.data[pageField] ?? 0;
+                // Check page limit
+                if (currentPage >= maxPages) {
+                    return false;
+                }
+                // Check if there are more pages
+                const hasMore = getFieldValue(state, options.hasMoreField);
+                return hasMore === true;
+            },
+        },
+        metadata: {
+            loopType: 'pagination',
+            pageField,
+            hasMoreField: options.hasMoreField,
+            maxPages,
+            exitNode: options.exitNode,
+        },
+    };
+}
+/**
+ * Evaluate a condition against state
+ */
+async function evaluateCondition(condition, state, context) {
+    const fieldValue = condition.field
+        ? getFieldValue(state, condition.field)
+        : undefined;
+    switch (condition.type) {
+        case 'equals':
+            return fieldValue === condition.value;
+        case 'not_equals':
+            return fieldValue !== condition.value;
+        case 'contains':
+            if (Array.isArray(fieldValue)) {
+                return fieldValue.includes(condition.value);
+            }
+            if (typeof fieldValue === 'string') {
+                return fieldValue.includes(String(condition.value));
+            }
+            return false;
+        case 'greater_than':
+            return (typeof fieldValue === 'number' &&
+                typeof condition.value === 'number' &&
+                fieldValue > condition.value);
+        case 'less_than':
+            return (typeof fieldValue === 'number' &&
+                typeof condition.value === 'number' &&
+                fieldValue < condition.value);
+        case 'exists':
+            return fieldValue !== undefined && fieldValue !== null;
+        case 'not_exists':
+            return fieldValue === undefined || fieldValue === null;
+        case 'custom':
+            if (condition.evaluate) {
+                return await condition.evaluate(state, context);
+            }
+            return false;
+        default:
+            return false;
+    }
+}
+/**
+ * Get a nested field value from state
+ */
+function getFieldValue(state, field) {
+    const parts = field.split('.');
+    let current = state;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Schema for loop configuration validation
+ */
+exports.LoopConfigSchema = zod_1.z.object({
+    maxIterations: zod_1.z.number().min(1).optional(),
+    counterField: zod_1.z.string().optional(),
+    condition: zod_1.z.object({
+        type: zod_1.z.enum([
+            'equals',
+            'not_equals',
+            'contains',
+            'greater_than',
+            'less_than',
+            'exists',
+            'not_exists',
+            'custom',
+        ]),
+        field: zod_1.z.string().optional(),
+        value: zod_1.z.unknown().optional(),
+    }),
+    onMaxIterations: zod_1.z.enum(['error', 'exit', 'force-exit']).optional(),
+    exitNode: zod_1.z.string().optional(),
+});
+/**
+ * Validate a loop configuration
+ */
+function validateLoopConfig(config) {
+    try {
+        exports.LoopConfigSchema.parse(config);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=loop-edge.js.map

package/dist/edges/loop-edge.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * LangGraph Orchestrator - LangGraph-style cyclic, state-driven workflows
+ * @module @wundr.io/langgraph-orchestrator
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   StateGraph,
+ *   createLLMNode,
+ *   createToolNode,
+ *   createDecisionNode,
+ *   MemoryCheckpointer
+ * } from '@wundr.io/langgraph-orchestrator';
+ *
+ * // Create a workflow graph
+ * const graph = new StateGraph('my-workflow')
+ *   .addNode('agent', createLLMNode({
+ *     id: 'agent',
+ *     name: 'Agent',
+ *     config: { model: 'claude-3-sonnet-20240229' }
+ *   }))
+ *   .addNode('tools', createToolNode({
+ *     id: 'tools',
+ *     name: 'Tools'
+ *   }))
+ *   .addEdge('agent', 'tools')
+ *   .addConditionalEdge('tools', 'agent', {
+ *     type: 'exists',
+ *     field: 'data.pendingToolCalls'
+ *   })
+ *   .setEntryPoint('agent')
+ *   .setCheckpointer(new MemoryCheckpointer());
+ *
+ * // Execute the workflow
+ * const result = await graph.execute({
+ *   initialState: {
+ *     data: { task: 'Research AI developments' }
+ *   }
+ * });
+ * ```
+ */
+import { StateGraph as StateGraphClass } from './state-graph';
+import type { LLMProvider, Tool } from './types';
+export type { AgentState, Message, MessageRole, ToolCall, ToolResult, StateHistoryEntry, StateChange, WorkflowError, StateMetadata, GraphConfig, GraphGlobalConfig, RetryConfig, LogLevel, NodeDefinition, NodeType, NodeConfig, NodeExecutor, NodeContext, NodeServices, NodeResult, NodeExecutionMetadata, NodeHook, Logger, Tool, ToolRegistry, LLMProvider, LLMRequest, LLMResponse, TokenUsage, FinishReason, LLMStreamChunk, EdgeDefinition, EdgeType, EdgeCondition, ConditionType, EdgeConditionEvaluator, EdgeContext, GraphCheckpointer, Checkpoint, CheckpointSummary, ExecutionOptions, ExecutionHandlers, ExecutionResult, ExecutionStats, } from './types';
+export { MessageSchema, GraphConfigSchema, CheckpointSchema } from './types';
+export { StateGraph, StateGraphEvents } from './state-graph';
+export { createLLMNode, createLLMRouter, createStructuredLLMNode, createConversationalLLMNode, LLMNodeConfig, LLMNodeConfigSchema, } from './nodes/llm-node';
+export { createToolNode, createToolRegistry, createTool, createBatchToolNode, ToolNodeConfig, ToolNodeConfigSchema, } from './nodes/tool-node';
+export { createDecisionNode, createSwitchNode, createThresholdNode, createIfElseNode, createMultiConditionNode, DecisionNodeConfig, DecisionBranch, DecisionNodeConfigSchema, } from './nodes/decision-node';
+export { createHumanNode, createConsoleInputHandler, createCallbackInputHandler, createConfirmationNode, createFeedbackNode, HumanNodeConfig, HumanInputHandler, HumanInputContext, HumanChoice, HumanResponse, HumanNodeConfigSchema, } from './nodes/human-node';
+export { ConditionalEdgeBuilder, conditionalEdge, createRouter, conditions, EdgeConditionSchema, validateCondition, } from './edges/conditional-edge';
+export { LoopEdgeBuilder, loopEdge, createForLoop, createWhileLoop, createDoWhileLoop, createRetryLoop, createPaginationLoop, LoopConfig, LoopConfigSchema, validateLoopConfig, } from './edges/loop-edge';
+export { MemoryCheckpointer, FileCheckpointer, TimeTravelDebugger, createCheckpoint, applyRetentionPolicy, validateCheckpoint, FileSystem, StateDiff, StateHistoryItem, RetentionPolicy, CheckpointSchema as CheckpointValidationSchema, } from './checkpointing';
+export { createPlanExecuteRefineGraph, createSimpleTaskGraph, PlanExecuteState, PlanStep, StepResult, PlanExecuteRefineConfig, PlanSchema, } from './prebuilt-graphs/plan-execute-refine';
+/**
+ * Create a simple agent workflow
+ *
+ * @example
+ * ```typescript
+ * const graph = createAgentWorkflow({
+ *   name: 'research-agent',
+ *   llmProvider: myProvider,
+ *   tools: [searchTool, writeTool],
+ *   systemPrompt: 'You are a helpful research assistant.'
+ * });
+ * ```
+ */
+export declare function createAgentWorkflow(options: {
+    name: string;
+    llmProvider: LLMProvider;
+    tools?: Tool[];
+    systemPrompt?: string;
+    maxIterations?: number;
+}): StateGraphClass;
+/**
+ * Create a chat workflow with conversation history
+ *
+ * @example
+ * ```typescript
+ * const chat = createChatWorkflow({
+ *   name: 'chat-assistant',
+ *   llmProvider: myProvider,
+ *   systemPrompt: 'You are a friendly assistant.',
+ *   maxHistory: 20
+ * });
+ * ```
+ */
+export declare function createChatWorkflow(options: {
+    name: string;
+    llmProvider: LLMProvider;
+    systemPrompt?: string;
+    maxHistory?: number;
+}): StateGraphClass;
+/**
+ * Create a decision tree workflow
+ *
+ * @example
+ * ```typescript
+ * const tree = createDecisionTree({
+ *   name: 'support-router',
+ *   decisions: [
+ *     {
+ *       field: 'data.category',
+ *       branches: {
+ *         'billing': 'billing-handler',
+ *         'technical': 'tech-handler',
+ *         'general': 'general-handler'
+ *       },
+ *       default: 'general-handler'
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export declare function createDecisionTree(options: {
+    name: string;
+    decisions: Array<{
+        id?: string;
+        field: string;
+        branches: Record<string, string>;
+        default?: string;
+    }>;
+}): StateGraphClass;
+export declare const VERSION = "1.0.3";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAmBH,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEjD,YAAY,EAEV,UAAU,EACV,OAAO,EACP,WAAW,EACX,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EAGb,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,QAAQ,EAGR,cAAc,EACd,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,QAAQ,EACR,MAAM,EAGN,IAAI,EACJ,YAAY,EAGZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EAGd,cAAc,EACd,QAAQ,EACR,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,WAAW,EAGX,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EAGjB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAK7E,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAO7D,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,2BAA2B,EAC3B,aAAa,EACb,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,gBAAgB,IAAI,0BAA0B,GAC/C,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,uBAAuB,EACvB,UAAU,GACX,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,eAAe,CAmDlB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,eAAe,CAsBlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ,GAAG,eAAe,CAyBlB;AAKD,eAAO,MAAM,OAAO,UAAU,CAAC"}