@coool/opencode-adaptive 0.0.0-stage → 1.0.0

package/dist/ui/tui/controller.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The `/adaptive` keyboard-flow controller (ADP-033): a pure-ish state machine
+ * over two seams — the typed RPC API and the host dialogs/toasts. It holds no
+ * local settings state: every mutation goes through `settings.set` and the
+ * returned snapshot becomes the new local view (the server is the single
+ * source of truth, ADP-036).
+ *
+ * Flow contract: `undefined` selections always mean "cancel this step" — the
+ * menu loop continues or exits; API failures toast and keep the loop alive.
+ */
+import type { OperatingMode } from "../../core/scheduler/types.js";
+import type { TierName } from "../../core/tier-policy/types.js";
+import type { SettingsPatch, SettingsV1 } from "../../state/settings/index.js";
+import type { PatchResult } from "../../state/settings/types.js";
+import type { SessionModeSetResult } from "../../state/session-modes/index.js";
+import type { TierRequestSetResult } from "../../rpc/handlers.js";
+import type { Receipt } from "../../state/receipts/types.js";
+import type { StatusSnapshot } from "../../rpc/status.js";
+import { type MainMenuChoice } from "./menu.js";
+import { type ModelSummary } from "./tiers.js";
+import { type SelectOption } from "./options.js";
+import { RECEIPTS_PAGE_SIZE } from "./receipts.js";
+export interface AdaptiveView {
+    select<Value>(options: {
+        title: string;
+        placeholder?: string;
+        options: readonly SelectOption<Value>[];
+        current?: Value;
+        search?: (query: string, options: readonly SelectOption<Value>[]) => readonly SelectOption<Value>[];
+    }): Promise<Value | undefined>;
+    /** A select with footer actions (page flips): the action closes the
+     * dialog and is reported separately from an option pick. */
+    selectPaged<Value>(spec: {
+        title: string;
+        options: readonly SelectOption<Value>[];
+        actions: readonly {
+            title: string;
+            value: string;
+            bind: string;
+        }[];
+    }): Promise<{
+        picked: Value | undefined;
+        action: string | undefined;
+    }>;
+    confirm(options: {
+        title: string;
+        message: string;
+        label?: {
+            confirm?: string;
+            cancel?: string;
+        };
+    }): Promise<boolean | undefined>;
+    alert(options: {
+        title: string;
+        message: string;
+    }): Promise<void>;
+    /** A column-aligned text table (header row first); Escape closes it. */
+    table(spec: {
+        title: string;
+        lines: string[];
+    }): Promise<void>;
+    toast(message: string, variant: "info" | "success" | "warning" | "error"): void;
+}
+export interface AdaptiveApi {
+    settings: () => Promise<SettingsV1>;
+    setSettings: (patch: SettingsPatch) => Promise<PatchResult>;
+    status: () => Promise<StatusSnapshot>;
+    receipts: () => Promise<Receipt[]>;
+    /** The session's mode override (`null` = follows the global mode). */
+    sessionMode: (sessionID: string) => Promise<OperatingMode | null>;
+    setSessionMode: (sessionID: string, mode: OperatingMode | null) => Promise<SessionModeSetResult>;
+    /** The session's pinned tier request (`null` = follows the routing ladder). */
+    tierRequest: (sessionID: string) => Promise<TierName | null>;
+    setTierRequest: (sessionID: string, tier: string | null) => Promise<TierRequestSetResult>;
+}
+export type ModelLister = () => readonly ModelSummary[];
+export interface AdaptiveEnv {
+    api: AdaptiveApi;
+    view: AdaptiveView;
+    models: ModelLister;
+    /**
+     * The session the command was opened from (ADP-054). Present only when the
+     * palette command ran inside a session screen — the mode menu then steers
+     * that session's override instead of the global mode.
+     */
+    sessionID?: string | undefined;
+}
+export declare const INVITE_TITLE = "OpenCode Adaptive";
+export declare const INVITE_MESSAGE: string;
+/** Tracks whether this dialog session already showed the save toast. */
+export interface SaveFeedback {
+    once: boolean;
+}
+export declare function runAdaptive(env: AdaptiveEnv): Promise<void>;
+/** Exported for tests: the receipts page size used by the receipts browser. */
+export { RECEIPTS_PAGE_SIZE };
+export type { MainMenuChoice, OperatingMode, StatusSnapshot, SettingsV1, SettingsPatch, PatchResult, Receipt, };
+//# sourceMappingURL=controller.d.ts.map

