@dsh-cc/tui 0.5.0

package/lib/harness/driver-agent.js

@@ -0,0 +1,314 @@
+/**
+ * Agent-model + history cluster of the TUI driver factory.
+ *
+ * createDriver used to hold these locals inline: resolveEfforts / stalePair /
+ * seedDefaultModel, the resume marker + prompt/bash histories, the tool
+ * presenters, history folding, and the model-command catalog. They only read
+ * `ctx`/`current`/`selection`/`liveMode` off `rt` (DriverAgentCtx), so they
+ * migrate here as a free-function collaborator to keep the factory under the
+ * 500-line budget — the same pattern as the other harness/driver-*.ts leaves.
+ *
+ * Mutable state the other sections rebind (`markedContent`, `history`,
+ * `bashHistory`) is owned HERE and exposed through get/set/append handles so
+ * no other module captures a stale copy.
+ * @module @dsh-cc/tui/harness/driver-agent
+ */
+import { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+import { bootBannerText } from "./boot-banner.js";
+import { loadHistory, HISTORY_CAP } from "../history.js";
+import { loadBashHistory, saveBashHistory } from "../bash-history.js";
+import { writeResumeTarget } from "../resume-target.js";
+import { clearTurn, resetTurnStep, setBusy, setPermissionMode, setTurnActive, upsertRow, } from "../store.js";
+import { applySessionEvent, } from "../transcript.js";
+/**
+ * The slice of createDriver's model/history cluster that the session/event
+ * listener needs: it folds events onto fresh state and presents tool cards for
+ * the live agent.
+ */
+export function attachSessionEvents(rt) {
+    // Whether a compact this driver anchored owns the working line: a manual
+    // `/compact` on an IDLE agent starts its own pseudo-turn (busy + anchor),
+    // and its `compaction/end` clears that anchor and flushes the outbox. An
+    // auto-compact riding a live turn never touches the anchor.
+    let compactOwnedTurn = false;
+    // Sessions that already showed the classifier-breaker fallback notice (R4):
+    // ONE per session per process, on live-appended events only — the initial
+    // fold/replay never routes through this listener, so a resume never re-shows
+    // a notice for a long-fixed lane.
+    const breakerNoticed = new Set();
+    const CLASSIFIER_BREAKER_NOTICE = 'classifier lane failed repeatedly; auto mode continues without LLM vetting until settings change';
+    rt.ctx.on('session/event', (session, event) => {
+        // Late events from a disposed session are dropped by id mismatch.
+        if (session.id !== rt.current.agent.session.id)
+            return;
+        const eventType = event.type;
+        rt.emit(applySessionEvent(rt.state(), event, rt.presenters));
+        if (eventType === 'permission/mode' || eventType === 'plan/mode') {
+            rt.emit(setPermissionMode(rt.state(), rt.liveMode(rt.current.agent)));
+        }
+        // R4: a live classifier breaker open is surfaced once, visibly — replayed
+        // logs are handled by the transcript fold, never re-shown here.
+        if (eventType === 'permission/classifier') {
+            const data = event.data;
+            if (data?.failure === 'breaker' && !breakerNoticed.has(session.id)) {
+                breakerNoticed.add(session.id);
+                rt.showNotice(CLASSIFIER_BREAKER_NOTICE);
+            }
+        }
+        // Manual-compaction working line: an idle agent's `/compact` runs outside
+        // any turn, so anchor the working line for its duration. A live turn's
+        // anchor (auto-compact mid-request) is left untouched.
+        if (eventType === 'compaction/start') {
+            if (rt.state().turn === undefined) {
+                compactOwnedTurn = true;
+                rt.emit(setBusy(rt.state(), true));
+                rt.emit(setTurnActive(rt.state(), { startedAt: Date.now(), outputBase: rt.state().hud?.tokens?.output }));
+            }
+        }
+        else if (eventType === 'compaction/end' && compactOwnedTurn) {
+            compactOwnedTurn = false;
+            rt.emit(clearTurn(rt.state()));
+            rt.emit(setBusy(rt.state(), false));
+            // Same contract as turn/end: entries submitted during the compaction
+            // flush into the next durable turn.
+            rt.flushQueue();
+        }
+        // Working-line anchor backstop: a live `turn/start` (or `agent/status`
+        // running) can be the first evidence of a turn this UI never saw
+        // submitted. Anchor only when none exists — re-anchoring a live turn
+        // would reset elapsed time and the token delta to zero.
+        const liveState = rt.state();
+        if (eventType === 'turn/start' && liveState.turn === undefined) {
+            rt.emit(setTurnActive(rt.state(), { startedAt: Date.now(), outputBase: liveState.hud?.tokens?.output }));
+        }
+        else if (eventType === 'agent/status' && liveState.turn === undefined) {
+            const status = event.data;
+            if (status?.status === 'running') {
+                rt.emit(setTurnActive(rt.state(), { startedAt: Date.now(), outputBase: liveState.hud?.tokens?.output }));
+            }
+        }
+        // Working-line step clock: each tool call (and each tool result) resets
+        // the elapsed timer, so the line shows the current step's duration.
+        const stepState = rt.state();
+        if ((eventType === 'tool/call' || eventType === 'tool/result') && stepState.turn !== undefined) {
+            rt.emit(resetTurnStep(rt.state(), Date.now()));
+        }
+        // Outbox flush anchor: the durable `turn/end` fires exactly once per turn.
+        if (eventType === 'turn/end') {
+            rt.emit(clearTurn(rt.state()));
+            rt.flushQueue();
+        }
+    });
+}
+/**
+ * Build the agent-model/history cluster. Returns handles createDriver threads
+ * into the picker/session/run-local/queue sections and the Driver API, and
+ * exposes the owned `markedContent`/`history`/`bashHistory` state through
+ * get/set seams so no other module captures a stale copy.
+ */
+export function createAgentSection(rt) {
+    const { ctx, current, selection, agentOptions } = rt;
+    // Deployment default-model service (settings.yaml's agent-default-model).
+    const agentDefaultModel = ctx.get('agentDefaultModel');
+    /**
+     * Advertised reasoning-effort levels of `provider`/`model`, or undefined
+     * when they cannot be resolved: the llm service is absent, does not expose
+     * `resolveModelInfo` (legacy stubs), the lookup rejects, or the model
+     * carries no reasoning metadata.
+     */
+    const resolveEfforts = async (provider, model) => {
+        const llm = ctx.get('llm');
+        if (llm?.resolveModelInfo === undefined)
+            return undefined;
+        try {
+            const info = await llm.resolveModelInfo(provider, model);
+            return info.reasoning === undefined ? undefined : info.reasoning.efforts;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    /**
+     * Stale-pair guard for detached (submit-then-continue) writes: the captured
+     * `{provider, model}` must still be the live selection when the continuation
+     * resumes.
+     */
+    const stalePair = (captured) => {
+        const live = selection.current;
+        if (live !== undefined && live.provider === captured.provider && live.model === captured.model) {
+            return false;
+        }
+        rt.emit(upsertRow(rt.state(), { kind: 'status', text: 'Model changed; effort not applied.' }));
+        return true;
+    };
+    /**
+     * Seed `selection.current` from the deployment default when no explicit
+     * provider/model is configured. `currentSelection()` is awaited so a
+     * (duck-typed) async service can defer settlement — the boot seed's
+     * await-late wait seam keys off this promise.
+     */
+    const seedDefaultModel = async (reset = false) => {
+        if (reset)
+            selection.current = undefined;
+        if (selection.current !== undefined)
+            return;
+        if (current.agent.options.provider !== undefined && current.agent.options.model !== undefined) {
+            selection.current = { provider: current.agent.options.provider, model: current.agent.options.model };
+            return;
+        }
+        if (agentOptions === undefined) {
+            const dep = await agentDefaultModel?.currentSelection();
+            if (dep !== undefined) {
+                let effort;
+                if (dep.reasoningEffort !== undefined) {
+                    const efforts = await resolveEfforts(dep.provider, dep.model);
+                    if (efforts?.some(level => level.id === dep.reasoningEffort) === true) {
+                        effort = dep.reasoningEffort;
+                    }
+                }
+                selection.current = effort === undefined
+                    ? { provider: dep.provider, model: dep.model }
+                    : { provider: dep.provider, model: dep.model, reasoningEffort: ReasoningEffortId(effort) };
+            }
+        }
+    };
+    /**
+     * Fire-early / await-late boot seed (W4): the seed promise is kicked once
+     * and shared (idempotent), so createDriver builds the root without waiting,
+     * while every model-turn path (queue submit, /effort) awaits
+     * {@link waitForModel} before dispatch. A failed seed is caught and warned —
+     * the wait must resolve so submit never deadlocks; the turn then runs on
+     * the agent's own default route. On settle (success or failure) the boot
+     * banner row is upserted to the resolved label and the no-model notice is
+     * emitted ONLY here — a slow-but-fine boot never flashes it.
+     */
+    let seedPromise;
+    const runSeed = async () => {
+        try {
+            await seedDefaultModel();
+        }
+        catch (error) {
+            console.warn('[dsh-cc-tui] default-model seed failed:', error);
+        }
+        finally {
+            const settled = rt.state();
+            const modelLabel = selection.current?.model ?? 'default model';
+            const rows = settled.rows.slice();
+            const bannerIndex = rows.findIndex(existing => existing.kind === 'status' && existing.text?.startsWith('dsh cc-mode — '));
+            if (bannerIndex >= 0) {
+                rows[bannerIndex] = { kind: 'status', text: bootBannerText(modelLabel, rt.cwd) };
+                rt.emit({ ...settled, rows });
+            }
+            if (selection.current === undefined) {
+                rt.emit(upsertRow(rt.state(), { kind: 'status', text: 'No model configured. Pick one with /model.' }));
+            }
+        }
+    };
+    const waitForModel = () => {
+        if (seedPromise === undefined)
+            seedPromise = runSeed();
+        return seedPromise;
+    };
+    /**
+     * Bounded boot-frame wait (W4): let a seed that settles within the current
+     * microtask cascade (a sync deployment-default service — the common boot)
+     * land its banner upsert + gated notice before the first frame; a genuinely
+     * slow seed resolves via the one-macrotask timer and never blocks it.
+     */
+    const awaitBootFrame = () => Promise.race([waitForModel(), new Promise(resolve => { setTimeout(resolve, 0); })]);
+    /**
+     * Marker semantics: write on resume (self-heal) and after the first real
+     * user prompt — never on an empty fresh boot.
+     */
+    let markedContent = false;
+    const persistResumeTarget = () => {
+        const id = String(current.agent.session.id);
+        // The NEW marker keys off the LIVE session's project (a resumed session
+        // created elsewhere writes its own bucket); legacy dual-write stays in
+        // the boot-cwd bucket. Dedupe is internal to writeResumeTarget (F4) —
+        // no read-compare here.
+        writeResumeTarget(id, {
+            cwd: current.agent.session.header.cwd ?? rt.cwd,
+            legacyCwd: rt.cwd,
+        });
+    };
+    // Composer + bash histories: owned here, rebound through get/set seams.
+    // `historyDir` is mutable so /resume can point it at the switched session's
+    // project directory (bindHistoryDir); every reader uses the live value via
+    // `get historyDir()` rather than a captured snapshot.
+    let historyDir = rt.historyDir;
+    let history = loadHistory(historyDir);
+    let bashHistory = loadBashHistory(historyDir).reverse();
+    const appendBashHistory = (command) => {
+        if (bashHistory[0] === command)
+            return;
+        bashHistory = [command, ...bashHistory].slice(0, HISTORY_CAP);
+        saveBashHistory([...bashHistory].reverse(), historyDir);
+    };
+    const bindHistoryDir = (dir) => {
+        historyDir = dir;
+        history = loadHistory(dir);
+        bashHistory = loadBashHistory(dir).reverse();
+    };
+    const tools = ctx.get('tools');
+    const shell = ctx.get('shell');
+    const presenters = tools === undefined
+        ? undefined
+        : {
+            presentCall(name, args) {
+                return tools.get(name, current.agent)?.presentCall?.(args);
+            },
+            presentResult(name, args, result) {
+                return tools.get(name, current.agent)?.presentResult?.(args, result);
+            },
+        };
+    /**
+     * Replay the durable event log so a resumed session shows its prior
+     * conversation. Folding is a reduce, not a per-event broadcast.
+     */
+    const foldHistory = () => {
+        let folded = rt.state();
+        for (const event of current.agent.session.events) {
+            folded = applySessionEvent(folded, event, presenters);
+        }
+        return folded;
+    };
+    /**
+     * Model-command catalog (`/model` picker). Reads the llm service providers
+     * it advertises.
+     */
+    const loadCatalog = async () => {
+        const llm = ctx.get('llm');
+        if (llm === undefined)
+            return [];
+        const entries = [];
+        for (const provider of llm.listProviders()) {
+            const models = await llm.listModels(provider.id);
+            for (const model of models) {
+                entries.push({ provider: model.provider, id: model.id, name: model.name });
+            }
+        }
+        return entries;
+    };
+    return {
+        resolveEfforts,
+        stalePair,
+        seedDefaultModel,
+        waitForModel,
+        awaitBootFrame,
+        persistResumeTarget,
+        getMarkedContent: () => markedContent,
+        setMarkedContent: (value) => { markedContent = value; },
+        get historyDir() { return historyDir; },
+        bindHistoryDir,
+        getHistory: () => history,
+        setHistory: (next) => { history = next; },
+        getBashHistory: () => bashHistory,
+        appendBashHistory,
+        presenters,
+        shell,
+        foldHistory,
+        loadCatalog,
+    };
+}
+//# sourceMappingURL=driver-agent.js.map

package/lib/harness/driver-agent.js.map

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

package/lib/harness/driver-agents.d.ts

@@ -0,0 +1,20 @@
+/**
+ * /agents local-slash pipeline of the in-process protocol driver: the TUI
+ * surface for continuable background agents. Consumes the SAME thin snapshot
+ * as the preset /agents command — the read-only `ccAgents` service published
+ * on the root realm by command-agents inside cc-services (plan §3.2 / F8
+ * bridge). When the service is absent the fold degrades to a thin snapshot
+ * over the process-wide event fold. Fold-derived decorations (provider, last
+ * epoch stopReason, prompt excerpt — newline-normalized, ANSI-stripped,
+ * unicode-truncated) are additive on the detail view: never different ids or
+ * ordering.
+ *
+ * @module @dsh-cc/tui/harness/driver-agents
+ */
+import type { DriverRunLocalCtx } from './driver-ctx.ts';
+/** The /agents slice of runLocal: one rendered status text per invocation. */
+export interface AgentsSection {
+    agentsSlash(rawInput: string): Promise<string>;
+}
+export declare function createAgentsSection(rt: DriverRunLocalCtx): AgentsSection;
+//# sourceMappingURL=driver-agents.d.ts.map

package/lib/harness/driver-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-agents.d.ts","sourceRoot":"","sources":["../../src/harness/driver-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC/C;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,iBAAiB,GAAG,aAAa,CAwGxE"}

package/lib/harness/driver-agents.js

@@ -0,0 +1,123 @@
+/**
+ * /agents local-slash pipeline of the in-process protocol driver: the TUI
+ * surface for continuable background agents. Consumes the SAME thin snapshot
+ * as the preset /agents command — the read-only `ccAgents` service published
+ * on the root realm by command-agents inside cc-services (plan §3.2 / F8
+ * bridge). When the service is absent the fold degrades to a thin snapshot
+ * over the process-wide event fold. Fold-derived decorations (provider, last
+ * epoch stopReason, prompt excerpt — newline-normalized, ANSI-stripped,
+ * unicode-truncated) are additive on the detail view: never different ids or
+ * ordering.
+ *
+ * @module @dsh-cc/tui/harness/driver-agents
+ */
+import { buildAgentsSnapshot, parseAgentsInput, renderAgentDetail, renderAgentsList, stopNotRunningCopy, stopRunningCopy, unknownAgentCopy, } from '@dsh-cc/command-agents/snapshot';
+export function createAgentsSection(rt) {
+    // --- /agents: continuable background agents --------------------------------
+    // Replaces the pre-existing flat subagent-activity renderer: the TUI
+    // consumes the SAME thin snapshot as the preset /agents command — published
+    // on the root realm as `ccAgents` by command-agents inside cc-services
+    // (plan §3.2 / F8 bridge). When the service is absent (composition without
+    // the command-agents row) the fold degrades to a thin snapshot over the
+    // process-wide event fold only. Fold-derived decorations (provider, last
+    // stopReason, prompt excerpt) are additive on the detail view — never
+    // different ids or ordering.
+    const agentsRows = async () => {
+        const parentSessionId = String(rt.current.agent.session.id);
+        const snapshot = rt.ctx.get('ccAgents');
+        if (snapshot !== undefined && typeof snapshot.list === 'function') {
+            return snapshot.list(parentSessionId);
+        }
+        // Fold-only fallback: SubagentRunView rows mapped to thin snapshot rows.
+        // Parked AND done runs stay visible (Ready group) — the fold is the only
+        // history this composition has; a done one-shot still renders with its
+        // last-epoch decoration.
+        return buildAgentsSnapshot({
+            listChildren: async () => rt.state().subagents.map(run => ({
+                id: run.sessionId,
+                activity: run.status === 'running' ? 'running' : 'inactive',
+                hasChildren: false,
+                mode: 'continuable',
+            })),
+            getAgent: id => rt.state().subagents.find(run => run.sessionId === id && run.status === 'running'),
+            readPin: () => undefined,
+            pinPath: () => '',
+        }, parentSessionId);
+    };
+    /**
+     * ANSI/control-stripped, newline-normalized, unicode-aware-truncated prompt
+     * excerpt from the child's first user message event, when the child agent's
+     * session is reachable via `ctx.agents.get` (F7: the fold itself carries no
+     * prompt).
+     */
+    const promptExcerptOf = (childId) => {
+        const child = rt.ctx.agents
+            ?.get?.(childId);
+        const events = child?.session?.events;
+        if (events === undefined)
+            return undefined;
+        for (const event of events) {
+            const record = event;
+            if (record.type !== 'message' || record.data?.role !== 'user')
+                continue;
+            const data = record.data;
+            const text = typeof data.text === 'string'
+                ? data.text
+                : Array.isArray(data.content)
+                    ? data.content
+                        .filter((block) => block !== null && typeof block === 'object' && block.type === 'text')
+                        .map(block => block.text)
+                        .join('')
+                    : '';
+            if (text.length === 0)
+                continue;
+            const normalized = text
+                .replace(/\r\n?/g, ' ')
+                .replace(/\x1B\[[0-9;?]*[A-Za-z]/g, '')
+                // eslint-disable-next-line no-control-regex
+                .replace(/[\u0000-\u0008\u000B-\u001F\u007F]/g, '');
+            const chars = Array.from(normalized);
+            return (chars.length > 80 ? chars.slice(0, 80).join('') + '…' : normalized);
+        }
+        return undefined;
+    };
+    /** Fold-derived additive detail lines (provider, last epoch, prompt excerpt). */
+    const decoratedDetailOf = (row) => {
+        const run = rt.state().subagents.find(candidate => candidate.sessionId === row.id);
+        if (run === undefined)
+            return [];
+        const lines = [`  provider: ${run.provider}`];
+        if (run.stopReason !== undefined)
+            lines.push(`  last epoch: ${run.stopReason}`);
+        const excerpt = promptExcerptOf(row.id);
+        if (excerpt !== undefined)
+            lines.push(`  prompt: "${excerpt}"`);
+        return lines;
+    };
+    const agentsSlash = async (rawInput) => {
+        const parsed = parseAgentsInput(rawInput);
+        if (parsed.kind === 'error')
+            return parsed.text;
+        const rows = await agentsRows();
+        if (parsed.kind === 'list')
+            return renderAgentsList(rows);
+        const row = rows.find(candidate => candidate.id === parsed.id);
+        if (row === undefined)
+            return unknownAgentCopy(parsed.id);
+        if (parsed.kind === 'stop') {
+            if (row.residency !== 'running')
+                return stopNotRunningCopy(row.id, row.residency);
+            const subagents = rt.ctx.get('subagents');
+            if (typeof subagents?.interrupt !== 'function') {
+                return `No interrupt path available for agent ${row.id} in this composition.`;
+            }
+            subagents.interrupt(row.id, { kind: 'ancestor', agent: rt.current.agent });
+            return stopRunningCopy(row.id);
+        }
+        const detail = renderAgentDetail(row, undefined, undefined, String(rt.current.agent.session.id));
+        const decorated = decoratedDetailOf(row);
+        return decorated.length === 0 ? detail : `${detail}\n${decorated.join('\n')}`;
+    };
+    return { agentsSlash };
+}
+//# sourceMappingURL=driver-agents.js.map

package/lib/harness/driver-agents.js.map

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

package/lib/harness/driver-approvals.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Approval + user-question pipeline extracted from harness/driver.ts.
+ *
+ * Free-function collaborator: `createApprovalsSection` owns the modal FIFO
+ * (approvals and questions share one queue via createModalQueue) and takes a
+ * {@link DriverApprovalsCtx} instead of closing over createDriver's locals.
+ * Emits re-read the current view-model via `rt.state()` after every emit
+ * (createDriver rebinds `state` on emit). The section routes approvals from the
+ * host's `approval/request` hook, persists "always allow" rules through the
+ * settings provider, and answers questions through the host's userQuestions
+ * provider.
+ * @module @dsh-cc/tui/harness/driver-approvals
+ */
+import type { ApprovalAnswerKind } from '../state/driver-types.ts';
+import { type ModalEntry } from './driver-modal.ts';
+import type { DriverApprovalsCtx } from './driver-ctx.ts';
+/** The approvals-driven slice of the Driver surface, plus queue/dispose teardown. */
+export type ApprovalsSection = {
+    answerApproval(kind: ApprovalAnswerKind): void;
+    questionMove(delta: -1 | 1): void;
+    questionToggle(): void;
+    questionPick(index: number): void;
+    questionType(text: string): void;
+    questionBackspace(): void;
+    questionSubmit(): void;
+    questionCancel(): void;
+    /** Drain every parked modal entry (switchSession aborts approvals/questions). */
+    spliceAll(): ModalEntry[];
+    dispose(): void;
+};
+/**
+ * Build the approval/question pipeline. `answerApproval` threads the allow-rule
+ * write through {@link ModalAnswerDeps}; the modal FIFO lives here so approvals
+ * and user questions share a single queue. `current`/`state` are read live via
+ * the ctx — never captured snapshots.
+ */
+export declare function createApprovalsSection(rt: DriverApprovalsCtx): ApprovalsSection;
+//# sourceMappingURL=driver-approvals.d.ts.map

package/lib/harness/driver-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-approvals.d.ts","sourceRoot":"","sources":["../../src/harness/driver-approvals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,KAAK,EAAE,kBAAkB,EAAwB,MAAM,0BAA0B,CAAA;AASxF,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGzD,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC9C,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACjC,cAAc,IAAI,IAAI,CAAA;IACtB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,iBAAiB,IAAI,IAAI,CAAA;IACzB,cAAc,IAAI,IAAI,CAAA;IACtB,cAAc,IAAI,IAAI,CAAA;IACtB,iFAAiF;IACjF,SAAS,IAAI,UAAU,EAAE,CAAA;IACzB,OAAO,IAAI,IAAI,CAAA;CAChB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,kBAAkB,GAAG,gBAAgB,CAyP/E"}