testeiya 0.2.1 → 0.3.1-0.1

package/dist/src/args.js

@@ -0,0 +1,207 @@
+import { parseArgs } from "node:util";
+export const WELCOME = `
+  Testeiya, an AI testing agent.
+
+  testeiya task "analyze this pr and find inconsistencies"
+  testeiya ask "is this feature ready"
+
+  testeiya doctor    check your setup
+  testeiya --help    options and environment
+  testeiya help      the full guide
+`;
+export const USAGE = `testeiya, an AI testing agent
+
+Usage:
+  testeiya task "<task>"      run one task and write a report
+  testeiya ask "<question>"   answer a question
+  testeiya doctor             check what a run would resolve
+  testeiya models [pattern]   list the models your key can reach
+  testeiya skills [pattern]   list the skills bundled with this package
+  testeiya sessions           list saved sessions for this folder
+
+Options:
+  -o, --output <dest>   report destination, repeatable: file.md, file.json, gh:pr-comment
+      --model <id>      provider/model to run
+      --project <id>    Testomat.io project id
+  -c, --continue        continue the last session in this folder
+      --resume <id>     continue that session
+      --session <label> continue the session with that name, or start it
+      --name <label>    name the session
+      --no-session      do not save the session
+      --exit-zero       a negative verdict exits 0
+      --footer <text>   line added under a posted comment
+      --json            machine-readable output
+      --probe           doctor only: test the key with one request
+  -h, --help            show this
+  -v, --version         show version
+
+Environment:
+  TESTEIYA_MODEL          model to run, e.g. openrouter/anthropic/claude-sonnet-5
+  OPENROUTER_API_KEY      provider key, also ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY
+  TESTOMATIO              Testomat.io project API key
+  TESTOMATIO_PROJECT_ID   Testomat.io project id, same as --project
+  TESTOMATIO_URL          Testomat.io base url, for self-hosted
+
+Run "testeiya help" for the full guide.`;
+export const HELP = `${USAGE}
+
+Running a task
+
+  The agent runs one task and exits. There is no interactive mode. Progress and
+  errors go to stderr, so a run drops into CI as-is.
+
+  A task can also come from stdin:  cat task.md | testeiya task
+  A task starting with "-" must follow "--":  testeiya task -- "-weird task"
+
+  Exit codes: 0 pass, 1 failed run or negative verdict, 2 bad usage, 130 interrupted.
+
+  --exit-zero keeps a negative verdict from failing the command: a broken run
+  still exits 1 and bad usage still exits 2. The verdict is still in the report
+  and in the run envelope, so a pipeline can gate on it when it wants to.
+
+Where the report goes
+
+  --output names a destination and can repeat. Without one the report goes to
+  stdout. --json prints the run envelope to stdout instead.
+
+  report.md       the agent writes the report there
+  run.json        the run envelope: verdict, reason, report, tokens, session id
+  gh:pr-comment   posted on this branch's pull request, through the GitHub CLI
+  gh:pr#123       posted on that pull request
+
+  --footer adds a line under a posted comment, and nowhere else. Use it to say
+  how to answer the comment, e.g. --footer "> Reply with /testeiya to continue."
+
+  Every destination is checked before the run starts, so a missing gh costs no
+  tokens.
+
+Models and keys
+
+  There is no default model. Pass --model or set TESTEIYA_MODEL. A resumed run
+  reuses its session's model. "testeiya models" lists what your key can reach.
+
+  The provider key comes from the environment, from ~/.testeiya/.env, or from
+  ~/.testeiya/auth.json, which is the file the desktop app's Settings dialog
+  writes.
+
+Sessions
+
+  Runs are saved under ~/.testeiya, so a follow-up picks up where the last one
+  stopped. -c continues the last session in this folder, --resume <id> picks
+  another, --name labels one, and --no-session saves nothing.
+
+  --session <label> is the one for a job that runs again and again: it continues
+  the session with that name, and starts it the first time. Give each thread its
+  own label and they never mix.
+
+Skills
+
+  The package ships the skills the agent reads, and only those: skills found in
+  the folder it runs in are ignored, so a checkout cannot hand it its own.
+  "testeiya skills" lists them. Name one in the task to use it, e.g. a task
+  ending in "/qa-thinking".
+
+Testomat.io
+
+  Set TESTOMATIO to a project API key and the agent reads and writes that
+  project's tests, suites, runs and plans through check-tests and the REST API.
+  Add the project id, with --project or TESTOMATIO_PROJECT_ID, and it also gets
+  the Testomat.io tools. The MCP server needs the id: a token alone does not say
+  which project to talk to.`;
+export const COMMANDS = ["task", "ask", "models", "skills", "doctor", "sessions", "help"];
+export function parseCliArgs(argv) {
+    const first = argv[0];
+    if (!first)
+        return { command: "welcome" };
+    if (first === "-h" || first === "--help")
+        return { command: "usage" };
+    if (first === "-v" || first === "--version")
+        return { command: "version" };
+    if (!isCommand(first))
+        return { error: unknownCommand(first) };
+    if (first === "help")
+        return { command: "help" };
+    const options = OPTIONS[first];
+    let parsed;
+    try {
+        parsed = parseArgs({ args: argv.slice(1), options, allowPositionals: true, strict: true });
+    }
+    catch (err) {
+        if (err instanceof Error)
+            return { error: err.message };
+        return { error: String(err) };
+    }
+    const values = parsed.values;
+    if (values.help)
+        return { command: "usage" };
+    const args = { command: first };
+    const text = parsed.positionals.join(" ").trim();
+    if ((first === "task" || first === "ask") && text)
+        args.prompt = text;
+    if ((first === "models" || first === "skills") && text)
+        args.pattern = text;
+    if (Array.isArray(values.output))
+        args.outputs = values.output;
+    if (values.json)
+        args.json = true;
+    if (values.probe)
+        args.probe = true;
+    if (typeof values.model === "string")
+        args.model = values.model;
+    if (typeof values.project === "string")
+        args.project = values.project;
+    if (values.continue)
+        args.continueLast = true;
+    if (typeof values.resume === "string")
+        args.resume = values.resume;
+    if (typeof values.session === "string")
+        args.session = values.session;
+    if (typeof values.name === "string")
+        args.name = values.name;
+    if (values["no-session"])
+        args.noSession = true;
+    if (values["exit-zero"])
+        args.exitZero = true;
+    if (typeof values.footer === "string")
+        args.footer = values.footer;
+    if (args.session && (args.continueLast || args.resume || args.name || args.noSession)) {
+        return { error: "--session already names and continues a session" };
+    }
+    return args;
+}
+const HELP_FLAG = { type: "boolean", short: "h" };
+const JSON_FLAG = { type: "boolean" };
+const RUN_OPTIONS = {
+    output: { type: "string", short: "o", multiple: true },
+    json: JSON_FLAG,
+    model: { type: "string" },
+    project: { type: "string" },
+    continue: { type: "boolean", short: "c" },
+    resume: { type: "string" },
+    session: { type: "string" },
+    name: { type: "string" },
+    "no-session": { type: "boolean" },
+    "exit-zero": { type: "boolean" },
+    footer: { type: "string" },
+    help: HELP_FLAG,
+};
+const OPTIONS = {
+    task: RUN_OPTIONS,
+    ask: RUN_OPTIONS,
+    models: { json: JSON_FLAG, help: HELP_FLAG },
+    skills: { json: JSON_FLAG, help: HELP_FLAG },
+    doctor: { json: JSON_FLAG, probe: { type: "boolean" }, model: { type: "string" }, help: HELP_FLAG },
+    sessions: { json: JSON_FLAG, help: HELP_FLAG },
+    help: {},
+};
+function isCommand(value) {
+    return COMMANDS.includes(value);
+}
+// The task used to be the first positional, so a bare prompt is the mistake to
+// expect. Name the fix rather than printing the whole usage at them.
+function unknownCommand(value) {
+    if (value.startsWith("-"))
+        return `unknown option "${value}"`;
+    return `unknown command "${value}" — did you mean:  testeiya task "${value}"`;
+}
+//# sourceMappingURL=args.js.map

