@fraziym/axoniz 0.1.0

package/dist/core/intelligence/self_correction.js

@@ -0,0 +1,327 @@
+/**
+ * axoniz.core.intelligence.self_correction
+ * ==========================================
+ * Live Self-Correction Engine — Phase 1 of the AXONIZ dominance plan.
+ *
+ * After each tool result, the agent analyzes whether:
+ *   1. The result indicates an error
+ *   2. The action actually achieved its goal
+ *   3. The result is suspicious or unexpected
+ *
+ * If something went wrong, it:
+ *   - Detects the error type
+ *   - Generates a corrective action
+ *   - Signals the agent to replan instead of blindly continuing
+ *
+ * Port notes (Python → Node):
+ *   - `enum.Enum` → TypeScript string enums with identical `.value`s, so
+ *     `ErrorType.LOOP_DETECTED === "loop_detected"` just like Python's
+ *     `class ErrorType(str, Enum)` mixin.
+ *   - Python's `Tuple[ErrorType, str]` returns are arrays that additionally
+ *     expose `error_type` / `explanation` properties, so both tuple unpacking
+ *     (`const [t, e] = classify_error(...)`) and attribute access work.
+ */
+/* ── API Error types (from Hermes) ────────────────────────────────────────────── */
+export var APIFailoverReason;
+(function (APIFailoverReason) {
+    APIFailoverReason["AUTH"] = "auth";
+    APIFailoverReason["BILLING"] = "billing";
+    APIFailoverReason["RATE_LIMIT"] = "rate_limit";
+    APIFailoverReason["OVERLOADED"] = "overloaded";
+    APIFailoverReason["SERVER_ERROR"] = "server_error";
+    APIFailoverReason["TIMEOUT"] = "timeout";
+    APIFailoverReason["CONTEXT_OVERFLOW"] = "context_overflow";
+    APIFailoverReason["MODEL_NOT_FOUND"] = "model_not_found";
+    APIFailoverReason["FORMAT_ERROR"] = "format_error";
+    APIFailoverReason["UNKNOWN"] = "unknown";
+})(APIFailoverReason || (APIFailoverReason = {}));
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message || error.name;
+    if (typeof error === "string")
+        return error;
+    return String(error);
+}
+/** Classify an API error to determine recovery strategy. */
+export function classify_api_error(error) {
+    const msg = errorMessage(error).toLowerCase();
+    if (["context length", "context size", "token limit", "too many tokens"].some((p) => msg.includes(p))) {
+        return APIFailoverReason.CONTEXT_OVERFLOW;
+    }
+    if (["rate limit", "too many requests", "throttled"].some((p) => msg.includes(p))) {
+        return APIFailoverReason.RATE_LIMIT;
+    }
+    if (["insufficient credits", "billing", "quota exceeded"].some((p) => msg.includes(p))) {
+        return APIFailoverReason.BILLING;
+    }
+    if (["invalid api key", "unauthorized", "authentication"].some((p) => msg.includes(p))) {
+        return APIFailoverReason.AUTH;
+    }
+    if (["timeout", "connection refused", "deadline exceeded"].some((p) => msg.includes(p))) {
+        return APIFailoverReason.TIMEOUT;
+    }
+    if (["500", "502", "503", "504", "internal server error", "overloaded"].some((p) => msg.includes(p))) {
+        return APIFailoverReason.OVERLOADED;
+    }
+    return APIFailoverReason.UNKNOWN;
+}
+export const classifyApiError = classify_api_error;
+/* ── Error types ────────────────────────────────────────────────────────────── */
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["NONE"] = "none";
+    ErrorType["FILE_NOT_FOUND"] = "file_not_found";
+    ErrorType["PERMISSION"] = "permission_denied";
+    ErrorType["SYNTAX"] = "syntax_error";
+    ErrorType["IMPORT"] = "import_error";
+    ErrorType["RUNTIME"] = "runtime_error";
+    ErrorType["NETWORK"] = "network_error";
+    ErrorType["TOOL_UNKNOWN"] = "tool_unknown";
+    ErrorType["LOOP_DETECTED"] = "loop_detected";
+    ErrorType["TIMEOUT"] = "timeout";
+    ErrorType["EMPTY_RESULT"] = "empty_result";
+    ErrorType["UNEXPECTED"] = "unexpected";
+})(ErrorType || (ErrorType = {}));
+/* ─── Error patterns ──────────────────────────────────────────────────────────── */
+const _ERROR_PATTERNS = [
+    // File errors
+    [/no such file or directory/, ErrorType.FILE_NOT_FOUND, "The file path does not exist"],
+    [/filenotfounderror/, ErrorType.FILE_NOT_FOUND, "File not found"],
+    [/path does not exist/, ErrorType.FILE_NOT_FOUND, "Path does not exist"],
+    // Permissions
+    [/permission denied/, ErrorType.PERMISSION, "Insufficient permissions"],
+    [/access is denied/, ErrorType.PERMISSION, "Access denied (Windows)"],
+    // Syntax
+    [/syntaxerror/, ErrorType.SYNTAX, "Python syntax error in code"],
+    [/invalid syntax/, ErrorType.SYNTAX, "Invalid Python syntax"],
+    [/unexpected token/, ErrorType.SYNTAX, "Unexpected token"],
+    // Imports
+    [/modulenotfounderror/, ErrorType.IMPORT, "Python module not installed"],
+    [/importerror/, ErrorType.IMPORT, "Import failed"],
+    [/no module named/, ErrorType.IMPORT, "Module not found — needs pip install"],
+    // Runtime
+    [/traceback \(most recent/, ErrorType.RUNTIME, "Python exception occurred"],
+    [/typeerror/, ErrorType.RUNTIME, "Type error in code"],
+    [/nameerror/, ErrorType.RUNTIME, "Name not defined"],
+    [/attributeerror/, ErrorType.RUNTIME, "Attribute does not exist"],
+    [/valueerror/, ErrorType.RUNTIME, "Invalid value"],
+    [/indexerror/, ErrorType.RUNTIME, "Index out of range"],
+    [/keyerror/, ErrorType.RUNTIME, "Key not found"],
+    // Network
+    [/connection refused/, ErrorType.NETWORK, "Server is not running or wrong port"],
+    [/timeout/, ErrorType.TIMEOUT, "Operation timed out"],
+    [/urlopen error/, ErrorType.NETWORK, "Network request failed"],
+    [/name or service not known/, ErrorType.NETWORK, "DNS resolution failed"],
+    // Tool errors
+    [/\[error\]/, ErrorType.UNEXPECTED, "Tool reported an error"],
+    [/unknown tool/, ErrorType.TOOL_UNKNOWN, "Tool name not recognized"],
+    [/bad args/, ErrorType.UNEXPECTED, "Wrong arguments provided"],
+    // Loop detection
+    [/loop on '/, ErrorType.LOOP_DETECTED, "Agent is stuck in a loop"],
+    [/reached maximum steps/, ErrorType.LOOP_DETECTED, "Max steps exceeded"],
+];
+/**
+ * Classify what kind of error (if any) is in a tool result.
+ * Returns (ErrorType, explanation).
+ */
+export function classify_error(result) {
+    if (!result) {
+        return _classification(ErrorType.EMPTY_RESULT, "Tool returned no output");
+    }
+    const lower = result.toLowerCase();
+    // Quick success check — if result looks normal, skip pattern matching
+    if (result.length > 10 &&
+        !["error", "failed", "exception", "denied", "not found", "traceback"].some((kw) => lower.includes(kw))) {
+        return _classification(ErrorType.NONE, "");
+    }
+    for (const [pattern, err_type, explanation] of _ERROR_PATTERNS) {
+        if (pattern.test(lower)) {
+            return _classification(err_type, explanation);
+        }
+    }
+    return _classification(ErrorType.NONE, "");
+}
+function _classification(error_type, explanation) {
+    const tuple = [error_type, explanation];
+    return Object.assign(tuple, { error_type, explanation });
+}
+export const classifyError = classify_error;
+/* ─── Corrective actions ──────────────────────────────────────────────────────── */
+const _CORRECTIONS = {
+    [ErrorType.FILE_NOT_FOUND]: [
+        "Use file_list to check what actually exists in that directory",
+        "Check if the path uses the correct directory separator for this OS",
+        "Verify the workspace root with file_list(path='.')",
+    ],
+    [ErrorType.PERMISSION]: [
+        "Check if the file is locked by another process with shell_run('tasklist')",
+        "Try running the operation with a different path",
+        "Check file permissions with shell_run('icacls <path>')",
+    ],
+    [ErrorType.SYNTAX]: [
+        "Re-read the file to check for the syntax error location",
+        "Use code_lint to identify the exact line with the syntax error",
+        "Fix the syntax error before retrying",
+    ],
+    [ErrorType.IMPORT]: [
+        "Install the missing module with shell_run('pip install <module>')",
+        "Check if the virtual environment is activated",
+        "Verify the module name is correct",
+    ],
+    [ErrorType.RUNTIME]: [
+        "Read the full traceback to identify the exact failure point",
+        "Check the input values being passed to the failing function",
+        "Add error handling around the problematic code",
+    ],
+    [ErrorType.NETWORK]: [
+        "Check if the target server is running with shell_run",
+        "Verify the URL/port is correct",
+        "Try again after a short wait",
+    ],
+    [ErrorType.TIMEOUT]: [
+        "Increase timeout or use a simpler/faster alternative",
+        "Check if the process is hung",
+    ],
+    [ErrorType.LOOP_DETECTED]: [
+        "Stop and reassess the approach — current strategy is not working",
+        "Try a completely different tool or method for this step",
+        "Report the loop to the user and ask for guidance",
+    ],
+    [ErrorType.EMPTY_RESULT]: [
+        "Verify the target exists before running the operation",
+        "Check if the tool ran on the wrong path",
+    ],
+    [ErrorType.UNEXPECTED]: [
+        "Read the error message carefully and address the specific issue",
+        "Use a different approach to accomplish the same goal",
+    ],
+};
+/**
+ * Analyzes tool results in real-time and generates corrective guidance
+ * when something goes wrong.
+ *
+ * The agent calls analyze() after every tool execution. If an error is
+ * detected, it receives a correction dict telling it what to do next.
+ */
+export class SelfCorrector {
+    _corrections_made = 0;
+    _max;
+    _error_history = [];
+    constructor(max_corrections_per_session = 10) {
+        this._max = max_corrections_per_session;
+    }
+    get correctionsMade() {
+        return this._corrections_made;
+    }
+    get errorHistory() {
+        return this._error_history;
+    }
+    /**
+     * Analyze a tool result.
+     * Returns:
+     * {
+     *     "error_type":    ErrorType,
+     *     "has_error":     bool,
+     *     "explanation":   str,
+     *     "corrections":   list[str],    # what to do next
+     *     "should_replan": bool,         # should the agent change strategy?
+     *     "severity":      str,          # "low" / "medium" / "high" / "critical"
+     * }
+     */
+    analyze(tool_name, args, result, step_num = 0) {
+        void args; // Python accepted `args` and never used it.
+        const classification = classify_error(result);
+        const error_type = classification.error_type;
+        const explanation = classification.explanation;
+        const has_error = error_type !== ErrorType.NONE;
+        const corrections = (_CORRECTIONS[error_type] ?? []).slice(0, 3);
+        // Determine severity
+        let severity = "low";
+        if (error_type === ErrorType.LOOP_DETECTED) {
+            severity = "critical";
+        }
+        else if (error_type === ErrorType.PERMISSION ||
+            error_type === ErrorType.IMPORT ||
+            error_type === ErrorType.SYNTAX) {
+            severity = "high";
+        }
+        else if (error_type === ErrorType.RUNTIME || error_type === ErrorType.NETWORK) {
+            severity = "medium";
+        }
+        // Should we replan?
+        const should_replan = error_type === ErrorType.LOOP_DETECTED ||
+            error_type === ErrorType.PERMISSION ||
+            this._corrections_made >= this._max;
+        if (has_error) {
+            this._corrections_made += 1;
+            this._error_history.push({
+                step: step_num,
+                tool: tool_name,
+                error_type,
+                explanation,
+            });
+        }
+        return {
+            error_type,
+            has_error,
+            explanation,
+            corrections,
+            should_replan,
+            severity,
+        };
+    }
+    /** camelCase alias. */
+    analyzeResult(tool_name, args, result, step_num = 0) {
+        return this.analyze(tool_name, args, result, step_num);
+    }
+    /**
+     * Build a message the agent injects into the conversation
+     * to guide its next action.
+     */
+    build_correction_message(analysis, tool_name) {
+        if (!analysis.has_error) {
+            return "";
+        }
+        const lines = [
+            `[SELF-CORRECTION] Error detected after ${tool_name}:`,
+            `  Type:     ${analysis.error_type}`,
+            `  Problem:  ${analysis.explanation}`,
+            `  Severity: ${analysis.severity}`,
+        ];
+        if (analysis.corrections.length > 0) {
+            lines.push("  Suggested fixes:");
+            for (const c of analysis.corrections) {
+                lines.push(`    → ${c}`);
+            }
+        }
+        if (analysis.should_replan) {
+            lines.push("  IMPORTANT: Current approach is not working. Replan before continuing.");
+        }
+        lines.push("Address this issue before proceeding with the next step.");
+        return lines.join("\n");
+    }
+    /** camelCase alias. */
+    buildCorrectionMessage(analysis, tool_name) {
+        return this.build_correction_message(analysis, tool_name);
+    }
+    /** Summary of all errors corrected in this session. */
+    session_summary() {
+        if (this._error_history.length === 0) {
+            return "No errors encountered this session.";
+        }
+        const lines = [`Errors corrected: ${this._error_history.length}`];
+        for (const e of this._error_history.slice(-5)) {
+            lines.push(`  step ${e.step}: ${e.tool} → ${e.error_type} — ${e.explanation}`);
+        }
+        return lines.join("\n");
+    }
+    /** camelCase alias. */
+    sessionSummary() {
+        return this.session_summary();
+    }
+    reset() {
+        this._corrections_made = 0;
+        this._error_history = [];
+    }
+}
+//# sourceMappingURL=self_correction.js.map

package/dist/core/intelligence/self_correction.js.map

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

package/dist/core/intelligence/skill_distiller.d.ts

@@ -0,0 +1,100 @@
+/**
+ * axoniz.core.intelligence.skill_distiller
+ * ========================================
+ * The heart of AXONIZ's self-evolution.
+ * Analyzes successful trajectories and distills them into permanent 'Skills'.
+ *
+ * A 'Skill' in AXONIZ is a self-contained Python function registered as a tool.
+ * This is more robust than Hermes's skills (which are just prompt injections).
+ * AXONIZ skills are real code, making them faster, more reliable, and zero-context.
+ *
+ * Port notes (Python → Node):
+ *   - `analyze_session` / `_propose_skill` are `async` because the LLM call is
+ *     asynchronous in the Node port. `distill` stays synchronous (it only
+ *     writes a file).
+ *   - `SKILL_TEMPLATE.format(...)` → `renderSkillTemplate()`, a single-pass
+ *     `String.replace` over the same template text. A single pass matters:
+ *     LLM-generated `body`/`schema` values frequently contain `{`/`}` and must
+ *     never be re-scanned as placeholders.
+ *   - `time.strftime("%Y-%m-%d")` is LOCAL time → local date parts (NOT
+ *     `toISOString()`, which is UTC).
+ */
+export declare const SKILLS_DIR: string;
+/**
+ * Python value of the triple-quoted `SKILL_TEMPLATE` (i.e. it starts with a
+ * newline followed by `"""` and ends after the closing `)` plus a newline).
+ * Fill it with `renderSkillTemplate()`.
+ */
+export declare const SKILL_TEMPLATE = "\n\"\"\"\nAXONIZ Skill: {name}\nGenerated: {date}\nDescription: {description}\n\"\"\"\n\nfrom tools.registry import registry\n\ndef {name}({args_call}) -> str:\n    \"\"\"\n    {description}\n    \"\"\"\n    # Skill logic extracted from trajectory...\n    {body}\n\nregistry.register(\n    name=\"{name}\",\n    toolset=\"user_skills\",\n    schema={schema},\n    handler=lambda args, **kw: {name}(**args),\n    emoji=\"\uD83D\uDEE1\uFE0F\",\n)\n";
+export interface SkillTemplateVars {
+    name: string;
+    date: string;
+    description: string;
+    args_call: string;
+    body: string;
+    schema: string;
+}
+/**
+ * Replacement for Python's `SKILL_TEMPLATE.format(...)`.
+ * Unknown placeholders are left untouched (Python raised `KeyError` instead);
+ * the substitution is a single pass so injected code can never be interpreted
+ * as a placeholder.
+ */
+export declare function renderSkillTemplate(vars: SkillTemplateVars): string;
+/** camelCase alias. */
+export declare const render_skill_template: typeof renderSkillTemplate;
+export interface DistillProposal {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    code: string;
+    [k: string]: unknown;
+}
+/** The subset of the Agent surface the distiller needs. */
+export interface SkillAgent {
+    trajectory?: {
+        get_session_steps?(session_id: string): unknown[] | Promise<unknown[]>;
+        getSessionSteps?(session_id: string): unknown[] | Promise<unknown[]>;
+    };
+    generate_summary?(prompt: string): string | Promise<string>;
+    generateSummary?(prompt: string): string | Promise<string>;
+    _rebuild_llm?(): unknown;
+    _rebuildLlm?(): unknown;
+}
+export declare class SkillDistiller {
+    agent: SkillAgent | null;
+    constructor(agent?: SkillAgent | null);
+    /**
+     * Analyzes a completed trajectory session for 'skill-able' patterns.
+     * Criteria:
+     * 1. Task was successful.
+     * 2. Involved 5+ steps.
+     * 3. Pattern is repetitive or complex.
+     */
+    analyze_session(session_id: string): Promise<Record<string, unknown> | null>;
+    /** camelCase alias. */
+    analyzeSession(session_id: string): Promise<Record<string, unknown> | null>;
+    _propose_skill(steps: unknown[]): Promise<Record<string, unknown> | null>;
+    /** camelCase alias. */
+    _proposeSkill(steps: unknown[]): Promise<Record<string, unknown> | null>;
+    get pendingPath(): string;
+    getPendingSkills(): Record<string, DistillProposal>;
+    savePendingSkills(skills: Record<string, DistillProposal>): void;
+    propose(proposal: DistillProposal): void;
+    approve(name: string): boolean;
+    reject(name: string): boolean;
+    /** Writes the new skill to the skills directory. */
+    distill(proposal: DistillProposal): void;
+    _build_schema(proposal: DistillProposal): {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: Record<string, unknown>;
+            required: string[];
+        };
+    };
+    /** camelCase alias. */
+    _buildSchema(proposal: DistillProposal): ReturnType<SkillDistiller["_build_schema"]>;
+}
+//# sourceMappingURL=skill_distiller.d.ts.map

package/dist/core/intelligence/skill_distiller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill_distiller.d.ts","sourceRoot":"","sources":["../../../src/core/intelligence/skill_distiller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,eAAO,MAAM,UAAU,QAAmC,CAAC;AAO3D;;;;GAIG;AACH,eAAO,MAAM,cAAc,mcAuB1B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAMnE;AAED,uBAAuB;AACvB,eAAO,MAAM,qBAAqB,4BAAsB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE;QACX,iBAAiB,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,eAAe,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;KACtE,CAAC;IACF,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,YAAY,CAAC,IAAI,OAAO,CAAC;IACzB,WAAW,CAAC,IAAI,OAAO,CAAC;CACzB;AAcD,qBAAa,cAAc;IACzB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAEzB,YAAY,KAAK,GAAE,UAAU,GAAG,IAAW,EAE1C;IAED;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAmBjF;IAED,uBAAuB;IACvB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAE1E;IAEK,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAiC9E;IAED,uBAAuB;IACvB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAEvE;IACD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAOlD;IAED,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,CAE/D;IAED,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAKvC;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ7B;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO5B;IAED,oDAAoD;IACpD,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA2BvC;IAED,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG;QACxC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KACvF,CAWA;IAED,uBAAuB;IACvB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAEnF;CACF"}