pulseed 0.1.4 → 0.2.0

package/dist/adapters/__tests__/shell-datasource.test.js

@@ -0,0 +1,186 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ShellDataSourceAdapter } from "../datasources/shell-datasource.js";
+import { ObservationEngine } from "../../platform/observation/observation-engine.js";
+import { StateManager } from "../../base/state/state-manager.js";
+import { makeTempDir } from "../../../tests/helpers/temp-dir.js";
+import { makeGoal } from "../../../tests/helpers/fixtures.js";
+const defaultMethod = {
+    type: "mechanical",
+    source: "shell-datasource",
+    schedule: null,
+    endpoint: null,
+    confidence_tier: "mechanical",
+};
+// ─── Tests ───
+describe("ShellDataSourceAdapter", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = makeTempDir();
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
+    });
+    // 1. observe() with output_type "number" via echo
+    it('observe(["count"]) with argv echo "42" and output_type "number" returns {count: 42}', async () => {
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            count: { argv: ["echo", "42"], output_type: "number" },
+        });
+        const result = await adapter.observe(["count"]);
+        expect(result).toEqual({ count: 42 });
+    });
+    // 2. observe() with output_type "boolean" — stdout "1" → 1
+    it('observe(["flag"]) with argv echo "1" and output_type "boolean" returns {flag: 1}', async () => {
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            flag: { argv: ["echo", "1"], output_type: "boolean" },
+        });
+        const result = await adapter.observe(["flag"]);
+        expect(result).toEqual({ flag: 1 });
+    });
+    // 3. observe() with output_type "boolean" — stdout "false" → 0
+    it('observe(["flag"]) with argv echo "false" and output_type "boolean" returns {flag: 0}', async () => {
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            flag: { argv: ["echo", "false"], output_type: "boolean" },
+        });
+        const result = await adapter.observe(["flag"]);
+        expect(result).toEqual({ flag: 0 });
+    });
+    // 3b. observe() with output_type "raw" — stdout "73.98" → 73.98 (covers test_coverage use case)
+    it('observe(["coverage"]) with argv echo "73.98" and output_type "raw" returns {coverage: 73.98}', async () => {
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            coverage: { argv: ["echo", "73.98"], output_type: "raw" },
+        });
+        const result = await adapter.observe(["coverage"]);
+        expect(result).toEqual({ coverage: 73.98 });
+    });
+    // 3c. observe() with output_type "raw" — stdout "0" → 0 (parseFloat("0") must NOT fallback to NaN)
+    it('observe(["coverage"]) with argv echo "0" and output_type "raw" returns {coverage: 0}', async () => {
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            coverage: { argv: ["echo", "0"], output_type: "raw" },
+        });
+        const result = await adapter.observe(["coverage"]);
+        expect(result).toEqual({ coverage: 0 });
+    });
+    // 4. observe() with unknown dimension (no command defined) returns {}
+    it('observe(["unknown"]) when no command defined for "unknown" returns {}', async () => {
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            count: { argv: ["echo", "5"], output_type: "number" },
+        });
+        const result = await adapter.observe(["unknown"]);
+        expect(result).toEqual({});
+    });
+    // 5. getSupportedDimensions() returns keys from commands
+    it("getSupportedDimensions() returns keys from commands", () => {
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            todo_count: { argv: ["grep", "-rc", "TODO", "src/"], output_type: "number" },
+            fixme_count: { argv: ["grep", "-rc", "FIXME", "src/"], output_type: "number" },
+        });
+        const dims = adapter.getSupportedDimensions();
+        expect(dims).toContain("todo_count");
+        expect(dims).toContain("fixme_count");
+        expect(dims).toHaveLength(2);
+    });
+    // 6. grep exit code 1 (zero matches) → returns 0 for that dimension
+    it("grep exit code 1 (zero matches) returns 0 for that dimension", async () => {
+        // grep returns exit 1 when no matches found
+        // We search for a string that is extremely unlikely to exist
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            rare_count: {
+                argv: ["grep", "-r", "__PULSEED_UNLIKELY_TOKEN_XYZ_9999__", "."],
+                output_type: "number",
+                cwd: tmpDir,
+            },
+        }, tmpDir);
+        // Create a file so grep has something to scan (just returns exit 1 with no matches)
+        fs.writeFileSync(path.join(tmpDir, "dummy.txt"), "no special tokens here");
+        const result = await adapter.observe(["rare_count"]);
+        expect(result).toEqual({ rare_count: 0 });
+    });
+    // 7. Multi-line grep -c output sums to correct total
+    it("multi-line grep -c output (e.g. src/a.ts:2 + src/b.ts:1) sums to 3", async () => {
+        // Create files with TODO comments
+        fs.writeFileSync(path.join(tmpDir, "a.ts"), "// TODO first\n// TODO second\n");
+        fs.writeFileSync(path.join(tmpDir, "b.ts"), "// TODO third\n");
+        const adapter = new ShellDataSourceAdapter("ds_shell_test", {
+            todo_count: {
+                argv: ["grep", "-rc", "TODO", "."],
+                output_type: "number",
+                cwd: tmpDir,
+            },
+        }, tmpDir);
+        const result = await adapter.observe(["todo_count"]);
+        expect(result["todo_count"]).toBe(3);
+    });
+    // shell binary blocklist tests
+    describe("shell binary blocklist", () => {
+        it("throws when argv[0] is 'bash'", () => {
+            expect(() => new ShellDataSourceAdapter("ds_test", {
+                count: { argv: ["bash", "-c", "echo 1"], output_type: "number" },
+            })).toThrow(/Shell binary "bash" is not allowed/);
+        });
+        it("throws when argv[0] is 'sh'", () => {
+            expect(() => new ShellDataSourceAdapter("ds_test", {
+                count: { argv: ["sh", "-c", "echo 1"], output_type: "number" },
+            })).toThrow(/Shell binary "sh" is not allowed/);
+        });
+        it("throws when argv[0] is 'zsh'", () => {
+            expect(() => new ShellDataSourceAdapter("ds_test", {
+                count: { argv: ["zsh", "-c", "echo 1"], output_type: "number" },
+            })).toThrow(/Shell binary "zsh" is not allowed/);
+        });
+        it("throws when argv[0] is 'powershell'", () => {
+            expect(() => new ShellDataSourceAdapter("ds_test", {
+                count: { argv: ["powershell", "-Command", "Write-Output 1"], output_type: "number" },
+            })).toThrow(/Shell binary "powershell" is not allowed/);
+        });
+        it("throws when argv[0] is '/bin/bash' (full path blocked via basename)", () => {
+            expect(() => new ShellDataSourceAdapter("ds_test", {
+                count: { argv: ["/bin/bash", "-c", "echo 1"], output_type: "number" },
+            })).toThrow(/Shell binary "\/bin\/bash" is not allowed/);
+        });
+        it("does NOT throw for safe binaries like 'grep' or 'echo'", () => {
+            expect(() => new ShellDataSourceAdapter("ds_test", {
+                count: { argv: ["grep", "-rc", "TODO", "src/"], output_type: "number" },
+                flag: { argv: ["echo", "1"], output_type: "boolean" },
+            })).not.toThrow();
+        });
+    });
+    // 8. Integration: ShellDataSourceAdapter registered with ObservationEngine triggers mechanical layer
+    it("registered with ObservationEngine, observe() records a mechanical-layer entry", async () => {
+        const stateDir = makeTempDir();
+        const stateManager = new StateManager(stateDir);
+        const adapter = new ShellDataSourceAdapter("ds_shell_integration", {
+            todo_count: { argv: ["echo", "3"], output_type: "number" },
+        });
+        const engine = new ObservationEngine(stateManager, [adapter]);
+        const goal = makeGoal({
+            id: "goal-shell-integration",
+            dimensions: [
+                {
+                    name: "todo_count",
+                    label: "TODO Count",
+                    current_value: 5,
+                    threshold: { type: "max", value: 0 },
+                    confidence: 0.5,
+                    observation_method: defaultMethod,
+                    last_updated: new Date().toISOString(),
+                    history: [],
+                    weight: 1.0,
+                    uncertainty_weight: null,
+                    state_integrity: "ok",
+                },
+            ],
+        });
+        await stateManager.saveGoal(goal);
+        // observeFromDataSource() is the engine method that uses registered adapters
+        const entry = await engine.observeFromDataSource(goal.id, "todo_count", "ds_shell_integration");
+        expect(entry.layer).toBe("mechanical");
+        expect(entry.extracted_value).toBe(3);
+        expect(entry.confidence).toBeGreaterThanOrEqual(0.85);
+        expect(entry.goal_id).toBe(goal.id);
+        expect(entry.dimension_name).toBe("todo_count");
+        fs.rmSync(stateDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
+    });
+});
+//# sourceMappingURL=shell-datasource.test.js.map

