instar 1.2.10 → 1.2.12

package/dist/commands/setup-wizard/codex-driver.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Codex driver for the hybrid wizard.
+ *
+ * Per-turn narrative: for each `narrative-then-prompt` state, instar
+ * spawns `codex exec` with a tightly-constrained prompt asking Codex
+ * to generate ONE warm 2-3 sentence intro paragraph. The structural
+ * prompt (the question text) is printed verbatim by instar from the
+ * state machine; Codex never sees it. This means Codex cannot reword
+ * the question, can't add or remove options, and can't decide to
+ * "execute the setup" — each per-turn invocation has nothing to
+ * execute and a single bounded text job.
+ *
+ * Action states call existing instar CLI commands directly. Telegram
+ * setup is a special action that spawns Codex as a full agentic
+ * session with Playwright access, pointed at a Telegram-specific
+ * prompt that aligns with Codex's execution-orientation (the
+ * conversational behavior is no longer expected here — Codex is
+ * driving the browser, that's its strength).
+ */
+export interface CodexDriverOptions {
+    codexPath: string;
+    projectDir: string;
+    instarRoot: string;
+    /**
+     * When false, the driver suppresses narrative LLM calls and prints
+     * a deterministic fallback intro for each step. Used in tests and
+     * when the codex binary returns an auth error.
+     */
+    enableNarrative?: boolean;
+}
+/**
+ * Entry point — runs the wizard from the initial state to completion.
+ */
+export declare function runCodexWizard(options: CodexDriverOptions): Promise<void>;
+//# sourceMappingURL=codex-driver.d.ts.map

package/dist/commands/setup-wizard/codex-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-driver.d.ts","sourceRoot":"","sources":["../../../src/commands/setup-wizard/codex-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgBH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA8VD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC/E"}

package/dist/commands/setup-wizard/codex-driver.js

