@falai/agent 3.4.4 → 4.0.0-alpha.1

package/dist/core/PromptComposer.js

@@ -1,393 +0,0 @@
-import { render, renderMany, formatKnowledgeBase, createTemplateContext } from "../utils/template.js";
-import { logger } from "../utils/index.js";
-import { splitWhenConditions } from "../utils/condition.js";
-export class PromptComposer {
-    constructor(context = createTemplateContext({}), cache) {
-        this.parts = [];
-        this.instructionCounter = 0;
-        /** Per-turn applied instructions, reset on every `addInstructions` invocation. */
-        this.lastAppliedInstructions = [];
-        this.renderContext = context;
-        this.cache = cache ?? null;
-    }
-    // Specific, typed sections tailored to the framework
-    async addAgentMeta(agent) {
-        const compute = async () => {
-            const lines = [];
-            lines.push("## Agent Identity");
-            lines.push(`You are "${agent.name}". Always refer to yourself by this name.`);
-            if (agent.persona) {
-                lines.push(await render(agent.persona, this.renderContext));
-            }
-            if (agent.goal) {
-                lines.push(`Your primary goal: ${agent.goal}`);
-            }
-            return lines.join("\n");
-        };
-        if (this.cache) {
-            this.cache.register("agentMeta", "static", compute);
-        }
-        else {
-            const result = await compute();
-            if (result)
-                this.parts.push(result);
-        }
-        return this;
-    }
-    async addFlowOverview(flows) {
-        return this.addActiveFlows(flows);
-    }
-    async addScoringRules() {
-        const compute = () => {
-            return `## Scoring Rules\n\n${[
-                "- 90-100: explicit keywords + clear intent",
-                "- 70-89: strong contextual evidence + relevant keywords",
-                "- 50-69: moderate relevance",
-                "- 30-49: weak connection or ambiguous",
-                "- 0-29: minimal/none",
-                "Return ONLY JSON matching the provided schema. Include scores for ALL flows.",
-            ].join("\n")}`;
-        };
-        if (this.cache) {
-            this.cache.register("scoringRules", "static", compute);
-        }
-        else {
-            this.parts.push(compute());
-        }
-        return Promise.resolve(this);
-    }
-    async addInstruction(text) {
-        if (!text)
-            return Promise.resolve(this);
-        const content = `## Instruction\n\n${text}`;
-        if (this.cache) {
-            const key = `instruction-${this.instructionCounter++}`;
-            this.cache.register(key, "dynamic", () => content);
-        }
-        else {
-            this.parts.push(content);
-        }
-        return Promise.resolve(this);
-    }
-    /**
-     * @deprecated History should flow through `GenerateMessageInput.history` natively.
-     * This method is kept for backward compatibility but will be removed in a future version.
-     */
-    async addInteractionHistory(history, note) {
-        const compute = () => {
-            const recent = history
-                .slice(-10)
-                .map((e) => `- ${JSON.stringify(e)}`)
-                .join("\n");
-            const header = note ? `${note}\n\n` : "";
-            return `## Interaction History\n\n${header}Recent conversation events:\n\n${recent}`;
-        };
-        if (this.cache) {
-            this.cache.register("interactionHistory", "dynamic", compute);
-        }
-        else {
-            this.parts.push(compute());
-        }
-        return Promise.resolve(this);
-    }
-    async addLastMessage(message) {
-        const compute = () => {
-            return `## Last Message\n\n${message}`;
-        };
-        if (this.cache) {
-            this.cache.register("lastMessage", "dynamic", compute);
-        }
-        else {
-            this.parts.push(compute());
-        }
-        return Promise.resolve(this);
-    }
-    async addGlossary(terms) {
-        if (!terms.length)
-            return this;
-        const compute = async () => {
-            const renderedTerms = await Promise.all(terms.map(async (t) => {
-                const name = await render(t.name, this.renderContext);
-                const description = await render(t.description, this.renderContext);
-                const synonyms = t.synonyms
-                    ? await renderMany(t.synonyms, this.renderContext)
-                    : [];
-                const synonymText = synonyms.length > 0 ? ` (synonyms: ${synonyms.join(", ")})` : "";
-                return `- **${name}**${synonymText}: ${description}`;
-            }));
-            return `## Glossary\n\n${renderedTerms.join("\n")}`;
-        };
-        if (this.cache) {
-            this.cache.register("glossary", "static", compute);
-        }
-        else {
-            const result = await compute();
-            if (result)
-                this.parts.push(result);
-        }
-        return this;
-    }
-    async addInstructions(scoped) {
-        // Reset the per-turn applied set
-        this.lastAppliedInstructions = [];
-        /**
-         * Evaluate a single instruction's `if` code predicate(s).
-         * Returns true if all predicates pass (AND semantics).
-         * If `if` is undefined, returns true (always active).
-         */
-        const evaluateIf = async (ifCondition) => {
-            if (ifCondition === undefined)
-                return true;
-            const predicates = Array.isArray(ifCondition) ? ifCondition : [ifCondition];
-            for (const predicate of predicates) {
-                try {
-                    const result = await predicate({
-                        context: (this.renderContext.context ?? {}),
-                        data: (this.renderContext.data || {}),
-                        session: (this.renderContext.session ?? { id: '', data: {}, history: [], metadata: {} }),
-                        history: this.renderContext.history || [],
-                    });
-                    if (!result)
-                        return false;
-                }
-                catch {
-                    // If a predicate throws, treat it as false (skip the instruction)
-                    return false;
-                }
-            }
-            return true;
-        };
-        /**
-         * Resolve the kind prefix for rendering.
-         * Default kind is 'should'.
-         */
-        const kindPrefix = (kind) => {
-            const resolved = kind || 'should';
-            return `[${resolved}]`;
-        };
-        /**
-         * Process a scope bucket: filter enabled, gate by `if`, render `when`, and collect applied records.
-         */
-        const processScope = async (items, caption, scope, scopeRef) => {
-            const lines = [];
-            const enabled = items.filter(g => g.enabled !== false);
-            for (const g of enabled) {
-                // Evaluate `if` first (free, code-only). Skip `when` if `if` fails.
-                const ifPassed = await evaluateIf(g.if);
-                if (!ifPassed)
-                    continue;
-                const text = await render(g.prompt, this.renderContext);
-                if (!text)
-                    continue;
-                const whenContextStrings = g.when
-                    ? splitWhenConditions(g.when)
-                    : { positive: [], negative: [] };
-                const conditionParts = [
-                    whenContextStrings.positive.length > 0
-                        ? `apply only when: ${whenContextStrings.positive.join(" OR ")}`
-                        : undefined,
-                    whenContextStrings.negative.length > 0
-                        ? `do not apply when: ${whenContextStrings.negative.join(" OR ")}`
-                        : undefined,
-                ].filter((part) => part !== undefined);
-                const condition = conditionParts.length > 0
-                    ? ` (${conditionParts.join("; ")})`
-                    : "";
-                lines.push(`- ${kindPrefix(g.kind)} ${caption} ${text}${condition}`);
-                this.lastAppliedInstructions.push({
-                    id: g.id || '',
-                    scope,
-                    scopeRef,
-                });
-            }
-            return lines;
-        };
-        // Compute functions for each scope
-        const computeGlobal = async () => {
-            const lines = await processScope(scoped.global, '[Always]', 'global');
-            return lines.length > 0 ? lines.join('\n') : null;
-        };
-        const computeFlow = async () => {
-            if (!scoped.flow)
-                return null;
-            const caption = `[In: ${scoped.flow.flowTitle}]`;
-            const lines = await processScope(scoped.flow.items, caption, 'flow', scoped.flow.flowTitle);
-            return lines.length > 0 ? lines.join('\n') : null;
-        };
-        const computeStep = async () => {
-            if (!scoped.step)
-                return null;
-            const caption = `[Step: ${scoped.step.stepId}]`;
-            const lines = await processScope(scoped.step.items, caption, 'step', scoped.step.stepId);
-            return lines.length > 0 ? lines.join('\n') : null;
-        };
-        if (this.cache) {
-            // Granular three-key approach with header coordination
-            // Register header first so it appears before content in resolveAll() output
-            this.cache.register('instructionsHeader', 'static', async () => {
-                const globalResult = await this.cache.get('instructionsGlobal');
-                const flowResult = scoped.flow ? await this.cache.get('instructionsFlow') : null;
-                const stepResult = scoped.step ? await this.cache.get('instructionsStep') : null;
-                if (globalResult || flowResult || stepResult) {
-                    return '## Instructions';
-                }
-                return null;
-            });
-            this.cache.register('instructionsGlobal', 'static', computeGlobal);
-            if (scoped.flow) {
-                this.cache.register('instructionsFlow', 'static', computeFlow);
-            }
-            if (scoped.step) {
-                this.cache.register('instructionsStep', 'dynamic', computeStep);
-            }
-        }
-        else {
-            // No cache: compute inline and push to parts
-            const globalLines = await computeGlobal();
-            const flowLines = await computeFlow();
-            const stepLines = await computeStep();
-            const allLines = [globalLines, flowLines, stepLines].filter(Boolean).join('\n');
-            if (allLines) {
-                this.parts.push(`## Instructions\n\n${allLines}`);
-            }
-        }
-        // Debug logging
-        if (this.lastAppliedInstructions.length > 0) {
-            const globalIds = this.lastAppliedInstructions
-                .filter(g => g.scope === 'global')
-                .map(g => g.id);
-            const flowGroup = this.lastAppliedInstructions.filter(g => g.scope === 'flow');
-            const stepGroup = this.lastAppliedInstructions.filter(g => g.scope === 'step');
-            const debugPayload = { global: globalIds };
-            if (flowGroup.length > 0) {
-                debugPayload.flow = { flowTitle: scoped.flow?.flowTitle, ids: flowGroup.map(g => g.id) };
-            }
-            if (stepGroup.length > 0) {
-                debugPayload.step = { stepId: scoped.step?.stepId, ids: stepGroup.map(g => g.id) };
-            }
-            logger.debug('[instructions] applied', debugPayload);
-        }
-        return this;
-    }
-    async addKnowledgeBase(agentKnowledgeBase, flowKnowledgeBase) {
-        const compute = () => {
-            // Merge agent and flow knowledge bases (flow takes precedence for conflicts)
-            const mergedKnowledge = {
-                ...(agentKnowledgeBase || {}),
-                ...(flowKnowledgeBase || {}),
-            };
-            // Only add section if there's knowledge data
-            if (Object.keys(mergedKnowledge).length > 0) {
-                return formatKnowledgeBase(mergedKnowledge, "Knowledge Base");
-            }
-            return null;
-        };
-        if (this.cache) {
-            this.cache.register("knowledgeBase", "static", compute);
-        }
-        else {
-            const result = compute();
-            if (result)
-                this.parts.push(result);
-        }
-        return Promise.resolve(this);
-    }
-    addActiveFlows(flows) {
-        if (!flows.length)
-            return Promise.resolve(this);
-        const compute = () => {
-            const renderedFlows = flows.map((r, i) => {
-                // v2: `when` is string | string[] (AI-evaluated). Split into positives and exclusions.
-                const whenContextStrings = r.when
-                    ? splitWhenConditions(r.when)
-                    : { positive: [], negative: [] };
-                const conditionParts = [];
-                if (whenContextStrings.positive.length > 0) {
-                    conditionParts.push(`\n\n  **Triggered when:** ${whenContextStrings.positive.join(" OR ")}`);
-                }
-                if (whenContextStrings.negative.length > 0) {
-                    conditionParts.push(`\n\n  **Do not trigger when:** ${whenContextStrings.negative.join(" OR ")}`);
-                }
-                const conditions = conditionParts.join("");
-                const desc = r.description
-                    ? `\n\n  **Description:** ${r.description}`
-                    : "";
-                return `### Flow ${i + 1}: ${r.title} (ID: ${r.id})${desc}${conditions}`;
-            });
-            return `## Available Flows\n\n${renderedFlows.join("\n\n")}`;
-        };
-        if (this.cache) {
-            this.cache.register("activeFlows", "static", compute);
-        }
-        else {
-            const result = compute();
-            if (result)
-                this.parts.push(result);
-        }
-        return Promise.resolve(this);
-    }
-    async addDirectives(directives) {
-        if (!directives?.length)
-            return this;
-        const compute = () => {
-            return `## Directives\n\nAddress concisely:\n\n${directives
-                .map((d) => `- ${d}`)
-                .join("\n")}`;
-        };
-        if (this.cache) {
-            this.cache.register("directives", "dynamic", compute);
-        }
-        else {
-            this.parts.push(compute());
-        }
-        return Promise.resolve(this);
-    }
-    async addAvailableTools(tools) {
-        if (!tools?.length)
-            return this;
-        const compute = () => {
-            const renderedTools = tools.map((tool, i) => {
-                const toolName = tool.name || tool.id;
-                const desc = tool.description
-                    ? `\n    Description: ${tool.description}`
-                    : "";
-                return `### Tool ${i + 1}: ${toolName}${desc}`;
-            });
-            return `## Available Tools\n\n${renderedTools.join("\n\n")}`;
-        };
-        if (this.cache) {
-            this.cache.register("availableTools", "dynamic", compute);
-        }
-        else {
-            this.parts.push(compute());
-        }
-        return Promise.resolve(this);
-    }
-    /**
-     * Build the final prompt string.
-     *
-     * @param options.transientAppendage - Per-turn sentences from merged
-     *   Directive.appendPrompt arrays (outer-to-inner: agent.onEnter →
-     *   flow.onEnter → step.onEnter → step.prepare). Appended after all
-     *   other sections. Fresh every turn, never cached, never persisted.
-     *   **Validates: Requirements 2.2, 2.8, 2.11, 27.1, 27.2, 27.4**
-     */
-    async build(options) {
-        let sections;
-        if (this.cache) {
-            const resolved = await this.cache.resolveAll();
-            sections = resolved.filter((s) => s != null && s !== "");
-        }
-        else {
-            sections = this.parts.filter(Boolean);
-        }
-        // Append transient per-turn sentences (from Directive.appendPrompt).
-        // These are never cached — they are a fresh slot built per turn.
-        if (options?.transientAppendage && options.transientAppendage.length > 0) {
-            const appendageBlock = options.transientAppendage.join("\n");
-            sections.push(appendageBlock);
-        }
-        return sections.join("\n\n").trim();
-    }
-}
-//# sourceMappingURL=PromptComposer.js.map

