agent-relay 9.1.4 → 9.1.6

package/dist/cli/commands/reflex.js

@@ -0,0 +1,192 @@
+import fs from 'node:fs';
+import { chmod, mkdir, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import readline from 'node:readline';
+const ALLOWED_RELAYHISTORY_HOSTS = new Set(['history.agentrelay.com']);
+function validateRelayhistoryBaseUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        return { ok: false, error: `AI_HIST_BASE_URL is not a valid URL: ${raw}` };
+    }
+    const isLocalDev = parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1' || parsed.hostname === '::1';
+    if (!isLocalDev && !ALLOWED_RELAYHISTORY_HOSTS.has(parsed.hostname)) {
+        return {
+            ok: false,
+            error: `AI_HIST_BASE_URL hostname "${parsed.hostname}" is not an allowed relayhistory host`,
+        };
+    }
+    return { ok: true, url: parsed };
+}
+function promptYesNo(question) {
+    if (!process.stdin.isTTY) {
+        return Promise.resolve(false);
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            const normalized = answer.trim().toLowerCase();
+            resolve(normalized === 'y' || normalized === 'yes');
+        });
+    });
+}
+async function defaultReadRelayAuth() {
+    const { readStoredAuth } = await import('@agent-relay/cloud');
+    return readStoredAuth();
+}
+async function defaultLoginToCloud(relayAccessToken) {
+    const rawBase = process.env.AI_HIST_BASE_URL ?? 'https://history.agentrelay.com';
+    const validated = validateRelayhistoryBaseUrl(rawBase);
+    if (!validated.ok) {
+        return { ok: false, error: validated.error };
+    }
+    const url = `${rawBase.replace(/\/$/, '')}/v1/cli/login`;
+    let resp;
+    try {
+        resp = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ agentRelayToken: relayAccessToken }),
+            signal: AbortSignal.timeout(15_000),
+        });
+    }
+    catch (err) {
+        return { ok: false, error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => '');
+        return { ok: false, error: `Login failed (HTTP ${resp.status}): ${text.slice(0, 200)}` };
+    }
+    let payload;
+    try {
+        const raw = await resp.json();
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            return { ok: false, error: 'Login response has unexpected shape' };
+        }
+        payload = raw;
+    }
+    catch {
+        return { ok: false, error: 'Login response was not valid JSON' };
+    }
+    if (typeof payload.accessToken !== 'string') {
+        return { ok: false, error: 'Login response missing accessToken' };
+    }
+    // Persist rth_at_ tokens so ai-hist sync/push can authenticate on subsequent runs.
+    try {
+        const configDir = process.env.AI_HIST_CONFIG_DIR ?? path.join(os.homedir(), '.config', 'ai-hist');
+        const authPath = path.join(configDir, 'auth.json');
+        const auth = {
+            baseUrl: rawBase.replace(/\/$/, ''),
+            accessToken: payload.accessToken,
+            ...(typeof payload.refreshToken === 'string' ? { refreshToken: payload.refreshToken } : {}),
+        };
+        await mkdir(configDir, { recursive: true });
+        await writeFile(authPath, JSON.stringify(auth, null, 2));
+        // Explicitly tighten perms — writeFile mode only applies to newly created files.
+        await chmod(authPath, 0o600);
+    }
+    catch {
+        // Non-fatal: local state is written; cloud sync may prompt again next run.
+    }
+    return { ok: true };
+}
+function withDefaults(overrides = {}) {
+    return {
+        fs,
+        homedir: os.homedir,
+        readRelayAuth: defaultReadRelayAuth,
+        loginToCloud: defaultLoginToCloud,
+        prompt: promptYesNo,
+        log: (...args) => console.log(...args),
+        ...overrides,
+    };
+}
+function getReflexDir(deps) {
+    return path.join(deps.homedir(), '.agentworkforce');
+}
+function getReflexStateFile(deps) {
+    return path.join(getReflexDir(deps), 'reflex.json');
+}
+function writeReflexState(deps, state) {
+    deps.fs.mkdirSync(getReflexDir(deps), { recursive: true });
+    deps.fs.writeFileSync(getReflexStateFile(deps), JSON.stringify(state, null, 2), 'utf-8');
+}
+function readReflexState(deps) {
+    const stateFile = getReflexStateFile(deps);
+    if (!deps.fs.existsSync(stateFile)) {
+        return null;
+    }
+    try {
+        return JSON.parse(deps.fs.readFileSync(stateFile, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function registerReflexCommands(program, overrides = {}) {
+    const deps = withDefaults(overrides);
+    const reflex = program.command('reflex').description('Manage Reflex history sync');
+    reflex
+        .command('on')
+        .description('Enable Reflex history sync')
+        .action(async () => {
+        deps.log('Reflex will capture your agent sessions and sync to history.agentrelay.com');
+        const accepted = await deps.prompt('Enable Reflex? (y/N) ');
+        if (!accepted) {
+            deps.log('Reflex was not enabled.');
+            return;
+        }
+        writeReflexState(deps, {
+            enabled: true,
+            enabledAt: new Date().toISOString(),
+        });
+        const relayAuth = await deps.readRelayAuth();
+        if (!relayAuth) {
+            deps.log('Not logged in to Agent Relay. Run `agent-relay login` first to sync Reflex history to the cloud.');
+        }
+        else {
+            const result = await deps.loginToCloud(relayAuth.accessToken);
+            if (!result.ok) {
+                deps.log(`Reflex is enabled locally, but cloud login did not complete: ${result.error}`);
+            }
+        }
+        deps.log('Reflex is on.');
+        deps.log('State file: ~/.agentworkforce/reflex.json');
+    });
+    reflex
+        .command('off')
+        .description('Disable Reflex history sync')
+        .action(() => {
+        writeReflexState(deps, { enabled: false });
+        deps.log('Reflex is off.');
+    });
+    reflex
+        .command('status')
+        .description('Show Reflex status')
+        .action(() => {
+        const state = readReflexState(deps);
+        if (!state) {
+            deps.log('Reflex is off (never enabled).');
+            return;
+        }
+        if (state.enabled) {
+            deps.log('Reflex is on.');
+            if (state.enabledAt) {
+                deps.log(`Enabled at: ${state.enabledAt}`);
+            }
+            return;
+        }
+        deps.log('Reflex is off.');
+        if (state.enabledAt) {
+            deps.log(`Enabled at: ${state.enabledAt}`);
+        }
+    });
+}
+//# sourceMappingURL=reflex.js.map

package/dist/cli/commands/reflex.js.map

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

package/dist/cli/commands/skills.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from 'commander';
+import { parseSkill, type HarnessTarget, type InstallResult, type SkillScope, type TargetContext } from '../lib/skills-install.js';
+type ExitFn = (code: number) => never;
+/** The plan resolved either interactively or from flags. */
+interface SkillPlan {
+    scope: SkillScope;
+    harnesses: HarnessTarget[];
+}
+export interface SkillsDependencies {
+    fetchSkill: (url: string) => Promise<string>;
+    promptScope: () => Promise<SkillScope | null>;
+    promptHarnesses: (harnesses: HarnessTarget[]) => Promise<string[] | null>;
+    getContext: () => TargetContext;
+    isInteractive: () => boolean;
+    install: (skill: ReturnType<typeof parseSkill>, plan: SkillPlan, ctx: TargetContext) => InstallResult[];
+    log: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    exit: ExitFn;
+}
+export declare function registerSkillsCommands(program: Command, overrides?: Partial<SkillsDependencies>): void;
+export {};
+//# sourceMappingURL=skills.d.ts.map

package/dist/cli/commands/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAOL,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAGlC,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;AAEtC,4DAA4D;AAC5D,UAAU,SAAS;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC9C,eAAe,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1E,UAAU,EAAE,MAAM,aAAa,CAAC;IAChC,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,KAAK,aAAa,EAAE,CAAC;IACxG,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AA4HD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,IAAI,CAsC1G"}

package/dist/cli/commands/skills.js

@@ -0,0 +1,147 @@
+import { getProjectPaths } from '@agent-relay/config';
+import { defaultExit } from '../lib/exit.js';
+import { HARNESS_TARGETS, ORCHESTRATE_SKILL, defaultTargetContext, fetchSkill, findHarnessTarget, installSkill, parseSkill, } from '../lib/skills-install.js';
+import { selectHarnesses, selectScope } from '../lib/skills-tui.js';
+function resolveProjectRoot() {
+    // `getProjectPaths()` resolves the nearest project root and otherwise falls
+    // back to the cwd; the try/catch is defensive so a global install can never
+    // be blocked by project resolution from outside an Agent Relay project.
+    try {
+        const paths = getProjectPaths();
+        return paths.projectRoot ?? process.cwd();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+function withDefaults(overrides = {}) {
+    return {
+        fetchSkill,
+        promptScope: () => selectScope(),
+        promptHarnesses: (harnesses) => selectHarnesses(harnesses),
+        getContext: () => defaultTargetContext(resolveProjectRoot()),
+        isInteractive: () => Boolean(process.stdin.isTTY && process.stdout.isTTY),
+        install: (skill, plan, ctx) => installSkill({ skill, scope: plan.scope, harnesses: plan.harnesses, ctx }),
+        log: (...args) => console.log(...args),
+        error: (...args) => console.error(...args),
+        exit: defaultExit,
+        ...overrides,
+    };
+}
+/** Parse `--harness a,b` into a deduped list of ids. */
+function parseHarnessFlag(raw) {
+    if (!raw)
+        return [];
+    return [
+        ...new Set(raw
+            .split(',')
+            .map((s) => s.trim().toLowerCase())
+            .filter(Boolean)),
+    ];
+}
+/** Resolve scope from flags, or null when it must be asked interactively. */
+function scopeFromFlags(opts, deps) {
+    if (opts.global && opts.local) {
+        deps.error('Choose only one of --global or --local.');
+        deps.exit(1);
+    }
+    if (opts.global)
+        return 'global';
+    if (opts.local)
+        return 'project';
+    return null;
+}
+/** Resolve harness targets from flags, or null when they must be asked. */
+function harnessesFromFlags(opts, deps) {
+    if (opts.all)
+        return [...HARNESS_TARGETS];
+    const ids = parseHarnessFlag(opts.harness);
+    if (ids.length === 0)
+        return null;
+    const resolved = [];
+    for (const id of ids) {
+        const target = findHarnessTarget(id);
+        if (!target) {
+            deps.error(`Unknown harness "${id}". Known harnesses: ${HARNESS_TARGETS.map((t) => t.id).join(', ')}.`);
+            deps.exit(1);
+        }
+        resolved.push(target);
+    }
+    return resolved;
+}
+async function resolvePlan(opts, deps) {
+    let scope = scopeFromFlags(opts, deps);
+    let harnesses = harnessesFromFlags(opts, deps);
+    const needsPrompt = scope === null || harnesses === null;
+    if (needsPrompt && !deps.isInteractive()) {
+        deps.error('Non-interactive terminal: specify the scope and harnesses with flags, e.g.\n' +
+            '  agent-relay skills add --global --harness claude,codex\n' +
+            '  agent-relay skills add --local --all');
+        deps.exit(1);
+    }
+    if (scope === null) {
+        scope = await deps.promptScope();
+        if (scope === null)
+            return null;
+    }
+    if (harnesses === null) {
+        const ids = await deps.promptHarnesses([...HARNESS_TARGETS]);
+        if (ids === null || ids.length === 0)
+            return null;
+        harnesses = ids.map((id) => findHarnessTarget(id)).filter((t) => Boolean(t));
+    }
+    return { scope, harnesses };
+}
+function reportResults(results, deps) {
+    const ok = results.filter((r) => r.status !== 'failed');
+    const failed = results.filter((r) => r.status === 'failed');
+    for (const r of ok) {
+        const verb = r.status === 'overwritten' ? 'Updated' : 'Installed';
+        deps.log(`  \x1b[32m✓\x1b[0m ${verb} ${r.label} → ${r.path}`);
+    }
+    for (const r of failed) {
+        deps.error(`  \x1b[31m✗\x1b[0m ${r.label} → ${r.path}: ${r.error}`);
+    }
+    if (ok.length > 0) {
+        deps.log('');
+        deps.log(`/${ORCHESTRATE_SKILL.slug} is ready in ${ok.length} harness${ok.length === 1 ? '' : 'es'}.`);
+    }
+    return failed.length > 0 ? 1 : 0;
+}
+export function registerSkillsCommands(program, overrides = {}) {
+    const deps = withDefaults(overrides);
+    const group = program
+        .command('skills')
+        .description('Install Agent Relay skills into your coding harnesses');
+    group
+        .command('add')
+        .description(`Install the /${ORCHESTRATE_SKILL.slug} skill into one or more harnesses`)
+        .option('-g, --global', 'Install into your global (home) config')
+        .option('-l, --local', 'Install into the current project')
+        .option('--harness <ids>', 'Comma-separated harness ids (claude, codex, cursor, gemini, opencode)')
+        .option('--all', 'Install into every supported harness')
+        .action(async (opts) => {
+        const plan = await resolvePlan(opts, deps);
+        if (!plan) {
+            deps.log('Cancelled. Nothing was installed.');
+            return;
+        }
+        let raw;
+        try {
+            raw = await deps.fetchSkill(ORCHESTRATE_SKILL.url);
+        }
+        catch (err) {
+            deps.error(err instanceof Error ? err.message : String(err));
+            deps.exit(1);
+            return;
+        }
+        const skill = parseSkill(raw);
+        const ctx = deps.getContext();
+        deps.log(`Installing /${ORCHESTRATE_SKILL.slug} (${plan.scope === 'global' ? 'global' : 'this project'})…`);
+        const results = deps.install(skill, plan, ctx);
+        const code = reportResults(results, deps);
+        if (code !== 0)
+            deps.exit(code);
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/cli/commands/skills.js.map

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

package/dist/cli/lib/skills-install.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Core logic for `agent-relay skills add` — fetching a published skill and
+ * installing it into the right per-harness directory for either the current
+ * project or the user's global config.
+ *
+ * This module is deliberately free of any interactive/TTY concerns so it can
+ * be unit-tested in isolation. The TUI lives in `./skills-tui.ts` and the
+ * command wiring in `../commands/skills.ts`.
+ */
+/** Where a skill is installed: into the current project or the user's home. */
+export type SkillScope = 'project' | 'global';
+/** The `/orchestrate` skill published at agentrelay.com. */
+export declare const ORCHESTRATE_SKILL: {
+    /** Slug used for the installed file/directory name (the slash command). */
+    readonly slug: "orchestrate";
+    /** Canonical source of the skill markdown. */
+    readonly url: "https://agentrelay.com/skill.md";
+};
+/** A skill split into its YAML frontmatter fields and markdown body. */
+export interface ParsedSkill {
+    /** Raw, unmodified source (frontmatter + body). */
+    raw: string;
+    /** `name:` from frontmatter, if present. */
+    name?: string;
+    /** `description:` from frontmatter, if present. */
+    description?: string;
+    /** Markdown body with the leading frontmatter block removed. */
+    body: string;
+}
+/**
+ * Parse a skill markdown document, extracting `name`/`description` from the
+ * leading `---` YAML frontmatter block (if any) and the body that follows.
+ * Tolerant by design: a document with no frontmatter yields `body === raw`.
+ */
+export declare function parseSkill(raw: string): ParsedSkill;
+/** Resolution context handed to each harness target. */
+export interface TargetContext {
+    projectRoot: string;
+    homeDir: string;
+}
+/** A coding harness we know how to install a skill into. */
+export interface HarnessTarget {
+    /** Stable id, matches the CLI registry (`claude`, `codex`, …). */
+    id: string;
+    /** Human-friendly label shown in the TUI. */
+    label: string;
+    /** Absolute file path the skill is written to for the given scope. */
+    resolvePath: (scope: SkillScope, ctx: TargetContext) => string;
+    /** Render the on-disk content for this harness from the parsed skill. */
+    render: (skill: ParsedSkill, slug: string) => string;
+}
+/**
+ * The set of harnesses `skills add` can target. Each maps the skill onto the
+ * harness's native custom-command / skill convention.
+ */
+export declare const HARNESS_TARGETS: HarnessTarget[];
+/** Look up a harness target by id. */
+export declare function findHarnessTarget(id: string): HarnessTarget | undefined;
+/** Default resolution context: real project root + home directory. */
+export declare function defaultTargetContext(projectRoot: string): TargetContext;
+/** Outcome of installing into a single harness. */
+export interface InstallResult {
+    harnessId: string;
+    label: string;
+    path: string;
+    status: 'installed' | 'overwritten' | 'failed';
+    error?: string;
+}
+/** Side-effecting writer, injected so tests can capture without touching disk. */
+export interface SkillWriter {
+    exists: (filePath: string) => boolean;
+    write: (filePath: string, content: string) => void;
+}
+/** Default writer: mkdir -p the parent and write the file. */
+export declare const fsWriter: SkillWriter;
+/**
+ * Install the skill into each requested harness for the given scope.
+ * Never throws for a single-harness failure — it is recorded in the result so
+ * the caller can report a partial success.
+ */
+export declare function installSkill(opts: {
+    skill: ParsedSkill;
+    scope: SkillScope;
+    harnesses: HarnessTarget[];
+    ctx: TargetContext;
+    writer?: SkillWriter;
+    slug?: string;
+}): InstallResult[];
+/** Default time budget for the skill download before it is aborted. */
+export declare const FETCH_SKILL_TIMEOUT_MS = 15000;
+/**
+ * Fetch the published skill markdown over HTTPS. Bounded by an abort timeout so
+ * a stalled connection can't hang `skills add` (notably in CI). Throws a clear
+ * error on timeout or a non-2xx response so the command can surface it.
+ */
+export declare function fetchSkill(url?: string, timeoutMs?: number): Promise<string>;
+//# sourceMappingURL=skills-install.d.ts.map

package/dist/cli/lib/skills-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-install.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/skills-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9C,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB;IAC5B,2EAA2E;;IAE3E,8CAA8C;;CAEtC,CAAC;AAEX,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAYnD;AASD,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;IAC/D,yEAAyE;IACzE,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD;AAOD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAwE1C,CAAC;AAMF,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEvE;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAEvE;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,8DAA8D;AAC9D,eAAO,MAAM,QAAQ,EAAE,WAMtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,aAAa,EAAE,CAwBlB;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,GAAG,GAAE,MAA8B,EACnC,SAAS,GAAE,MAA+B,GACzC,OAAO,CAAC,MAAM,CAAC,CA0BjB"}