@@ -0,0 +1,355 @@
+/**
+ * Codex driver for the hybrid wizard.
+ *
+ * Per-turn narrative: for each `narrative-then-prompt` state, instar
+ * spawns `codex exec` with a tightly-constrained prompt asking Codex
+ * to generate ONE warm 2-3 sentence intro paragraph. The structural
+ * prompt (the question text) is printed verbatim by instar from the
+ * state machine; Codex never sees it. This means Codex cannot reword
+ * the question, can't add or remove options, and can't decide to
+ * "execute the setup" — each per-turn invocation has nothing to
+ * execute and a single bounded text job.
+ *
+ * Action states call existing instar CLI commands directly. Telegram
+ * setup is a special action that spawns Codex as a full agentic
+ * session with Playwright access, pointed at a Telegram-specific
+ * prompt that aligns with Codex's execution-orientation (the
+ * conversational behavior is no longer expected here — Codex is
+ * driving the browser, that's its strength).
+ */
+import { execFileSync, spawn, spawnSync } from 'node:child_process';
+import path from 'node:path';
+import readline from 'node:readline';
+import pc from 'picocolors';
+import { buildFreshProjectInstall, INITIAL_STATE, } from './state-machine.js';
+import { WIZARD_CODEX_MODEL } from './model-constants.js';
+/**
+ * Per-state narrative-prompt builders. Each returns the EXACT text we
+ * send to `codex exec`. The contract: ONE paragraph, no tools, no
+ * commands. Codex's `-s read-only` sandbox plus the prompt's
+ * constraints together prevent execution.
+ */
+const NARRATIVE_PROMPTS = {
+    welcome: (_a, ctx) => `
+You are a warm, friendly setup wizard greeting a new user installing
+instar (a persistent AI-agent toolkit) in their project at ${path.basename(ctx.projectDir)}.
+
+OUTPUT EXACTLY ONE warm 2-3 sentence paragraph welcoming them. Do NOT
+include CLI commands, file paths, or technical jargon. Do NOT use ANY
+tools or run ANY commands. Do NOT ask any questions — a separate
+structured prompt will follow yours.
+
+After your paragraph, exit. Output text only.
+`.trim(),
+    'agent-name': (a) => `
+You are continuing the instar setup wizard. The user just accepted
+the privacy notice. Now you're transitioning to the identity phase
+where they'll pick a name for their agent.
+
+OUTPUT EXACTLY ONE warm 2-3 sentence paragraph introducing the
+"pick a name" step. Make it feel like the start of something — they're
+naming a presence, not configuring a script. Hint that the name can
+be anything (made-up word, real name, project-relevant).
+
+Do NOT include CLI commands, file paths, or examples in code blocks.
+Do NOT use ANY tools. Do NOT ask the question — a structured prompt
+follows. Output text only and exit.
+
+Their answers so far: name not yet given.
+`.trim(),
+    'agent-role': (a) => `
+The user just told you their agent will be called "${a.agentName}".
+Acknowledge the name in one short sentence (warmly), then introduce
+the next step: a one-sentence description of what the agent should
+focus on.
+
+OUTPUT 1-2 sentences total. No CLI, no jargon, no tools, no question
+(structured prompt follows). Output text only and exit.
+`.trim(),
+    'user-name': (a) => `
+The user named their agent "${a.agentName}" and described its focus
+as: "${a.agentRole}". Now you're asking what they'd like to be called.
+
+OUTPUT ONE short sentence transitioning into "what should ${a.agentName}
+call you?". Warm, not formal. No tools, no question (structured
+prompt follows). Output text only and exit.
+`.trim(),
+    autonomy: (a) => `
+The user is "${a.userName}". Their agent "${a.agentName}" will focus on:
+"${a.agentRole}". Next step: pick an autonomy level.
+
+OUTPUT 2-3 short sentences introducing the autonomy choice. Explain
+that this is a starting point — they can change it anytime later by
+just chatting the agent ("be more proactive", "ask before acting").
+Don't re-list the options (a structured prompt with the options
+follows). No tools. Output text only and exit.
+`.trim(),
+    messaging: (a) => `
+The user "${a.userName}" has set up their agent "${a.agentName}" with
+${a.autonomy} autonomy. Now they need to pick how to talk to the agent
+day-to-day.
+
+OUTPUT 2-3 short sentences introducing the messaging-channel choice.
+Hint that messaging is THE interface — the user shouldn't need to
+return to a terminal after this. Don't re-list the options. No tools.
+Output text only and exit.
+`.trim(),
+};
+function narrativeFor(stateId, answers, ctx) {
+    const builder = NARRATIVE_PROMPTS[stateId];
+    return builder ? builder(answers, ctx) : null;
+}
+/**
+ * Default deterministic narrative for each state, used when the
+ * Codex call is suppressed or fails. Keeps the wizard usable even
+ * when narrative generation is unavailable.
+ */
+const FALLBACK_NARRATIVES = {
+    welcome: 'Welcome to instar.',
+    'agent-name': 'Let\'s start with a name for your agent.',
+    'agent-role': 'Got it.',
+    'user-name': 'And one more piece of identity:',
+    autonomy: 'A starting point — you can change this anytime.',
+    messaging: 'Messaging is the interface you\'ll use day-to-day.',
+};
+/**
+ * Run `codex exec` for one narrative-generation turn. Returns the
+ * text body of Codex's response (stdout), or null on failure /
+ * timeout. Bounded to a short per-turn timeout so a flaky network
+ * doesn't stall the wizard.
+ */
+function runCodexNarrative(codexPath, prompt, options) {
+    try {
+        const result = spawnSync(codexPath, [
+            'exec',
+            '-s', 'read-only',
+            '-m', WIZARD_CODEX_MODEL,
+            '--skip-git-repo-check',
+            '--ephemeral',
+            prompt,
+        ], {
+            cwd: options.instarRoot,
+            timeout: options.timeoutMs,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        if (result.status !== 0)
+            return null;
+        // Strip any trailing trace blocks that codex exec prints. We want
+        // the last contiguous block of plain-English text.
+        const stdout = (result.stdout || '').trim();
+        // Heuristic: take everything after the last "--------" or "user\n" /
+        // "codex\n" marker if present (codex exec output sometimes prefixes
+        // session metadata).
+        const markers = ['\n--------\n', '\nuser\n', '\ncodex\n'];
+        let body = stdout;
+        for (const m of markers) {
+            const idx = body.lastIndexOf(m);
+            if (idx >= 0 && idx < body.length - 20)
+                body = body.slice(idx + m.length).trim();
+        }
+        return body || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Prompt the user with readline. Returns the trimmed answer (may be
+ * empty string for "user pressed enter").
+ */
+async function askUser(promptText) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(promptText, (answer) => {
+            rl.close();
+            resolve(answer || '');
+        });
+    });
+}
+/**
+ * Render a state to the user: narrative paragraph (LLM-generated) +
+ * structural prompt (verbatim). Then read the answer.
+ */
+async function renderNarrativeState(state, answers, options) {
+    // Generate narrative
+    let narrative = null;
+    if (options.enableNarrative !== false) {
+        const prompt = narrativeFor(state.id, answers, { projectDir: options.projectDir });
+        if (prompt) {
+            narrative = runCodexNarrative(options.codexPath, prompt, {
+                instarRoot: options.instarRoot,
+                timeoutMs: 30_000,
+            });
+        }
+    }
+    console.log();
+    console.log(pc.cyan(narrative ?? FALLBACK_NARRATIVES[state.id] ?? ''));
+    console.log();
+    console.log(state.prompt);
+    console.log();
+    const placeholderHint = state.input.kind === 'text' && state.input.placeholder
+        ? pc.dim(`  (${state.input.placeholder})`)
+        : '';
+    if (placeholderHint)
+        console.log(placeholderHint);
+    return askUser('  > ');
+}
+/**
+ * Execute an action state — calls the appropriate instar CLI command
+ * or hands off to an agentic session.
+ */
+async function runAction(action, answers, options) {
+    console.log();
+    console.log(pc.dim(`  → ${action.description}...`));
+    switch (action.kind) {
+        case 'init': {
+            // We assume instar is on PATH (the bareword `npx instar` flow
+            // got us here). Use the installed binary.
+            try {
+                execFileSync('npx', [
+                    'instar',
+                    'init',
+                    '--dir', options.projectDir,
+                    '--framework', 'codex-cli',
+                ], { stdio: 'inherit' });
+            }
+            catch {
+                console.log(pc.yellow('  (init returned non-zero; continuing)'));
+            }
+            return {};
+        }
+        case 'add-user': {
+            const id = (answers.userName || 'user').toLowerCase().replace(/[^a-z0-9]/g, '');
+            const name = answers.userName || 'User';
+            try {
+                execFileSync('npx', ['instar', 'user', 'add', '-d', options.projectDir, '--id', id, '--name', name], { stdio: 'inherit' });
+            }
+            catch {
+                // non-fatal
+            }
+            return {};
+        }
+        case 'start-server': {
+            try {
+                execFileSync('npx', ['instar', 'server', 'start', '-d', options.projectDir], { stdio: 'inherit' });
+                return { serverStarted: true };
+            }
+            catch {
+                return { serverStarted: false };
+            }
+        }
+        case 'install-autostart': {
+            try {
+                execFileSync('npx', ['instar', 'autostart', 'install', '-d', options.projectDir], { stdio: 'inherit' });
+            }
+            catch {
+                // non-fatal
+            }
+            return {};
+        }
+        case 'setup-telegram-agentic': {
+            return await runTelegramSetup(options);
+        }
+        case 'setup-whatsapp-agentic':
+        case 'setup-slack-agentic': {
+            // Not yet ported to the hybrid wizard. Fall back to a clear
+            // pointer: setup completes, user can configure later via
+            // `instar add <channel>`.
+            console.log();
+            console.log(pc.yellow('  This channel will be configured after setup.'));
+            console.log(pc.dim('  (Hybrid wizard will gain agentic setup for it in a follow-up release.)'));
+            return {};
+        }
+        case 'send-greeting': {
+            // Lifeline topic greeting depends on Telegram being configured.
+            // Defer to existing helper if available; otherwise skip silently.
+            return {};
+        }
+        case 'github-backup': {
+            // Out of scope for v1.2.12 minimum. Future PR.
+            return {};
+        }
+    }
+}
+/**
+ * Telegram setup — the agentic phase. Spawns Codex with a tight
+ * Telegram-specific prompt and Playwright access. Codex's
+ * execution-orientation is an asset here.
+ */
+async function runTelegramSetup(options) {
+    const skillPath = path.join(options.instarRoot, '.claude', 'skills', 'setup-wizard', 'SKILL.md');
+    // Inline Codex-specific Telegram-only prompt. The skill text isn't
+    // perfect for Codex but the Telegram-via-Playwright phase is
+    // primarily execution (open browser, click buttons, capture token),
+    // which Codex handles well.
+    const telegramPrompt = `
+You are completing the Telegram messaging setup for an instar agent
+already initialized at ${options.projectDir}.
+
+Your task is OPERATIONAL and BOUNDED:
+1. Open Telegram Web in a browser via Playwright (if Playwright MCP
+   tools are available; otherwise fall back to printing manual steps).
+2. Help the user create a bot via BotFather.
+3. Capture the bot token and chat ID.
+4. Write them to .instar/config.json under messaging[].config.
+
+When you have the token + chat ID and have written them, exit. Do NOT
+proceed past Telegram setup — the rest of the wizard is owned by
+instar's state machine.
+
+If Playwright is not available, print clear manual steps (open
+t.me/BotFather, type /newbot, etc.) and prompt the user for the token
+and chat ID. Then write them to config.
+
+Reference skill (for the wizard sections about Telegram if you need
+detail): ${skillPath}
+`.trim();
+    return new Promise((resolve) => {
+        const child = spawn(options.codexPath, [
+            'exec',
+            '--dangerously-bypass-approvals-and-sandbox',
+            '-m', WIZARD_CODEX_MODEL,
+            telegramPrompt,
+        ], {
+            cwd: options.projectDir,
+            stdio: 'inherit',
+        });
+        child.on('close', () => resolve({ telegramConfigured: true }));
+        child.on('error', () => resolve({ telegramConfigured: false }));
+    });
+}
+/**
+ * Entry point — runs the wizard from the initial state to completion.
+ */
+export async function runCodexWizard(options) {
+    const states = buildFreshProjectInstall();
+    const answers = {};
+    let currentId = INITIAL_STATE;
+    let safety = 30; // guard against infinite loops via bad transitions
+    while (safety-- > 0) {
+        const state = states[currentId];
+        if (!state) {
+            console.log(pc.red(`  Wizard reached an unknown state: ${currentId}`));
+            return;
+        }
+        if (state.kind === 'terminal') {
+            console.log();
+            console.log(pc.green(state.farewell));
+            console.log();
+            return;
+        }
+        if (state.kind === 'action') {
+            const updates = await runAction(state.action, answers, options);
+            Object.assign(answers, updates);
+            currentId = state.next(answers);
+            continue;
+        }
+        // narrative-then-prompt
+        const answer = await renderNarrativeState(state, answers, options);
+        const { state: nextId, updates } = state.next(answer, answers);
+        Object.assign(answers, updates);
+        currentId = nextId;
+    }
+}
+//# sourceMappingURL=codex-driver.js.map

package/dist/commands/setup-wizard/codex-driver.js.map

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

package/dist/commands/setup-wizard/model-constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Codex model used by the hybrid wizard's Codex driver.
+ *
+ * Codex CLI's bundled default (gpt-5.2-codex) was retired from
+ * ChatGPT-subscription accounts on 2026-04-14 and is API-only since.
+ * The wizard targets the subscription path by default, so we pin to a
+ * model empirically confirmed-working on ChatGPT auth (see
+ * src/providers/adapters/openai-codex/models.ts for the full
+ * availability matrix). gpt-5.3-codex is the "balanced" tier in that
+ * matrix.
+ */
+export declare const WIZARD_CODEX_MODEL = "gpt-5.3-codex";
+//# sourceMappingURL=model-constants.d.ts.map

package/dist/commands/setup-wizard/model-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-constants.d.ts","sourceRoot":"","sources":["../../../src/commands/setup-wizard/model-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}

