@fraziym/axoniz 0.1.0

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

@@ -0,0 +1,84 @@
+/**
+ * AXONIZ ShadowGuard — The Reflex Engine.
+ * High-speed, low-memory intent detection and autonomous response.
+ * Acts like a 'Shadow Guard' that protects and serves instantly.
+ *
+ * Port notes (Python → Node):
+ *   - `threading.Thread(target=self.brain.load, daemon=True)` → `void
+ *     this.brain.load()` (Node is single-threaded; the load is I/O-ish).
+ *   - `transformers.pipeline("text-generation", ...)` → NOT AVAILABLE. See
+ *     `ReflexBrain.load()` for the documented degradation: the heuristic reflex
+ *     table is the working path, exactly as in Python when the pipeline failed
+ *     to load.
+ *   - `pyautogui` / `ctypes.windll` / `webbrowser` → `node:child_process` +
+ *     the `open` package (best effort, always unref'd and swallowed on error).
+ *   - `axoniz.core.optimizer.get_hardware_profile()` → `systeminformation`,
+ *     fetched once in the background and cached, so `process()` can stay
+ *     SYNCHRONOUS like the Python original.
+ *   - `process()` keeps its synchronous signature: every reflex action returns
+ *     a string immediately.
+ */
+/** The `transformers` text-generation pipeline signature `classify()` calls. */
+export type ReflexPipeline = (prompt: string, options: Record<string, unknown>) => unknown;
+/** A tiny brain for semantic intent classification. */
+export declare class ReflexBrain {
+    model_path: string;
+    _pipeline: ReflexPipeline | null;
+    _intent_map: Record<string, string[]>;
+    constructor(model_path: string);
+    /**
+     * FIDELITY LOSS: Python built a HuggingFace `transformers` text-generation
+     * pipeline here. No inference dependency for a transformers model directory is
+     * available in the Node dependency set, so this is a documented no-op that
+     * keeps the public API and the *behaviour* Python exhibited when loading
+     * failed: `_pipeline` stays null and `classify()` returns null, leaving the
+     * heuristic reflex table as the sole working path. An external caller may
+     * still inject a `_pipeline` to re-enable semantic classification.
+     */
+    load(): Promise<void>;
+    classify(text: string): string | null;
+    /** Async door for callers that can await a future inference backend. */
+    classify_async(text: string): Promise<string | null>;
+    /** camelCase alias. */
+    classifyAsync(text: string): Promise<string | null>;
+}
+export interface ReflexComputerTools {
+    screen_capture?(filename: string): unknown;
+    key_press?(keys: string): unknown;
+}
+/** The subset of the Agent surface the reflex layer touches. */
+export interface ReflexAgent {
+    health?: unknown;
+    computer_tools?: ReflexComputerTools;
+    computerTools?: ReflexComputerTools;
+}
+interface HardwareProfile {
+    cpu_count: number;
+    total_ram_gb: number;
+    has_gpu: boolean;
+}
+type ReflexAction = (match: RegExpExecArray | null) => string;
+export declare class ShadowGuardReflex {
+    agent: ReflexAgent | null;
+    brain: ReflexBrain | null;
+    reflexes: Array<[RegExp, ReflexAction]>;
+    _hw: HardwareProfile | null;
+    constructor(agent?: ReflexAgent | null);
+    /** Process text and return a response if a reflex was triggered. */
+    process(text: string): string | null;
+    _open_browser(match: RegExpExecArray | null): string;
+    _open_editor(match: RegExpExecArray | null): string;
+    _screenshot(match: RegExpExecArray | null): string;
+    /** Python's `datetime.now().strftime('%I:%M %p')`. */
+    _get_time(match: RegExpExecArray | null): string;
+    /** Python's `datetime.now().strftime('%A, %B %d, %Y')`. */
+    _get_date(match: RegExpExecArray | null): string;
+    _minimize_all(match: RegExpExecArray | null): string;
+    _lock_pc(match: RegExpExecArray | null): string;
+    _web_search(match: RegExpExecArray | null): string;
+    _check_hardware(match: RegExpExecArray | null): string;
+    /** Background replacement for `optimizer.get_hardware_profile()`. */
+    _refresh_hardware(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=reflex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reflex.d.ts","sourceRoot":"","sources":["../../../src/core/intelligence/reflex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAYH,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAE3F,uDAAuD;AACvD,qBAAa,WAAW;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,cAAc,GAAG,IAAI,CAAQ;IACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAMnC;IAEF,YAAY,UAAU,EAAE,MAAM,EAE7B;IAED;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ1B;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBpC;IAED,wEAAwE;IAClE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEzD;IAED,uBAAuB;IACvB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAElD;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,MAAM,CAAC;AAE9D,qBAAa,iBAAiB;IAC5B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAQ;IACjC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACxC,GAAG,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEnC,YAAY,KAAK,GAAE,WAAW,GAAG,IAAW,EAgD3C;IAED,oEAAoE;IACpE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBnC;IAID,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAkBnD;IAED,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CASlD;IAED,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAUjD;IAED,sDAAsD;IACtD,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAS/C;IAED,2DAA2D;IAC3D,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAM/C;IAED,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CA2BnD;IAED,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAe9C;IAED,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAQjD;IAED,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAYrD;IAED,qEAAqE;IAC/D,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAYvC;CACF"}

package/dist/core/intelligence/reflex.js

@@ -0,0 +1,344 @@
+/**
+ * AXONIZ ShadowGuard — The Reflex Engine.
+ * High-speed, low-memory intent detection and autonomous response.
+ * Acts like a 'Shadow Guard' that protects and serves instantly.
+ *
+ * Port notes (Python → Node):
+ *   - `threading.Thread(target=self.brain.load, daemon=True)` → `void
+ *     this.brain.load()` (Node is single-threaded; the load is I/O-ish).
+ *   - `transformers.pipeline("text-generation", ...)` → NOT AVAILABLE. See
+ *     `ReflexBrain.load()` for the documented degradation: the heuristic reflex
+ *     table is the working path, exactly as in Python when the pipeline failed
+ *     to load.
+ *   - `pyautogui` / `ctypes.windll` / `webbrowser` → `node:child_process` +
+ *     the `open` package (best effort, always unref'd and swallowed on error).
+ *   - `axoniz.core.optimizer.get_hardware_profile()` → `systeminformation`,
+ *     fetched once in the background and cached, so `process()` can stay
+ *     SYNCHRONOUS like the Python original.
+ *   - `process()` keeps its synchronous signature: every reflex action returns
+ *     a string immediately.
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import { debug, info, warn } from "../debug.js";
+/** A tiny brain for semantic intent classification. */
+export class ReflexBrain {
+    model_path;
+    _pipeline = null;
+    _intent_map = {
+        browser: ["open browser", "start chrome", "google search"],
+        editor: ["open vscode", "start coding", "edit files"],
+        screenshot: ["take screenshot", "capture screen"],
+        system: ["lock pc", "check ram", "hardware status"],
+        time: ["what time", "today's date"],
+    };
+    constructor(model_path) {
+        this.model_path = model_path;
+    }
+    /**
+     * FIDELITY LOSS: Python built a HuggingFace `transformers` text-generation
+     * pipeline here. No inference dependency for a transformers model directory is
+     * available in the Node dependency set, so this is a documented no-op that
+     * keeps the public API and the *behaviour* Python exhibited when loading
+     * failed: `_pipeline` stays null and `classify()` returns null, leaving the
+     * heuristic reflex table as the sole working path. An external caller may
+     * still inject a `_pipeline` to re-enable semantic classification.
+     */
+    async load() {
+        if (this._pipeline)
+            return;
+        if (!fs.existsSync(this.model_path)) {
+            warn(`[ShadowGuard] Reflex Brain path not found: ${this.model_path}`);
+            return;
+        }
+        info(`[ShadowGuard] Loading Reflex Brain: ${this.model_path}`);
+        this._pipeline = null;
+    }
+    classify(text) {
+        if (!this._pipeline)
+            return null;
+        // Simple semantic mapping
+        const prompt = `User: ${text}\nIntent:`;
+        try {
+            const out = this._pipeline(prompt, { max_new_tokens: 5, do_sample: false });
+            const first = (Array.isArray(out) ? out[0] : out);
+            const generated = String(first?.["generated_text"] ?? "");
+            const gen = generated.slice(prompt.length).toLowerCase().trim();
+            for (const [intent, keywords] of Object.entries(this._intent_map)) {
+                if (keywords.some((k) => gen.includes(k)) || gen.includes(intent)) {
+                    return intent;
+                }
+            }
+        }
+        catch {
+            /* classification is best effort */
+        }
+        return null;
+    }
+    /** Async door for callers that can await a future inference backend. */
+    async classify_async(text) {
+        return this.classify(text);
+    }
+    /** camelCase alias. */
+    classifyAsync(text) {
+        return this.classify_async(text);
+    }
+}
+export class ShadowGuardReflex {
+    agent;
+    brain = null;
+    reflexes;
+    _hw = null;
+    constructor(agent = null) {
+        this.agent = agent;
+        // Load from optional environment variable, no hardcoded path
+        const reflex_model = process.env.AXONIZ_REFLEX_MODEL;
+        if (reflex_model && fs.existsSync(reflex_model)) {
+            this.brain = new ReflexBrain(reflex_model);
+            // Python: threading.Thread(target=self.brain.load, daemon=True).start()
+            void this.brain.load();
+        }
+        // Heuristic fallback patterns
+        this.reflexes = [
+            [
+                /\b(open|start|launch)\b.*?\b(chrome|browser|google)\b/,
+                _named((m) => this._open_browser(m), "_open_browser"),
+            ],
+            [
+                /\b(open|start|launch)\b.*?\b(vscode|code|editor)\b/,
+                _named((m) => this._open_editor(m), "_open_editor"),
+            ],
+            [
+                /\b(take|grab|make)\b.*?\b(screenshot|picture|screen)\b/,
+                _named((m) => this._screenshot(m), "_screenshot"),
+            ],
+            [/\b(what|tell me)\b.*?\b(time|clock)\b/, _named((m) => this._get_time(m), "_get_time")],
+            [/\b(what|tell me)\b.*?\b(date|today)\b/, _named((m) => this._get_date(m), "_get_date")],
+            [
+                /\b(minimize|hide)\b.*?\b(all|windows)\b/,
+                _named((m) => this._minimize_all(m), "_minimize_all"),
+            ],
+            [/\b(lock)\b.*?\b(computer|pc|screen)\b/, _named((m) => this._lock_pc(m), "_lock_pc")],
+            [
+                /\b(search|find)\b.*?\b(for|on web)\b\s+(.*)/,
+                _named((m) => this._web_search(m), "_web_search"),
+            ],
+            [
+                /\b(how much|check)\b.*?\b(ram|memory|cpu|hardware)\b/,
+                _named((m) => this._check_hardware(m), "_check_hardware"),
+            ],
+        ];
+        // Python read the hardware profile synchronously from the optimizer; the
+        // Node equivalent (`systeminformation`) is async, so it is cached in the
+        // background while `process()`/`_check_hardware()` stay synchronous.
+        if (this.agent) {
+            void this._refresh_hardware();
+        }
+    }
+    /** Process text and return a response if a reflex was triggered. */
+    process(text) {
+        const low = text.toLowerCase().trim();
+        // 1. AI-Powered semantic check (Reflex Brain)
+        if (this.brain) {
+            const intent = this.brain.classify(low);
+            if (intent) {
+                info(`[ShadowGuard] AI Intent detected: ${intent}`);
+                if (intent === "browser")
+                    return this._open_browser(null);
+                if (intent === "editor")
+                    return this._open_editor(null);
+                if (intent === "screenshot")
+                    return this._screenshot(null);
+                if (intent === "system")
+                    return this._check_hardware(null);
+                if (intent === "time")
+                    return this._get_time(null);
+            }
+        }
+        // 2. Heuristic fallback patterns
+        for (const [pattern, action] of this.reflexes) {
+            const match = pattern.exec(low);
+            if (match) {
+                info(`[ShadowGuard] Reflex triggered: ${action.name}`);
+                return action(match);
+            }
+        }
+        return null;
+    }
+    /* ── Reflex Actions ──────────────────────────────────────────────────────── */
+    _open_browser(match) {
+        void match;
+        try {
+            if (process.platform === "win32") {
+                const child = spawn("cmd", ["/c", "start", "chrome"], {
+                    shell: true,
+                    detached: true,
+                    stdio: "ignore",
+                });
+                child.unref();
+            }
+            else {
+                const child = spawn("open", ["-a", "Google Chrome"], { detached: true, stdio: "ignore" });
+                child.unref();
+            }
+        }
+        catch (e) {
+            debug(`[ShadowGuard] open browser failed: ${errText(e)}`);
+        }
+        return "Opening Chrome, my liege.";
+    }
+    _open_editor(match) {
+        void match;
+        try {
+            const child = spawn("code", ["."], { shell: true, detached: true, stdio: "ignore" });
+            child.unref();
+        }
+        catch (e) {
+            debug(`[ShadowGuard] open editor failed: ${errText(e)}`);
+        }
+        return "VS Code is launching in the current workspace.";
+    }
+    _screenshot(match) {
+        void match;
+        const ct = this.agent?.computer_tools ?? this.agent?.computerTools;
+        if (this.agent && ct && typeof ct.screen_capture === "function") {
+            const res = String(ct.screen_capture("reflex_capture.png") ?? "");
+            if (res.includes("[OK]")) {
+                return "Screenshot captured and saved to workspace.";
+            }
+        }
+        return "I've captured the screen for you.";
+    }
+    /** Python's `datetime.now().strftime('%I:%M %p')`. */
+    _get_time(match) {
+        void match;
+        const d = new Date();
+        let h = d.getHours() % 12;
+        if (h === 0)
+            h = 12;
+        const hh = String(h).padStart(2, "0");
+        const mm = String(d.getMinutes()).padStart(2, "0");
+        const ap = d.getHours() < 12 ? "AM" : "PM";
+        return `It is currently ${hh}:${mm} ${ap}.`;
+    }
+    /** Python's `datetime.now().strftime('%A, %B %d, %Y')`. */
+    _get_date(match) {
+        void match;
+        const d = new Date();
+        const weekday = _WEEKDAYS[d.getDay()] ?? "";
+        const month = _MONTHS[d.getMonth()] ?? "";
+        return `Today is ${weekday}, ${month} ${String(d.getDate()).padStart(2, "0")}, ${d.getFullYear()}.`;
+    }
+    _minimize_all(match) {
+        void match;
+        if (process.platform === "win32") {
+            // Minimize the active window via the shell COM object (ctypes.windll is
+            // not available in Node).
+            try {
+                const child = spawn("powershell", ["-NoProfile", "-Command", "(New-Object -ComObject Shell.Application).MinimizeAll()"], { detached: true, stdio: "ignore" });
+                child.unref();
+            }
+            catch (e) {
+                debug(`[ShadowGuard] minimize failed: ${errText(e)}`);
+            }
+            // For all windows, win+d is better but requires the computer tools
+            const ct = this.agent?.computer_tools ?? this.agent?.computerTools;
+            if (this.agent && ct && typeof ct.key_press === "function") {
+                try {
+                    ct.key_press("winleft+d");
+                }
+                catch (e) {
+                    debug(`[ShadowGuard] key_press failed: ${errText(e)}`);
+                }
+                return "All windows minimized.";
+            }
+        }
+        return "Minimizing workspace.";
+    }
+    _lock_pc(match) {
+        void match;
+        if (process.platform === "win32") {
+            try {
+                const child = spawn("rundll32.exe", ["user32.dll,LockWorkStation"], {
+                    detached: true,
+                    stdio: "ignore",
+                });
+                child.unref();
+            }
+            catch (e) {
+                debug(`[ShadowGuard] lock failed: ${errText(e)}`);
+            }
+            return "System locked.";
+        }
+        return "I cannot lock this OS yet.";
+    }
+    _web_search(match) {
+        // Python: `match.group(3) if match.lastindex >= 3 else "nothing"`
+        const query = match && match[3] !== undefined ? match[3] : "nothing";
+        const url = `https://www.google.com/search?q=${query}`;
+        void import("open")
+            .then((m) => m.default(url))
+            .catch(() => undefined);
+        return `Searching the web for ${query}.`;
+    }
+    _check_hardware(match) {
+        void match;
+        if (this.agent && this.agent.health !== undefined) {
+            if (this._hw) {
+                const hw = this._hw;
+                return `You have ${hw.cpu_count} CPU cores and ${hw.total_ram_gb}GB of RAM. ${hw.has_gpu ? "GPU detected." : "No GPU found."}`;
+            }
+            return "Hardware check failed, but the system is running stable.";
+        }
+        return "System resources are within optimal bounds.";
+    }
+    /** Background replacement for `optimizer.get_hardware_profile()`. */
+    async _refresh_hardware() {
+        try {
+            const si = await import("systeminformation");
+            const [cpu, mem, gfx] = await Promise.all([si.cpu(), si.mem(), si.graphics()]);
+            this._hw = {
+                cpu_count: Number(cpu.processors ?? cpu.cores ?? 0),
+                total_ram_gb: Math.round(Number(mem.total ?? 0) / 1024 ** 3),
+                has_gpu: Array.isArray(gfx.controllers) && gfx.controllers.length > 0,
+            };
+        }
+        catch (e) {
+            debug(`[ShadowGuard] Hardware probe failed: ${errText(e)}`);
+        }
+    }
+}
+/* ── helpers ──────────────────────────────────────────────────────────────── */
+const _WEEKDAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+const _MONTHS = [
+    "January",
+    "February",
+    "March",
+    "April",
+    "May",
+    "June",
+    "July",
+    "August",
+    "September",
+    "October",
+    "November",
+    "December",
+];
+/** Give a wrapper the Python action's `__name__` so logs stay identical. */
+function _named(fn, name) {
+    try {
+        Object.defineProperty(fn, "name", { value: name, configurable: true });
+    }
+    catch {
+        /* frozen function objects are fine — the log just loses the name */
+    }
+    return fn;
+}
+function errText(e) {
+    if (e instanceof Error)
+        return e.message || e.name;
+    if (typeof e === "string")
+        return e;
+    return String(e);
+}
+//# sourceMappingURL=reflex.js.map

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

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

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

@@ -0,0 +1,121 @@
+/**
+ * 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.
+ */
+export declare enum APIFailoverReason {
+    AUTH = "auth",
+    BILLING = "billing",
+    RATE_LIMIT = "rate_limit",
+    OVERLOADED = "overloaded",
+    SERVER_ERROR = "server_error",
+    TIMEOUT = "timeout",
+    CONTEXT_OVERFLOW = "context_overflow",
+    MODEL_NOT_FOUND = "model_not_found",
+    FORMAT_ERROR = "format_error",
+    UNKNOWN = "unknown"
+}
+/** Classify an API error to determine recovery strategy. */
+export declare function classify_api_error(error: unknown): APIFailoverReason;
+export declare const classifyApiError: typeof classify_api_error;
+export declare enum ErrorType {
+    NONE = "none",
+    FILE_NOT_FOUND = "file_not_found",
+    PERMISSION = "permission_denied",
+    SYNTAX = "syntax_error",
+    IMPORT = "import_error",
+    RUNTIME = "runtime_error",
+    NETWORK = "network_error",
+    TOOL_UNKNOWN = "tool_unknown",
+    LOOP_DETECTED = "loop_detected",
+    TIMEOUT = "timeout",
+    EMPTY_RESULT = "empty_result",
+    UNEXPECTED = "unexpected"
+}
+/** `(ErrorType, explanation)` — an array that also carries both fields by name. */
+export type ErrorClassification = [ErrorType, string] & {
+    error_type: ErrorType;
+    explanation: string;
+};
+/**
+ * Classify what kind of error (if any) is in a tool result.
+ * Returns (ErrorType, explanation).
+ */
+export declare function classify_error(result: string): ErrorClassification;
+export declare const classifyError: typeof classify_error;
+export interface ErrorHistoryEntry {
+    step: number;
+    tool: string;
+    error_type: ErrorType;
+    explanation: string;
+}
+/** Shape of what `SelfCorrector.analyze()` returns (Python dict keys preserved). */
+export interface CorrectionAnalysis {
+    error_type: ErrorType;
+    has_error: boolean;
+    explanation: string;
+    corrections: string[];
+    should_replan: boolean;
+    severity: string;
+}
+/**
+ * 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 declare class SelfCorrector {
+    _corrections_made: number;
+    _max: number;
+    _error_history: ErrorHistoryEntry[];
+    constructor(max_corrections_per_session?: number);
+    get correctionsMade(): number;
+    get errorHistory(): ErrorHistoryEntry[];
+    /**
+     * 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: string, args: Record<string, unknown>, result: string, step_num?: number): CorrectionAnalysis;
+    /** camelCase alias. */
+    analyzeResult(tool_name: string, args: Record<string, unknown>, result: string, step_num?: number): CorrectionAnalysis;
+    /**
+     * Build a message the agent injects into the conversation
+     * to guide its next action.
+     */
+    build_correction_message(analysis: CorrectionAnalysis, tool_name: string): string;
+    /** camelCase alias. */
+    buildCorrectionMessage(analysis: CorrectionAnalysis, tool_name: string): string;
+    /** Summary of all errors corrected in this session. */
+    session_summary(): string;
+    /** camelCase alias. */
+    sessionSummary(): string;
+    reset(): void;
+}
+//# sourceMappingURL=self_correction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"self_correction.d.ts","sourceRoot":"","sources":["../../../src/core/intelligence/self_correction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,OAAO,YAAY;CACpB;AAQD,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAuBpE;AAED,eAAO,MAAM,gBAAgB,2BAAqB,CAAC;AAInD,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,cAAc,mBAAmB;IACjC,UAAU,sBAAsB;IAChC,MAAM,iBAAiB;IACvB,MAAM,iBAAiB;IACvB,OAAO,kBAAkB;IACzB,OAAO,kBAAkB;IACzB,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;CAC1B;AA0CD,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG;IACtD,UAAU,EAAE,SAAS,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAwBlE;AAOD,eAAO,MAAM,aAAa,uBAAiB,CAAC;AAwD5C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,iBAAiB,SAAK;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,iBAAiB,EAAE,CAAM;IAEzC,YAAY,2BAA2B,SAAK,EAE3C;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,YAAY,IAAI,iBAAiB,EAAE,CAEtC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,SAAI,GACX,kBAAkB,CA+CpB;IAED,uBAAuB;IACvB,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,SAAI,GACX,kBAAkB,CAEpB;IAED;;;OAGG;IACH,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAsBhF;IAED,uBAAuB;IACvB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;IAED,uDAAuD;IACvD,eAAe,IAAI,MAAM,CASxB;IAED,uBAAuB;IACvB,cAAc,IAAI,MAAM,CAEvB;IAED,KAAK,IAAI,IAAI,CAGZ;CACF"}