package/dist/core/PromptComposer.js.map

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

package/dist/core/PromptSectionCache.d.ts

@@ -1,48 +0,0 @@
-/**
- * PromptSectionCache - Memoizes static prompt sections across turns,
- * recomputing only dynamic sections per-turn.
- *
- * Static sections (agent identity, glossary, knowledge base, flow descriptions)
- * are cached after first computation. Dynamic sections (current step context,
- * directives, available tools) are recomputed on every resolveAll() call.
- */
-import type { PromptSectionType, PromptCacheConfig, SectionCompute } from "../types/prompt-cache.js";
-export type { PromptSectionType, PromptCacheConfig, SectionCompute } from "../types/prompt-cache.js";
-export declare class PromptSectionCache {
-    private sections;
-    private insertionOrder;
-    private config;
-    constructor(config?: PromptCacheConfig);
-    /**
-     * Register a section with its compute function and type.
-     * Sections are resolved in registration order during resolveAll().
-     */
-    register(key: string, type: PromptSectionType, compute: SectionCompute): void;
-    /**
-     * Get a section's value. Static sections return cached value if available;
-     * dynamic sections always recompute.
-     */
-    get(key: string): Promise<string | null>;
-    /**
-     * Resolve all registered sections in registration order.
-     * Static sections use cache when available; dynamic sections always recompute.
-     */
-    resolveAll(): Promise<(string | null)[]>;
-    /**
-     * Invalidate a specific section's cache, forcing recomputation on next resolve.
-     */
-    invalidate(key: string): void;
-    /**
-     * Invalidate all cached sections (e.g., on session change or /clear).
-     */
-    invalidateAll(): void;
-    /**
-     * Check whether a section has a cached value.
-     */
-    has(key: string): boolean;
-    /**
-     * Determine if a section needs recomputation.
-     */
-    private shouldRecompute;
-}
-//# sourceMappingURL=PromptSectionCache.d.ts.map