package/dist/commands/setup-wizard/model-constants.js

@@ -0,0 +1,13 @@
+/**
+ * Codex model used by the hybrid wizard's Codex driver.
+ *
+ * Codex CLI's bundled default (gpt-5.2-codex) was retired from
+ * ChatGPT-subscription accounts on 2026-04-14 and is API-only since.
+ * The wizard targets the subscription path by default, so we pin to a
+ * model empirically confirmed-working on ChatGPT auth (see
+ * src/providers/adapters/openai-codex/models.ts for the full
+ * availability matrix). gpt-5.3-codex is the "balanced" tier in that
+ * matrix.
+ */
+export const WIZARD_CODEX_MODEL = 'gpt-5.3-codex';
+//# sourceMappingURL=model-constants.js.map

package/dist/commands/setup-wizard/model-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-constants.js","sourceRoot":"","sources":["../../../src/commands/setup-wizard/model-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC"}

package/dist/commands/setup-wizard/state-machine.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Wizard state machine — backbone of the conversational setup flow.
+ *
+ * This is the deterministic spine. Each state has a `prompt` (what the
+ * user is asked), a list of `choices` (when multi-choice) or `kind:
+ * 'text'` (free-text), and `nextState` derived from the user's answer.
+ * Side-effects (init, user add, server start, etc.) are emitted as
+ * `actions` the driver runs at appropriate transitions.
+ *
+ * Framework-specific drivers (codex-driver.ts) consume this state
+ * machine. The framework's LLM is invoked ONLY to generate narrative
+ * intro text for each state — not to drive transitions. Transitions
+ * are owned by instar.
+ *
+ * This is the "Structure > Willpower" answer to the v1.2.11 failure
+ * mode where Codex ignored the wizard SKILL.md's conversational
+ * contract and executed the entire setup non-interactively. With the
+ * state machine owning the flow, the framework cannot get out of hand
+ * — each per-turn LLM call has a single bounded text job.
+ */
+export type Autonomy = 'guided' | 'proactive' | 'autonomous';
+export type Messaging = 'telegram' | 'whatsapp' | 'slack' | 'skip';
+export interface WizardAnswers {
+    agentName?: string;
+    agentRole?: string;
+    userName?: string;
+    autonomy?: Autonomy;
+    messaging?: Messaging;
+    telegramConfigured?: boolean;
+    whatsappConfigured?: boolean;
+    slackConfigured?: boolean;
+    githubBackupRepo?: string;
+    serverStarted?: boolean;
+}
+export type WizardActionKind = 'init' | 'add-user' | 'setup-telegram-agentic' | 'setup-whatsapp-agentic' | 'setup-slack-agentic' | 'github-backup' | 'start-server' | 'install-autostart' | 'send-greeting';
+export interface WizardAction {
+    kind: WizardActionKind;
+    description: string;
+}
+export type StateKind = 'narrative-then-prompt' | 'action' | 'terminal';
+export interface NarrativeState {
+    id: string;
+    kind: 'narrative-then-prompt';
+    /**
+     * The question text the user sees. Framework drivers should NOT
+     * regenerate this — it is the structural prompt, displayed verbatim.
+     * Narrative intro text is rendered separately by the driver via a
+     * per-turn LLM call.
+     */
+    prompt: string;
+    /** Optional preamble keys for the driver to look up narrative-prompt builders. */
+    narrativeContext: string;
+    input: {
+        kind: 'text';
+        placeholder?: string;
+    } | {
+        kind: 'choice';
+        choices: Array<{
+            value: string;
+            label: string;
+        }>;
+    };
+    /** Where to go next based on the user's answer. Driver invokes this. */
+    next: (answer: string, answers: WizardAnswers) => {
+        state: string;
+        updates: Partial<WizardAnswers>;
+    };
+}
+export interface ActionState {
+    id: string;
+    kind: 'action';
+    action: WizardAction;
+    /**
+     * Where to go after the action completes. Drivers are responsible
+     * for running the action and applying any answer updates.
+     */
+    next: (answers: WizardAnswers) => string;
+}
+export interface TerminalState {
+    id: string;
+    kind: 'terminal';
+    /** Final farewell text. */
+    farewell: string;
+}
+export type WizardState = NarrativeState | ActionState | TerminalState;
+/**
+ * Normalize a user-typed answer for choice matching: accepts the
+ * 1-based numeric index OR the choice's `value` (case-insensitive
+ * prefix-match against the label).
+ */
+export declare function resolveChoice(answer: string, choices: Array<{
+    value: string;
+    label: string;
+}>): string | null;
+/**
+ * Build the wizard state machine for a fresh project-bound install
+ * (the most common entry point — and the one observed broken in the
+ * v1.2.11 instar-codey log). Restore / multi-user / multi-machine
+ * scenarios are out of scope for the first hybrid-wizard PR; they
+ * stay on the existing SKILL.md path until ported.
+ */
+export declare function buildFreshProjectInstall(): Record<string, WizardState>;
+export declare const INITIAL_STATE = "welcome";
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/commands/setup-wizard/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../../src/commands/setup-wizard/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,UAAU,GACV,wBAAwB,GACxB,wBAAwB,GACxB,qBAAqB,GACrB,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,eAAe,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,SAAS,GAAG,uBAAuB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,uBAAuB,CAAC;IAC9B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EACD;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACtC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACzE,wEAAwE;IACxE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;KAAE,CAAC;CACtG;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C,MAAM,GAAG,IAAI,CAYf;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuNtE;AAED,eAAO,MAAM,aAAa,YAAY,CAAC"}