package/dist/src/args.js.map

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

package/dist/src/cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { HELP, parseCliArgs, USAGE, WELCOME } from "./args.js";
+import { runDoctor } from "./doctor.js";
+import { loadEnvFiles, PACKAGE_ROOT } from "./env.js";
+import { UsageError } from "./model.js";
+import { runModels } from "./models.js";
+import { runSkills } from "./skills.js";
+import { parseDestinations, preflight } from "./output.js";
+import { runPrint } from "./run.js";
+import { openSessionManager, runSessions } from "./sessions.js";
+main(process.argv.slice(2)).catch((err) => {
+    process.stderr.write(`${err?.message ?? err}\n`);
+    process.exit(1);
+});
+async function main(argv) {
+    process.title = "testeiya";
+    const args = parseCliArgs(argv);
+    if (args.error) {
+        process.stderr.write(`${args.error}\n\n${USAGE}\n`);
+        process.exit(2);
+    }
+    if (args.command === "welcome") {
+        process.stdout.write(`${WELCOME}\n`);
+        return;
+    }
+    if (args.command === "usage") {
+        process.stdout.write(`${USAGE}\n`);
+        return;
+    }
+    if (args.command === "help") {
+        process.stdout.write(`${HELP}\n`);
+        return;
+    }
+    if (args.command === "version") {
+        process.stdout.write(`${version()}\n`);
+        return;
+    }
+    const envSources = loadEnvFiles();
+    // --project is a spelling of the env var the MCP server needs, so the rest of
+    // the CLI only ever reads the environment.
+    if (args.project)
+        process.env.TESTOMATIO_PROJECT_ID = args.project;
+    try {
+        if (args.command === "models")
+            process.exit(await runModels(args.pattern, args.json));
+        if (args.command === "skills")
+            process.exit(await runSkills(args.pattern, args.json));
+        if (args.command === "doctor") {
+            process.exit(await runDoctor({ envSources, json: args.json, probe: args.probe, model: args.model }));
+        }
+        if (args.command === "sessions")
+            process.exit(await runSessions(process.cwd(), args.json));
+        process.exit(await task(args));
+    }
+    catch (err) {
+        if (!(err instanceof UsageError))
+            throw err;
+        process.stderr.write(`  ${err.message}\n`);
+        process.exit(2);
+    }
+}
+async function task(args) {
+    const prompt = args.prompt ?? (await readStdin());
+    if (!prompt.trim()) {
+        process.stderr.write(`  ${args.command} needs something to work on\n\n${USAGE}\n`);
+        process.exit(2);
+    }
+    const destinations = parseDestinations(args.outputs ?? [], args.json);
+    if (typeof destinations === "string")
+        throw new UsageError(destinations);
+    // A footer nobody will ever see is a workflow that thinks it started a
+    // conversation and did not.
+    if (args.footer && !destinations.some((d) => d.kind === "gh")) {
+        throw new UsageError("--footer needs a comment destination, e.g. -o gh:pr-comment");
+    }
+    // Everything a destination needs is checked before a single token is spent.
+    const unreachable = await preflight(destinations);
+    if (unreachable)
+        throw new UsageError(unreachable);
+    const sessionManager = await openSessionManager(process.cwd(), args);
+    if (typeof sessionManager === "string")
+        throw new UsageError(sessionManager);
+    if (args.name)
+        sessionManager.appendSessionInfo(args.name);
+    let sessionId = null;
+    if (!args.noSession)
+        sessionId = sessionManager.getSessionId();
+    const brief = args.command === "ask";
+    return runPrint({
+        prompt,
+        destinations,
+        sessionManager,
+        sessionId,
+        brief,
+        model: args.model,
+        exitZero: args.exitZero,
+        footer: args.footer,
+    });
+}
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8");
+}
+function version() {
+    const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, "package.json"), "utf8"));
+    return pkg.version;
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/doctor.js