package/dist/core/PromptSectionCache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PromptSectionCache.d.ts","sourceRoot":"","sources":["../../src/core/PromptSectionCache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACrG,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAWrG,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,MAAM,CAA8B;gBAEhC,MAAM,CAAC,EAAE,iBAAiB;IAOtC;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAQ7E;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAc9C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAQ9C;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO7B;;OAEG;IACH,aAAa,IAAI,IAAI;IAMrB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAoB1B"}

package/dist/core/PromptSectionCache.js

@@ -1,104 +0,0 @@
-/**
- * PromptSectionCache - Memoizes static prompt sections across turns,
- * recomputing only dynamic sections per-turn.
- *
- * Static sections (agent identity, glossary, knowledge base, flow descriptions)
- * are cached after first computation. Dynamic sections (current step context,
- * directives, available tools) are recomputed on every resolveAll() call.
- */
-export class PromptSectionCache {
-    constructor(config) {
-        this.sections = new Map();
-        this.insertionOrder = [];
-        this.config = {
-            enabled: config?.enabled ?? true,
-            volatileKeys: config?.volatileKeys ?? [],
-        };
-    }
-    /**
-     * Register a section with its compute function and type.
-     * Sections are resolved in registration order during resolveAll().
-     */
-    register(key, type, compute) {
-        const existing = this.sections.has(key);
-        this.sections.set(key, { key, type, compute, cachedValue: undefined });
-        if (!existing) {
-            this.insertionOrder.push(key);
-        }
-    }
-    /**
-     * Get a section's value. Static sections return cached value if available;
-     * dynamic sections always recompute.
-     */
-    async get(key) {
-        const entry = this.sections.get(key);
-        if (!entry) {
-            return null;
-        }
-        if (this.shouldRecompute(entry)) {
-            const value = await entry.compute();
-            entry.cachedValue = value;
-            return value;
-        }
-        // cachedValue is defined (string or null) — return it
-        return entry.cachedValue;
-    }
-    /**
-     * Resolve all registered sections in registration order.
-     * Static sections use cache when available; dynamic sections always recompute.
-     */
-    async resolveAll() {
-        const results = [];
-        for (const key of this.insertionOrder) {
-            results.push(await this.get(key));
-        }
-        return results;
-    }
-    /**
-     * Invalidate a specific section's cache, forcing recomputation on next resolve.
-     */
-    invalidate(key) {
-        const entry = this.sections.get(key);
-        if (entry) {
-            entry.cachedValue = undefined;
-        }
-    }
-    /**
-     * Invalidate all cached sections (e.g., on session change or /clear).
-     */
-    invalidateAll() {
-        for (const entry of this.sections.values()) {
-            entry.cachedValue = undefined;
-        }
-    }
-    /**
-     * Check whether a section has a cached value.
-     */
-    has(key) {
-        return this.sections.has(key);
-    }
-    /**
-     * Determine if a section needs recomputation.
-     */
-    shouldRecompute(entry) {
-        // Caching disabled — always recompute
-        if (!this.config.enabled) {
-            return true;
-        }
-        // Dynamic sections always recompute
-        if (entry.type === "dynamic") {
-            return true;
-        }
-        // Volatile keys always recompute
-        if (this.config.volatileKeys.includes(entry.key)) {
-            return true;
-        }
-        // Static section not yet computed
-        if (entry.cachedValue === undefined) {
-            return true;
-        }
-        // Static section with cached value — use cache
-        return false;
-    }
-}
-//# sourceMappingURL=PromptSectionCache.js.map