package/dist/ui/tui/controller.d.ts.map

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

package/dist/ui/tui/controller.js

@@ -0,0 +1,399 @@
+import { TIERS } from "../../core/tier-policy/types.js";
+import { STATUS_EMPTY_MESSAGE, statusTable } from "./status.js";
+import { mainMenuOptions, modeOptions, modeTargetOptions, sessionModeOptions, sessionTierOptions, } from "./menu.js";
+import { modelPickerOptions, moveResource, moveResourceToTop, removeResource, resourceLabel, tierEditorOptions, tierMenuOptions, variantOptions, } from "./tiers.js";
+import { errorText } from "./options.js";
+import { receiptDetail, receiptLine, receiptPage, RECEIPTS_PAGE_SIZE } from "./receipts.js";
+export const INVITE_TITLE = "OpenCode Adaptive";
+export const INVITE_MESSAGE = "Adaptive starts in Observe mode: routing decisions are recorded as receipts, " +
+    "but no model is switched. Open /adaptive to configure tiers or switch to Active.";
+/** Run one API call; on failure toast and return undefined. */
+async function tryApi(env, run) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        env.view.toast(errorText(error), "error");
+        return undefined;
+    }
+}
+/**
+ * Apply one patch; alert on validation errors, toast on success. The host
+ * never auto-dismisses toasts, so the success toast is shown only on the
+ * first successful save of a dialog session — later saves stay silent
+ * (the updated menu already reflects them).
+ */
+async function applySettings(env, patch, feedback) {
+    const result = await tryApi(env, () => env.api.setSettings(patch));
+    if (result === undefined)
+        return undefined;
+    if (!result.ok) {
+        await env.view.alert({ title: "Invalid settings", message: result.errors.join("; ") });
+        return undefined;
+    }
+    if (!feedback.once) {
+        env.view.toast("Settings saved", "success");
+        feedback.once = true;
+    }
+    return result.settings;
+}
+/**
+ * Persist one session-mode override; alert on errors, toast on success. Same
+ * once-toast semantics as `applySettings` — the success toast is shown only
+ * on the first successful save of a dialog session.
+ */
+async function applySessionMode(env, sessionID, mode, feedback) {
+    const result = await tryApi(env, () => env.api.setSessionMode(sessionID, mode));
+    if (result === undefined)
+        return undefined;
+    if (!result.ok) {
+        await env.view.alert({ title: "Invalid settings", message: result.errors.join("; ") });
+        return undefined;
+    }
+    if (!feedback.once) {
+        env.view.toast("Settings saved", "success");
+        feedback.once = true;
+    }
+    return result;
+}
+/**
+ * Persist one session tier request; alert on errors, toast on success. Same
+ * once-toast semantics as `applySettings` — the success toast is shown only
+ * on the first successful save of a dialog session.
+ */
+async function applyTierRequest(env, sessionID, tier, feedback) {
+    const result = await tryApi(env, () => env.api.setTierRequest(sessionID, tier));
+    if (result === undefined)
+        return undefined;
+    if (!result.ok) {
+        await env.view.alert({ title: "Invalid tier request", message: result.errors.join("; ") });
+        return undefined;
+    }
+    if (!feedback.once) {
+        env.view.toast("Settings saved", "success");
+        feedback.once = true;
+    }
+    return result;
+}
+export async function runAdaptive(env) {
+    const loaded = await tryApi(env, () => env.api.settings());
+    if (loaded === undefined)
+        return;
+    let settings = loaded;
+    const feedback = { once: false };
+    const sessionID = env.sessionID;
+    // The session's current override: fetched once when the flow starts inside
+    // a session; a failure degrades to "follow global" (the menu still works).
+    let override = sessionID === undefined
+        ? null
+        : ((await tryApi(env, () => env.api.sessionMode(sessionID))) ?? null);
+    if (!settings.inviteDismissed) {
+        await env.view.confirm({ title: INVITE_TITLE, message: INVITE_MESSAGE });
+        const pick = await env.view.select({
+            title: INVITE_TITLE,
+            options: [
+                { title: "Open the menu now", value: true },
+                { title: "Later", value: false },
+            ],
+        });
+        const dismissed = await applySettings(env, { inviteDismissed: true }, feedback);
+        if (dismissed !== undefined)
+            settings = dismissed;
+        if (pick !== true)
+            return;
+    }
+    for (;;) {
+        // The menu descriptions degrade silently: a failing status read must not
+        // spam a toast on every loop iteration (the flows that need status toast
+        // through tryApi themselves).
+        const status = await env.api.status().catch(() => undefined);
+        // The session's pinned tier request: fetched per loop so the entry
+        // description tracks the latest request; a failure degrades to the
+        // generic description (the menu still works).
+        const tierPinned = sessionID === undefined
+            ? undefined
+            : await env.api.tierRequest(sessionID).catch(() => undefined);
+        const choice = await env.view.select({
+            title: `Adaptive (${override ?? settings.mode})`,
+            options: mainMenuOptions(settings, status, tierPinned),
+        });
+        if (choice === undefined)
+            return;
+        if (choice === "status") {
+            await runStatusView(env);
+            continue;
+        }
+        if (choice === "models") {
+            settings = (await runTierEditor(env, settings, feedback)) ?? settings;
+            continue;
+        }
+        if (choice === "mode") {
+            const next = await runModeMenu(env, settings, feedback, sessionID, override);
+            if (next !== undefined) {
+                settings = next.settings;
+                override = next.override;
+            }
+            continue;
+        }
+        if (choice === "tier") {
+            if (sessionID === undefined) {
+                // The tier request only exists inside a session; on home the pick is
+                // explained (not silently dropped) and the menu re-opens.
+                await env.view.alert({
+                    title: "This session",
+                    message: "This session's tier request can only be changed inside a session. Open a session and run /adaptive from there.",
+                });
+                continue;
+            }
+            await runTierRequestMenu(env, sessionID, feedback);
+            continue;
+        }
+        if (choice === "pin") {
+            settings = (await runPinMenu(env, settings, feedback)) ?? settings;
+            continue;
+        }
+        await runReceiptsView(env);
+    }
+}
+async function runModeMenu(env, settings, feedback, sessionID, override) {
+    // Every screen gets the same first question — which mode to steer — so a
+    // user who opens the menu on home learns the two-level structure before
+    // they ever run the command inside a session.
+    for (;;) {
+        const target = await env.view.select({
+            title: "Operating mode",
+            options: modeTargetOptions(settings.mode, override ?? settings.mode),
+        });
+        if (target === undefined)
+            return undefined;
+        if (target === "global") {
+            const pick = await env.view.select({
+                title: "Global mode",
+                options: modeOptions(settings.mode),
+            });
+            if (pick === undefined || pick === settings.mode)
+                return undefined;
+            const applied = await applySettings(env, { mode: pick }, feedback);
+            // The session override is deliberately untouched: changing the global
+            // default must not rewrite what a session was pinned to.
+            return applied === undefined ? undefined : { settings: applied, override };
+        }
+        if (sessionID === undefined) {
+            // The session override only exists inside a session; on home the pick
+            // is explained (not silently dropped) and the target question repeats.
+            await env.view.alert({
+                title: "This session",
+                message: "This session's mode can only be changed inside a session. Open a session and run /adaptive from there.",
+            });
+            continue;
+        }
+        const pick = await env.view.select({
+            title: "This session's mode",
+            options: sessionModeOptions({
+                global: settings.mode,
+                override,
+                effective: override ?? settings.mode,
+            }),
+        });
+        if (pick === undefined)
+            return undefined;
+        if (pick.kind === "global") {
+            if (override === null)
+                return undefined;
+            const saved = await applySessionMode(env, sessionID, null, feedback);
+            return saved === undefined ? undefined : { settings, override: null };
+        }
+        if (pick.mode === (override ?? settings.mode))
+            return undefined;
+        const saved = await applySessionMode(env, sessionID, pick.mode, feedback);
+        return saved === undefined ? undefined : { settings, override: pick.mode };
+    }
+}
+/** The per-session tier-request menu (ADP-055): pin a tier or clear it. */
+async function runTierRequestMenu(env, sessionID, feedback) {
+    const pinned = await tryApi(env, () => env.api.tierRequest(sessionID));
+    if (pinned === undefined)
+        return;
+    const pick = await env.view.select({
+        title: "This session's tier",
+        options: sessionTierOptions({ pinned }),
+    });
+    if (pick === undefined)
+        return;
+    const next = pick.kind === "ladder" ? null : pick.tier;
+    if (next === pinned)
+        return;
+    await applyTierRequest(env, sessionID, next, feedback);
+}
+/**
+ * The status view: every configured model with its state as a column-aligned
+ * table (header row, tier order, priority order within tiers). No
+ * per-resource selection step — the table IS the view; Escape returns to the
+ * menu.
+ */
+async function runStatusView(env) {
+    const snapshot = await tryApi(env, () => env.api.status());
+    if (snapshot === undefined)
+        return;
+    const configured = TIERS.some((tier) => snapshot.tiers[tier].length > 0);
+    if (!configured) {
+        await env.view.alert({ title: "Status", message: STATUS_EMPTY_MESSAGE });
+        return;
+    }
+    await env.view.table({ title: "Status", lines: statusTable(snapshot) });
+}
+async function runTierEditor(env, initial, feedback) {
+    let settings = initial;
+    for (;;) {
+        const status = await tryApi(env, () => env.api.status());
+        if (status === undefined)
+            return undefined;
+        const tier = await env.view.select({ title: "Tier", options: tierMenuOptions(status) });
+        if (tier === undefined)
+            return undefined;
+        const choice = await env.view.select({
+            title: `Tier: ${tier}`,
+            options: tierEditorOptions(settings, tier, status),
+        });
+        if (choice === undefined)
+            continue;
+        if (choice.kind === "add") {
+            const next = await runAddModel(env, settings, tier, feedback);
+            if (next !== undefined)
+                settings = next;
+            continue;
+        }
+        const next = await runResourceMenu(env, settings, tier, choice.index, feedback);
+        if (next !== undefined)
+            settings = next;
+    }
+}
+async function runAddModel(env, settings, tier, feedback) {
+    const models = env.models();
+    const pick = await env.view.select({
+        title: "Add model",
+        placeholder: "Search provider / model / name",
+        options: modelPickerOptions(models, ""),
+        search: (query) => modelPickerOptions(models, query),
+    });
+    if (pick === undefined)
+        return undefined;
+    const info = models.find((m) => m.providerID === pick.providerID && m.modelID === pick.modelID);
+    const variants = info?.variants ?? [];
+    let variant;
+    if (variants.length > 0) {
+        const choice = await env.view.select({
+            title: `Variant: ${pick.providerID}/${pick.modelID}`,
+            options: variantOptions(variants),
+        });
+        if (choice === undefined)
+            return undefined;
+        variant = choice.variant;
+    }
+    const ref = variant === undefined
+        ? { providerID: pick.providerID, id: pick.modelID }
+        : { providerID: pick.providerID, id: pick.modelID, variant };
+    const list = [...settings.tiers[tier], ref];
+    return applySettings(env, { tiers: { ...settings.tiers, [tier]: list } }, feedback);
+}
+function resourceMenuOptions() {
+    return [
+        { title: "Move to top", value: "top", description: "Make this the primary resource" },
+        { title: "Move up", value: "up", description: "Higher priority within the tier" },
+        { title: "Move down", value: "down", description: "Lower priority within the tier" },
+        { title: "Remove", value: "remove" },
+    ];
+}
+async function runResourceMenu(env, settings, tier, index, feedback) {
+    const ref = settings.tiers[tier][index];
+    if (ref === undefined)
+        return undefined;
+    const pick = await env.view.select({
+        title: `Resource: ${resourceLabel(ref)}`,
+        options: resourceMenuOptions(),
+    });
+    if (pick === undefined)
+        return undefined;
+    if (pick === "remove") {
+        const confirmed = await env.view.confirm({
+            title: "Remove resource",
+            message: `Remove ${resourceLabel(ref)} from ${tier}?`,
+        });
+        if (confirmed !== true)
+            return undefined;
+        return applySettings(env, { tiers: { ...settings.tiers, [tier]: removeResource(settings.tiers[tier], index) } }, feedback);
+    }
+    const list = pick === "top"
+        ? moveResourceToTop(settings.tiers[tier], index)
+        : moveResource(settings.tiers[tier], index, pick === "up" ? -1 : 1);
+    return applySettings(env, { tiers: { ...settings.tiers, [tier]: list } }, feedback);
+}
+function pinOptions(settings) {
+    const options = [
+        { title: "No pin", value: { kind: "clear" }, description: "clear the pin" },
+    ];
+    for (const tier of TIERS) {
+        for (const ref of settings.tiers[tier]) {
+            options.push({
+                title: `${resourceLabel(ref)} (${tier})`,
+                description: "route every turn to this resource, even in active mode",
+                value: { kind: "pin", ref },
+            });
+        }
+    }
+    return options;
+}
+async function runPinMenu(env, settings, feedback) {
+    const configured = TIERS.some((tier) => settings.tiers[tier].length > 0);
+    if (!configured) {
+        await env.view.alert({ title: "Pin", message: "(no configured resources to pin)" });
+        return undefined;
+    }
+    const pick = await env.view.select({ title: "Pin", options: pinOptions(settings) });
+    if (pick === undefined)
+        return undefined;
+    return applySettings(env, { pin: pick.kind === "clear" ? null : pick.ref }, feedback);
+}
+async function runReceiptsView(env) {
+    const all = await tryApi(env, () => env.api.receipts());
+    if (all === undefined)
+        return;
+    if (all.length === 0) {
+        await env.view.alert({
+            title: "Receipts",
+            message: "No decisions recorded yet.",
+        });
+        return;
+    }
+    // Paginated browse: every page is a bounded view, and the page flips are
+    // footer actions (not list items) — they close the dialog and the loop
+    // reopens it at the new offset. Viewing a detail returns to the same
+    // page; Escape (no pick, no action) leaves the browser.
+    for (let offset = 0;;) {
+        const page = receiptPage(all.slice(offset));
+        const hasNext = offset + RECEIPTS_PAGE_SIZE < all.length;
+        const result = await env.view.selectPaged({
+            title: `Receipts (${String(all.length)}, newest first)`,
+            options: page.map((receipt) => ({ title: receiptLine(receipt), value: receipt })),
+            actions: [
+                ...(offset > 0 ? [{ title: "Previous page", value: "prev", bind: "ctrl+b" }] : []),
+                ...(hasNext ? [{ title: "Next page", value: "next", bind: "ctrl+f" }] : []),
+            ],
+        });
+        if (result.action === "next") {
+            offset += RECEIPTS_PAGE_SIZE;
+            continue;
+        }
+        if (result.action === "prev") {
+            offset = Math.max(0, offset - RECEIPTS_PAGE_SIZE);
+            continue;
+        }
+        const pick = result.picked;
+        if (pick === undefined)
+            return;
+        await env.view.alert({ title: `Receipt #${String(pick.id)}`, message: receiptDetail(pick) });
+    }
+}
+/** Exported for tests: the receipts page size used by the receipts browser. */
+export { RECEIPTS_PAGE_SIZE };
+//# sourceMappingURL=controller.js.map

