koneck 2.33.0 → 2.35.0

package/dist/lsp.js

@@ -0,0 +1,473 @@
+/**
+ * Asking the language instead of grepping for it.
+ *
+ * "Where is this defined", "what calls this", "what type is this" are questions with exact answers,
+ * and an agent that greps for them gets a list of places the name appears — comments, strings, a
+ * different symbol with the same name in another module, and not the definition if it is re-exported.
+ * Every wrong entry costs a file read, and the one that matters may not be in the list at all.
+ *
+ * Two providers, because there is no single one that is both correct and always present:
+ *
+ *   - A real language server, if one is on PATH. Speaks LSP over stdio, works for whatever language
+ *     the server is for, and is the authority when it exists.
+ *   - The workspace's own TypeScript, otherwise. A TypeScript or JavaScript project being worked on
+ *     almost always has `typescript` in its node_modules, and its compiler API answers the same
+ *     questions with the same precision for those files.
+ *
+ * KONECK installs with `npm i -g koneck`, so neither is a dependency of KONECK. Requiring a global
+ * language-server install would mean the feature was broken on the day most people first tried it,
+ * and bundling a compiler for one language would put megabytes into every install to serve some of
+ * them. What is present is used; what is absent is reported as absent, which is a usable answer.
+ */
+import { spawn } from 'child_process';
+import { createRequire } from 'module';
+import path from 'path';
+import { existsSync } from 'fs';
+import { readFile } from 'fs/promises';
+/**
+ * Servers KONECK knows how to start, in the order they are preferred.
+ *
+ * Only ones that speak LSP over stdio and need no configuration file to do it: a server that must
+ * be configured before it will answer is not something to start behind somebody's back.
+ */
+export const SERVERS = [
+    { command: 'typescript-language-server', args: ['--stdio'],
+        extensions: ['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs'], language: 'typescript' },
+    { command: 'pyright-langserver', args: ['--stdio'], extensions: ['.py', '.pyi'], language: 'python' },
+    { command: 'pylsp', args: [], extensions: ['.py', '.pyi'], language: 'python' },
+    { command: 'gopls', args: ['serve'], extensions: ['.go'], language: 'go' },
+    { command: 'rust-analyzer', args: [], extensions: ['.rs'], language: 'rust' },
+    { command: 'clangd', args: [], extensions: ['.c', '.h', '.cc', '.cpp', '.hpp'], language: 'c' },
+    { command: 'jdtls', args: [], extensions: ['.java'], language: 'java' },
+];
+function onPath(command) {
+    const dirs = (process.env['PATH'] ?? '').split(path.delimiter).filter(Boolean);
+    const exts = process.platform === 'win32'
+        ? (process.env['PATHEXT'] ?? '.EXE;.CMD;.BAT').split(';')
+        : [''];
+    return dirs.some(dir => exts.some(ext => existsSync(path.join(dir, command + ext))));
+}
+/** The server for a file, or nothing. */
+export function serverFor(file, has = onPath) {
+    const ext = path.extname(file).toLowerCase();
+    return SERVERS.find(s => s.extensions.includes(ext) && has(s.command)) ?? null;
+}
+/* ── LSP over stdio ───────────────────────────────────────────────────────────────────────── */
+/**
+ * The framing, which is the part that is easy to get subtly wrong.
+ *
+ * Every message is `Content-Length: N\r\n\r\n` then exactly N BYTES of JSON — bytes, not
+ * characters. A header counted in characters truncates the first message containing anything
+ * outside ASCII, which in practice means the first identifier with an accent in it.
+ */
+export function frame(message) {
+    const body = Buffer.from(JSON.stringify(message), 'utf8');
+    return Buffer.concat([Buffer.from(`Content-Length: ${body.length}\r\n\r\n`, 'ascii'), body]);
+}
+/** Pulls whole messages out of a growing buffer, leaving any partial one behind. */
+export function unframe(buffer) {
+    const messages = [];
+    let rest = buffer;
+    for (;;) {
+        const split = rest.indexOf('\r\n\r\n');
+        if (split === -1)
+            break;
+        const header = rest.subarray(0, split).toString('ascii');
+        const match = /content-length:\s*(\d+)/i.exec(header);
+        if (!match) {
+            rest = rest.subarray(split + 4);
+            continue;
+        }
+        const length = Number(match[1]);
+        const start = split + 4;
+        if (rest.length < start + length)
+            break; // the body has not all arrived
+        try {
+            messages.push(JSON.parse(rest.subarray(start, start + length).toString('utf8')));
+        }
+        catch { /* a malformed body is dropped rather than desynchronising the stream */ }
+        rest = Buffer.from(rest.subarray(start + length));
+    }
+    return { messages, rest };
+}
+const fileUri = (file) => 'file://' + path.resolve(file).split(path.sep).join('/');
+const fromUri = (uri) => decodeURIComponent(uri.replace(/^file:\/\//, ''));
+/** One conversation with one server, for one question. Started, asked, and shut down. */
+class Session {
+    root;
+    child;
+    buffer = Buffer.alloc(0);
+    nextId = 1;
+    waiting = new Map();
+    diagnostics = new Map();
+    constructor(spec, root) {
+        this.root = root;
+        this.child = spawn(spec.command, spec.args, {
+            cwd: root, stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.child.stdout.on('data', (chunk) => {
+            this.buffer = Buffer.concat([this.buffer, chunk]);
+            const { messages, rest } = unframe(this.buffer);
+            this.buffer = Buffer.from(rest);
+            for (const message of messages)
+                this.receive(message);
+        });
+        // A server's stderr is its own business; reading it stops the pipe filling and blocking it.
+        this.child.stderr.on('data', () => { });
+        this.child.on('error', () => { for (const r of this.waiting.values())
+            r(null); });
+    }
+    receive(message) {
+        const m = message;
+        if (m.method === 'textDocument/publishDiagnostics') {
+            const p = m.params;
+            if (p?.uri)
+                this.diagnostics.set(p.uri, p.diagnostics ?? []);
+            return;
+        }
+        if (typeof m.id === 'number' && this.waiting.has(m.id)) {
+            this.waiting.get(m.id)(m.result ?? null);
+            this.waiting.delete(m.id);
+        }
+    }
+    notify(method, params) {
+        try {
+            this.child.stdin.write(frame({ jsonrpc: '2.0', method, params }));
+        }
+        catch { /* gone */ }
+    }
+    request(method, params, timeoutMs) {
+        const id = this.nextId++;
+        return new Promise(resolve => {
+            const timer = setTimeout(() => { this.waiting.delete(id); resolve(null); }, timeoutMs);
+            this.waiting.set(id, value => { clearTimeout(timer); resolve(value); });
+            try {
+                this.child.stdin.write(frame({ jsonrpc: '2.0', id, method, params }));
+            }
+            catch {
+                clearTimeout(timer);
+                resolve(null);
+            }
+        });
+    }
+    diagnosticsFor(uri) { return this.diagnostics.get(uri) ?? []; }
+    async start(timeoutMs) {
+        const result = await this.request('initialize', {
+            processId: process.pid,
+            rootUri: fileUri(this.root),
+            workspaceFolders: [{ uri: fileUri(this.root), name: path.basename(this.root) }],
+            capabilities: {
+                textDocument: {
+                    definition: { linkSupport: true },
+                    references: {},
+                    hover: { contentFormat: ['plaintext', 'markdown'] },
+                    publishDiagnostics: {},
+                },
+            },
+        }, timeoutMs);
+        if (result === null)
+            return false;
+        this.notify('initialized', {});
+        return true;
+    }
+    stop() {
+        this.notify('shutdown', null);
+        this.notify('exit', null);
+        // Killed rather than waited for: the answer has already been given, and a server that is slow
+        // to exit must not hold up the tool that asked.
+        setTimeout(() => { try {
+            this.child.kill('SIGKILL');
+        }
+        catch { /* gone */ } }, 200).unref?.();
+    }
+}
+/** How long a server gets. Generous for a first request, which may include indexing. */
+export const LSP_TIMEOUT_MS = 20_000;
+function locationsFrom(result, source) {
+    const raw = Array.isArray(result) ? result : result == null ? [] : [result];
+    const out = [];
+    for (const item of raw) {
+        const r = item;
+        const uri = r.uri ?? r.targetUri;
+        const start = (r.range ?? r.targetSelectionRange)?.start;
+        if (!uri || !start)
+            continue;
+        out.push({ path: fromUri(uri) || source, line: start.line + 1, column: start.character + 1 });
+    }
+    return out;
+}
+/** Asks a real language server. Returns null when there is none, or it never answered. */
+export async function askServer(kind, file, at, root) {
+    const spec = serverFor(file);
+    if (!spec)
+        return null;
+    const session = new Session(spec, root);
+    try {
+        if (!await session.start(LSP_TIMEOUT_MS))
+            return null;
+        const text = await readFile(file, 'utf8').catch(() => '');
+        const uri = fileUri(file);
+        session.notify('textDocument/didOpen', {
+            textDocument: { uri, languageId: spec.language, version: 1, text },
+        });
+        if (kind === 'diagnostics') {
+            // Diagnostics arrive unsolicited after didOpen, so this waits rather than asks.
+            await new Promise(r => setTimeout(r, 1_500));
+            const problems = session.diagnosticsFor(uri).map(d => {
+                const p = d;
+                const start = p.range?.start ?? { line: 0, character: 0 };
+                return {
+                    path: file, line: start.line + 1, column: start.character + 1,
+                    severity: (p.severity === 1 ? 'error' : p.severity === 2 ? 'warning' : 'info'),
+                    message: String(p.message ?? ''),
+                };
+            });
+            return { kind, via: 'language-server', found: [], problems };
+        }
+        const method = kind === 'definition' ? 'textDocument/definition'
+            : kind === 'references' ? 'textDocument/references'
+                : 'textDocument/hover';
+        const params = { textDocument: { uri }, position: at };
+        if (kind === 'references')
+            params['context'] = { includeDeclaration: false };
+        const result = await session.request(method, params, LSP_TIMEOUT_MS);
+        if (result === null)
+            return null;
+        if (kind === 'hover') {
+            const h = result;
+            const contents = h?.contents;
+            const info = typeof contents === 'string' ? contents
+                : Array.isArray(contents) ? contents.map(c => typeof c === 'string' ? c : String(c.value ?? '')).join('\n')
+                    : String(contents?.value ?? '');
+            return { kind, via: 'language-server', found: [], info: info.trim() };
+        }
+        return { kind, via: 'language-server', found: locationsFrom(result, file) };
+    }
+    finally {
+        session.stop();
+    }
+}
+/* ── the workspace's own TypeScript ───────────────────────────────────────────────────────── */
+const TS_EXTENSIONS = ['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs'];
+/** The workspace's typescript, if it has one. Never KONECK's: this is about their code. */
+export function workspaceTypeScript(root) {
+    try {
+        const require = createRequire(path.join(path.resolve(root), 'package.json'));
+        return require('typescript');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The files the compiler should know about.
+ *
+ * One file is enough for a definition or a hover — the compiler follows imports from disk as it
+ * needs them. It is NOT enough for references, which live in the files that do the referencing: a
+ * one-file program answered "0 references" for a function used in eleven places, and a confidently
+ * wrong zero is worse than an admission of ignorance. So a references query loads the project's
+ * own file list from tsconfig.json, and pays the seconds that costs.
+ */
+function programFiles(ts, root, absolute, wide) {
+    if (!wide)
+        return [absolute];
+    const configPath = ts.findConfigFile(path.resolve(root), ts.sys.fileExists, 'tsconfig.json');
+    if (!configPath)
+        return [absolute];
+    try {
+        const read = ts.readConfigFile(configPath, ts.sys.readFile);
+        if (read.error)
+            return [absolute];
+        const parsed = ts.parseJsonConfigFileContent(read.config, ts.sys, path.dirname(configPath));
+        // Capped: a repository with tens of thousands of files would spend a minute here, and the
+        // answer to "what references this" is not worth a minute.
+        const files = parsed.fileNames.slice(0, MAX_PROJECT_FILES);
+        return files.includes(absolute) ? files : [absolute, ...files];
+    }
+    catch {
+        return [absolute];
+    }
+}
+/** Above this, a references query loads the file alone and says the answer may be partial. */
+export const MAX_PROJECT_FILES = 3_000;
+/**
+ * Asks the compiler directly.
+ *
+ * The program is as small as the question allows: see programFiles.
+ */
+export async function askTypeScript(kind, file, at, root) {
+    if (!TS_EXTENSIONS.includes(path.extname(file).toLowerCase()))
+        return null;
+    const ts = workspaceTypeScript(root);
+    if (!ts)
+        return null;
+    const absolute = path.resolve(file);
+    const text = await readFile(absolute, 'utf8').catch(() => null);
+    if (text === null)
+        return null;
+    // Only a references query needs the whole project; everything else is answered from one file.
+    const files = programFiles(ts, root, absolute, kind === 'references');
+    const host = {
+        getScriptFileNames: () => files,
+        getScriptVersion: () => '1',
+        getScriptSnapshot: name => {
+            if (name === absolute)
+                return ts.ScriptSnapshot.fromString(text);
+            const source = ts.sys.readFile(name);
+            return source === undefined ? undefined : ts.ScriptSnapshot.fromString(source);
+        },
+        getCurrentDirectory: () => path.resolve(root),
+        getCompilationSettings: () => ({
+            allowJs: true, checkJs: false, target: ts.ScriptTarget.ESNext,
+            module: ts.ModuleKind.ESNext, moduleResolution: ts.ModuleResolutionKind.Bundler,
+            jsx: ts.JsxEmit.ReactJSX, allowImportingTsExtensions: true, noEmit: true,
+        }),
+        getDefaultLibFileName: options => ts.getDefaultLibFilePath(options),
+        fileExists: ts.sys.fileExists,
+        readFile: ts.sys.readFile,
+        readDirectory: ts.sys.readDirectory,
+        directoryExists: ts.sys.directoryExists,
+        getDirectories: ts.sys.getDirectories,
+    };
+    const service = ts.createLanguageService(host, ts.createDocumentRegistry());
+    const lines = text.split('\n');
+    const offset = lines.slice(0, at.line).reduce((n, l) => n + l.length + 1, 0) + at.character;
+    const lineText = (n) => lines[n - 1]?.trim();
+    const place = (name, start) => {
+        const source = name === absolute ? text : (ts.sys.readFile(name) ?? '');
+        const before = source.slice(0, start).split('\n');
+        return {
+            path: path.relative(path.resolve(root), name) || name,
+            line: before.length,
+            column: (before.at(-1)?.length ?? 0) + 1,
+            ...(name === absolute ? { text: lineText(before.length) } : {}),
+        };
+    };
+    if (kind === 'definition') {
+        const found = service.getDefinitionAtPosition(absolute, offset) ?? [];
+        return { kind, via: 'typescript',
+            found: found.map(d => place(d.fileName, d.textSpan.start)) };
+    }
+    if (kind === 'references') {
+        const found = service.getReferencesAtPosition(absolute, offset) ?? [];
+        return { kind, via: 'typescript',
+            // The declaration comes back in the list. It is not a caller, so it is dropped — by
+            // position rather than by a flag, which this TypeScript version does not expose.
+            found: found
+                .filter(r => !(r.fileName === absolute && r.textSpan.start <= offset
+                && offset < r.textSpan.start + r.textSpan.length))
+                .map(r => place(r.fileName, r.textSpan.start)),
+            ...(files.length === 1
+                ? { note: 'Answered from this file alone — no tsconfig.json was found, so references in '
+                        + 'other files were not visible. Searching the text would be more complete.' }
+                : {}) };
+    }
+    if (kind === 'hover') {
+        const info = service.getQuickInfoAtPosition(absolute, offset);
+        const parts = info ? ts.displayPartsToString(info.displayParts) : '';
+        const doc = info?.documentation ? ts.displayPartsToString(info.documentation) : '';
+        return { kind, via: 'typescript', found: [],
+            info: [parts, doc].filter(Boolean).join('\n\n') };
+    }
+    const problems = [
+        ...service.getSyntacticDiagnostics(absolute),
+        ...service.getSemanticDiagnostics(absolute),
+    ].map(d => {
+        const start = d.start ?? 0;
+        const before = text.slice(0, start).split('\n');
+        return {
+            path: path.relative(path.resolve(root), absolute) || absolute,
+            line: before.length,
+            column: (before.at(-1)?.length ?? 0) + 1,
+            severity: (d.category === ts.DiagnosticCategory.Error ? 'error'
+                : d.category === ts.DiagnosticCategory.Warning ? 'warning' : 'info'),
+            message: ts.flattenDiagnosticMessageText(d.messageText, ' '),
+        };
+    });
+    return { kind, via: 'typescript', found: [], problems };
+}
+/* ── the one question ─────────────────────────────────────────────────────────────────────── */
+/**
+ * Finds a symbol's position in a file by name, so a caller need not count characters.
+ *
+ * A tool call saying "where is `resolveEndpoint` defined" is what an agent can actually produce;
+ * a line and character offset is what it would have to guess at.
+ */
+export function findSymbol(text, symbol) {
+    const lines = text.split('\n');
+    const pattern = new RegExp(`\\b${symbol.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`);
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip a line that is only a comment: the declaration is what is wanted, and a mention in
+        // prose above it is the commonest first match.
+        if (/^\s*(\/\/|\*|#)/.test(line))
+            continue;
+        const match = pattern.exec(line);
+        if (match)
+            return { line: i, character: match.index };
+    }
+    return null;
+}
+/**
+ * The answer, from whichever provider can give one.
+ *
+ * A real server first, because it is the authority for its language and knows about the whole
+ * project. The compiler second, because it is nearly always there for the files it covers. Neither
+ * being available is reported plainly — an agent told "no language support here" greps, which is
+ * what it would have done anyway; an agent told nothing assumes an empty answer means no results.
+ */
+export async function ask(kind, file, symbolOrPosition, root) {
+    const absolute = path.resolve(root, file);
+    if (!existsSync(absolute)) {
+        return { kind, via: 'none', found: [], note: `${file} is not a file in this workspace` };
+    }
+    /*
+     * Whether anything can answer at all, before looking for the symbol.
+     *
+     * The other way round produces a misleading answer: hunting for the symbol first meant a
+     * markdown file came back as "nothing does not appear in notes.md" — which is both wrong (the
+     * word is right there) and beside the point. It was wrong because findSymbol skips comment lines
+     * and `#` opens a comment in most languages but a heading in that one; and beside the point
+     * because no provider covers markdown, so the symbol's whereabouts were never the issue.
+     */
+    const ext = path.extname(absolute).toLowerCase();
+    const supported = serverFor(absolute) !== null
+        || (TS_EXTENSIONS.includes(ext) && workspaceTypeScript(root) !== null);
+    if (!supported) {
+        return {
+            kind, via: 'none', found: [],
+            note: TS_EXTENSIONS.includes(ext)
+                ? `No language support for ${file}: this workspace has no typescript installed and no `
+                    + `language server is on PATH. Searching the text is the alternative.`
+                : `No language server on PATH for ${ext || 'that kind of file'}. `
+                    + `Searching the text is the alternative.`,
+        };
+    }
+    let at;
+    if (typeof symbolOrPosition === 'string') {
+        const text = await readFile(absolute, 'utf8').catch(() => '');
+        const found = findSymbol(text, symbolOrPosition);
+        if (!found && kind !== 'diagnostics') {
+            return { kind, via: 'none', found: [],
+                note: `"${symbolOrPosition}" does not appear in ${file}` };
+        }
+        at = found ?? { line: 0, character: 0 };
+    }
+    else {
+        at = symbolOrPosition;
+    }
+    const viaServer = await askServer(kind, absolute, at, root).catch(() => null);
+    if (viaServer)
+        return viaServer;
+    const viaTs = await askTypeScript(kind, absolute, at, root).catch(() => null);
+    if (viaTs)
+        return viaTs;
+    // A provider was available and did not answer — a server that failed to start, or a compiler
+    // that could not load the file. Different from "not supported", and worth saying so.
+    return {
+        kind, via: 'none', found: [],
+        note: `Nothing could answer about ${file}: the language support for it is present but did not `
+            + `respond. Searching the text is the alternative.`,
+    };
+}
+//# sourceMappingURL=lsp.js.map

package/dist/lsp.js.map

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

package/dist/router-failure.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Reading a router's own account of what it tried.
+ *
+ * A gateway fronting many models reports failure as one message listing every upstream it
+ * attempted, which arrives looking like a single opaque error:
+ *
+ *   Stream ended before producing a non-ping SSE event
+ *   [oc/deepseek-v4-flash-free (400), oc/nemotron-3-ultra-free (502)] (bad_gateway)
+ *
+ * Treated as one failure that is worth retrying, which is what it looks like, the run retries
+ * against the same exhausted pool and then gives up — reported three times in a row by the same
+ * person, on the same alias, with the same two models.
+ *
+ * The list is the useful part, and the status beside each name says something different about each:
+ *
+ *   - 5xx is the upstream being unwell. Retrying can reach a healthy one.
+ *   - 429 is a quota. Retrying can work once it resets, which is usually seconds.
+ *   - 4xx other than 429 is the REQUEST being refused, and it will be refused identically every
+ *     time. On a free model it is almost always the prompt exceeding a context window far smaller
+ *     than the alias implies. Retrying that is time spent to arrive at the same answer.
+ *
+ * So a pool where every attempt was refused is not transient, however transient the wrapper says
+ * it was, and saying which models failed and how turns "it broke again" into a decision the person
+ * can actually make.
+ */
+export interface RouterAttempt {
+    model: string;
+    status: number;
+}
+export interface RouterFailure {
+    attempts: RouterAttempt[];
+    /** True when at least one upstream failure could plausibly succeed on another try. */
+    worthRetrying: boolean;
+    /** What to tell the person, when there is something worth telling them. */
+    advice: string;
+}
+/**
+ * The per-model attempts a router listed, if it listed any.
+ *
+ * Deliberately narrow: it matches a bracketed list of `name (status)` pairs and nothing else,
+ * because guessing at the shape of a message from an unknown gateway is how a parser starts
+ * inventing failures that never happened.
+ */
+export declare function parseRouterAttempts(message: string): RouterAttempt[];
+/** Whether one upstream status could plausibly go differently next time. */
+export declare function statusWorthRetrying(status: number): boolean;
+/** What a status means, in words a person can act on. */
+export declare function describeStatus(status: number): string;
+/**
+ * Reads a router failure, if that is what this is.
+ *
+ * Returns null for anything that does not carry a per-model list, so ordinary errors keep their
+ * ordinary handling rather than being re-interpreted by a parser that wanted to find something.
+ */
+export declare function readRouterFailure(message: string): RouterFailure | null;
+//# sourceMappingURL=router-failure.d.ts.map

package/dist/router-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-failure.d.ts","sourceRoot":"","sources":["../src/router-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,sFAAsF;IACtF,aAAa,EAAE,OAAO,CAAC;IACvB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAapE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAuCvE"}