@duetso/agent 0.1.20

package/dist/src/session/session-manager.js

@@ -0,0 +1,94 @@
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { nanoid } from "nanoid";
+import { Session } from "./session.js";
+export const DEFAULT_DUET_DIR = ".duet";
+export const DEFAULT_DUET_HOME = join(homedir(), DEFAULT_DUET_DIR);
+export const DEFAULT_SESSION_STORAGE_DIR = join(DEFAULT_DUET_HOME, "sessions");
+export const DEFAULT_MEMORY_DB_PATH = join(DEFAULT_DUET_HOME, "memory.db");
+export class SessionManager {
+    options;
+    sessions = new Map();
+    eventHandlers = new Set();
+    sessionStoragePath;
+    config;
+    constructor(config, options = {}) {
+        this.options = options;
+        this.config = withDefaultMemoryDbPath(config);
+        this.sessionStoragePath = options.sessionStoragePath ?? DEFAULT_SESSION_STORAGE_DIR;
+    }
+    subscribe(handler) {
+        this.eventHandlers.add(handler);
+        return () => {
+            this.eventHandlers.delete(handler);
+        };
+    }
+    create(input) {
+        const session = this.createSession(input.sessionId, false);
+        this.sessions.set(session.id, session);
+        const setup = session.start({
+            ...(input.mode ? { mode: input.mode } : {}),
+            ...(input.options ? { options: input.options } : {}),
+        });
+        if (input.prompt) {
+            const prompt = input.prompt;
+            void setup.then(() => session.prompt({
+                message: prompt,
+            }));
+        }
+        return session;
+    }
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    resume(sessionId) {
+        const existing = this.sessions.get(sessionId);
+        if (existing)
+            return existing;
+        const session = this.createSession(sessionId, true);
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    async dispose() {
+        for (const session of this.sessions.values()) {
+            await session.dispose();
+        }
+        this.sessions.clear();
+    }
+    createSession(sessionId, resumeFromStorage) {
+        const id = sessionId ?? createSessionId();
+        const sessionPath = join(this.sessionStoragePath, sanitizeSessionId(id));
+        mkdirSync(sessionPath, { recursive: true });
+        const session = new Session(this.config, {
+            id,
+            runner: this.options.createRunner?.(id),
+            resumeFromStorage,
+            sessionPath,
+        });
+        session.subscribe((event) => {
+            this.emit({ sessionId: session.id, event });
+        });
+        return session;
+    }
+    emit(event) {
+        for (const handler of this.eventHandlers) {
+            handler(event);
+        }
+    }
+}
+function withDefaultMemoryDbPath(config) {
+    if (config.memoryDbPath !== undefined)
+        return config;
+    return {
+        ...config,
+        memoryDbPath: DEFAULT_MEMORY_DB_PATH,
+    };
+}
+function createSessionId() {
+    return `session_${nanoid(12)}`;
+}
+function sanitizeSessionId(sessionId) {
+    return sessionId.replace(/[^A-Za-z0-9_.-]/g, "_");
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/src/session/session-manager.js.map

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

package/dist/src/session/session.d.ts

@@ -0,0 +1,113 @@
+import { type TurnEventHandler } from "../turn-runner/turn-runner.js";
+import type { TurnRunnerConfig } from "../types/config.js";
+import type { Skill } from "@earendil-works/pi-coding-agent";
+import type { SkillCollision } from "../turn-runner/skills.js";
+import type { TurnAgentFile, TurnEditFollowUpQueueCommand, TurnEvent, TurnInterruptCommand, TurnMode, TurnPromptBehavior, TurnQuestion, TurnStartCommand, TurnState, TurnTerminalEvent, TurnCommand, TurnOptions } from "../types/protocol.js";
+export interface SessionStartInput {
+    /** Routing mode for subsequent prompts. Omit to use the session's configured default. */
+    mode?: TurnMode;
+    options?: TurnOptions;
+}
+export interface SessionPromptInput {
+    message: string;
+    behavior?: TurnPromptBehavior;
+}
+export interface SessionAnswerInput {
+    questions: TurnQuestion[];
+    answers: Record<string, string>;
+    behavior?: TurnPromptBehavior;
+}
+export interface SessionEditFollowUpQueueInput {
+    prompts: string[];
+}
+export type SessionEventHandler = (event: TurnEvent) => void;
+export interface SessionTurnRunner {
+    start(command: TurnStartCommand): Promise<TurnState>;
+    turn(command: TurnCommand): Promise<TurnTerminalEvent>;
+    interrupt(command: TurnInterruptCommand): void;
+    editFollowUpQueue(command: TurnEditFollowUpQueueCommand): void;
+    subscribe(handler: TurnEventHandler): () => void;
+    getState(): TurnState | undefined;
+    getSkills(): Promise<readonly Skill[]>;
+    getResolvedAgentFiles(): Promise<readonly TurnAgentFile[]>;
+    getSkillCollisions(): Promise<readonly SkillCollision[]>;
+    dispose(): Promise<void>;
+}
+export interface SessionOptions {
+    id: string;
+    /** Concrete directory owned by this session. The manager creates it before construction. */
+    sessionPath: string;
+    runner?: SessionTurnRunner;
+    resumeFromStorage?: boolean;
+}
+export declare class Session {
+    readonly config: TurnRunnerConfig;
+    readonly id: string;
+    private readonly runner;
+    /** Directory owned by this session. State persistence writes `state.json` inside it. */
+    private readonly sessionPath;
+    /** Subscribers interested in this single session's raw turn-runner events. */
+    private readonly eventHandlers;
+    /** Removes the session's subscription to its owned runner during disposal. */
+    private readonly unsubscribeRunner;
+    /** In-flight runner turn, used to distinguish active work from a reusable terminal result. */
+    private activeTurn?;
+    /** In-flight runner setup, awaited before any turn dispatches so turn_started lands first. */
+    private startPromise?;
+    /** Most recent terminal event, returned immediately when callers wait after a turn has settled. */
+    private lastTerminal?;
+    /** Scheduled wake for sleeping state-machine states; cancelled when user input or interrupt arrives. */
+    private wakeTimer?;
+    /** Restores a prompt/answer turn back to sleep when the state machine is still waiting. */
+    private restoreSleepAfterTurn?;
+    /** Whether this session should hydrate `state.json` on first use. New sessions start empty. */
+    private readonly resumeFromStorage;
+    /** Pending callers of `waitForTerminal`, resolved together when the next terminal event arrives. */
+    private readonly terminalWaiters;
+    constructor(config: TurnRunnerConfig, options: SessionOptions);
+    subscribe(handler: SessionEventHandler): () => void;
+    /**
+     * Initialize the session before any turn runs. Calls the runner's setup
+     * step once so the caller can render skills and agent files immediately on
+     * launch, before the user types a prompt.
+     *
+     * Repeat calls are no-ops; resumed sessions reuse the persisted state.
+     */
+    start(input?: SessionStartInput): Promise<void>;
+    prompt(input: SessionPromptInput): Promise<void>;
+    answer(input: SessionAnswerInput): Promise<void>;
+    interrupt(): Promise<void>;
+    private ensureStarted;
+    editFollowUpQueue(input: SessionEditFollowUpQueueInput): void;
+    waitForTerminal(): Promise<TurnTerminalEvent>;
+    isTurnActive(): boolean;
+    /** Current runner-owned turn state snapshot, including agent message history. */
+    getState(): TurnState | undefined;
+    /**
+     * Skills discovered for this session. Available after `start()` resolves;
+     * loading happens lazily on first call otherwise.
+     */
+    getSkills(): Promise<readonly Skill[]>;
+    /** System-prompt files (AGENTS.md by default) that resolved on disk. */
+    getResolvedAgentFiles(): Promise<readonly TurnAgentFile[]>;
+    /** Skill name collisions where one definition shadowed another during discovery. */
+    getSkillCollisions(): Promise<readonly SkillCollision[]>;
+    /** Start this session from persisted state before dispatching a user command. */
+    hydrate(): Promise<void>;
+    dispose(): Promise<void>;
+    private dispatchTurn;
+    private handleTurnEvent;
+    private normalizeTerminalEvent;
+    private emit;
+    private scheduleWake;
+    private cancelWake;
+    private requireState;
+    private persistLatestState;
+    private startOptions;
+    private isWaitingOnScheduledState;
+    private currentScheduledState;
+    private readStoredState;
+    private writeStoredState;
+    private sessionFilePath;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/src/session/session.d.ts.map

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

package/dist/src/session/session.js

@@ -0,0 +1,308 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { TurnRunner } from "../turn-runner/turn-runner.js";
+export class Session {
+    config;
+    id;
+    runner;
+    /** Directory owned by this session. State persistence writes `state.json` inside it. */
+    sessionPath;
+    /** Subscribers interested in this single session's raw turn-runner events. */
+    eventHandlers = new Set();
+    /** Removes the session's subscription to its owned runner during disposal. */
+    unsubscribeRunner;
+    /** In-flight runner turn, used to distinguish active work from a reusable terminal result. */
+    activeTurn;
+    /** In-flight runner setup, awaited before any turn dispatches so turn_started lands first. */
+    startPromise;
+    /** Most recent terminal event, returned immediately when callers wait after a turn has settled. */
+    lastTerminal;
+    /** Scheduled wake for sleeping state-machine states; cancelled when user input or interrupt arrives. */
+    wakeTimer;
+    /** Restores a prompt/answer turn back to sleep when the state machine is still waiting. */
+    restoreSleepAfterTurn;
+    /** Whether this session should hydrate `state.json` on first use. New sessions start empty. */
+    resumeFromStorage;
+    /** Pending callers of `waitForTerminal`, resolved together when the next terminal event arrives. */
+    terminalWaiters = [];
+    constructor(config, options) {
+        this.config = config;
+        this.id = options.id;
+        this.resumeFromStorage = options.resumeFromStorage ?? Boolean(options.id);
+        this.runner = options.runner ?? new TurnRunner(config);
+        this.sessionPath = options.sessionPath;
+        this.unsubscribeRunner = this.runner.subscribe((event) => void this.handleTurnEvent(event));
+    }
+    subscribe(handler) {
+        this.eventHandlers.add(handler);
+        return () => {
+            this.eventHandlers.delete(handler);
+        };
+    }
+    /**
+     * Initialize the session before any turn runs. Calls the runner's setup
+     * step once so the caller can render skills and agent files immediately on
+     * launch, before the user types a prompt.
+     *
+     * Repeat calls are no-ops; resumed sessions reuse the persisted state.
+     */
+    async start(input = {}) {
+        if (this.startPromise) {
+            await this.startPromise;
+            return;
+        }
+        const state = this.resumeFromStorage ? await this.readStoredState() : undefined;
+        const command = {
+            type: "start",
+            ...((input.mode ?? this.config.mode) ? { mode: input.mode ?? this.config.mode } : {}),
+            ...(state ? { state } : {}),
+            ...this.startOptions(input.options),
+        };
+        this.startPromise = this.runner.start(command).then(() => undefined);
+        await this.startPromise;
+    }
+    async prompt(input) {
+        await this.ensureStarted();
+        const state = await this.requireState();
+        this.cancelWake();
+        const wasSleeping = state.status === "sleeping";
+        this.restoreSleepAfterTurn = wasSleeping && this.isWaitingOnScheduledState(state);
+        const command = {
+            type: "prompt",
+            message: input.message,
+            behavior: input.behavior ?? "follow_up",
+        };
+        this.dispatchTurn(command);
+    }
+    async answer(input) {
+        await this.ensureStarted();
+        const state = await this.requireState();
+        this.cancelWake();
+        const wasSleeping = state.status === "sleeping";
+        this.restoreSleepAfterTurn = wasSleeping && this.isWaitingOnScheduledState(state);
+        const command = {
+            type: "answer",
+            questions: input.questions,
+            answers: input.answers,
+            behavior: input.behavior ?? "follow_up",
+        };
+        this.dispatchTurn(command);
+    }
+    async interrupt() {
+        await this.ensureStarted();
+        this.cancelWake();
+        this.runner.interrupt({ type: "interrupt" });
+    }
+    async ensureStarted() {
+        if (!this.startPromise) {
+            await this.start();
+            return;
+        }
+        await this.startPromise;
+    }
+    editFollowUpQueue(input) {
+        this.runner.editFollowUpQueue({
+            type: "edit_follow_up_queue",
+            prompts: input.prompts,
+        });
+    }
+    async waitForTerminal() {
+        if (this.lastTerminal && !this.activeTurn) {
+            return this.lastTerminal;
+        }
+        return new Promise((resolve) => {
+            this.terminalWaiters.push(resolve);
+        });
+    }
+    isTurnActive() {
+        return Boolean(this.activeTurn);
+    }
+    /** Current runner-owned turn state snapshot, including agent message history. */
+    getState() {
+        return this.runner.getState();
+    }
+    /**
+     * Skills discovered for this session. Available after `start()` resolves;
+     * loading happens lazily on first call otherwise.
+     */
+    getSkills() {
+        return this.runner.getSkills();
+    }
+    /** System-prompt files (AGENTS.md by default) that resolved on disk. */
+    getResolvedAgentFiles() {
+        return this.runner.getResolvedAgentFiles();
+    }
+    /** Skill name collisions where one definition shadowed another during discovery. */
+    getSkillCollisions() {
+        return this.runner.getSkillCollisions();
+    }
+    /** Start this session from persisted state before dispatching a user command. */
+    async hydrate() {
+        if (this.startPromise) {
+            await this.startPromise;
+            return;
+        }
+        if (!this.resumeFromStorage)
+            return;
+        const state = await this.readStoredState();
+        if (!state)
+            return;
+        this.startPromise = this.runner
+            .start({ type: "start", state, ...this.startOptions() })
+            .then(() => undefined);
+        await this.startPromise;
+    }
+    async dispose() {
+        await this.persistLatestState();
+        this.unsubscribeRunner();
+        this.cancelWake();
+        await this.runner.dispose();
+    }
+    dispatchTurn(command) {
+        this.lastTerminal = undefined;
+        const activeTurn = this.runner
+            .turn(command)
+            .then(() => undefined)
+            .catch((error) => {
+            this.emit({
+                type: "system",
+                level: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        })
+            .finally(() => {
+            if (this.activeTurn === activeTurn) {
+                this.activeTurn = undefined;
+            }
+        });
+        this.activeTurn = activeTurn;
+    }
+    async handleTurnEvent(event) {
+        let emitted = event;
+        if (isTerminalEvent(event)) {
+            emitted = this.normalizeTerminalEvent(event);
+            this.lastTerminal = emitted;
+            await this.writeStoredState(emitted.state);
+            if (emitted.type === "sleep") {
+                this.scheduleWake(emitted);
+            }
+            for (const resolve of this.terminalWaiters.splice(0)) {
+                resolve(emitted);
+            }
+        }
+        this.emit(emitted);
+    }
+    normalizeTerminalEvent(event) {
+        if (this.restoreSleepAfterTurn &&
+            event.type === "complete" &&
+            this.isWaitingOnScheduledState(event.state)) {
+            this.restoreSleepAfterTurn = false;
+            if (event.status === "failed") {
+                this.emit({
+                    type: "system",
+                    level: "error",
+                    message: event.error ?? event.result ?? "Prompt failed while waiting.",
+                });
+            }
+            const state = this.currentScheduledState(event.state);
+            const progress = state ? event.state.stateMachine?.progress?.states[state.name] : undefined;
+            const wakeAt = progress?.nextWakeAt ??
+                (state?.kind === "poll" ? Date.now() + state.intervalMs : (state?.wakeAt ?? Date.now()));
+            return {
+                type: "sleep",
+                wakeAt,
+                state: { ...event.state, status: "sleeping" },
+            };
+        }
+        this.restoreSleepAfterTurn = false;
+        return event;
+    }
+    emit(event) {
+        for (const handler of this.eventHandlers) {
+            handler(event);
+        }
+    }
+    scheduleWake(terminal) {
+        this.cancelWake();
+        this.wakeTimer = setTimeout(() => {
+            this.wakeTimer = undefined;
+            const state = this.runner.getState();
+            if (!state || state.status !== "sleeping")
+                return;
+            this.dispatchTurn({ type: "wake" });
+        }, Math.max(0, terminal.wakeAt - Date.now()));
+    }
+    cancelWake() {
+        if (this.wakeTimer) {
+            clearTimeout(this.wakeTimer);
+            this.wakeTimer = undefined;
+        }
+    }
+    async requireState() {
+        await this.ensureStarted();
+        const state = this.runner.getState();
+        if (!state) {
+            throw new Error(`Unknown session: ${this.id}`);
+        }
+        return state;
+    }
+    async persistLatestState() {
+        const state = this.runner.getState();
+        if (!state)
+            return;
+        await this.writeStoredState(state);
+    }
+    startOptions(options) {
+        // CLI/TUI config is the current session contract. On resume it should
+        // override persisted options so flags like --model take effect immediately.
+        const effective = {
+            ...(this.config.model ? { model: this.config.model } : {}),
+            ...(this.config.memoryModel ? { memoryModel: this.config.memoryModel } : {}),
+            ...(this.config.thinkingLevel ? { thinkingLevel: this.config.thinkingLevel } : {}),
+            ...options,
+        };
+        return Object.keys(effective).length > 0 ? { options: effective } : {};
+    }
+    isWaitingOnScheduledState(state) {
+        return Boolean(this.currentScheduledState(state) && !state?.stateMachine?.terminal);
+    }
+    currentScheduledState(state) {
+        const stateMachine = state?.stateMachine;
+        const currentState = stateMachine?.currentState;
+        if (!stateMachine || !currentState)
+            return undefined;
+        const definitionState = stateMachine.definition.states.find((item) => item.name === currentState);
+        return definitionState?.kind === "poll" || definitionState?.kind === "timer"
+            ? definitionState
+            : undefined;
+    }
+    async readStoredState() {
+        try {
+            const content = await readFile(this.sessionFilePath(), "utf-8");
+            const stored = JSON.parse(content);
+            return stored.state ?? stored.session;
+        }
+        catch (error) {
+            if (isEnoent(error) || String(error).includes(this.sessionFilePath())) {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    async writeStoredState(state) {
+        await writeFile(this.sessionFilePath(), `${JSON.stringify({ sessionId: this.id, updatedAt: Date.now(), state }, null, 2)}\n`, "utf-8");
+    }
+    sessionFilePath() {
+        return join(this.sessionPath, "state.json");
+    }
+}
+function isTerminalEvent(event) {
+    return (event.type === "complete" ||
+        event.type === "ask" ||
+        event.type === "interrupted" ||
+        event.type === "sleep");
+}
+function isEnoent(error) {
+    return String(error).includes("ENOENT");
+}
+//# sourceMappingURL=session.js.map

package/dist/src/session/session.js.map

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

package/dist/src/tui/app.d.ts

@@ -0,0 +1,60 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { Session } from "../session/session.js";
+import type { TurnTerminalEvent } from "../types/protocol.js";
+export interface RunTuiInput {
+    session: Session;
+    initialPrompt?: string;
+    /** Current working directory shown in the startup header. */
+    workDir: string;
+    /** Session id shown in the startup header and resume context. */
+    sessionId: string;
+    /** Installed package version shown in the startup header. */
+    packageVersion: string;
+    /** Fully resolved provider:modelId string used for this CLI session. */
+    modelName: string;
+    /** Human-readable provenance for modelName, e.g. "inferred from ANTHROPIC_API_KEY in .env". */
+    modelSource?: string;
+    /** Fully resolved provider:modelId string used for observational memory work. */
+    memoryModelName: string;
+    /** Human-readable provenance for memoryModelName. */
+    memoryModelSource?: string;
+    /** Best-effort package update notice, shown in-TUI because stderr is hidden. */
+    newVersionNotice?: string;
+    /** Past messages to replay into the transcript on resume. */
+    history?: AgentMessage[];
+    /** Maximum prior-session display lines to replay on resume; 0 disables replay. */
+    resumeHistoryLines?: number;
+}
+type HistoryBlockKind = "user" | "agent" | "reasoning" | "tool" | "error";
+export interface HistoryDisplayBlock {
+    kind: HistoryBlockKind;
+    content: string;
+}
+export interface LimitedHistory {
+    blocks: HistoryDisplayBlock[];
+    omittedLines: number;
+}
+export interface StartupHeaderInput {
+    packageVersion: string;
+    workDir: string;
+    sessionId: string;
+    modelName: string;
+    modelSource?: string;
+    memoryModelName: string;
+    memoryModelSource?: string;
+    newVersionNotice?: string;
+}
+/**
+ * Runs the interactive TUI for a session. Resolves with the most recent
+ * terminal event (if any) when the user exits the UI.
+ *
+ * Differentiating Enter vs Shift+Enter requires the terminal to report
+ * modifier keys with Enter, which most terminals only do when the Kitty
+ * keyboard protocol is enabled. We opt into it via `useKittyKeyboard`.
+ */
+export declare function runTui(input: RunTuiInput): Promise<TurnTerminalEvent | undefined>;
+export declare function historyDisplayBlocks(history: readonly AgentMessage[]): HistoryDisplayBlock[];
+export declare function startupHeaderLines(input: StartupHeaderInput): string[];
+export declare function limitHistoryDisplayBlocks(blocks: readonly HistoryDisplayBlock[], maxLines: number): LimitedHistory;
+export {};
+//# sourceMappingURL=app.d.ts.map

package/dist/src/tui/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/tui/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAWlE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAIV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,KAAK,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAsBD;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAgqBvF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,mBAAmB,EAAE,CAgD5F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,EAAE,CActE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,mBAAmB,EAAE,EACtC,QAAQ,EAAE,MAAM,GACf,cAAc,CAyBhB"}