package/dist/ui/tui/controller.js.map

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

package/dist/ui/tui/menu.d.ts

@@ -0,0 +1,56 @@
+import type { OperatingMode } from "../../core/scheduler/types.js";
+import type { TierName } from "../../core/tier-policy/types.js";
+import type { StatusSnapshot } from "../../rpc/status.js";
+import type { SettingsV1 } from "../../state/settings/index.js";
+import type { SelectOption } from "./options.js";
+export declare const MAIN_MENU_ITEMS: readonly ["status", "models", "mode", "tier", "pin", "receipts"];
+export type MainMenuChoice = (typeof MAIN_MENU_ITEMS)[number];
+/** "3 resources · 1 windowed" — the status line under the menu entry. */
+export declare function statusSummary(status: StatusSnapshot | undefined): string;
+/** "quick: 1 · standard: 0 · advanced: 2" — what is configured where. */
+export declare function modelsSummary(settings: SettingsV1): string;
+export declare function mainMenuOptions(settings: SettingsV1, status: StatusSnapshot | undefined, tierRequest?: TierName | null): SelectOption<MainMenuChoice>[];
+export declare function modeOptions(current: OperatingMode): SelectOption<OperatingMode>[];
+/** One per-session mode-menu pick: follow the global mode, or set an override. */
+export type SessionModeChoice = {
+    kind: "global";
+} | {
+    kind: "mode";
+    mode: OperatingMode;
+};
+/** Which mode the user steers inside a session: the global default or the session override. */
+export type ModeTarget = "global" | "session";
+/**
+ * The first select of the in-session mode flow (ADP-054): ask which mode to
+ * steer before showing any mode list — the global default or this session's
+ * override. Each row names the current value so the user can tell at a
+ * glance which side needs changing.
+ */
+export declare function modeTargetOptions(global: OperatingMode, effective: OperatingMode): SelectOption<ModeTarget>[];
+/**
+ * The per-session mode menu (ADP-054): first "Follow global" (clearing the
+ * override), then every mode. An existing override is marked "(override)" —
+ * distinct from the effective mode's "(current)" — so the user can tell a
+ * set override apart from a session merely inheriting the global mode.
+ */
+export declare function sessionModeOptions(input: {
+    global: OperatingMode;
+    override: OperatingMode | null;
+    effective: OperatingMode;
+}): SelectOption<SessionModeChoice>[];
+/** One per-session tier-menu pick: follow the routing ladder, or pin a tier. */
+export type SessionTierChoice = {
+    kind: "ladder";
+} | {
+    kind: "tier";
+    tier: TierName;
+};
+/**
+ * The per-session tier menu (ADP-055): first "Follow routing ladder" (clearing
+ * the request), then every tier. A pinned request is marked "(pinned)" so the
+ * user can tell the sticky request apart from the ordinary ladder.
+ */
+export declare function sessionTierOptions(input: {
+    pinned: TierName | null;
+}): SelectOption<SessionTierChoice>[];
+//# sourceMappingURL=menu.d.ts.map

package/dist/ui/tui/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/ui/tui/menu.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,eAAO,MAAM,eAAe,kEAAmE,CAAA;AAC/F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7D,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAUxE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAG1D;AAiBD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,WAAW,CAAC,EAAE,QAAQ,GAAG,IAAI,GAC5B,YAAY,CAAC,cAAc,CAAC,EAAE,CAyChC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAAC,aAAa,CAAC,EAAE,CAMjF;AAcD,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAA;AAE1F,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE7C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,aAAa,GACvB,YAAY,CAAC,UAAU,CAAC,EAAE,CAa5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,SAAS,EAAE,aAAa,CAAA;CACzB,GAAG,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAiBpC;AAcD,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAErF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAA;CACxB,GAAG,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAgBpC"}