pulseed 0.4.17 → 0.4.19

package/dist/platform/observation/data-source-adapter.d.ts

@@ -0,0 +1,62 @@
+import type { DataSourceType, DataSourceConfig, DataSourceQuery, DataSourceResult } from "../../base/types/data-source.js";
+export declare function getNestedValue(obj: unknown, path: string): unknown;
+export interface IDataSourceAdapter {
+    readonly sourceId: string;
+    readonly sourceType: DataSourceType;
+    readonly config: DataSourceConfig;
+    connect(): Promise<void>;
+    query(params: DataSourceQuery): Promise<DataSourceResult>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    getSupportedDimensions?(): string[];
+}
+export declare class FileDataSourceAdapter implements IDataSourceAdapter {
+    readonly sourceId: string;
+    readonly sourceType: DataSourceType;
+    readonly config: DataSourceConfig;
+    constructor(config: DataSourceConfig);
+    connect(): Promise<void>;
+    query(params: DataSourceQuery): Promise<DataSourceResult>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+export declare class HttpApiDataSourceAdapter implements IDataSourceAdapter {
+    readonly sourceId: string;
+    readonly sourceType: DataSourceType;
+    readonly config: DataSourceConfig;
+    constructor(config: DataSourceConfig);
+    connect(): Promise<void>;
+    query(params: DataSourceQuery): Promise<DataSourceResult>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+declare function runPsql(connectionString: string, sql: string, timeoutMs: number): Promise<{
+    stdout: string;
+    stderr: string;
+    code: number | null;
+}>;
+export declare class PostgresDataSourceAdapter implements IDataSourceAdapter {
+    readonly sourceId: string;
+    readonly sourceType: DataSourceType;
+    readonly config: DataSourceConfig;
+    private readonly runner;
+    constructor(config: DataSourceConfig, runner?: typeof runPsql);
+    private resolveConnectionString;
+    private resolveQueryExpression;
+    connect(): Promise<void>;
+    query(params: DataSourceQuery): Promise<DataSourceResult>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+export declare class DataSourceRegistry {
+    private readonly sources;
+    register(adapter: IDataSourceAdapter): void;
+    getSource(id: string): IDataSourceAdapter;
+    listSources(): string[];
+    getAllSources(): IDataSourceAdapter[];
+    remove(id: string): void;
+    has(id: string): boolean;
+    upsert(adapter: IDataSourceAdapter): void;
+}
+export {};
+//# sourceMappingURL=data-source-adapter.d.ts.map

package/dist/platform/observation/data-source-adapter.d.ts.map

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

package/dist/platform/observation/data-source-adapter.js

@@ -0,0 +1,396 @@
+// ─── DataSourceAdapter ───
+//
+// Defines the IDataSourceAdapter interface and concrete implementations for
+// file-based and HTTP API data sources, plus DataSourceRegistry for managing
+// multiple adapter instances.
+import * as fsp from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { ValidationError } from "../../base/utils/errors.js";
+// ─── Helper ───
+export function getNestedValue(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+// ─── FileDataSourceAdapter ───
+export class FileDataSourceAdapter {
+    sourceId;
+    sourceType = "file";
+    config;
+    constructor(config) {
+        this.config = config;
+        this.sourceId = config.id;
+    }
+    async connect() {
+        const path = this.config.connection.path;
+        if (!path) {
+            throw new ValidationError(`FileDataSourceAdapter [${this.sourceId}]: connection.path is required`);
+        }
+        try {
+            await fsp.access(path);
+        }
+        catch {
+            throw new Error(`FileDataSourceAdapter [${this.sourceId}]: file not found: ${path}`);
+        }
+    }
+    async query(params) {
+        const path = this.config.connection.path;
+        if (!path) {
+            throw new ValidationError(`FileDataSourceAdapter [${this.sourceId}]: connection.path is required`);
+        }
+        let raw;
+        let value;
+        const content = await fsp.readFile(path, "utf-8");
+        if (path.endsWith(".json")) {
+            raw = JSON.parse(content);
+            if (params.expression) {
+                const extracted = getNestedValue(raw, params.expression);
+                value = extracted !== undefined ? extracted : null;
+            }
+            else {
+                value = null;
+            }
+        }
+        else {
+            raw = content;
+            value = content;
+        }
+        return {
+            value,
+            raw,
+            timestamp: new Date().toISOString(),
+            source_id: this.sourceId,
+        };
+    }
+    async disconnect() {
+        // no-op
+    }
+    async healthCheck() {
+        const path = this.config.connection.path;
+        if (!path)
+            return false;
+        try {
+            await fsp.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ─── HttpApiDataSourceAdapter ───
+function buildAuthHeaders(config) {
+    const auth = config.auth;
+    if (!auth || auth.type === "none")
+        return {};
+    const secret = auth.secret_ref ?? "";
+    if (auth.type === "api_key") {
+        return { "X-API-Key": secret };
+    }
+    if (auth.type === "bearer") {
+        return { Authorization: `Bearer ${secret}` };
+    }
+    if (auth.type === "basic") {
+        const encoded = Buffer.from(secret).toString("base64");
+        return { Authorization: `Basic ${encoded}` };
+    }
+    return {};
+}
+export class HttpApiDataSourceAdapter {
+    sourceId;
+    sourceType = "http_api";
+    config;
+    constructor(config) {
+        this.config = config;
+        this.sourceId = config.id;
+    }
+    async connect() {
+        const healthy = await this.healthCheck();
+        if (!healthy) {
+            throw new Error(`HttpApiDataSourceAdapter [${this.sourceId}]: health check failed for ${this.config.connection.url}`);
+        }
+    }
+    async query(params) {
+        const url = this.config.connection.url;
+        if (!url) {
+            throw new ValidationError(`HttpApiDataSourceAdapter [${this.sourceId}]: connection.url is required`);
+        }
+        const timeoutMs = params.timeout_ms ?? 10000;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const method = this.config.connection.method ?? "GET";
+        const headers = {
+            "Content-Type": "application/json",
+            ...this.config.connection.headers,
+            ...buildAuthHeaders(this.config),
+        };
+        let body;
+        if (method === "POST" && this.config.connection.body_template) {
+            body = this.config.connection.body_template.replace("{{dimension_name}}", params.dimension_name);
+        }
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers,
+                body,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok) {
+            throw new Error(`HttpApiDataSourceAdapter [${this.sourceId}]: HTTP ${response.status} from ${url}`);
+        }
+        const raw = await response.json();
+        let value = null;
+        if (params.expression) {
+            const extracted = getNestedValue(raw, params.expression);
+            value = extracted !== undefined ? extracted : null;
+        }
+        return {
+            value,
+            raw,
+            timestamp: new Date().toISOString(),
+            source_id: this.sourceId,
+        };
+    }
+    async disconnect() {
+        // no-op
+    }
+    async healthCheck() {
+        const url = this.config.connection.url;
+        if (!url)
+            return false;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 5000);
+        try {
+            const response = await fetch(url, {
+                method: "HEAD",
+                headers: buildAuthHeaders(this.config),
+                signal: controller.signal,
+            });
+            return response.status >= 200 && response.status < 300;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+// ─── PostgresDataSourceAdapter ───
+function parseScalarResult(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return null;
+    if (trimmed === "null")
+        return null;
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (/^[-+]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?$/.test(trimmed)) {
+        const num = Number(trimmed);
+        if (!Number.isNaN(num))
+            return num;
+    }
+    return trimmed;
+}
+function buildPsqlArgs(connectionString, sql) {
+    return [
+        "-X",
+        "-q",
+        "-t",
+        "-A",
+        "-v",
+        "ON_ERROR_STOP=1",
+        "-d",
+        connectionString,
+        "-c",
+        sql,
+    ];
+}
+function normalizeSqlExpression(expression) {
+    const trimmed = expression.trim();
+    if (/^(select|with)\b/i.test(trimmed)) {
+        return trimmed;
+    }
+    return `SELECT (${trimmed}) AS value`;
+}
+function runPsql(connectionString, sql, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("psql", buildPsqlArgs(connectionString, sql), {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error("PostgresDataSourceAdapter: query timed out"));
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf-8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf-8");
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                reject(new Error(stderr.trim() || `psql exited with code ${code ?? "unknown"}`));
+                return;
+            }
+            resolve({ stdout, stderr, code });
+        });
+    });
+}
+export class PostgresDataSourceAdapter {
+    sourceId;
+    sourceType = "database";
+    config;
+    runner;
+    constructor(config, runner = runPsql) {
+        this.config = config;
+        this.sourceId = config.id;
+        this.runner = runner;
+    }
+    resolveConnectionString() {
+        const direct = this.config.connection_string?.trim();
+        if (direct)
+            return direct;
+        const url = this.config.connection.url?.trim();
+        if (url)
+            return url;
+        return undefined;
+    }
+    resolveQueryExpression(params) {
+        const mapped = this.config.dimension_mapping?.[params.dimension_name];
+        const expression = params.expression ?? mapped;
+        if (!expression || !expression.trim()) {
+            return undefined;
+        }
+        return expression;
+    }
+    async connect() {
+        const healthy = await this.healthCheck();
+        if (!healthy) {
+            throw new Error(`PostgresDataSourceAdapter [${this.sourceId}]: health check failed`);
+        }
+    }
+    async query(params) {
+        const connectionString = this.resolveConnectionString();
+        if (!connectionString) {
+            throw new ValidationError(`PostgresDataSourceAdapter [${this.sourceId}]: connection_string is required`);
+        }
+        const expression = this.resolveQueryExpression(params);
+        if (!expression) {
+            return {
+                value: null,
+                raw: [],
+                timestamp: new Date().toISOString(),
+                source_id: this.sourceId,
+                metadata: {
+                    error: `No SQL expression configured for dimension "${params.dimension_name}"`,
+                },
+            };
+        }
+        const sql = normalizeSqlExpression(expression);
+        try {
+            const result = await this.runner(connectionString, sql, params.timeout_ms ?? 10_000);
+            const lines = result.stdout.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+            const firstRow = lines[0] ?? "";
+            const [firstCell = ""] = firstRow.split("\t");
+            return {
+                value: parseScalarResult(firstCell),
+                raw: lines,
+                timestamp: new Date().toISOString(),
+                source_id: this.sourceId,
+                metadata: {
+                    query: sql,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                value: null,
+                raw: [],
+                timestamp: new Date().toISOString(),
+                source_id: this.sourceId,
+                metadata: {
+                    query: sql,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            };
+        }
+    }
+    async disconnect() {
+        // no-op
+    }
+    async healthCheck() {
+        const connectionString = this.resolveConnectionString();
+        if (!connectionString)
+            return false;
+        try {
+            await this.runner(connectionString, "SELECT 1", 5_000);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ─── DataSourceRegistry ───
+export class DataSourceRegistry {
+    sources = new Map();
+    register(adapter) {
+        if (this.sources.has(adapter.sourceId)) {
+            throw new Error(`DataSourceRegistry: source "${adapter.sourceId}" is already registered. ` +
+                `Remove it first before re-registering.`);
+        }
+        this.sources.set(adapter.sourceId, adapter);
+    }
+    getSource(id) {
+        const source = this.sources.get(id);
+        if (!source) {
+            throw new Error(`DataSourceRegistry: no source registered with id "${id}". ` +
+                `Available sources: [${this.listSources().join(", ")}]`);
+        }
+        return source;
+    }
+    listSources() {
+        return Array.from(this.sources.keys()).sort();
+    }
+    getAllSources() {
+        return Array.from(this.sources.values());
+    }
+    remove(id) {
+        if (!this.sources.has(id)) {
+            throw new Error(`DataSourceRegistry: cannot remove "${id}" — not registered. ` +
+                `Available sources: [${this.listSources().join(", ")}]`);
+        }
+        this.sources.delete(id);
+    }
+    has(id) {
+        return this.sources.has(id);
+    }
+    upsert(adapter) {
+        if (this.has(adapter.sourceId)) {
+            this.remove(adapter.sourceId);
+        }
+        this.register(adapter);
+    }
+}
+//# sourceMappingURL=data-source-adapter.js.map

package/dist/platform/observation/data-source-adapter.js.map

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

package/dist/platform/observation/dimension-pre-checker.d.ts

@@ -0,0 +1,26 @@
+import type { Dimension } from "../../base/types/goal.js";
+import type { ObservationLogEntry } from "../../base/types/state.js";
+import type { ToolExecutor } from "../../tools/executor.js";
+export interface PreCheckResult {
+    changed: boolean;
+    hint?: string;
+    raw_value?: unknown;
+}
+export interface IDimensionPreChecker {
+    check(dimension: Dimension, lastObservation: ObservationLogEntry | null, goalContext: {
+        workspace_path?: string;
+    }): Promise<PreCheckResult>;
+}
+export interface DimensionPreCheckerConfig {
+    min_observation_interval_sec: number;
+    strategies: Array<"age" | "git_diff" | "file_stat">;
+    toolExecutor?: ToolExecutor;
+}
+export declare class DimensionPreChecker implements IDimensionPreChecker {
+    private readonly config;
+    constructor(config?: Partial<DimensionPreCheckerConfig>);
+    check(dimension: Dimension, lastObservation: ObservationLogEntry | null, goalContext: {
+        workspace_path?: string;
+    }): Promise<PreCheckResult>;
+}
+//# sourceMappingURL=dimension-pre-checker.d.ts.map

package/dist/platform/observation/dimension-pre-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-pre-checker.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/dimension-pre-checker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAM5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,CACH,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,mBAAmB,GAAG,IAAI,EAC3C,WAAW,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAID,MAAM,WAAW,yBAAyB;IACxC,4BAA4B,EAAE,MAAM,CAAC;IACrC,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAsGD,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,MAAM,GAAE,OAAO,CAAC,yBAAyB,CAAM;IAIrD,KAAK,CACT,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,mBAAmB,GAAG,IAAI,EAC3C,WAAW,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,cAAc,CAAC;CAgD3B"}

package/dist/platform/observation/dimension-pre-checker.js

@@ -0,0 +1,130 @@
+import { execFile as execFileCb } from "child_process";
+import { stat } from "fs/promises";
+import { promisify } from "util";
+const execFile = promisify(execFileCb);
+const DEFAULT_CONFIG = {
+    min_observation_interval_sec: 60,
+    strategies: ["age", "git_diff"],
+};
+// Age strategy: skip if last observation is younger than min_observation_interval.
+function checkAge(lastObservation, minIntervalSec) {
+    if (!lastObservation)
+        return null; // no previous obs -> must run
+    const lastTs = new Date(lastObservation.timestamp).getTime();
+    const ageMs = Date.now() - lastTs;
+    if (ageMs < minIntervalSec * 1000) {
+        return { changed: false };
+    }
+    return null; // age check passes; defer to other strategies
+}
+// Git diff strategy via ToolExecutor (preferred) or raw execFile fallback.
+async function checkGitDiff(workspacePath, lastObservation, toolExecutor) {
+    if (!workspacePath)
+        return null;
+    if (!lastObservation)
+        return null;
+    if (toolExecutor) {
+        try {
+            const ctx = {
+                cwd: workspacePath,
+                goalId: "pre-check",
+                trustBalance: 0,
+                preApproved: true,
+                approvalFn: async () => true,
+                callId: "pre-check-dirty",
+                sessionId: "observation",
+            };
+            // Use ShellTool with `git status --short` to detect all changes
+            // (staged, unstaged, AND untracked files — unlike git diff which misses untracked)
+            const result = await toolExecutor.execute("shell", { command: "git status --short", timeoutMs: 8000 }, ctx);
+            if (result.success && typeof result.data === "object" && result.data !== null) {
+                const stdout = String(result.data.stdout ?? "").trim();
+                if (stdout.length === 0)
+                    return { changed: false };
+                return { changed: true, hint: stdout.slice(0, 200) };
+            }
+        }
+        catch {
+            // ToolExecutor call failed -- fall through to execFile fallback
+        }
+    }
+    // Fallback: raw execFile
+    try {
+        const { stdout } = await execFile("git", ["status", "--short"], { cwd: workspacePath, timeout: 8000, encoding: "utf8" });
+        if (stdout.trim().length === 0) {
+            return { changed: false };
+        }
+        return { changed: true, hint: stdout.trim().slice(0, 200) };
+    }
+    catch {
+        // Not a git repo or git unavailable -- skip this strategy
+        return null;
+    }
+}
+// File stat strategy: if workspace mtime <= last observation timestamp, no change.
+async function checkFileStat(workspacePath, lastObservation) {
+    if (!workspacePath)
+        return null;
+    if (!lastObservation)
+        return null;
+    try {
+        const s = await stat(workspacePath);
+        const lastObsTime = new Date(lastObservation.timestamp).getTime();
+        const mtimeMs = s.mtimeMs;
+        if (mtimeMs <= lastObsTime) {
+            return { changed: false };
+        }
+        return { changed: true, hint: `Workspace mtime changed since last observation` };
+    }
+    catch {
+        // stat failed (path does not exist, permissions) -- skip
+        return null;
+    }
+}
+// --- Default implementation ---
+export class DimensionPreChecker {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    async check(dimension, lastObservation, goalContext) {
+        // No previous observation -> always run full observation
+        if (!lastObservation) {
+            return { changed: true };
+        }
+        const results = [];
+        for (const strategy of this.config.strategies) {
+            switch (strategy) {
+                case "age":
+                    results.push(checkAge(lastObservation, this.config.min_observation_interval_sec));
+                    break;
+                case "git_diff":
+                    results.push(await checkGitDiff(goalContext.workspace_path, lastObservation, this.config.toolExecutor));
+                    break;
+                case "file_stat":
+                    results.push(await checkFileStat(goalContext.workspace_path, lastObservation));
+                    break;
+            }
+        }
+        // Filter out null results (strategy not applicable)
+        const applicable = results.filter((r) => r !== null);
+        // No applicable strategy produced a result -> default to changed=true (run LLM)
+        if (applicable.length === 0) {
+            return { changed: true };
+        }
+        // If ANY strategy reports changed=true -> proceed to LLM
+        const changedResult = applicable.find((r) => r.changed);
+        if (changedResult) {
+            return changedResult;
+        }
+        // ALL applicable strategies report changed=false -> skip
+        const hints = applicable.map((r) => r.hint).filter(Boolean);
+        const rawValue = applicable.find((r) => r.raw_value !== undefined)?.raw_value;
+        return {
+            changed: false,
+            hint: hints.length > 0 ? hints.join("; ") : undefined,
+            raw_value: rawValue,
+        };
+    }
+}
+//# sourceMappingURL=dimension-pre-checker.js.map

package/dist/platform/observation/dimension-pre-checker.js.map

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

package/dist/platform/observation/engine/observe-context.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from "../../../runtime/logger.js";
+export type WorkspaceContextFetcher = (goalId: string, dimensionName: string) => Promise<string | undefined>;
+export declare function createWorkspaceContextFetcher(contextProvider: ((goalId: string, dimensionName: string) => Promise<string>) | undefined, logger?: Logger): WorkspaceContextFetcher;
+//# sourceMappingURL=observe-context.d.ts.map

package/dist/platform/observation/engine/observe-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-context.d.ts","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAE7G,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,EACzF,MAAM,CAAC,EAAE,MAAM,GACd,uBAAuB,CA8BzB"}