wotann 0.5.0

package/dist/core/schema-migration.js

@@ -0,0 +1,322 @@
+/**
+ * Schema Auto-Migration System.
+ *
+ * Version-aware config migration that automatically upgrades user configs
+ * when WOTANN is updated. Each migration is a pure function that transforms
+ * config from version N to version N+1.
+ *
+ * DESIGN PRINCIPLES:
+ * - Migrations are immutable transforms (old config → new config)
+ * - Each migration has a pre-check that validates preconditions
+ * - Backup is created before any migration runs
+ * - Migrations are idempotent (running twice is safe)
+ * - Unknown fields are preserved (forward compatibility)
+ */
+import { readFileSync, writeFileSync, existsSync, copyFileSync } from "node:fs";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+// ── Version Comparison ───────────────────────────────────
+function parseVersion(version) {
+    const parts = version.split(".").map(Number);
+    return [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0];
+}
+export function compareVersions(a, b) {
+    const [aMajor, aMinor, aPatch] = parseVersion(a);
+    const [bMajor, bMinor, bPatch] = parseVersion(b);
+    if (aMajor !== bMajor)
+        return aMajor - bMajor;
+    if (aMinor !== bMinor)
+        return aMinor - bMinor;
+    return aPatch - bPatch;
+}
+// ── Migration Registry ───────────────────────────────────
+const MIGRATIONS = [
+    {
+        fromVersion: "0.1.0",
+        toVersion: "0.2.0",
+        description: "Add provider priority field and normalize provider config",
+        migrate(config) {
+            const providers = (config["providers"] ?? {});
+            const normalized = {};
+            let priority = 1;
+            for (const [name, providerConfig] of Object.entries(providers)) {
+                normalized[name] = {
+                    ...providerConfig,
+                    priority: providerConfig["priority"] ?? priority,
+                    enabled: providerConfig["enabled"] ?? true,
+                };
+                priority++;
+            }
+            return { ...config, providers: normalized, version: "0.2.0" };
+        },
+        validate(config) {
+            return typeof config["version"] === "string";
+        },
+    },
+    {
+        fromVersion: "0.2.0",
+        toVersion: "0.3.0",
+        description: "Add memory config with SQLite defaults and daemon config",
+        migrate(config) {
+            const memory = (config["memory"] ?? {});
+            const daemon = (config["daemon"] ?? {});
+            return {
+                ...config,
+                memory: {
+                    enabled: true,
+                    dbPath: ".wotann/memory.db",
+                    maxEntries: 10000,
+                    ...memory,
+                },
+                daemon: {
+                    enabled: false,
+                    tickInterval: 60000,
+                    ...daemon,
+                },
+                version: "0.3.0",
+            };
+        },
+        validate(config) {
+            return config["version"] === "0.2.0";
+        },
+    },
+    {
+        fromVersion: "0.3.0",
+        toVersion: "0.4.0",
+        description: "Add hooks profile, UI theme, and cost tracking defaults",
+        migrate(config) {
+            const hooks = (config["hooks"] ?? {});
+            const ui = (config["ui"] ?? {});
+            return {
+                ...config,
+                hooks: {
+                    profile: "standard",
+                    ...hooks,
+                },
+                ui: {
+                    theme: "default",
+                    panels: ["chat"],
+                    ...ui,
+                },
+                costTracking: {
+                    enabled: true,
+                    dailyBudgetUsd: 10.0,
+                    warningThreshold: 0.8,
+                },
+                version: "0.4.0",
+            };
+        },
+        validate(config) {
+            return config["version"] === "0.3.0";
+        },
+    },
+    {
+        fromVersion: "0.4.0",
+        toVersion: "0.5.0",
+        description: "Restructure provider auth: separate apiKey from oauth tokens",
+        migrate(config) {
+            const providers = (config["providers"] ?? {});
+            const updated = {};
+            for (const [name, providerConfig] of Object.entries(providers)) {
+                const { apiKey, ...rest } = providerConfig;
+                updated[name] = {
+                    ...rest,
+                    auth: apiKey
+                        ? { method: "api-key", token: apiKey }
+                        : (providerConfig["auth"] ?? { method: "local" }),
+                };
+            }
+            return { ...config, providers: updated, version: "0.5.0" };
+        },
+        validate(config) {
+            return config["version"] === "0.4.0";
+        },
+    },
+];
+// ── Current Version ──────────────────────────────────────
+export const CURRENT_SCHEMA_VERSION = "0.5.0";
+// ── Migration Engine ─────────────────────────────────────
+/**
+ * Build a migration plan from current version to target.
+ */
+export function planMigration(currentVersion, targetVersion = CURRENT_SCHEMA_VERSION) {
+    if (compareVersions(currentVersion, targetVersion) >= 0) {
+        return { currentVersion, targetVersion, steps: [], isUpToDate: true };
+    }
+    const applicableSteps = MIGRATIONS.filter((m) => compareVersions(m.fromVersion, currentVersion) >= 0 &&
+        compareVersions(m.toVersion, targetVersion) <= 0).sort((a, b) => compareVersions(a.fromVersion, b.fromVersion));
+    return {
+        currentVersion,
+        targetVersion,
+        steps: applicableSteps,
+        isUpToDate: applicableSteps.length === 0,
+    };
+}
+/**
+ * Execute a migration plan against a config object.
+ * Returns a new config — does NOT mutate the input.
+ */
+export function executeMigration(config, plan) {
+    if (plan.isUpToDate) {
+        return {
+            success: true,
+            fromVersion: plan.currentVersion,
+            toVersion: plan.targetVersion,
+            stepsApplied: [],
+            backupPath: null,
+            errors: [],
+            config,
+        };
+    }
+    let current = { ...config };
+    const appliedSteps = [];
+    const errors = [];
+    for (const step of plan.steps) {
+        if (!step.validate(current)) {
+            errors.push(`Precondition failed for migration ${step.fromVersion} → ${step.toVersion}: ${step.description}`);
+            break;
+        }
+        try {
+            current = step.migrate(current);
+            appliedSteps.push(`${step.fromVersion} → ${step.toVersion}: ${step.description}`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push(`Migration ${step.fromVersion} → ${step.toVersion} failed: ${message}`);
+            break;
+        }
+    }
+    return {
+        success: errors.length === 0,
+        fromVersion: plan.currentVersion,
+        toVersion: errors.length === 0
+            ? plan.targetVersion
+            : (current["version"] ?? plan.currentVersion),
+        stepsApplied: appliedSteps,
+        backupPath: null,
+        errors,
+        config: current,
+    };
+}
+/**
+ * Migrate a YAML config file on disk.
+ * Creates a timestamped backup before modifying.
+ */
+export function migrateConfigFile(configPath, targetVersion = CURRENT_SCHEMA_VERSION) {
+    if (!existsSync(configPath)) {
+        return {
+            success: false,
+            fromVersion: "unknown",
+            toVersion: targetVersion,
+            stepsApplied: [],
+            backupPath: null,
+            errors: [`Config file not found: ${configPath}`],
+            config: {},
+        };
+    }
+    // Read and parse
+    const raw = readFileSync(configPath, "utf-8");
+    let config;
+    try {
+        config = parseYaml(raw);
+    }
+    catch {
+        return {
+            success: false,
+            fromVersion: "unknown",
+            toVersion: targetVersion,
+            stepsApplied: [],
+            backupPath: null,
+            errors: ["Failed to parse YAML config"],
+            config: {},
+        };
+    }
+    const currentVersion = config["version"] ?? "0.1.0";
+    // Plan migration
+    const plan = planMigration(currentVersion, targetVersion);
+    if (plan.isUpToDate) {
+        return {
+            success: true,
+            fromVersion: currentVersion,
+            toVersion: targetVersion,
+            stepsApplied: [],
+            backupPath: null,
+            errors: [],
+            config,
+        };
+    }
+    // Create backup
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const backupPath = `${configPath}.backup-${timestamp}`;
+    copyFileSync(configPath, backupPath);
+    // Execute migration
+    const result = executeMigration(config, plan);
+    // Write migrated config
+    if (result.success) {
+        const yaml = stringifyYaml(result.config);
+        writeFileSync(configPath, yaml, "utf-8");
+    }
+    return { ...result, backupPath };
+}
+/**
+ * Check if a config needs migration without actually migrating.
+ */
+export function needsMigration(config, targetVersion = CURRENT_SCHEMA_VERSION) {
+    const currentVersion = config["version"] ?? "0.1.0";
+    return compareVersions(currentVersion, targetVersion) < 0;
+}
+/**
+ * Get all registered migration steps.
+ */
+export function getMigrationSteps() {
+    return MIGRATIONS;
+}
+/**
+ * Entry point for "migrate old-version configs on startup". Safe to
+ * call unconditionally at runtime boot — returns {migrated:false}
+ * when no config exists or the config is already current, so callers
+ * don't need to pre-check. Always creates a timestamped backup BEFORE
+ * mutating the on-disk file so rollback is a single `mv`.
+ *
+ * Callers typically invoke this after resolving the workspace but
+ * BEFORE loading any runtime state that depends on the schema shape.
+ */
+export function migrateOnStartup(configPath, targetVersion = CURRENT_SCHEMA_VERSION) {
+    // No config file → nothing to migrate. Treat as a clean slate.
+    if (!existsSync(configPath)) {
+        return {
+            migrated: false,
+            backupPath: null,
+            fromVersion: null,
+            toVersion: targetVersion,
+            stepsApplied: [],
+            errors: [],
+        };
+    }
+    const result = migrateConfigFile(configPath, targetVersion);
+    return {
+        migrated: result.stepsApplied.length > 0 && result.success,
+        backupPath: result.backupPath,
+        fromVersion: result.fromVersion,
+        toVersion: result.toVersion,
+        stepsApplied: result.stepsApplied,
+        errors: result.errors,
+    };
+}
+/**
+ * Lightweight "does this config need migration" check suitable for UI
+ * prompts ("Your config is out of date — migrate now?"). Reads the
+ * file but does not mutate it.
+ */
+export function configNeedsMigration(configPath, targetVersion = CURRENT_SCHEMA_VERSION) {
+    if (!existsSync(configPath))
+        return false;
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        const config = parseYaml(raw);
+        return needsMigration(config, targetVersion);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=schema-migration.js.map

package/dist/core/schema-migration.js.map

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

package/dist/core/session-fork.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Session Fork — branch a new session from an existing one.
+ *
+ * Port of `codex fork` (research/codex/codex-rs/cli/src/main.rs:148, 270-289).
+ * Codex calls this "Fork a previous interactive session". The use case:
+ * the user wants to "what-if" a conversation — try a different prompt path
+ * without losing the original. Pairs naturally with WOTANN's loop detector
+ * (commit 0ca2fd3): when a loop is detected we can suggest
+ * `wotann fork-session --last` to retry from before the loop.
+ *
+ * Implementation note: this helper only READS via session.ts's public APIs
+ * (`restoreSession`, `findLatestSession`, `saveSession`). We deliberately
+ * do NOT touch the SessionStore class — the caller (src/index.ts) owns the
+ * write boundary, and the file split keeps SessionStore's class-internal
+ * invariants out of the fork concern.
+ *
+ * Quality bar: honest stub > over-engineering. If the source session can
+ * be loaded and re-saved with a fresh id, fork works. If not, we return
+ * a structured error instead of pretending success.
+ */
+export interface ForkSessionResult {
+    readonly ok: boolean;
+    readonly newSessionId?: string;
+    readonly newSessionPath?: string;
+    readonly sourceSessionId?: string;
+    readonly messageCount?: number;
+    readonly error?: string;
+}
+export interface ForkSessionOptions {
+    /** Source session id. Mutually exclusive with `last`. */
+    readonly sessionId?: string;
+    /** Fork the most recent session for this cwd. */
+    readonly last?: boolean;
+    /**
+     * If true, search across ALL sessions in `sessionDir` regardless of cwd.
+     * Default: false (cwd-filtered, matches `wotann resume`'s default).
+     */
+    readonly all?: boolean;
+    /** Explicit session dir; defaults to `<cwd>/.wotann/sessions`. */
+    readonly sessionDir?: string;
+}
+/**
+ * Fork a session: copy the source rollout to a new session id, persist it,
+ * return the new id. Caller is responsible for printing user-facing output.
+ *
+ * Exit-code mapping (caller in src/index.ts):
+ *   - ok: true                              → exit 0
+ *   - ok: false, error matches /not found/  → exit 1
+ *   - ok: false, error matches /argument/   → exit 2
+ */
+export declare function forkSession(opts: ForkSessionOptions): ForkSessionResult;
+//# sourceMappingURL=session-fork.d.ts.map

package/dist/core/session-fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-fork.d.ts","sourceRoot":"","sources":["../../src/core/session-fork.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CA2EvE"}

package/dist/core/session-fork.js

@@ -0,0 +1,147 @@
+/**
+ * Session Fork — branch a new session from an existing one.
+ *
+ * Port of `codex fork` (research/codex/codex-rs/cli/src/main.rs:148, 270-289).
+ * Codex calls this "Fork a previous interactive session". The use case:
+ * the user wants to "what-if" a conversation — try a different prompt path
+ * without losing the original. Pairs naturally with WOTANN's loop detector
+ * (commit 0ca2fd3): when a loop is detected we can suggest
+ * `wotann fork-session --last` to retry from before the loop.
+ *
+ * Implementation note: this helper only READS via session.ts's public APIs
+ * (`restoreSession`, `findLatestSession`, `saveSession`). We deliberately
+ * do NOT touch the SessionStore class — the caller (src/index.ts) owns the
+ * write boundary, and the file split keeps SessionStore's class-internal
+ * invariants out of the fork concern.
+ *
+ * Quality bar: honest stub > over-engineering. If the source session can
+ * be loaded and re-saved with a fresh id, fork works. If not, we return
+ * a structured error instead of pretending success.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { findLatestSession, restoreSession, saveSession } from "./session.js";
+// ── Public API ──────────────────────────────────────────
+/**
+ * Fork a session: copy the source rollout to a new session id, persist it,
+ * return the new id. Caller is responsible for printing user-facing output.
+ *
+ * Exit-code mapping (caller in src/index.ts):
+ *   - ok: true                              → exit 0
+ *   - ok: false, error matches /not found/  → exit 1
+ *   - ok: false, error matches /argument/   → exit 2
+ */
+export function forkSession(opts) {
+    const sessionDir = opts.sessionDir ?? join(process.cwd(), ".wotann", "sessions");
+    // Argument validation: exactly one of {sessionId, last} must be set.
+    // `--all` only widens the search space when paired with `--last`.
+    if (!opts.sessionId && !opts.last) {
+        return {
+            ok: false,
+            error: "argument: pass <sessionId> or --last (use --all to widen --last across all cwds)",
+        };
+    }
+    if (opts.sessionId && opts.last) {
+        return {
+            ok: false,
+            error: "argument: --last conflicts with explicit <sessionId>",
+        };
+    }
+    // Resolve the source session file path.
+    let sourcePath = null;
+    if (opts.sessionId) {
+        const candidate = join(sessionDir, `${opts.sessionId}.json`);
+        if (existsSync(candidate)) {
+            sourcePath = candidate;
+        }
+    }
+    else if (opts.last) {
+        sourcePath = opts.all ? findLatestSessionAllCwds(sessionDir) : findLatestSession(sessionDir);
+    }
+    if (!sourcePath || !existsSync(sourcePath)) {
+        return {
+            ok: false,
+            error: opts.sessionId
+                ? `session not found: ${opts.sessionId} (looked in ${sessionDir})`
+                : `session not found: no recorded sessions in ${sessionDir}`,
+        };
+    }
+    const source = restoreSession(sourcePath);
+    if (!source) {
+        return {
+            ok: false,
+            error: `session not found: ${sourcePath} could not be deserialized (corrupt or wrong version)`,
+        };
+    }
+    // Build the forked state. Codex's fork copies ALL prior messages into a
+    // new conversation — the user can then steer in a new direction. We
+    // mirror that exactly: copy messages verbatim, mint a fresh id, reset
+    // the startedAt clock so the new session's stats reflect the FORK time
+    // (not the source's original start). Costs/tokens are inherited so the
+    // fork's running tally still reflects the conversation history's
+    // already-paid context.
+    const newId = randomUUID();
+    const forked = {
+        id: newId,
+        startedAt: new Date(),
+        provider: source.provider,
+        model: source.model,
+        totalTokens: source.totalTokens,
+        totalCost: source.totalCost,
+        toolCalls: source.toolCalls,
+        messages: [...source.messages],
+        incognito: source.incognito ?? false,
+    };
+    const newPath = saveSession(forked, sessionDir);
+    return {
+        ok: true,
+        newSessionId: newId,
+        newSessionPath: newPath,
+        sourceSessionId: source.id,
+        messageCount: source.messages.length,
+    };
+}
+// ── Internals ───────────────────────────────────────────
+/**
+ * `findLatestSession` (in session.ts) filters by `cwd === process.cwd()`,
+ * matching `wotann resume`'s default. The `--all` flag widens that to ALL
+ * recorded sessions regardless of cwd. We replicate session.ts's logic
+ * here rather than reaching into its private filter, because session.ts
+ * is on the read-only list (the prompt forbids writes there).
+ */
+function findLatestSessionAllCwds(sessionDir) {
+    if (!existsSync(sessionDir))
+        return null;
+    let latest = null;
+    for (const file of readdirSync(sessionDir)) {
+        if (!file.endsWith(".json"))
+            continue;
+        const p = join(sessionDir, file);
+        try {
+            const st = statSync(p);
+            // Prefer savedAt from inside the file (matches session.ts's
+            // ordering); fall back to filesystem mtime if read fails.
+            let savedAt = st.mtimeMs;
+            try {
+                const data = JSON.parse(readFileSync(p, "utf-8"));
+                if (data.savedAt) {
+                    const parsed = new Date(data.savedAt).getTime();
+                    if (Number.isFinite(parsed))
+                        savedAt = parsed;
+                }
+            }
+            catch {
+                // Use filesystem mtime — already set above.
+            }
+            if (latest === null || savedAt > latest.mtime) {
+                latest = { path: p, mtime: savedAt };
+            }
+        }
+        catch {
+            // Stat failed — skip this file.
+        }
+    }
+    return latest?.path ?? null;
+}
+//# sourceMappingURL=session-fork.js.map

package/dist/core/session-fork.js.map

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

package/dist/core/session-recap.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Session recap + auto-naming (C23).
+ *
+ * Claude Code recently added two session conveniences we didn't have:
+ *   1. Auto-generated session names derived from the plan / first prompt
+ *      (instead of "session-8f3a1" UUIDs).
+ *   2. Concise recap on resume — a 3-5 bullet snapshot of where things
+ *      stood, showing "last action", "next step", and any blockers —
+ *      instead of the full verbose dump `buildResumePrompt` produces.
+ *
+ * Both are pure functions over `SessionSnapshot` so they are trivially
+ * testable and composable. No side effects.
+ */
+import type { SessionSnapshot } from "./session-resume.js";
+/**
+ * Best-effort noun-phrase title for a session. Priority:
+ *   1. First in-progress or paused task description
+ *   2. First user message in the conversation
+ *   3. Working dir name + timestamp fallback
+ *
+ * Normalises whitespace, strips imperative verbs so the result reads as
+ * a topic rather than a command ("fix the auth bug" → "auth bug fix").
+ * Truncated to 60 chars with a visible ellipsis, kebab-safe for use in
+ * filenames via slugifyTitle().
+ */
+export declare function autoNameFromSnapshot(snapshot: SessionSnapshot): string;
+export declare function slugifyTitle(title: string): string;
+export interface SessionRecap {
+    readonly title: string;
+    readonly ageMinutes: number;
+    readonly lastAction: string | undefined;
+    readonly nextStep: string | undefined;
+    readonly blockers: readonly string[];
+    readonly filesTouchedCount: number;
+    readonly costUsd: number;
+    readonly contextTokens: number;
+}
+/**
+ * Build a structured recap from the snapshot. Unlike `buildResumePrompt`,
+ * this only keeps the signal — last assistant turn gist, next step, open
+ * blockers derived from failed tasks — so the resume UI can render a
+ * short card instead of a wall of text.
+ */
+export declare function buildRecap(snapshot: SessionSnapshot): SessionRecap;
+/**
+ * Render the recap as a compact markdown block suitable for the resume
+ * prompt. Targets <= 500 characters so it doesn't crowd the first turn
+ * context window the way the full snapshot does.
+ */
+export declare function renderRecap(recap: SessionRecap): string;
+//# sourceMappingURL=session-recap.d.ts.map

package/dist/core/session-recap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recap.d.ts","sourceRoot":"","sources":["../../src/core/session-recap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAmC,MAAM,qBAAqB,CAAC;AAI5F;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAUtE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAgDD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,YAAY,CAkBlE;AA0BD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAyBvD"}