package/dist/adapters/__tests__/shell-datasource.test.js.map

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

package/dist/adapters/agents/a2a-adapter.d.ts

@@ -0,0 +1,49 @@
+import type { IAdapter, AgentTask, AgentResult } from "../../orchestrator/execution/adapter-layer.js";
+import type { A2AClientConfig } from "./a2a-client.js";
+export interface A2AAdapterConfig extends A2AClientConfig {
+    /**
+     * Adapter type string registered in AdapterRegistry.
+     * Default: "a2a". Override to register multiple A2A agents
+     * (e.g., "a2a_research_agent", "a2a_code_agent").
+     */
+    adapterType?: string;
+    /**
+     * Override capabilities instead of deriving from Agent Card skills.
+     * If not set, capabilities are fetched from the Agent Card on first use.
+     */
+    capabilities?: string[];
+    /**
+     * Prefer SSE streaming over polling. Default: true.
+     * Falls back to polling if the agent does not advertise streaming support.
+     */
+    preferStreaming?: boolean;
+    /**
+     * Context ID for multi-turn conversations. If set, all tasks sent through
+     * this adapter share the same A2A conversation context.
+     */
+    contextId?: string;
+}
+export declare class A2AAdapter implements IAdapter {
+    readonly adapterType: string;
+    private readonly client;
+    private readonly preferStreaming;
+    private readonly contextId?;
+    private resolvedCapabilities;
+    private agentCard;
+    constructor(config: A2AAdapterConfig);
+    get capabilities(): readonly string[];
+    /**
+     * Fetch Agent Card and derive capabilities from skills.
+     * Called lazily on first execute() if capabilities were not provided in config.
+     * Safe to call multiple times (cached).
+     */
+    discoverCapabilities(): Promise<void>;
+    execute(task: AgentTask): Promise<AgentResult>;
+    private mapTaskToResult;
+    /**
+     * Extract text content from A2A artifacts and history.
+     * Concatenates all text parts from artifacts (preferred) or last agent message.
+     */
+    private extractTextOutput;
+}
+//# sourceMappingURL=a2a-adapter.d.ts.map

