@polpo-ai/core 0.8.1 → 0.9.0

package/dist/loop/hooks.d.ts

@@ -0,0 +1,132 @@
+import type { AgentConfig } from "../types.js";
+import type { ContextBag, LoopConfig } from "./types.js";
+export type LoopHook = "loop:start" | "step:before" | "model:before" | "tool:before" | "tool:after" | "step:after" | "loop:stop" | "loop:transition" | "loop:end";
+export type LoopHookPhase = "before" | "after";
+export interface LoopRuntimeConfig extends LoopConfig {
+    name: string;
+}
+export interface LoopToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface LoopHookPayloads {
+    "loop:start": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        context: ContextBag;
+        input?: unknown;
+    };
+    "step:before": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        turn: number;
+        context: ContextBag;
+        activeTools?: string[];
+        toolChoice?: unknown;
+    };
+    "model:before": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        turn: number;
+        context: ContextBag;
+        activeTools?: string[];
+        toolChoice?: unknown;
+    };
+    "tool:before": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        turn: number;
+        context: ContextBag;
+        toolCall: LoopToolCall;
+        result?: string;
+    };
+    "tool:after": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        turn: number;
+        context: ContextBag;
+        toolCall: LoopToolCall;
+        result: string;
+        isError: boolean;
+        skipped: boolean;
+    };
+    "step:after": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        turn: number;
+        context: ContextBag;
+        text: string;
+        toolCalls: LoopToolCall[];
+        toolResults: LoopToolResult[];
+        usage?: unknown;
+    };
+    "loop:stop": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        turn: number;
+        context: ContextBag;
+        reason: LoopStopReason;
+        shouldStop: boolean;
+    };
+    "loop:transition": {
+        agent?: AgentConfig;
+        from: string;
+        to: string;
+        context: ContextBag;
+    };
+    "loop:end": {
+        agent?: AgentConfig;
+        loop: LoopRuntimeConfig;
+        context: ContextBag;
+        status: LoopRunStatus;
+        reason: LoopStopReason;
+        turns: number;
+        text: string;
+    };
+}
+export type LoopStopReason = "completed" | "max_turns" | "cancelled";
+export type LoopRunStatus = "completed" | "cancelled";
+export interface LoopToolResult {
+    toolCall: LoopToolCall;
+    result: string;
+    isError: boolean;
+    skipped: boolean;
+}
+export interface LoopHookContext<T = unknown> {
+    readonly hook: LoopHook;
+    readonly phase: LoopHookPhase;
+    data: T;
+    cancel(reason?: string): void;
+    readonly cancelled: boolean;
+    readonly cancelReason?: string;
+    readonly timestamp: string;
+}
+export type LoopHookHandler<T = unknown> = (ctx: LoopHookContext<T>) => void | Promise<void>;
+export interface LoopHookRegistration<K extends LoopHook = LoopHook> {
+    hook: K;
+    phase: LoopHookPhase;
+    handler: LoopHookHandler<LoopHookPayloads[K]>;
+    priority?: number;
+    name?: string;
+}
+export interface LoopBeforeHookResult<T> {
+    cancelled: boolean;
+    cancelReason?: string;
+    data: T;
+}
+export declare class LoopHookRegistry {
+    private registrations;
+    register<K extends LoopHook>(reg: LoopHookRegistration<K>): () => void;
+    runBefore<K extends LoopHook>(hook: K, data: LoopHookPayloads[K]): Promise<LoopBeforeHookResult<LoopHookPayloads[K]>>;
+    runAfter<K extends LoopHook>(hook: K, data: LoopHookPayloads[K]): Promise<void>;
+    get size(): number;
+    list(): Array<{
+        hook: LoopHook;
+        phase: LoopHookPhase;
+        priority: number;
+        name?: string;
+    }>;
+    clear(): void;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/loop/hooks.d.ts.map

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

package/dist/loop/hooks.js

@@ -0,0 +1,85 @@
+export class LoopHookRegistry {
+    registrations = [];
+    register(reg) {
+        const stored = {
+            hook: reg.hook,
+            phase: reg.phase,
+            handler: reg.handler,
+            priority: reg.priority ?? 100,
+            name: reg.name,
+        };
+        this.registrations.push(stored);
+        this.registrations.sort((a, b) => a.priority - b.priority);
+        return () => {
+            const idx = this.registrations.indexOf(stored);
+            if (idx >= 0)
+                this.registrations.splice(idx, 1);
+        };
+    }
+    async runBefore(hook, data) {
+        const handlers = this.registrations.filter(r => r.hook === hook && r.phase === "before");
+        if (handlers.length === 0)
+            return { cancelled: false, data };
+        let cancelled = false;
+        let cancelReason;
+        const ctx = {
+            hook,
+            phase: "before",
+            data,
+            cancel(reason) {
+                cancelled = true;
+                cancelReason = reason;
+            },
+            get cancelled() { return cancelled; },
+            get cancelReason() { return cancelReason; },
+            timestamp: new Date().toISOString(),
+        };
+        for (const reg of handlers) {
+            try {
+                await reg.handler(ctx);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[LoopHookRegistry] Error in before:${hook} handler "${reg.name ?? "anonymous"}": ${msg}`);
+            }
+        }
+        return { cancelled, cancelReason, data: ctx.data };
+    }
+    async runAfter(hook, data) {
+        const handlers = this.registrations.filter(r => r.hook === hook && r.phase === "after");
+        if (handlers.length === 0)
+            return;
+        const ctx = {
+            hook,
+            phase: "after",
+            data,
+            cancel() { },
+            get cancelled() { return false; },
+            timestamp: new Date().toISOString(),
+        };
+        for (const reg of handlers) {
+            try {
+                await reg.handler(ctx);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[LoopHookRegistry] Error in after:${hook} handler "${reg.name ?? "anonymous"}": ${msg}`);
+            }
+        }
+    }
+    get size() {
+        return this.registrations.length;
+    }
+    list() {
+        return this.registrations.map(r => ({
+            hook: r.hook,
+            phase: r.phase,
+            priority: r.priority,
+            name: r.name,
+        }));
+    }
+    clear() {
+        this.registrations.length = 0;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/loop/hooks.js.map

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

package/dist/loop/pipeline.d.ts

@@ -0,0 +1,38 @@
+import type { LoopHookRegistry } from "./hooks.js";
+import { type ContextBag, type LoopConfig, type Pipeline, type Step } from "./types.js";
+export interface PipelineLoopResult {
+    output?: unknown;
+    context?: ContextBag;
+}
+export interface PipelineHumanResult {
+    output?: unknown;
+    context?: ContextBag;
+}
+export interface PipelineTraceEvent {
+    type: "loop" | "human" | "switch" | "parallel" | "skip";
+    name?: string;
+    when?: string;
+    matched?: boolean;
+}
+export interface PipelineExecutionResult {
+    context: ContextBag;
+    trace: PipelineTraceEvent[];
+}
+export interface PipelineExecutorOptions {
+    pipeline: Pipeline;
+    loops: Record<string, LoopConfig>;
+    context?: ContextBag;
+    hooks?: LoopHookRegistry;
+    runLoop: (name: string, loop: LoopConfig, context: Readonly<ContextBag>) => Promise<PipelineLoopResult>;
+    handleHuman?: (name: string, step: Extract<Step, {
+        human: string;
+    }>, context: Readonly<ContextBag>) => Promise<PipelineHumanResult>;
+}
+export declare class PipelineExecutor {
+    private readonly evaluator;
+    execute(options: PipelineExecutorOptions): Promise<PipelineExecutionResult>;
+    private executeSteps;
+    private matchesWhen;
+    private runTransitionHook;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/loop/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/loop/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAyD,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAE/I,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxG,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACrI;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAErD,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;YAOnE,YAAY;IAsE1B,OAAO,CAAC,WAAW;YAKL,iBAAiB;CAkBhC"}

package/dist/loop/pipeline.js

@@ -0,0 +1,101 @@
+import { SafeExpressionEvaluator } from "./expression.js";
+import { isHumanStep, isLoopStep, isParallelStep, isSwitchStep } from "./types.js";
+export class PipelineExecutor {
+    evaluator = new SafeExpressionEvaluator();
+    async execute(options) {
+        const context = { ...(options.context ?? {}) };
+        const trace = [];
+        await this.executeSteps(options.pipeline.steps, context, trace, options);
+        return { context, trace };
+    }
+    async executeSteps(steps, context, trace, options, previousNode) {
+        let lastNode = previousNode;
+        for (const step of steps) {
+            if (!this.matchesWhen(step.when, context)) {
+                trace.push({ type: "skip", when: step.when, matched: false });
+                continue;
+            }
+            if (isLoopStep(step)) {
+                const loop = options.loops[step.loop];
+                if (!loop)
+                    throw new Error(`Pipeline references unknown loop "${step.loop}"`);
+                await this.runTransitionHook(lastNode, step.loop, context, options);
+                const result = await options.runLoop(step.loop, loop, freezeContext(context));
+                mergeLoopResult(context, step.loop, result);
+                trace.push({ type: "loop", name: step.loop, when: step.when, matched: true });
+                lastNode = step.loop;
+                continue;
+            }
+            if (isSwitchStep(step)) {
+                let matched = false;
+                for (const branch of step.switch.cases) {
+                    if (this.matchesWhen(branch.when, context)) {
+                        trace.push({ type: "switch", when: branch.when, matched: true });
+                        lastNode = await this.executeSteps(branch.steps, context, trace, options, lastNode);
+                        matched = true;
+                        break;
+                    }
+                }
+                if (!matched && step.switch.default) {
+                    trace.push({ type: "switch", matched: false });
+                    lastNode = await this.executeSteps(step.switch.default.steps, context, trace, options, lastNode);
+                }
+                continue;
+            }
+            if (isParallelStep(step)) {
+                const snapshot = freezeContext(context);
+                const branchResults = await Promise.all(step.parallel.map(async (child) => {
+                    const branchContext = { ...snapshot };
+                    const branchTrace = [];
+                    await this.executeSteps([child], branchContext, branchTrace, options);
+                    return { branchContext, branchTrace };
+                }));
+                for (const result of branchResults) {
+                    Object.assign(context, result.branchContext);
+                    trace.push(...result.branchTrace);
+                }
+                trace.push({ type: "parallel", matched: true });
+                continue;
+            }
+            if (isHumanStep(step)) {
+                if (!options.handleHuman)
+                    throw new Error(`Pipeline human step "${step.human}" requires a human handler`);
+                await this.runTransitionHook(lastNode, step.human, context, options);
+                const result = await options.handleHuman(step.human, step, freezeContext(context));
+                mergeLoopResult(context, step.human, result);
+                trace.push({ type: "human", name: step.human, when: step.when, matched: true });
+                lastNode = step.human;
+            }
+        }
+        return lastNode;
+    }
+    matchesWhen(expression, context) {
+        if (!expression)
+            return true;
+        return this.evaluator.evaluate(expression, context);
+    }
+    async runTransitionHook(from, to, context, options) {
+        if (!from || !options.hooks)
+            return;
+        const result = await options.hooks.runBefore("loop:transition", {
+            from,
+            to,
+            context,
+        });
+        if (result.cancelled) {
+            throw new Error(`Loop transition from "${from}" to "${to}" cancelled${result.cancelReason ? `: ${result.cancelReason}` : ""}`);
+        }
+        Object.assign(context, result.data.context);
+        await options.hooks.runAfter("loop:transition", result.data);
+    }
+}
+function freezeContext(context) {
+    return Object.freeze({ ...context });
+}
+function mergeLoopResult(context, name, result) {
+    if (result.context)
+        Object.assign(context, result.context);
+    if (result.output !== undefined)
+        context[name] = result.output;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/loop/pipeline.js.map

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

package/dist/loop/pipeline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline.test.d.ts.map

package/dist/loop/pipeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.test.d.ts","sourceRoot":"","sources":["../../src/loop/pipeline.test.ts"],"names":[],"mappings":""}

package/dist/loop/pipeline.test.js

@@ -0,0 +1,103 @@
+import { describe, expect, it } from "vitest";
+import { LoopHookRegistry } from "./hooks.js";
+import { PipelineExecutor } from "./pipeline.js";
+describe("PipelineExecutor", () => {
+    it("runs sequential loop steps and accumulates context by loop name", async () => {
+        const executor = new PipelineExecutor();
+        const result = await executor.execute({
+            loops: { plan: {}, build: {} },
+            pipeline: { steps: [{ loop: "plan" }, { loop: "build", when: "plan.ready == true" }] },
+            runLoop: async (name) => ({ output: { ready: true, name } }),
+        });
+        expect(result.context).toMatchObject({
+            plan: { ready: true, name: "plan" },
+            build: { ready: true, name: "build" },
+        });
+        expect(result.trace.map(e => e.type)).toEqual(["loop", "loop"]);
+    });
+    it("routes switch branches deterministically from context", async () => {
+        const executor = new PipelineExecutor();
+        const result = await executor.execute({
+            loops: { review: {}, fix: {}, ship: {} },
+            context: { review: { passed: false } },
+            pipeline: {
+                steps: [{
+                        switch: {
+                            cases: [
+                                { when: "review.passed == true", steps: [{ loop: "ship" }] },
+                                { when: "review.passed == false", steps: [{ loop: "fix" }] },
+                            ],
+                        },
+                    }],
+            },
+            runLoop: async (name) => ({ output: { ran: name } }),
+        });
+        expect(result.context.fix).toEqual({ ran: "fix" });
+        expect(result.context.ship).toBeUndefined();
+    });
+    it("runs parallel branches against a frozen snapshot and merges by branch output", async () => {
+        const executor = new PipelineExecutor();
+        const result = await executor.execute({
+            loops: { test: {}, typecheck: {} },
+            context: { build: { done: true } },
+            pipeline: { steps: [{ parallel: [{ loop: "test" }, { loop: "typecheck" }], join: "all" }] },
+            runLoop: async (name, _loop, context) => {
+                expect(() => (context.mutated = true)).toThrow();
+                return { output: { passed: name === "test" || name === "typecheck" } };
+            },
+        });
+        expect(result.context).toMatchObject({
+            test: { passed: true },
+            typecheck: { passed: true },
+        });
+        expect(result.context.mutated).toBeUndefined();
+    });
+    it("supports human nodes through an injected handler", async () => {
+        const executor = new PipelineExecutor();
+        const result = await executor.execute({
+            loops: {},
+            pipeline: { steps: [{ human: "underwriter" }] },
+            runLoop: async () => ({ output: {} }),
+            handleHuman: async () => ({ output: { decision: "approve" } }),
+        });
+        expect(result.context.underwriter).toEqual({ decision: "approve" });
+    });
+    it("fires loop:transition hooks between sequential loop nodes", async () => {
+        const hooks = new LoopHookRegistry();
+        const transitions = [];
+        hooks.register({
+            hook: "loop:transition",
+            phase: "before",
+            handler: (ctx) => {
+                transitions.push(`${ctx.data.from}->${ctx.data.to}`);
+            },
+        });
+        const executor = new PipelineExecutor();
+        await executor.execute({
+            hooks,
+            loops: { plan: {}, build: {} },
+            pipeline: { steps: [{ loop: "plan" }, { loop: "build" }] },
+            runLoop: async (name) => ({ output: { name } }),
+        });
+        expect(transitions).toEqual(["plan->build"]);
+    });
+    it("blocks a transition when loop:transition is cancelled", async () => {
+        const hooks = new LoopHookRegistry();
+        hooks.register({
+            hook: "loop:transition",
+            phase: "before",
+            handler: (ctx) => {
+                if (ctx.data.from === "plan" && ctx.data.to === "build")
+                    ctx.cancel("approval required");
+            },
+        });
+        const executor = new PipelineExecutor();
+        await expect(executor.execute({
+            hooks,
+            loops: { plan: {}, build: {} },
+            pipeline: { steps: [{ loop: "plan" }, { loop: "build" }] },
+            runLoop: async (name) => ({ output: { name } }),
+        })).rejects.toThrow('Loop transition from "plan" to "build" cancelled: approval required');
+    });
+});
+//# sourceMappingURL=pipeline.test.js.map

package/dist/loop/pipeline.test.js.map

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

package/dist/loop/runner.d.ts

@@ -0,0 +1,44 @@
+import type { AgentConfig } from "../types.js";
+import type { ContextBag, LoopConfig } from "./types.js";
+import { LoopHookRegistry, type LoopRuntimeConfig, type LoopRunStatus, type LoopStopReason, type LoopToolCall, type LoopToolResult } from "./hooks.js";
+export interface LoopModelInput {
+    agent?: AgentConfig;
+    loop: LoopRuntimeConfig;
+    turn: number;
+    context: ContextBag;
+    activeTools?: string[];
+    toolChoice?: unknown;
+}
+export interface LoopModelResult {
+    text: string;
+    toolCalls?: LoopToolCall[];
+    usage?: unknown;
+}
+export interface LoopRunResult {
+    status: LoopRunStatus;
+    reason: LoopStopReason;
+    turns: number;
+    text: string;
+    context: ContextBag;
+    toolResults: LoopToolResult[];
+}
+export interface LoopRunnerOptions {
+    agent?: AgentConfig;
+    loop: LoopConfig & {
+        name?: string;
+    };
+    context?: ContextBag;
+    input?: unknown;
+    hooks?: LoopHookRegistry;
+    maxTurns?: number;
+    model: (input: LoopModelInput) => Promise<LoopModelResult>;
+    executeTool: (toolCall: LoopToolCall, input: LoopModelInput) => Promise<string>;
+}
+export declare class LoopRunner {
+    private readonly hooks;
+    private readonly evaluator;
+    constructor(hooks?: LoopHookRegistry);
+    run(options: LoopRunnerOptions): Promise<LoopRunResult>;
+    private finish;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/loop/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/loop/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3D,WAAW,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjF;AA8BD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;gBAE/C,KAAK,CAAC,EAAE,gBAAgB;IAI9B,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;YAiL/C,MAAM;CAuBrB"}