openplanter 0.1.0

package/dist/runtime.js

@@ -0,0 +1,259 @@
+/**
+ * Session runtime – migrated from agent/runtime.py.
+ *
+ * Provides SessionError, SessionStore, and SessionRuntime for managing
+ * agent sessions with persistence.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import * as crypto from "node:crypto";
+import { ExternalContext, } from "./engine.js";
+// ---------------------------------------------------------------------------
+// SessionError
+// ---------------------------------------------------------------------------
+export class SessionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SessionError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function _utcNow() {
+    return new Date().toISOString();
+}
+function _newSessionId() {
+    const now = new Date();
+    const stamp = now.getUTCFullYear().toString() +
+        String(now.getUTCMonth() + 1).padStart(2, "0") +
+        String(now.getUTCDate()).padStart(2, "0") +
+        "-" +
+        String(now.getUTCHours()).padStart(2, "0") +
+        String(now.getUTCMinutes()).padStart(2, "0") +
+        String(now.getUTCSeconds()).padStart(2, "0");
+    return `${stamp}-${crypto.randomBytes(3).toString("hex")}`;
+}
+function _safeComponent(text) {
+    return text.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "artifact";
+}
+// ---------------------------------------------------------------------------
+// SessionStore
+// ---------------------------------------------------------------------------
+export class SessionStore {
+    workspace;
+    sessionRootDir;
+    root;
+    sessions;
+    constructor(workspace, sessionRootDir = ".openplanter") {
+        let ws = workspace;
+        if (ws.startsWith("~")) {
+            ws = path.join(os.homedir(), ws.slice(1));
+        }
+        this.workspace = path.resolve(ws);
+        this.sessionRootDir = sessionRootDir;
+        this.root = path.resolve(path.join(this.workspace, this.sessionRootDir));
+        this.sessions = path.join(this.root, "sessions");
+        fs.mkdirSync(this.sessions, { recursive: true });
+    }
+    _sessionDir(sessionId) {
+        return path.join(this.sessions, sessionId);
+    }
+    _metadataPath(sessionId) {
+        return path.join(this._sessionDir(sessionId), "metadata.json");
+    }
+    listSessions(limit = 100) {
+        if (!fs.existsSync(this.sessions))
+            return [];
+        let dirs;
+        try {
+            dirs = fs.readdirSync(this.sessions).sort().reverse();
+        }
+        catch {
+            return [];
+        }
+        const results = [];
+        for (const dir of dirs.slice(0, limit)) {
+            const metaPath = this._metadataPath(dir);
+            if (!fs.existsSync(metaPath))
+                continue;
+            try {
+                const raw = fs.readFileSync(metaPath, "utf-8");
+                const data = JSON.parse(raw);
+                results.push({
+                    session_id: String(data["session_id"] ?? dir),
+                    created_at: String(data["created_at"] ?? "unknown"),
+                    updated_at: String(data["updated_at"] ?? "unknown"),
+                });
+            }
+            catch {
+                results.push({ session_id: dir, created_at: "unknown", updated_at: "unknown" });
+            }
+        }
+        return results;
+    }
+    openSession(sessionId, resume) {
+        if (resume && !sessionId) {
+            // Find the latest session
+            const sessions = this.listSessions(1);
+            if (sessions.length > 0) {
+                sessionId = sessions[0]["session_id"];
+            }
+        }
+        if (sessionId && resume) {
+            const dir = this._sessionDir(sessionId);
+            if (!fs.existsSync(dir)) {
+                throw new SessionError(`Session '${sessionId}' not found.`);
+            }
+            const statePath = path.join(dir, "state.json");
+            let state = {};
+            if (fs.existsSync(statePath)) {
+                try {
+                    state = JSON.parse(fs.readFileSync(statePath, "utf-8"));
+                }
+                catch {
+                    state = {};
+                }
+            }
+            this._touchMetadata(sessionId);
+            return [sessionId, state, false];
+        }
+        const sid = sessionId ?? _newSessionId();
+        const dir = this._sessionDir(sid);
+        const createdNew = !fs.existsSync(dir);
+        fs.mkdirSync(dir, { recursive: true });
+        this._touchMetadata(sid);
+        return [sid, {}, createdNew];
+    }
+    appendEvent(sessionId, eventType, data) {
+        const dir = this._sessionDir(sessionId);
+        fs.mkdirSync(dir, { recursive: true });
+        const logPath = path.join(dir, "events.jsonl");
+        const entry = {
+            timestamp: _utcNow(),
+            type: eventType,
+            ...data,
+        };
+        fs.appendFileSync(logPath, JSON.stringify(entry) + "\n", "utf-8");
+    }
+    saveState(sessionId, state) {
+        const dir = this._sessionDir(sessionId);
+        fs.mkdirSync(dir, { recursive: true });
+        const statePath = path.join(dir, "state.json");
+        fs.writeFileSync(statePath, JSON.stringify(state, null, 2), "utf-8");
+    }
+    getSessionDir(sessionId) {
+        return this._sessionDir(sessionId);
+    }
+    _touchMetadata(sessionId) {
+        const metaPath = this._metadataPath(sessionId);
+        let base = {};
+        if (fs.existsSync(metaPath)) {
+            try {
+                base = JSON.parse(fs.readFileSync(metaPath, "utf-8"));
+            }
+            catch {
+                base = {};
+            }
+        }
+        base["session_id"] = sessionId;
+        base["workspace"] = this.workspace;
+        if (!base["created_at"])
+            base["created_at"] = _utcNow();
+        base["updated_at"] = _utcNow();
+        fs.writeFileSync(metaPath, JSON.stringify(base, null, 2), "utf-8");
+    }
+}
+// ---------------------------------------------------------------------------
+// SessionRuntime
+// ---------------------------------------------------------------------------
+export class SessionRuntime {
+    engine;
+    store;
+    sessionId;
+    context;
+    maxPersistedObservations;
+    constructor(opts) {
+        this.engine = opts.engine;
+        this.store = opts.store;
+        this.sessionId = opts.sessionId;
+        this.context = opts.context;
+        this.maxPersistedObservations = opts.maxPersistedObservations ?? 400;
+    }
+    static bootstrap(opts) {
+        const { engine, config, sessionId = null, resume = false } = opts;
+        const store = new SessionStore(config.workspace, config.sessionRootDir);
+        const [sid, state, createdNew] = store.openSession(sessionId, resume);
+        const persisted = state["external_observations"];
+        const obs = Array.isArray(persisted) ? persisted.map(String) : [];
+        const maxObs = Math.max(1, config.maxPersistedObservations);
+        const context = new ExternalContext();
+        context.observations = obs.slice(-maxObs);
+        engine.sessionDir = store.getSessionDir(sid);
+        engine.sessionId = sid;
+        const runtime = new SessionRuntime({
+            engine,
+            store,
+            sessionId: sid,
+            context,
+            maxPersistedObservations: maxObs,
+        });
+        try {
+            runtime.store.appendEvent(sid, "session_started", { resume, created_new: createdNew });
+        }
+        catch {
+            // swallow
+        }
+        try {
+            runtime._persistState();
+        }
+        catch {
+            // swallow
+        }
+        return runtime;
+    }
+    async solve(objective, opts) {
+        const trimmed = objective.trim();
+        if (!trimmed)
+            return "No objective provided.";
+        const { onEvent = null, onStep = null, onContentDelta = null } = opts ?? {};
+        try {
+            this.store.appendEvent(this.sessionId, "objective", { text: trimmed });
+        }
+        catch {
+            // swallow
+        }
+        const [result] = await this.engine.solveWithContext({
+            objective: trimmed,
+            context: this.context,
+            onEvent,
+            onStep,
+            onContentDelta,
+        });
+        try {
+            this.store.appendEvent(this.sessionId, "response", {
+                text: result.slice(0, 4000),
+            });
+        }
+        catch {
+            // swallow
+        }
+        try {
+            this._persistState();
+        }
+        catch {
+            // swallow
+        }
+        return result;
+    }
+    _persistState() {
+        const maxObs = this.maxPersistedObservations;
+        const obs = this.context.observations.slice(-maxObs);
+        this.store.saveState(this.sessionId, {
+            external_observations: obs,
+            session_tokens: this.engine.sessionTokens,
+        });
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Persistent settings – migrated from agent/settings.py.
+ *
+ * Provides reasoning effort validation, PersistentSettings, and
+ * SettingsStore for JSON-backed persistence.
+ */
+export declare const VALID_REASONING_EFFORTS: ReadonlySet<string>;
+export declare function normalizeReasoningEffort(value: string | null): string | null;
+export declare class PersistentSettings {
+    defaultModel: string | null;
+    defaultReasoningEffort: string | null;
+    defaultModelOpenai: string | null;
+    defaultModelAnthropic: string | null;
+    defaultModelOpenrouter: string | null;
+    defaultModelCerebras: string | null;
+    defaultModelGrok: string | null;
+    constructor(opts?: {
+        defaultModel?: string | null;
+        defaultReasoningEffort?: string | null;
+        defaultModelOpenai?: string | null;
+        defaultModelAnthropic?: string | null;
+        defaultModelOpenrouter?: string | null;
+        defaultModelCerebras?: string | null;
+        defaultModelGrok?: string | null;
+    });
+    defaultModelForProvider(provider: string): string | null;
+    normalized(): PersistentSettings;
+    toJson(): Record<string, string>;
+    static fromJson(payload: Record<string, unknown> | null): PersistentSettings;
+}
+export declare class SettingsStore {
+    workspace: string;
+    sessionRootDir: string;
+    settingsPath: string;
+    constructor(workspace: string, sessionRootDir?: string);
+    load(): PersistentSettings;
+    save(settings: PersistentSettings): void;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAItD,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,MAAM,GAAG,IAAI,CAUf;AAMD,qBAAa,kBAAkB;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEpB,IAAI,CAAC,EAAE;QACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC;IAUD,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAaxD,UAAU,IAAI,kBAAkB;IAmBhC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAmBhC,MAAM,CAAC,QAAQ,CACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,kBAAkB;CAyBtB;AAMD,qBAAa,aAAa;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;gBAET,SAAS,EAAE,MAAM,EAAE,cAAc,GAAE,MAAuB;IAYtE,IAAI,IAAI,kBAAkB;IAa1B,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;CAQzC"}

package/dist/settings.js

@@ -0,0 +1,146 @@
+/**
+ * Persistent settings – migrated from agent/settings.py.
+ *
+ * Provides reasoning effort validation, PersistentSettings, and
+ * SettingsStore for JSON-backed persistence.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+// ---------------------------------------------------------------------------
+// Reasoning effort validation
+// ---------------------------------------------------------------------------
+export const VALID_REASONING_EFFORTS = new Set([
+    "low",
+    "medium",
+    "high",
+]);
+export function normalizeReasoningEffort(value) {
+    if (value === null)
+        return null;
+    const cleaned = value.trim().toLowerCase();
+    if (!cleaned)
+        return null;
+    if (!VALID_REASONING_EFFORTS.has(cleaned)) {
+        throw new Error(`Invalid reasoning effort '${value}'. Expected one of: ${[...VALID_REASONING_EFFORTS].sort().join(", ")}`);
+    }
+    return cleaned;
+}
+// ---------------------------------------------------------------------------
+// PersistentSettings
+// ---------------------------------------------------------------------------
+export class PersistentSettings {
+    defaultModel;
+    defaultReasoningEffort;
+    defaultModelOpenai;
+    defaultModelAnthropic;
+    defaultModelOpenrouter;
+    defaultModelCerebras;
+    defaultModelGrok;
+    constructor(opts) {
+        this.defaultModel = opts?.defaultModel ?? null;
+        this.defaultReasoningEffort = opts?.defaultReasoningEffort ?? null;
+        this.defaultModelOpenai = opts?.defaultModelOpenai ?? null;
+        this.defaultModelAnthropic = opts?.defaultModelAnthropic ?? null;
+        this.defaultModelOpenrouter = opts?.defaultModelOpenrouter ?? null;
+        this.defaultModelCerebras = opts?.defaultModelCerebras ?? null;
+        this.defaultModelGrok = opts?.defaultModelGrok ?? null;
+    }
+    defaultModelForProvider(provider) {
+        const perProvider = {
+            openai: this.defaultModelOpenai,
+            anthropic: this.defaultModelAnthropic,
+            openrouter: this.defaultModelOpenrouter,
+            cerebras: this.defaultModelCerebras,
+            grok: this.defaultModelGrok,
+        };
+        const specific = perProvider[provider] ?? null;
+        if (specific)
+            return specific;
+        return this.defaultModel ?? null;
+    }
+    normalized() {
+        const model = (this.defaultModel ?? "").trim() || null;
+        const effort = normalizeReasoningEffort(this.defaultReasoningEffort);
+        return new PersistentSettings({
+            defaultModel: model,
+            defaultReasoningEffort: effort,
+            defaultModelOpenai: (this.defaultModelOpenai ?? "").trim() || null,
+            defaultModelAnthropic: (this.defaultModelAnthropic ?? "").trim() || null,
+            defaultModelOpenrouter: (this.defaultModelOpenrouter ?? "").trim() || null,
+            defaultModelCerebras: (this.defaultModelCerebras ?? "").trim() || null,
+            defaultModelGrok: (this.defaultModelGrok ?? "").trim() || null,
+        });
+    }
+    toJson() {
+        const payload = {};
+        if (this.defaultModel)
+            payload["default_model"] = this.defaultModel;
+        if (this.defaultReasoningEffort)
+            payload["default_reasoning_effort"] = this.defaultReasoningEffort;
+        if (this.defaultModelOpenai)
+            payload["default_model_openai"] = this.defaultModelOpenai;
+        if (this.defaultModelAnthropic)
+            payload["default_model_anthropic"] = this.defaultModelAnthropic;
+        if (this.defaultModelOpenrouter)
+            payload["default_model_openrouter"] = this.defaultModelOpenrouter;
+        if (this.defaultModelCerebras)
+            payload["default_model_cerebras"] = this.defaultModelCerebras;
+        if (this.defaultModelGrok)
+            payload["default_model_grok"] = this.defaultModelGrok;
+        return payload;
+    }
+    static fromJson(payload) {
+        if (payload === null ||
+            typeof payload !== "object" ||
+            Array.isArray(payload)) {
+            return new PersistentSettings();
+        }
+        return new PersistentSettings({
+            defaultModel: String(payload["default_model"] ?? "").trim() || null,
+            defaultReasoningEffort: String(payload["default_reasoning_effort"] ?? "").trim() || null,
+            defaultModelOpenai: String(payload["default_model_openai"] ?? "").trim() || null,
+            defaultModelAnthropic: String(payload["default_model_anthropic"] ?? "").trim() || null,
+            defaultModelOpenrouter: String(payload["default_model_openrouter"] ?? "").trim() || null,
+            defaultModelCerebras: String(payload["default_model_cerebras"] ?? "").trim() || null,
+            defaultModelGrok: String(payload["default_model_grok"] ?? "").trim() || null,
+        }).normalized();
+    }
+}
+// ---------------------------------------------------------------------------
+// SettingsStore
+// ---------------------------------------------------------------------------
+export class SettingsStore {
+    workspace;
+    sessionRootDir;
+    settingsPath;
+    constructor(workspace, sessionRootDir = ".openplanter") {
+        let ws = workspace;
+        if (ws.startsWith("~")) {
+            ws = path.join(os.homedir(), ws.slice(1));
+        }
+        this.workspace = path.resolve(ws);
+        this.sessionRootDir = sessionRootDir;
+        const root = path.join(this.workspace, this.sessionRootDir);
+        fs.mkdirSync(root, { recursive: true });
+        this.settingsPath = path.join(root, "settings.json");
+    }
+    load() {
+        if (!fs.existsSync(this.settingsPath)) {
+            return new PersistentSettings();
+        }
+        try {
+            const raw = fs.readFileSync(this.settingsPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            return PersistentSettings.fromJson(parsed);
+        }
+        catch {
+            return new PersistentSettings();
+        }
+    }
+    save(settings) {
+        const normalized = settings.normalized();
+        fs.writeFileSync(this.settingsPath, JSON.stringify(normalized.toJson(), null, 2), "utf-8");
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/tool-defs.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Provider-neutral tool definitions for the OpenPlanter agent.
+ *
+ * Single source of truth for tool schemas. Converter helpers produce the
+ * provider-specific shapes expected by OpenAI and Anthropic APIs.
+ */
+export interface JsonSchema {
+    type: string;
+    properties?: Record<string, JsonSchema | JsonSchemaAnyOf>;
+    required?: string[];
+    additionalProperties?: boolean;
+    description?: string;
+    enum?: string[];
+    items?: JsonSchema;
+}
+/** Union produced by strict-mode nullable wrapping. */
+export interface JsonSchemaAnyOf {
+    anyOf: JsonSchema[];
+    description?: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: JsonSchema;
+}
+export interface OpenAITool {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: JsonSchema | JsonSchemaAnyOf;
+        strict?: boolean;
+    };
+}
+export interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: JsonSchema;
+}
+export declare const TOOL_DEFINITIONS: ToolDefinition[];
+/**
+ * Return tool definitions based on mode.
+ *
+ * - `includeSubtask=true` (normal recursive) → everything except execute, artifact tools.
+ * - `includeSubtask=false` (flat / executor) → no subtask, no execute, no artifact tools.
+ * - `includeArtifacts=true` → add list_artifacts + read_artifact.
+ * - `includeAcceptanceCriteria=false` → strip acceptance_criteria from schemas.
+ */
+export declare function get_tool_definitions(options?: {
+    includeSubtask?: boolean;
+    includeArtifacts?: boolean;
+    includeAcceptanceCriteria?: boolean;
+}): ToolDefinition[];
+/** Convert provider-neutral definitions to OpenAI tools array format. */
+export declare function to_openai_tools(defs?: ToolDefinition[], strict?: boolean): OpenAITool[];
+/** Convert provider-neutral definitions to Anthropic tools array format. */
+export declare function to_anthropic_tools(defs?: ToolDefinition[]): AnthropicTool[];
+//# sourceMappingURL=tool-defs.d.ts.map

package/dist/tool-defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-defs.d.ts","sourceRoot":"","sources":["../src/tool-defs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC;QACzC,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,CAAC;CAC1B;AAMD,eAAO,MAAM,gBAAgB,EAAE,cAAc,EA06B5C,CAAC;AA2CF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,cAAc,EAAE,CA4BnB;AAuFD,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,IAAI,CAAC,EAAE,cAAc,EAAE,EACvB,MAAM,UAAO,GACZ,UAAU,EAAE,CAuBd;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,IAAI,CAAC,EAAE,cAAc,EAAE,GACtB,aAAa,EAAE,CAOjB"}