@falai/agent 3.4.4 → 4.0.0-alpha.1

package/dist/cjs/core/Step.js

@@ -1,599 +0,0 @@
-"use strict";
-/**
- * Step in a conversational flow
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Step = exports.FlowConfigurationError = void 0;
-const index_js_1 = require("../types/index.js");
-const index_js_2 = require("../utils/index.js");
-const condition_js_1 = require("../utils/condition.js");
-const flow_namespace_js_1 = require("./flow-namespace.js");
-/**
- * Error thrown when a step's configuration violates auto-step constraints.
- */
-class FlowConfigurationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "FlowConfigurationError";
-    }
-}
-exports.FlowConfigurationError = FlowConfigurationError;
-/**
- * Merge two handler results (shorthand + hooks.* desugar). Scalar/object
- * results merge via the canonical Algorithm 4; void/undefined passes through.
- */
-function mergeHookResults(a, b) {
-    if (a == null)
-        return b ?? undefined;
-    if (b == null)
-        return a;
-    // PrepareResult is a structural subset of Directive — the canonical merge
-    // accepts both sides and its output remains a valid PrepareResult.
-    return flow_namespace_js_1.flow.merge(a, b);
-}
-/**
- * Represents a step within a route
- */
-class Step {
-    /** Whether this step runs without an LLM call (computational only). */
-    get auto() {
-        return this._auto;
-    }
-    /** Explicit source-local fork entries, if declared. */
-    get branches() {
-        return this._branches;
-    }
-    constructor(routeId, options = {}, parentAgent) {
-        this.nextSteps = [];
-        this._instructions = [];
-        // Use provided ID or generate a deterministic one
-        this.id = options.id || (0, index_js_2.generateStepId)(routeId, options.description);
-        this.flowId = routeId;
-        this.description = options.description;
-        this._auto = options.auto ?? false;
-        this._branches = options.branches;
-        this.collect = options.collect;
-        this.skip = options.skip;
-        this.requires = options.requires;
-        this.prompt = options.prompt;
-        this.reply = options.reply;
-        this.when = options.when;
-        this.if = options.if;
-        // Desugar `hooks.prepare` / `hooks.finalize` onto the shorthand fields so
-        // both spellings run through the same lifecycle machinery. When both are
-        // declared, both run — the shorthand first, then the hook — with their
-        // directive returns merged via Algorithm 4 (same desugar pattern as
-        // flow-level onComplete).
-        const hooks = options.hooks;
-        /** Compose a function-form shorthand with a function-form hook. */
-        const composeWithHook = (base, hook) => {
-            if (!base)
-                return hook;
-            return async (context, data) => mergeHookResults(await base(context, data), await hook(context, data));
-        };
-        if (hooks?.prepare) {
-            const hookPrepare = (context, data) => hooks.prepare(context, data);
-            const base = options.prepare;
-            // A tool-reference shorthand cannot compose with a function hook in a
-            // single field — refuse loudly instead of silently dropping one.
-            if (base != null && typeof base !== "function") {
-                throw new FlowConfigurationError(`[FlowConfigurationError] Step "${this.id}" declares both a tool-based prepare and hooks.prepare. A step can only have one prepare handler — remove one or inline the tool call inside the function.`);
-            }
-            this.prepare = composeWithHook(typeof base === "function" ? base : undefined, hookPrepare);
-        }
-        else {
-            this.prepare = options.prepare;
-        }
-        if (hooks?.finalize) {
-            const hookFinalize = (context, data) => hooks.finalize(context, data);
-            const base = options.finalize;
-            if (base != null && typeof base !== "function") {
-                throw new FlowConfigurationError(`[FlowConfigurationError] Step "${this.id}" declares both a tool-based finalize and hooks.finalize. A step can only have one finalize handler — remove one or inline the tool call inside the function.`);
-            }
-            this.finalize = composeWithHook(typeof base === "function" ? base : undefined, hookFinalize);
-        }
-        else {
-            this.finalize = options.finalize;
-        }
-        this.tools = options.tools;
-        // Validate when/if split: functions belong on `if`, not `when`
-        if (this.when !== undefined) {
-            const whenValue = this.when;
-            if (typeof whenValue === 'function') {
-                throw new FlowConfigurationError(`[FlowConfigurationError] Step "${this.id}" has a function on "when": functions belong on "if" only. Move the function to the "if" field.`);
-            }
-            if (Array.isArray(whenValue)) {
-                for (let i = 0; i < whenValue.length; i++) {
-                    if (typeof whenValue[i] === 'function') {
-                        throw new FlowConfigurationError(`[FlowConfigurationError] Step "${this.id}" has a function at "when[${i}]": functions belong on "if" only. Move the function to the "if" field.`);
-                    }
-                }
-            }
-        }
-        // Validate auto-step shape: auto-steps cannot define prompt, collect, tools, or finalize
-        if (this._auto) {
-            const violatingFields = [];
-            if (this.prompt != null)
-                violatingFields.push('prompt');
-            if (this.collect != null && this.collect.length > 0)
-                violatingFields.push('collect');
-            if (this.tools != null && this.tools.length > 0)
-                violatingFields.push('tools');
-            if (this.finalize != null)
-                violatingFields.push('finalize');
-            if (violatingFields.length > 0) {
-                throw new FlowConfigurationError(`[FlowConfigurationError] Auto-step "${this.id}" cannot define: ${violatingFields.join(', ')}. Auto-steps run without an LLM call and must not declare prompt, collect, tools, or finalize. Remove these fields or set auto: false.`);
-            }
-        }
-        // Validate reply-step shape: reply steps cannot define prompt, collect, tools, finalize, or auto: true
-        if (this.reply != null) {
-            const conflictingFields = [];
-            if (this.prompt != null)
-                conflictingFields.push('prompt');
-            if (this.collect != null && this.collect.length > 0)
-                conflictingFields.push('collect');
-            if (this.tools != null && this.tools.length > 0)
-                conflictingFields.push('tools');
-            if (this.finalize != null)
-                conflictingFields.push('finalize');
-            if (this._auto)
-                conflictingFields.push('auto: true');
-            if (conflictingFields.length > 0) {
-                throw new FlowConfigurationError(`[FlowConfigurationError] Step "${this.id}" sets "reply" together with conflicting fields: ${conflictingFields.join(', ')}. A reply step skips the LLM call and cannot define prompt, collect, tools, finalize, or auto: true.`);
-            }
-        }
-        // Validate branches shape
-        if (this._branches !== undefined) {
-            this.validateBranches(this._branches);
-        }
-        // Initialize instructions from options
-        if (options.instructions) {
-            options.instructions.forEach((instruction) => {
-                this.addInstruction(instruction);
-            });
-        }
-        // Store reference to parent agent for ToolManager access
-        this.parentAgent = parentAgent;
-    }
-    /**
-     * Configure the step properties after creation
-     * Useful for overriding initial step configuration
-     */
-    configure(config) {
-        if (config.description !== undefined) {
-            this.description = config.description;
-        }
-        if (config.collect !== undefined) {
-            this.collect = config.collect;
-        }
-        if (config.skip !== undefined) {
-            this.skip = config.skip;
-        }
-        if (config.requires !== undefined) {
-            this.requires = config.requires;
-        }
-        if (config.prompt !== undefined) {
-            this.prompt = config.prompt;
-        }
-        if (config.prepare !== undefined) {
-            this.prepare = config.prepare;
-        }
-        if (config.finalize !== undefined) {
-            this.finalize = config.finalize;
-        }
-        if (config.tools !== undefined) {
-            this.tools = config.tools;
-        }
-        return this;
-    }
-    /**
-     * Create a transition from this step to another
-     *
-     * @param spec - Transition specification (prompt, tool, or direct step)
-     * @returns StepResult that supports chaining
-     */
-    nextStep(spec) {
-        // Create new target step for prompt or tool
-        const targetStep = new Step(this.flowId, spec, this.parentAgent);
-        this.nextSteps.push(targetStep);
-        return this.createStepRefWithTransition(targetStep.getRef(), targetStep);
-    }
-    /**
-     * Create multiple branches from this step
-     *
-     * @param branches - Array of branch specifications
-     * @returns BranchResult mapping branch names to their step results
-     */
-    branch(branches) {
-        const result = {};
-        for (const branchSpec of branches) {
-            // Create step options with optional ID
-            const stepOptions = branchSpec.id
-                ? { ...branchSpec.step, id: branchSpec.id }
-                : branchSpec.step;
-            // Create a new step for this branch
-            const branchStep = new Step(this.flowId, stepOptions, this.parentAgent);
-            // Add it to our transitions
-            this.nextSteps.push(branchStep);
-            // Create a step result for chaining
-            const branchName = branchSpec.name;
-            result[branchName] = this.createStepRefWithTransition(branchStep.getRef(), branchStep);
-        }
-        return result;
-    }
-    /**
-     * Add an instruction to this step.
-     */
-    addInstruction(instruction) {
-        this._instructions.push({
-            ...instruction,
-            kind: instruction.kind || 'should',
-            id: instruction.id || `instruction_${this.id}_${this._instructions.length}`,
-            enabled: instruction.enabled !== false, // Default to true
-        });
-    }
-    /**
-     * Get instructions for this step
-     */
-    getInstructions() {
-        return [...this._instructions];
-    }
-    /**
-     * Add a tool to this step using the unified Tool interface
-     * Creates and adds the tool to step scope in one operation
-     */
-    addTool(tool) {
-        // Validate tool before adding
-        if (!tool || !tool.id || !tool.handler) {
-            throw new Error('Invalid tool: must have id and handler properties');
-        }
-        // Add to step's tools array
-        if (!this.tools) {
-            this.tools = [];
-        }
-        this.tools.push(tool);
-        return this;
-    }
-    /**
-     * Resolve tool references in the tools array
-     * Supports both string IDs (resolved from registry) and inline tool objects
-     */
-    resolveTools() {
-        if (!this.tools) {
-            return [];
-        }
-        const resolvedTools = [];
-        for (const toolRef of this.tools) {
-            if (typeof toolRef === 'string') {
-                // Tool ID - try to resolve from ToolManager using proper scope resolution
-                if (this.parentAgent?.tool) {
-                    const registeredTool = this.parentAgent.tool.find(toolRef);
-                    if (registeredTool) {
-                        resolvedTools.push(registeredTool);
-                    }
-                    else {
-                        // Tool not found - log warning but don't fail
-                        index_js_2.logger.warn(`[Step] Tool ID '${toolRef}' not found in any scope for step ${this.id}`);
-                    }
-                }
-                else {
-                    index_js_2.logger.warn(`[Step] No parent agent available to resolve tool ID '${toolRef}' for step ${this.id}`);
-                }
-            }
-            else {
-                // Inline tool object - validate and use directly
-                if (toolRef && toolRef.id && typeof toolRef.handler === 'function') {
-                    resolvedTools.push(toolRef);
-                }
-                else {
-                    index_js_2.logger.warn(`[Step] Invalid inline tool object in step ${this.id}:`, toolRef);
-                }
-            }
-        }
-        return resolvedTools;
-    }
-    /**
-     * Get all tools available to this step (both inline and resolved from registry)
-     */
-    getAvailableTools() {
-        return this.tools ? [...this.tools] : [];
-    }
-    /**
-     * Get all resolved tools available to this step using ToolManager
-     * This method provides the complete set of tools accessible from this step
-     */
-    getAllAvailableTools() {
-        if (!this.parentAgent?.tool) {
-            // Fallback to local resolution if no ToolManager available
-            return this.resolveTools();
-        }
-        // Use ToolManager to get all available tools for this step context
-        return this.parentAgent.tool.getAvailable(index_js_1.ToolScope.ALL, this, undefined);
-    }
-    /**
-     * Find a specific tool by ID using ToolManager resolution
-     * This method respects the tool resolution hierarchy: step → route → agent → registry
-     */
-    findTool(toolId, scope) {
-        if (!this.parentAgent?.tool) {
-            // Fallback to local resolution if no ToolManager available
-            const resolved = this.resolveTools();
-            return resolved.find(tool => tool.id === toolId || tool.id === toolId);
-        }
-        // Use ToolManager to find the tool with proper scope resolution
-        return this.parentAgent.tool.find(toolId, scope || index_js_1.ToolScope.ALL, this, undefined);
-    }
-    /**
-     * Get tools from a specific scope
-     */
-    getToolsFromScope(scope) {
-        if (!this.parentAgent?.tool) {
-            // Fallback to local resolution if no ToolManager available
-            return scope === index_js_1.ToolScope.STEP ? this.resolveTools() : [];
-        }
-        return this.parentAgent.tool.getAvailable(scope, this, undefined);
-    }
-    /**
-     * Get only step-level tools (inline tools in this step)
-     */
-    getStepTools() {
-        return this.getToolsFromScope(index_js_1.ToolScope.STEP);
-    }
-    /**
-     * Get only registered tools accessible from this step
-     */
-    getRegisteredTools() {
-        return this.getToolsFromScope(index_js_1.ToolScope.REGISTERED);
-    }
-    /**
-     * Validate that all tool references in this step can be resolved
-     * Returns validation result with details about missing tools
-     */
-    validateToolReferences() {
-        if (!this.tools || this.tools.length === 0) {
-            return { valid: true, missing: [], found: [], details: [] };
-        }
-        // Extract tool IDs from the tools array
-        const toolIds = [];
-        for (const toolRef of this.tools) {
-            if (typeof toolRef === 'string') {
-                toolIds.push(toolRef);
-            }
-            else if (toolRef && toolRef.id) {
-                toolIds.push(toolRef.id);
-            }
-        }
-        if (!this.parentAgent?.tool) {
-            // Fallback validation without ToolManager
-            const resolved = this.resolveTools();
-            const resolvedIds = resolved.map(tool => tool.id);
-            const missing = toolIds.filter(id => !resolvedIds.includes(id));
-            const found = toolIds.filter(id => resolvedIds.includes(id));
-            return {
-                valid: missing.length === 0,
-                missing,
-                found,
-                details: toolIds.map(id => ({ id, found: resolvedIds.includes(id) }))
-            };
-        }
-        // Use ToolManager validation
-        return this.parentAgent.tool.validateToolReferences(toolIds, this);
-    }
-    /**
-     * Get all transitions from this step
-     */
-    getTransitions() {
-        return [...this.nextSteps];
-    }
-    /**
-     * Evaluate when/if conditions using the v2 split logic.
-     * `if` (code predicate) evaluates first (free); `when` (AI) evaluates only when `if` passes.
-     * `if` predicates use AND semantics. Non-`!` `when` strings use OR semantics;
-     * `!` strings are exclusions where any match inhibits activation.
-     * When both fields are set, the passing `if` gate and AI match are combined with AND.
-     */
-    async evaluateWhen(templateContext) {
-        // If neither `when` nor `if` is set, step is always eligible
-        if (!this.when && !this.if) {
-            return {
-                shouldActivate: true,
-                aiContextStrings: [],
-                aiExclusionStrings: [],
-                hasProgrammaticConditions: false
-            };
-        }
-        // Evaluate `if` first (free, code-only)
-        if (this.if) {
-            const predicates = Array.isArray(this.if) ? this.if : [this.if];
-            for (const predicate of predicates) {
-                try {
-                    const result = await predicate({
-                        data: templateContext.data,
-                        context: templateContext.context,
-                        session: templateContext.session,
-                        history: templateContext.history || [],
-                    });
-                    if (!result) {
-                        // `if` failed — short-circuit, don't bother with `when`
-                        return {
-                            shouldActivate: false,
-                            aiContextStrings: [],
-                            aiExclusionStrings: [],
-                            hasProgrammaticConditions: true
-                        };
-                    }
-                }
-                catch (error) {
-                    index_js_2.logger.warn(`[Step] "if" predicate failed for step "${this.id}":`, error);
-                    return {
-                        shouldActivate: false,
-                        aiContextStrings: [],
-                        aiExclusionStrings: [],
-                        hasProgrammaticConditions: true
-                    };
-                }
-            }
-        }
-        // `if` passed (or was absent) — now evaluate `when` (AI-evaluated strings)
-        if (this.when) {
-            const whenConditions = (0, condition_js_1.splitWhenConditions)(this.when);
-            // `when` strings are handed to the AI — return them as aiContextStrings
-            // The programmatic result is true (strings don't fail programmatically;
-            // they're scored by the AI at routing time)
-            return {
-                shouldActivate: true,
-                aiContextStrings: whenConditions.positive,
-                aiExclusionStrings: whenConditions.negative,
-                hasProgrammaticConditions: !!this.if
-            };
-        }
-        // Only `if` was set and it passed
-        return {
-            shouldActivate: true,
-            aiContextStrings: [],
-            aiExclusionStrings: [],
-            hasProgrammaticConditions: true
-        };
-    }
-    /**
-     * Evaluate the skip condition (if-only shape — code predicates, OR semantics).
-     * Returns true if the step should be skipped.
-     */
-    async evaluateSkip(templateContext) {
-        if (!this.skip) {
-            return {
-                shouldSkip: false,
-                aiContextStrings: [],
-                hasProgrammaticConditions: false
-            };
-        }
-        const predicates = Array.isArray(this.skip) ? this.skip : [this.skip];
-        // OR semantics: if ANY predicate returns true, skip
-        for (const predicate of predicates) {
-            try {
-                const result = await predicate({
-                    data: templateContext.data,
-                    context: templateContext.context,
-                    session: templateContext.session,
-                    history: templateContext.history || [],
-                });
-                if (result) {
-                    return {
-                        shouldSkip: true,
-                        aiContextStrings: [],
-                        hasProgrammaticConditions: true
-                    };
-                }
-            }
-            catch (error) {
-                index_js_2.logger.warn(`[Step] "skip" predicate failed for step "${this.id}":`, error);
-                // On error, default to not skipping (safe fallback)
-            }
-        }
-        return {
-            shouldSkip: false,
-            aiContextStrings: [],
-            hasProgrammaticConditions: true
-        };
-    }
-    /**
-     * Check if this step has all required data to proceed
-     */
-    hasRequires(data) {
-        if (!this.requires || this.requires.length === 0)
-            return true;
-        return this.requires.every((key) => data[key] !== undefined);
-    }
-    /**
-     * Get step reference
-     */
-    getRef() {
-        return {
-            id: this.id,
-            flowId: this.flowId,
-        };
-    }
-    /**
-     * Create a step reference with nextStep capability for chaining
-     */
-    createStepRefWithTransition(ref, step) {
-        const stepInstance = step || this;
-        return {
-            ...ref,
-            nextStep: (spec) => stepInstance.nextStep(spec),
-            branch: (branches) => stepInstance.branch(branches),
-        };
-    }
-    /**
-     * Create a transition result for this step
-     */
-    asStepResult() {
-        return {
-            ...this.getRef(),
-            nextStep: (spec) => this.nextStep(spec),
-            branch: (branches) => this.branch(branches),
-        };
-    }
-    /**
-     * Export step configuration as StepOptions for copying/cloning
-     * @returns StepOptions that can be used to create a new step with identical configuration
-     */
-    toOptions() {
-        return {
-            id: this.id,
-            description: this.description,
-            auto: this._auto,
-            branches: this._branches,
-            prompt: this.prompt,
-            reply: this.reply,
-            tools: this.tools,
-            prepare: this.prepare,
-            finalize: this.finalize,
-            collect: this.collect,
-            skip: this.skip,
-            requires: this.requires,
-            when: this.when,
-            if: this.if,
-            instructions: this.getInstructions(),
-        };
-    }
-    /**
-     * Validate the branches array at construction time.
-     * Checks:
-     * - Non-empty array
-     * - Unconditional entries (no `when` and no `if`) only legal as the last entry
-     * - Directive `then` values: at most one position field, no empty `goTo: {}`
-     */
-    validateBranches(branches) {
-        if (branches.length === 0) {
-            throw new FlowConfigurationError(`[FlowConfigurationError] Empty branches array on step "${this.id}": branches must contain at least one entry. Add branch entries or remove the branches field.`);
-        }
-        const POSITION_FIELDS = ['goTo', 'goToStep', 'complete', 'abort', 'reset'];
-        for (let i = 0; i < branches.length; i++) {
-            const entry = branches[i];
-            const isLast = i === branches.length - 1;
-            // Non-last entry without `when` or `if` is dead code — later entries are unreachable
-            if (!isLast && !entry.when && !entry.if) {
-                throw new FlowConfigurationError(`[FlowConfigurationError] Dead-code branch at index ${i}: branches[${i}] has neither "when" nor "if" and is not the last entry. Entries after index ${i} are unreachable. Move the unconditional entry to the end or add a condition.`);
-            }
-            // Validate Directive `then` values
-            if (entry.then && typeof entry.then === 'object') {
-                const directive = entry.then;
-                // Check for multiple position fields
-                const setPositionFields = POSITION_FIELDS.filter((field) => directive[field] !== undefined);
-                if (setPositionFields.length > 1) {
-                    throw new FlowConfigurationError(`[FlowConfigurationError] Multiple position fields in branches[${i}].then: Directive sets ${setPositionFields.join(', ')}. At most one position field is allowed per Directive. Remove all but one.`);
-                }
-                // Check for empty goTo: {}
-                if (directive.goTo !== undefined && typeof directive.goTo === 'object' && directive.goTo !== null) {
-                    const goToObj = directive.goTo;
-                    if (Object.keys(goToObj).length === 0) {
-                        throw new FlowConfigurationError(`[FlowConfigurationError] Empty goTo in branches[${i}].then: Directive has "goTo: {}" with no flow target. Provide at least a flow id or title.`);
-                    }
-                }
-            }
-        }
-    }
-}
-exports.Step = Step;
-//# sourceMappingURL=Step.js.map