package/dist/adapters/agents/a2a-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/a2a-adapter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACZ,MAAM,+CAA+C,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvD,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,UAAW,YAAW,QAAQ;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,oBAAoB,CAAkB;IAC9C,OAAO,CAAC,SAAS,CAA6B;gBAElC,MAAM,EAAE,gBAAgB;IAQpC,IAAI,YAAY,IAAI,SAAS,MAAM,EAAE,CAEpC;IAED;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAsFpD,OAAO,CAAC,eAAe;IA2EvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CA+B1B"}

package/dist/adapters/agents/a2a-adapter.js

@@ -0,0 +1,211 @@
+// ─── A2AAdapter ───
+//
+// IAdapter implementation for the Google A2A (Agent-to-Agent) Protocol v0.3.
+// Wraps A2AClient for network I/O and maps between PulSeed's AgentTask/AgentResult
+// and A2A's Message/Task types. Supports both polling and SSE streaming.
+import { randomUUID } from "node:crypto";
+import { A2AClient } from "./a2a-client.js";
+import { A2A_TERMINAL_STATES } from "../../base/types/a2a.js";
+// ─── Adapter ───
+export class A2AAdapter {
+    adapterType;
+    client;
+    preferStreaming;
+    contextId;
+    resolvedCapabilities;
+    agentCard = null;
+    constructor(config) {
+        this.adapterType = config.adapterType ?? "a2a";
+        this.client = new A2AClient(config);
+        this.preferStreaming = config.preferStreaming ?? true;
+        this.contextId = config.contextId;
+        this.resolvedCapabilities = config.capabilities ?? null;
+    }
+    get capabilities() {
+        return this.resolvedCapabilities ?? ["general_purpose"];
+    }
+    /**
+     * Fetch Agent Card and derive capabilities from skills.
+     * Called lazily on first execute() if capabilities were not provided in config.
+     * Safe to call multiple times (cached).
+     */
+    async discoverCapabilities() {
+        if (this.agentCard)
+            return;
+        try {
+            this.agentCard = await this.client.fetchAgentCard();
+            if (!this.resolvedCapabilities && this.agentCard.skills?.length) {
+                this.resolvedCapabilities = this.agentCard.skills.flatMap((s) => s.tags ?? [s.id]);
+            }
+        }
+        catch {
+            // Agent Card not available — continue with default capabilities
+        }
+    }
+    async execute(task) {
+        const startedAt = Date.now();
+        // Lazy capability discovery
+        if (!this.agentCard) {
+            await this.discoverCapabilities();
+        }
+        // Build A2A message from PulSeed's prompt
+        const message = {
+            role: "user",
+            parts: [{ kind: "text", text: task.prompt }],
+            messageId: randomUUID(),
+            ...(this.contextId ? { contextId: this.contextId } : {}),
+        };
+        // Timeout via AbortController
+        const controller = new AbortController();
+        const timeoutHandle = setTimeout(() => controller.abort(), task.timeout_ms);
+        try {
+            let a2aTask;
+            const supportsStreaming = this.preferStreaming &&
+                this.agentCard?.capabilities?.streaming === true;
+            if (supportsStreaming) {
+                // ── SSE streaming path ──
+                a2aTask = await this.client.sendMessageStream(message, undefined, // onStatus callback — not needed for basic adapter
+                controller.signal);
+            }
+            else {
+                // ── Polling path ──
+                const initial = await this.client.sendMessage(message);
+                if (A2A_TERMINAL_STATES.has(initial.status.state)) {
+                    a2aTask = initial;
+                }
+                else {
+                    a2aTask = await this.client.waitForCompletion(initial.id, controller.signal);
+                }
+            }
+            clearTimeout(timeoutHandle);
+            return this.mapTaskToResult(a2aTask, startedAt);
+        }
+        catch (err) {
+            clearTimeout(timeoutHandle);
+            const elapsed = Date.now() - startedAt;
+            const errMessage = err instanceof Error ? err.message : String(err);
+            // Distinguish timeout from other errors
+            if (controller.signal.aborted ||
+                errMessage.includes("did not complete within")) {
+                return {
+                    success: false,
+                    output: "",
+                    error: `Timed out after ${task.timeout_ms}ms`,
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "timeout",
+                };
+            }
+            return {
+                success: false,
+                output: "",
+                error: errMessage,
+                exit_code: null,
+                elapsed_ms: elapsed,
+                stopped_reason: "error",
+            };
+        }
+    }
+    // ─── Private: map A2A Task to PulSeed AgentResult ───
+    mapTaskToResult(task, startedAt) {
+        const elapsed = Date.now() - startedAt;
+        // Extract text output from artifacts
+        const output = this.extractTextOutput(task);
+        switch (task.status.state) {
+            case "completed":
+                return {
+                    success: true,
+                    output,
+                    error: null,
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "completed",
+                };
+            case "failed":
+                return {
+                    success: false,
+                    output,
+                    error: task.status.message ?? "A2A task failed",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+            case "canceled":
+                return {
+                    success: false,
+                    output,
+                    error: "A2A task was canceled",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "timeout", // closest mapping
+                };
+            case "rejected":
+                return {
+                    success: false,
+                    output,
+                    error: task.status.message ??
+                        "A2A task was rejected by the remote agent",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+            case "input-required":
+            case "auth-required":
+                return {
+                    success: false,
+                    output,
+                    error: `A2A task requires ${task.status.state}: ${task.status.message ?? "no details"}. ` +
+                        "PulSeed does not support interactive input through adapters.",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+            default:
+                // Should not reach here after waitForCompletion, but handle gracefully
+                return {
+                    success: false,
+                    output,
+                    error: `A2A task in unexpected state: ${task.status.state}`,
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+        }
+    }
+    /**
+     * Extract text content from A2A artifacts and history.
+     * Concatenates all text parts from artifacts (preferred) or last agent message.
+     */
+    extractTextOutput(task) {
+        // Prefer artifacts
+        if (task.artifacts?.length) {
+            const texts = [];
+            for (const artifact of task.artifacts) {
+                for (const part of artifact.parts) {
+                    if (part.kind === "text") {
+                        texts.push(part.text);
+                    }
+                }
+            }
+            if (texts.length > 0)
+                return texts.join("\n");
+        }
+        // Fallback: last agent message in history
+        if (task.history?.length) {
+            const agentMessages = task.history.filter((m) => m.role === "agent");
+            const last = agentMessages[agentMessages.length - 1];
+            if (last) {
+                const texts = [];
+                for (const part of last.parts) {
+                    if (part.kind === "text") {
+                        texts.push(part.text);
+                    }
+                }
+                if (texts.length > 0)
+                    return texts.join("\n");
+            }
+        }
+        return "";
+    }
+}
+//# sourceMappingURL=a2a-adapter.js.map

package/dist/adapters/agents/a2a-adapter.js.map

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

package/dist/adapters/agents/a2a-client.d.ts

@@ -0,0 +1,28 @@
+import type { A2AAgentCard, A2ATask, A2ATaskState, A2AMessage } from "../../base/types/a2a.js";
+export interface A2AClientConfig {
+    /** Base URL of the A2A agent (e.g. "https://agent.example.com") */
+    baseUrl: string;
+    /** Auth token (Bearer). Optional — depends on agent's securitySchemes. */
+    authToken?: string;
+    /** Polling interval when SSE is not supported. Default: 2000ms */
+    pollIntervalMs?: number;
+    /** Maximum total wait time for task completion. Default: 300_000ms (5 min) */
+    maxWaitMs?: number;
+}
+export declare class A2AClient {
+    private readonly baseUrl;
+    private readonly authToken?;
+    private readonly pollIntervalMs;
+    private readonly maxWaitMs;
+    constructor(config: A2AClientConfig);
+    fetchAgentCard(): Promise<A2AAgentCard>;
+    sendMessage(message: A2AMessage): Promise<A2ATask>;
+    getTask(taskId: string): Promise<A2ATask>;
+    cancelTask(taskId: string): Promise<void>;
+    waitForCompletion(taskId: string, signal?: AbortSignal): Promise<A2ATask>;
+    sendMessageStream(message: A2AMessage, onStatus?: (state: A2ATaskState, msg?: string) => void, signal?: AbortSignal): Promise<A2ATask>;
+    private buildHeaders;
+    private httpGet;
+    private jsonRpc;
+}
+//# sourceMappingURL=a2a-client.d.ts.map

package/dist/adapters/agents/a2a-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/a2a-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,UAAU,EAEX,MAAM,yBAAyB,CAAC;AAUjC,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,eAAe;IAS7B,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IAQvC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAalD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAazC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IA6Bb,iBAAiB,CACrB,OAAO,EAAE,UAAU,EACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,EACtD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IA2EnB,OAAO,CAAC,YAAY;YAWN,OAAO;YAUP,OAAO;CAqBtB"}