@@ -0,0 +1,171 @@
+import { existsSync } from "node:fs";
+import { relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { TESTEIYA_HOME } from "./env.js";
+import { hasMcp, hasTestomatio, metadataCachePath, vendorBundle } from "./mcp.js";
+import { PROVIDER_KEYS, resolveModel, UsageError } from "./model.js";
+import { loadBundledSkills } from "./skills.js";
+import { BUNDLED_SKILLS_DIR, createRuntime } from "./session.js";
+const MIN_NODE = [22, 19];
+/**
+ * Everything a run resolves silently: which key file won, whether skills loaded,
+ * whether MCP is on. Reads config only — `--probe` is the one check that spends.
+ */
+export async function runDoctor(options) {
+    const checks = [nodeCheck(), homeCheck()];
+    const runtime = await createRuntime();
+    checks.push(keyCheck(runtime, options.envSources));
+    const model = modelCheck(runtime, options.model);
+    checks.push(model.check);
+    const skills = await skillsChecks();
+    checks.push(...skills.checks);
+    checks.push(testomatioCheck(), mcpCacheCheck());
+    if (options.probe)
+        checks.push(await probeCheck(runtime, model.resolved));
+    if (options.json) {
+        const report = {
+            checks: checks.filter((check) => check.status !== "list"),
+            skills: skills.groups,
+        };
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        return worst(checks) === "fail" ? 1 : 0;
+    }
+    process.stdout.write("\n");
+    for (const check of checks) {
+        process.stdout.write(`  ${MARK[check.status]} ${check.name.padEnd(12)} ${check.detail}\n`);
+    }
+    process.stdout.write("\n");
+    return worst(checks) === "fail" ? 1 : 0;
+}
+function nodeCheck() {
+    const version = process.versions.node;
+    const [major = 0, minor = 0] = version.split(".").map(Number);
+    if (major > MIN_NODE[0] || (major === MIN_NODE[0] && minor >= MIN_NODE[1])) {
+        return { name: "node", status: "ok", detail: `v${version}` };
+    }
+    return { name: "node", status: "fail", detail: `v${version}, needs v22.19 or newer` };
+}
+function homeCheck() {
+    if (!existsSync(TESTEIYA_HOME)) {
+        return { name: "home", status: "warn", detail: `${TESTEIYA_HOME} (not created yet)` };
+    }
+    return { name: "home", status: "ok", detail: TESTEIYA_HOME };
+}
+// The key can come from four places and nothing else ever says which one won.
+function keyCheck(runtime, sources) {
+    const found = [];
+    for (const { provider, env } of PROVIDER_KEYS) {
+        if (process.env[env]) {
+            found.push(`${provider} from ${sources.get(env) ?? "environment"}`);
+            continue;
+        }
+        if (runtime.hasConfiguredAuth(provider))
+            found.push(`${provider} from auth.json`);
+    }
+    if (found.length === 0) {
+        return { name: "key", status: "fail", detail: "none — set OPENROUTER_API_KEY or similar" };
+    }
+    return { name: "key", status: "ok", detail: found.join(", ") };
+}
+function modelCheck(runtime, explicit) {
+    try {
+        const model = resolveModel(runtime, explicit);
+        return {
+            check: { name: "model", status: "ok", detail: `${model.provider}/${model.id}` },
+            resolved: model,
+        };
+    }
+    catch (err) {
+        const detail = err instanceof UsageError ? err.message : String(err);
+        return { check: { name: "model", status: "warn", detail } };
+    }
+}
+async function skillsChecks() {
+    const { count, groups, diagnostics } = await loadBundledSkills();
+    const checks = [];
+    if (count === 0) {
+        checks.push({ name: "skills", status: "warn", detail: "none loaded" });
+    }
+    if (count > 0) {
+        checks.push({ name: "skills", status: "ok", detail: `${count} loaded` });
+        for (const { group, skills } of groups) {
+            const names = skills.map((skill) => skill.name);
+            checks.push({ name: "", status: "list", detail: `${group.padEnd(28)} ${summarize(names)}` });
+        }
+    }
+    // Collisions and parse errors were dropped on the floor before this command.
+    for (const diagnostic of diagnostics) {
+        const status = diagnostic.type === "error" ? "fail" : "warn";
+        let detail = diagnostic.message;
+        if (diagnostic.path)
+            detail = `${detail} — ${shorten(diagnostic.path)}`;
+        checks.push({ name: "skills", status, detail });
+    }
+    const listed = groups.map(({ group, skills }) => ({
+        group,
+        skills: skills.map((skill) => skill.name),
+    }));
+    return { checks, groups: listed };
+}
+function shorten(path) {
+    const inBundle = relative(BUNDLED_SKILLS_DIR, path);
+    if (inBundle.startsWith(".."))
+        return path;
+    return inBundle;
+}
+// The full list is `testeiya skills`; this line only proves the right set loaded.
+function summarize(names) {
+    if (names.length <= 6)
+        return names.join(", ");
+    return `${names.slice(0, 6).join(", ")}, +${names.length - 6}`;
+}
+function testomatioCheck() {
+    if (!hasTestomatio()) {
+        return { name: "testomatio", status: "warn", detail: "no TESTOMATIO token, not connected" };
+    }
+    if (!hasMcp()) {
+        return {
+            name: "testomatio",
+            status: "warn",
+            detail: "token set, no project id — check-tests and REST only",
+        };
+    }
+    return { name: "testomatio", status: "ok", detail: "token and project id, MCP tools on" };
+}
+function mcpCacheCheck() {
+    if (!hasMcp())
+        return { name: "mcp", status: "ok", detail: "off" };
+    const bundle = fileURLToPath(vendorBundle());
+    if (!existsSync(bundle)) {
+        return { name: "mcp", status: "fail", detail: "vendor bundle missing — run npm run build" };
+    }
+    if (!existsSync(metadataCachePath())) {
+        return { name: "mcp", status: "warn", detail: "tool cache empty, first run is proxy-only" };
+    }
+    return { name: "mcp", status: "ok", detail: "direct tools and proxy" };
+}
+async function probeCheck(runtime, model) {
+    if (!model)
+        return { name: "probe", status: "warn", detail: "skipped, no model to probe" };
+    const message = await runtime
+        .completeSimple(model, { messages: [{ role: "user", content: "ping", timestamp: Date.now() }] })
+        .catch((err) => ({ stopReason: "error", errorMessage: String(err) }));
+    if (message.stopReason === "error") {
+        return { name: "probe", status: "fail", detail: message.errorMessage ?? "request failed" };
+    }
+    return { name: "probe", status: "ok", detail: "the key works" };
+}
+function worst(checks) {
+    if (checks.some((check) => check.status === "fail"))
+        return "fail";
+    if (checks.some((check) => check.status === "warn"))
+        return "warn";
+    return "ok";
+}
+const MARK = {
+    ok: "✓",
+    warn: "!",
+    fail: "✗",
+    list: " ",
+};
+//# sourceMappingURL=doctor.js.map

package/dist/src/doctor.js.map

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

package/dist/src/env.js

@@ -0,0 +1,93 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+/**
+ * Testeiya's state directory, shared with the desktop app: a provider key saved
+ * in its Settings dialog works here with no extra step.
+ */
+export const TESTEIYA_HOME = join(homedir(), ".testeiya");
+/**
+ * This package's root, found by walking up to package.json — `dist/src` when
+ * built, `src` when run from source. Bundled files resolve from here.
+ */
+export const PACKAGE_ROOT = packageRoot();
+/**
+ * Where pi keeps its own state for this CLI. Deliberately not `~/.pi` — running
+ * `npx testeiya` must not write into a user's own pi installation.
+ */
+export const PI_STATE_DIR = join(TESTEIYA_HOME, "pi");
+// pi reads this at import time to place sessions and its MCP cache, and a
+// SessionManager is built before any session exists to read it from.
+process.env.PI_CODING_AGENT_DIR = PI_STATE_DIR;
+/**
+ * Fill gaps in process.env from `~/.testeiya/.env`, then from any `.env` found
+ * walking up from the working directory — so running in a repo picks up that
+ * repo's key. Exported variables always win; this only fills gaps.
+ *
+ * The walk starts at cwd, never at this file: an installed package sits under
+ * some node_modules whose ancestors are none of the agent's business, and
+ * silently adopting a key from there is a surprise, not a convenience.
+ *
+ * Returns the file each variable came from, which is what `doctor` reports.
+ */
+export function loadEnvFiles() {
+    const sources = new Map();
+    loadFile(join(TESTEIYA_HOME, ".env"), sources);
+    let dir = process.cwd();
+    for (let i = 0; i < 8; i++) {
+        loadFile(join(dir, ".env"), sources);
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return sources;
+}
+export function parseEnv(content) {
+    const out = {};
+    for (const raw of content.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const eq = line.indexOf("=");
+        if (eq === -1)
+            continue;
+        const key = line.slice(0, eq).trim();
+        let val = line.slice(eq + 1).trim();
+        if ((val.startsWith('"') && val.endsWith('"')) ||
+            (val.startsWith("'") && val.endsWith("'"))) {
+            val = val.slice(1, -1);
+        }
+        if (key)
+            out[key] = val;
+    }
+    return out;
+}
+function loadFile(path, sources) {
+    if (!existsSync(path))
+        return;
+    let vars;
+    try {
+        vars = parseEnv(readFileSync(path, "utf8"));
+    }
+    catch {
+        return;
+    }
+    for (const [key, value] of Object.entries(vars)) {
+        if (process.env[key] !== undefined)
+            continue;
+        process.env[key] = value;
+        sources.set(key, path);
+    }
+}
+function packageRoot() {
+    let dir = import.meta.dirname;
+    while (!existsSync(join(dir, "package.json"))) {
+        const parent = dirname(dir);
+        if (parent === dir)
+            return import.meta.dirname;
+        dir = parent;
+    }
+    return dir;
+}
+//# sourceMappingURL=env.js.map

package/dist/src/env.js.map

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

package/dist/src/mcp-extension.js

@@ -0,0 +1,9 @@
+import { mcpConfig, seedMetadataCache, vendorBundle } from "./mcp.js";
+/** The MCP adapter, configured from the environment, as a pi extension. */
+export default async function mcpExtension(pi) {
+    const config = mcpConfig();
+    await seedMetadataCache(config);
+    const { createMcpAdapter } = (await import(vendorBundle()));
+    await createMcpAdapter({ config })(pi);
+}
+//# sourceMappingURL=mcp-extension.js.map

package/dist/src/mcp-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-extension.js","sourceRoot":"","sources":["../../src/mcp-extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEtE,2EAA2E;AAC3E,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,YAAY,CAAC,EAAW;IACpD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEhC,MAAM,EAAE,gBAAgB,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC,CAEzD,CAAC;IACF,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC"}