package/dist/cjs/core/Step.js.map

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

package/dist/cjs/core/StepLifecycle.d.ts

@@ -1,43 +0,0 @@
-/**
- * StepLifecycle executes step `prepare` and `finalize` handlers.
- *
- * A handler may be a function, a registered tool id, or an inline tool.
- * Used by the response prepare phase (prepare) and by SessionFinalizer
- * (finalize).
- *
- * Handlers may emit directives three ways: a function's return value,
- * `ctx.dispatch()` inside a tool, or a `{ directive }` tool return. All are
- * merged via the canonical Algorithm 4 (`flow.merge`) and validated with
- * `flow.validate`. State writes (`dataUpdate`/`contextUpdate`) are applied
- * immediately to the TURN session — never to agent-level live state — so
- * persistence captures them. Remaining control-flow fields (position fields,
- * verbatim replies, halts) are returned to the caller to act on.
- */
-import type { Directive, SessionState } from "../types/index.js";
-import type { Flow } from "./Flow.js";
-import type { ToolManager } from "./ToolManager.js";
-export declare class StepLifecycle<TContext = unknown, TData = unknown> {
-    private readonly deps;
-    constructor(deps: {
-        getFlows: () => Flow<TContext, TData>[];
-        toolManager: ToolManager<TContext, TData>;
-        updateContext: (updates: Partial<TContext>) => Promise<void>;
-        updateData: (updates: Partial<TData>) => Promise<void>;
-    });
-    /**
-     * Execute prepare for the session's current step if available.
-     * Returns the merged control-flow directive, if the handler emitted one.
-     * Auto-steps are skipped — their prepare is handled by AutoChainExecutor.
-     */
-    runPrepare(session: SessionState<TData>, context: TContext): Promise<Directive<TContext, TData> | undefined>;
-    /**
-     * Execute finalize for the session's current step if available.
-     * Returns the merged control-flow directive, if the handler emitted one.
-     */
-    runFinalize(session: SessionState<TData>, context: TContext): Promise<Directive<TContext, TData> | undefined>;
-    /**
-     * Execute a prepare or finalize handler and resolve its emitted directives.
-     */
-    private executePrepareFinalize;
-}
-//# sourceMappingURL=StepLifecycle.d.ts.map

package/dist/cjs/core/StepLifecycle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StepLifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/StepLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiB,YAAY,EAAQ,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAyBpD,qBAAa,aAAa,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAEtD,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE;QACnB,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QACxC,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1C,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1D;IAGL;;;;OAIG;IACG,UAAU,CACZ,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAClB,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC;IA2BlD;;;OAGG;IACG,WAAW,CACb,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAClB,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC;IAwBlD;;OAEG;YACW,sBAAsB;CAsHvC"}