package/dist/core/PromptSectionCache.js.map

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

package/dist/core/ResponseEngine.d.ts

@@ -1,43 +0,0 @@
-import type { Event, StructuredSchema, SessionState, AgentOptions, Term, Template, ScopedInstructions, AppliedInstruction } from "../types/index.js";
-import type { Flow } from "./Flow.js";
-import type { Step } from "./Step.js";
-import { PromptSectionCache } from "./PromptSectionCache.js";
-export interface BuildResponsePromptParams<TContext = unknown, TData = unknown> {
-    flow: Flow<TContext, TData>;
-    currentStep: Step<TContext, TData>;
-    rules: Template<TContext, TData>[];
-    prohibitions: Template<TContext, TData>[];
-    directives: string[] | undefined;
-    history: Event[];
-    agentOptions?: AgentOptions<TContext, TData>;
-    instructions?: ScopedInstructions<TContext, TData>;
-    combinedTerms?: Term<TContext, TData>[];
-    context?: TContext;
-    session?: SessionState<TData>;
-    agentSchema?: StructuredSchema;
-    /**
-     * Per-turn transient appendage from merged Directive.appendPrompt arrays.
-     * Appended to the system prompt after all other sections.
-     * Fresh every turn, never cached, never persisted.
-     */
-    transientAppendage?: string[];
-}
-export interface BuildFallbackPromptParams<TContext = unknown, TData = unknown> {
-    agentOptions: AgentOptions<TContext, TData>;
-    terms: Term<TContext, TData>[];
-    instructions?: ScopedInstructions<TContext, TData>;
-    context?: TContext;
-    session?: SessionState<TData>;
-}
-export interface PromptBuilderResult {
-    prompt: string;
-    appliedInstructions: AppliedInstruction[];
-}
-export declare class ResponseEngine<TContext = unknown, TData = unknown> {
-    private readonly promptSectionCache?;
-    constructor(promptSectionCache?: PromptSectionCache | undefined);
-    responseSchemaForFlow(flow: Flow<TContext, TData>, currentStep?: Step<TContext, TData>, agentSchema?: StructuredSchema): StructuredSchema;
-    buildResponsePrompt(params: BuildResponsePromptParams<TContext, TData>): Promise<PromptBuilderResult>;
-    buildFallbackPrompt(params: BuildFallbackPromptParams<TContext, TData>): Promise<PromptBuilderResult>;
-}
-//# sourceMappingURL=ResponseEngine.d.ts.map

package/dist/core/ResponseEngine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ResponseEngine.d.ts","sourceRoot":"","sources":["../../src/core/ResponseEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,MAAM,WAAW,yBAAyB,CACxC,QAAQ,GAAG,OAAO,EAClB,KAAK,GAAG,OAAO;IAEf,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5B,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;IACnC,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;IAC1C,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAE7C,YAAY,CAAC,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;IACxC,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAE9B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAC5E,YAAY,EAAE,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5C,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;CAC3C;AAED,qBAAa,cAAc,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAAnB,kBAAkB,CAAC,EAAE,kBAAkB,YAAA;IAEpE,qBAAqB,CACnB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAC3B,WAAW,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EACnC,WAAW,CAAC,EAAE,gBAAgB,GAC7B,gBAAgB;IAuCb,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,GACjD,OAAO,CAAC,mBAAmB,CAAC;IAsNzB,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,GACjD,OAAO,CAAC,mBAAmB,CAAC;CAkBhC"}