@fraziym/axoniz 0.1.0

package/dist/core/authority.js

@@ -0,0 +1,402 @@
+/**
+ * AXONIZ Authority Engine — Action gating and auditing.
+ * Ensures that all autonomous actions are within permitted bounds.
+ *
+ * Port of axoniz/core/authority.py
+ *
+ * Port notes:
+ *  - `threading.Lock` around `check()` is dropped: the JS event loop is
+ *    single-threaded and `check()` is fully synchronous (no awaits), so the
+ *    critical section cannot be interleaved. This is the documented
+ *    "trivial async mutex only where genuinely needed" case — it is not needed.
+ *  - `ApprovalDelivery.resolve()` / `setApprovalCallback()` are additive: the
+ *    Python `ApprovalDelivery` only has `ask()`/`timeout`, yet
+ *    `axoniz/comms/telegram.py` calls `bot.set_approval_callback(
+ *    get_engine().delivery.resolve)`. The hook is provided here so the ported
+ *    Telegram bridge can wire a real approval channel without losing the
+ *    faithful `ask()` semantics.
+ */
+import fs from "node:fs";
+import { getLogger } from "./logger.js";
+const logger = getLogger();
+/* ── AuthLevel ────────────────────────────────────────────────────────────── */
+/**
+ * Numeric authority levels. Mirrors the Python `IntEnum`, including the
+ * duplicate-valued test aliases (`AUTONOMOUS`/`LOG_ONLY` = 1, `SOFT_GATE` = 2,
+ * `REQUIRE_APPROVAL` = 4).
+ *
+ * Implemented as a frozen const object + union type instead of a TS `enum` so
+ * the module stays fully erasable (runnable by Node's type-stripping test
+ * runner as well as by tsc).
+ */
+export const AuthLevel = {
+    SAFE: 0,
+    READ: 1,
+    WRITE: 2,
+    EXECUTE: 3,
+    SYSTEM: 4,
+    DANGEROUS: 5,
+    /* Aliases for tests / other modules */
+    AUTONOMOUS: 1,
+    LOG_ONLY: 1,
+    SOFT_GATE: 2,
+    REQUIRE_APPROVAL: 4,
+};
+/** Coerce an arbitrary number to a valid AuthLevel (mirrors `AuthLevel(x)`). */
+export function toAuthLevel(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 5) {
+        throw new Error(`${value} is not a valid AuthLevel`);
+    }
+    return value;
+}
+/* ── Decision ─────────────────────────────────────────────────────────────── */
+/** Mirrors the `Decision` dataclass (including the extra `id` set by `check`). */
+export class Decision {
+    approved;
+    reason;
+    /** Authority level the action was classified at. */
+    level;
+    decision_id;
+    id = 0;
+    constructor(approved, reason, level, decisionId = "") {
+        this.approved = approved;
+        this.reason = reason;
+        this.level = level;
+        this.decision_id = decisionId;
+    }
+    toJSON() {
+        return {
+            approved: this.approved,
+            reason: this.reason,
+            level: this.level,
+            decision_id: this.decision_id,
+            id: this.id,
+        };
+    }
+}
+/* ── Escalation rules (hardcoded safety overrides) ────────────────────────── */
+const PATH_ESCALATIONS = ["data/", "etc/", "var/", "system32", ".env", ".git", "audit.jsonl"];
+const COMMAND_ESCALATIONS = ["rm ", "del ", "format ", "mkfs", "> /dev/", "shadow_monarch"];
+/**
+ * Return 0 (SAFE) if no escalation is needed; otherwise the minimum level the
+ * action must be raised to. Only ever upgrades a level.
+ */
+export function _escalate_check(toolName, args) {
+    // Path escalation
+    if (["file_write", "file_edit", "file_delete", "file_append"].includes(toolName)) {
+        const p = String(args["path"] ?? "")
+            .toLowerCase()
+            .replace(/\\/g, "/");
+        if (PATH_ESCALATIONS.some((x) => p.includes(x))) {
+            return AuthLevel.REQUIRE_APPROVAL;
+        }
+    }
+    // Command escalation
+    if (["shell_run", "shell_python"].includes(toolName)) {
+        const cmd = String(args["command"] ?? "").toLowerCase();
+        if (COMMAND_ESCALATIONS.some((x) => cmd.includes(x))) {
+            return AuthLevel.REQUIRE_APPROVAL;
+        }
+    }
+    return 0;
+}
+/** camelCase alias. */
+export const escalateCheck = _escalate_check;
+/* ── AuditTrail ───────────────────────────────────────────────────────────── */
+export class AuditTrail {
+    path;
+    constructor(path, dbPath) {
+        this.path = path || dbPath || "audit.jsonl";
+    }
+    /** Append one JSON line. Failures are swallowed (Python bare `except`). */
+    log(entry) {
+        try {
+            fs.appendFileSync(this.path, `${JSON.stringify(entry)}\n`, "utf-8");
+        }
+        catch {
+            /* best effort */
+        }
+    }
+    /** Record a gated action (exact Python field set + ordering). */
+    record(tool, args, level, approved, reason) {
+        this.log({
+            tool,
+            args,
+            level: Math.trunc(level),
+            approved,
+            reason,
+            timestamp: Date.now() / 1000,
+        });
+    }
+    /** Last `n` parsed entries (empty list when missing/corrupt). */
+    recent(n = 10) {
+        if (!fs.existsSync(this.path))
+            return [];
+        try {
+            const lines = fs.readFileSync(this.path, "utf-8").split(/\r?\n/).filter((l) => l.length > 0);
+            return lines.slice(-n).map((l) => JSON.parse(l));
+        }
+        catch {
+            return [];
+        }
+    }
+    stats() {
+        let rows = [];
+        if (fs.existsSync(this.path)) {
+            try {
+                rows = fs
+                    .readFileSync(this.path, "utf-8")
+                    .split(/\r?\n/)
+                    .filter((l) => l.length > 0)
+                    .map((l) => JSON.parse(l));
+            }
+            catch {
+                /* Python swallows and keeps rows = [] */
+            }
+        }
+        return {
+            total_actions: rows.length,
+            blocked_actions: rows.filter((r) => !(r["approved"] ?? true)).length,
+        };
+    }
+}
+/* ── ApprovalLearner ──────────────────────────────────────────────────────── */
+export class ApprovalLearner {
+    approvals = new Map();
+    denials = new Map();
+    is_auto_approved(tool) {
+        return (this.approvals.get(tool) ?? 0) >= 3 && (this.denials.get(tool) ?? 0) === 0;
+    }
+    record_approval(tool) {
+        this.approvals.set(tool, (this.approvals.get(tool) ?? 0) + 1);
+        this.denials.set(tool, 0);
+    }
+    record_denial(tool) {
+        this.denials.set(tool, (this.denials.get(tool) ?? 0) + 1);
+        this.approvals.set(tool, 0);
+    }
+    /* camelCase aliases */
+    isAutoApproved(tool) {
+        return this.is_auto_approved(tool);
+    }
+    recordApproval(tool) {
+        this.record_approval(tool);
+    }
+    recordDenial(tool) {
+        this.record_denial(tool);
+    }
+}
+export class ApprovalDelivery {
+    timeout;
+    /** Optional synchronous approval channel wired in by a CLI/Telegram bridge. */
+    callback = null;
+    pending = null;
+    constructor(timeout = 30.0) {
+        this.timeout = timeout;
+    }
+    /** Additive: install a synchronous approval channel. */
+    setApprovalCallback(cb) {
+        this.callback = cb;
+    }
+    /**
+     * Additive: resolve the approval that `askAsync()` is currently waiting on.
+     * `axoniz/comms/telegram.py` wires this into the bot's approval callback.
+     */
+    resolve(approved) {
+        const p = this.pending;
+        this.pending = null;
+        if (p)
+            p(approved);
+    }
+    /**
+     * Faithful port: never prompts interactively (there is no synchronous prompt
+     * in Node), so it returns False after printing the approval banner — exactly
+     * like the Python implementation when nothing is wired up.
+     */
+    ask(tool, args) {
+        if (this.timeout <= 0)
+            return false;
+        if (this.callback) {
+            try {
+                return this.callback(tool, args);
+            }
+            catch (e) {
+                logger.debug(`[Authority] approval callback failed: ${String(e)}`);
+                return false;
+            }
+        }
+        console.log(`\n  ${AuthLevel.DANGEROUS} APPROVAL REQUIRED: ${tool}(${JSON.stringify(args)})`);
+        return false;
+    }
+    /** Additive async variant used by channels that can await a human. */
+    async askAsync(tool, args) {
+        if (this.timeout <= 0)
+            return false;
+        if (this.callback) {
+            try {
+                return this.callback(tool, args);
+            }
+            catch {
+                return false;
+            }
+        }
+        console.log(`\n  ${AuthLevel.DANGEROUS} APPROVAL REQUIRED: ${tool}(${JSON.stringify(args)})`);
+        return await new Promise((resolve) => {
+            this.pending = resolve;
+            const t = setTimeout(() => {
+                if (this.pending === resolve) {
+                    this.pending = null;
+                    resolve(false);
+                }
+            }, Math.max(1, this.timeout) * 1000);
+            if (typeof t.unref === "function")
+                t.unref();
+        });
+    }
+}
+/* ── Default rules ────────────────────────────────────────────────────────── */
+export const _DEFAULT_RULES = {
+    file_read: 1,
+    file_list: 1,
+    file_search: 1,
+    web_get: 1,
+    web_search: 1,
+    get_time: 0,
+    file_write: 2,
+    file_edit: 2,
+    file_append: 2,
+    file_delete: 4,
+    shell_run: 3,
+    shell_python: 3,
+    git_commit: 2,
+    git_push: 3,
+    mouse_move: 3,
+    mouse_click: 3,
+    key_type: 3,
+    key_press: 3,
+    screen_capture: 1,
+    optimize_hardware: 4,
+    done: 0,
+};
+/* ── AuthorityEngine ──────────────────────────────────────────────────────── */
+export class AuthorityEngine {
+    config;
+    audit;
+    learner;
+    delivery;
+    default_level;
+    max_auto_level;
+    _paused = false;
+    _id_counter = 0;
+    /** Dynamic per-tool overrides (set_rule). */
+    _rules = new Map();
+    constructor(config, defaultLevel = 3) {
+        this.config = config ?? {};
+        const dbPath = (this.config["audit_db"] ?? this.config["db_path"] ?? "axoniz_audit.jsonl");
+        this.audit = new AuditTrail(dbPath);
+        this.learner = new ApprovalLearner();
+        this.delivery = new ApprovalDelivery(Number(this.config["approval_timeout"] ?? 30));
+        this.default_level = toAuthLevel(defaultLevel);
+        this.max_auto_level = Number(this.config["max_auto_level"] ?? AuthLevel.EXECUTE);
+    }
+    set_rule(toolName, level) {
+        this._rules.set(toolName, toAuthLevel(level));
+    }
+    /** camelCase alias. */
+    setRule(toolName, level) {
+        this.set_rule(toolName, level);
+    }
+    check(toolName, args, _sessionId = "default") {
+        this._id_counter += 1;
+        if (this._paused) {
+            return new Decision(false, "System paused", AuthLevel.DANGEROUS);
+        }
+        // 1. Base level: Dynamic override -> Default rules -> Default engine level
+        const base = this._rules.get(toolName) ?? _DEFAULT_RULES[toolName] ?? this.default_level;
+        let level = base;
+        // 2. Path & command escalation (hardcoded safety overrides) — upgrade only.
+        const escLevel = _escalate_check(toolName, args);
+        if (escLevel > 0) {
+            level = Math.max(level, escLevel);
+        }
+        // 3. Learner check (auto-approval of trusted patterns)
+        if (this.learner.is_auto_approved(toolName)) {
+            level = AuthLevel.SAFE;
+        }
+        let approved = level <= this.max_auto_level;
+        // Match test expectations for the reason string.
+        let reason;
+        if ((level <= AuthLevel.READ || level === AuthLevel.AUTONOMOUS) && approved) {
+            reason = "autonomous";
+        }
+        else if (approved) {
+            reason = "Auto-approved";
+        }
+        else {
+            reason = `Action level ${level} exceeds threshold`;
+        }
+        if (!approved) {
+            // Try delivery
+            if (this.delivery.ask(toolName, args)) {
+                this.learner.record_approval(toolName);
+                approved = true;
+                reason = "User approved";
+            }
+            else {
+                this.learner.record_denial(toolName);
+            }
+        }
+        this.audit.record(toolName, args, level, approved, reason);
+        const d = new Decision(approved, reason, Math.trunc(level));
+        d.id = this._id_counter;
+        d.decision_id = String(this._id_counter);
+        return d;
+    }
+    emergency_pause() {
+        this._paused = true;
+    }
+    resume() {
+        this._paused = false;
+    }
+    summary() {
+        return `Authority: ${this._paused ? "PAUSED" : "Active"} | Audit: ${this.audit.path}`;
+    }
+    recent_audit(n = 10) {
+        const rows = this.audit.recent(n);
+        if (rows.length === 0)
+            return "No audit records.";
+        const lines = [];
+        for (const r of rows) {
+            lines.push(`[${formatTime(Number(r["timestamp"] ?? 0))}] ` +
+                `${String(r["tool"])} -> ${r["approved"] ? "OK" : "BLOCKED"} (${String(r["reason"])})`);
+        }
+        return lines.join("\n");
+    }
+    /* camelCase aliases */
+    emergencyPause() {
+        this.emergency_pause();
+    }
+    recentAudit(n = 10) {
+        return this.recent_audit(n);
+    }
+}
+/** `time.strftime('%H:%M:%S', time.localtime(ts))` for a float epoch. */
+function formatTime(ts) {
+    const d = new Date(ts * 1000);
+    const p = (x) => String(x).padStart(2, "0");
+    return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+/* ── Module singleton ─────────────────────────────────────────────────────── */
+let _engine_instance = null;
+export function get_engine(config) {
+    if (_engine_instance === null) {
+        _engine_instance = new AuthorityEngine(config);
+    }
+    return _engine_instance;
+}
+export const getEngine = get_engine;
+/** Test/reset hook (not present in Python; additive, keeps the singleton honest). */
+export function _resetEngine() {
+    _engine_instance = null;
+}
+//# sourceMappingURL=authority.js.map

package/dist/core/authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.js","sourceRoot":"","sources":["../../src/core/authority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAE3B,iFAAiF;AAEjF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,uCAAuC;IACvC,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,gBAAgB,EAAE,CAAC;CACX,CAAC;AAIX,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,2BAA2B,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAkB,CAAC;AAC5B,CAAC;AAED,iFAAiF;AAEjF,kFAAkF;AAClF,MAAM,OAAO,QAAQ;IACnB,QAAQ,CAAU;IAClB,MAAM,CAAS;IACf,oDAAoD;IACpD,KAAK,CAAS;IACd,WAAW,CAAS;IACpB,EAAE,GAAG,CAAC,CAAC;IAEP,YAAY,QAAiB,EAAE,MAAc,EAAE,KAAa,EAAE,UAAU,GAAG,EAAE;QAC3E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC;IACJ,CAAC;CACF;AAED,iFAAiF;AAEjF,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AAC9F,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAA6B;IAC7E,kBAAkB;IAClB,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aACjC,WAAW,EAAE;aACb,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvB,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC,gBAA0B,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACxD,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,OAAO,SAAS,CAAC,gBAA0B,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,uBAAuB;AACvB,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C,iFAAiF;AAEjF,MAAM,OAAO,UAAU;IACrB,IAAI,CAAS;IAEb,YAAY,IAAoB,EAAE,MAAsB;QACtD,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,MAAM,IAAI,aAAa,CAAC;IAC9C,CAAC;IAED,2EAA2E;IAC3E,GAAG,CAAC,KAA8B;QAChC,IAAI,CAAC;YACH,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,IAAY,EAAE,IAA6B,EAAE,KAAa,EAAE,QAAiB,EAAE,MAAc;QAClG,IAAI,CAAC,GAAG,CAAC;YACP,IAAI;YACJ,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;YACxB,QAAQ;YACR,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC7F,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAA4B,CAAC,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,IAAI,GAAmC,EAAE,CAAC;QAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,IAAI,GAAG,EAAE;qBACN,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;qBAChC,KAAK,CAAC,OAAO,CAAC;qBACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;qBAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAA4B,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,MAAM;YAC1B,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM;SACrE,CAAC;IACJ,CAAC;CACF;AAED,iFAAiF;AAEjF,MAAM,OAAO,eAAe;IAC1B,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEpC,gBAAgB,CAAC,IAAY;QAC3B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IACrF,CAAC;IAED,eAAe,CAAC,IAAY;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,uBAAuB;IACvB,cAAc,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF;AAMD,MAAM,OAAO,gBAAgB;IAC3B,OAAO,CAAS;IAChB,+EAA+E;IACrE,QAAQ,GAA4B,IAAI,CAAC;IACzC,OAAO,GAAyC,IAAI,CAAC;IAE/D,YAAY,OAAO,GAAG,IAAI;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,wDAAwD;IACxD,mBAAmB,CAAC,EAA2B;QAC7C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,QAAiB;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAY,EAAE,IAA6B;QAC7C,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,yCAAyC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACnE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,CAAC,SAAS,uBAAuB,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAA6B;QACxD,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,CAAC,SAAS,uBAAuB,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9F,OAAO,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;oBACpB,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,UAAU;gBAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;IACd,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,cAAc,EAAE,CAAC;IACjB,iBAAiB,EAAE,CAAC;IACpB,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,iFAAiF;AAEjF,MAAM,OAAO,eAAe;IAC1B,MAAM,CAA0B;IAChC,KAAK,CAAa;IAClB,OAAO,CAAkB;IACzB,QAAQ,CAAmB;IAC3B,aAAa,CAAY;IACzB,cAAc,CAAS;IACvB,OAAO,GAAG,KAAK,CAAC;IAChB,WAAW,GAAG,CAAC,CAAC;IAChB,6CAA6C;IACnC,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEhD,YAAY,MAAuC,EAAE,YAAY,GAAG,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,oBAAoB,CAAW,CAAC;QACrG,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;IAED,QAAQ,CAAC,QAAgB,EAAE,KAAa;QACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,QAAgB,EAAE,KAAa;QACrC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAgB,EAAE,IAA6B,EAAE,UAAU,GAAG,SAAS;QAC3E,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACnE,CAAC;QAED,2EAA2E;QAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC;QACzF,IAAI,KAAK,GAAW,IAAI,CAAC;QAEzB,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC;QAED,uDAAuD;QACvD,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC;QACzB,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC;QAE5C,iDAAiD;QACjD,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,UAAU,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC5E,MAAM,GAAG,YAAY,CAAC;QACxB,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YACpB,MAAM,GAAG,eAAe,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,gBAAgB,KAAK,oBAAoB,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,eAAe;YACf,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACvC,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,GAAG,eAAe,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE3D,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QACxB,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,eAAe;QACb,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,OAAO;QACL,OAAO,cAAc,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,aAAa,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACxF,CAAC;IAED,YAAY,CAAC,CAAC,GAAG,EAAE;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,mBAAmB,CAAC;QAClD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CACR,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBAC7C,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CACzF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,uBAAuB;IACvB,cAAc;QACZ,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IACD,WAAW,CAAC,CAAC,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,yEAAyE;AACzE,SAAS,UAAU,CAAC,EAAU;IAC5B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,iFAAiF;AAEjF,IAAI,gBAAgB,GAA2B,IAAI,CAAC;AAEpD,MAAM,UAAU,UAAU,CAAC,MAAuC;IAChE,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,gBAAgB,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;AAEpC,qFAAqF;AACrF,MAAM,UAAU,YAAY;IAC1B,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC"}

package/dist/core/backend/async_queue.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Async queue bridging callback/push producers to `for await` consumers.
+ * Used to turn node-llama-cpp's `onTextChunk` callback into an async iterator,
+ * preserving the Python generator-based backend interface.
+ */
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    private readonly items;
+    private readonly waiters;
+    private closed;
+    private error;
+    push(item: T): void;
+    close(): void;
+    fail(err: unknown): void;
+    get failure(): unknown;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+//# sourceMappingURL=async_queue.d.ts.map

package/dist/core/backend/async_queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_queue.d.ts","sourceRoot":"","sources":["../../../src/core/backend/async_queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAiB;IAE9B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAQlB;IAED,KAAK,IAAI,IAAI,CAMZ;IAED,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CASvB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAmBzC;CACF"}

package/dist/core/backend/async_queue.js

@@ -0,0 +1,66 @@
+/**
+ * Async queue bridging callback/push producers to `for await` consumers.
+ * Used to turn node-llama-cpp's `onTextChunk` callback into an async iterator,
+ * preserving the Python generator-based backend interface.
+ */
+export class AsyncQueue {
+    items = [];
+    waiters = [];
+    closed = false;
+    error = null;
+    push(item) {
+        if (this.closed)
+            return;
+        const waiter = this.waiters.shift();
+        if (waiter) {
+            waiter({ value: item, done: false });
+        }
+        else {
+            this.items.push(item);
+        }
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        while (this.waiters.length > 0) {
+            this.waiters.shift()({ value: undefined, done: true });
+        }
+    }
+    fail(err) {
+        if (this.closed)
+            return;
+        this.error = err;
+        this.closed = true;
+        while (this.waiters.length > 0) {
+            const waiter = this.waiters.shift();
+            // Surface the error to the consumer on its next pull.
+            waiter({ value: undefined, done: true });
+        }
+    }
+    get failure() {
+        return this.error;
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.items.length > 0) {
+                    return Promise.resolve({ value: this.items.shift(), done: false });
+                }
+                if (this.closed) {
+                    if (this.error)
+                        return Promise.reject(this.error);
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => {
+                    this.waiters.push(resolve);
+                });
+            },
+            return: () => {
+                this.close();
+                return Promise.resolve({ value: undefined, done: true });
+            },
+        };
+    }
+}
+//# sourceMappingURL=async_queue.js.map

package/dist/core/backend/async_queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_queue.js","sourceRoot":"","sources":["../../../src/core/backend/async_queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,UAAU;IACJ,KAAK,GAAQ,EAAE,CAAC;IAChB,OAAO,GAA0C,EAAE,CAAC;IAC7D,MAAM,GAAG,KAAK,CAAC;IACf,KAAK,GAAY,IAAI,CAAC;IAE9B,IAAI,CAAC,IAAO;QACV,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC,EAAE,KAAK,EAAE,SAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAY;QACf,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC;YACrC,sDAAsD;YACtD,MAAM,CAAC,EAAE,KAAK,EAAE,SAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,GAA+B,EAAE;gBACrC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACtE,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,IAAI,IAAI,CAAC,KAAK;wBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAClD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;oBAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC7B,CAAC,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,GAA+B,EAAE;gBACvC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/core/backend/index.d.ts

@@ -0,0 +1,24 @@
+import { activeProvider, type AxonizConfig } from "../config.js";
+import { LlamaCppBackend } from "./llamacpp.js";
+import { LlamaCppServerBackend } from "./llama_server.js";
+import { OpenAICompatibleBackend } from "./openai.js";
+import { OllamaBackend } from "./ollama.js";
+import { LMStudioBackend } from "./lmstudio.js";
+import { Backend, isToolCallResponse, textResponse, toolCallResponse, type BackendHealth, type ChatMessage, type CompletionResult, type TextResponse, type ToolCall, type ToolCallResponse } from "./types.js";
+export { Backend, isToolCallResponse, textResponse, toolCallResponse, LlamaCppBackend, LlamaCppServerBackend, OpenAICompatibleBackend, OllamaBackend, LMStudioBackend, };
+export type { BackendHealth, ChatMessage, CompletionResult, TextResponse, ToolCall, ToolCallResponse, };
+/**
+ * Build the right backend from the hierarchical config dict.
+ * Falls back to the legacy flat config when `llm` is absent.
+ */
+export declare function getBackend(cfg: AxonizConfig, tools?: unknown[]): Backend;
+export interface ProviderInfo {
+    id: string;
+    name: string;
+    requires: string;
+    model_format: string;
+}
+/** All supported providers, for UI display. */
+export declare function listSupportedProviders(): ProviderInfo[];
+export { activeProvider };
+//# sourceMappingURL=index.d.ts.map

package/dist/core/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/backend/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,eAAe,GAChB,CAAC;AACF,YAAY,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,gBAAgB,GACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,GAAE,OAAO,EAAO,GAAG,OAAO,CA+E5E;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,wBAAgB,sBAAsB,IAAI,YAAY,EAAE,CAiCvD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/backend/index.js

@@ -0,0 +1,128 @@
+/**
+ * Backend factory + re-exports.
+ * Port of the `Backend` ABC, response types, `get_backend` and
+ * `list_supported_providers` from axoniz/core/backend.py.
+ */
+import { debug } from "../debug.js";
+import { providerConfig, activeProvider } from "../config.js";
+import { LlamaCppBackend } from "./llamacpp.js";
+import { LlamaCppServerBackend } from "./llama_server.js";
+import { OpenAICompatibleBackend } from "./openai.js";
+import { OllamaBackend } from "./ollama.js";
+import { LMStudioBackend } from "./lmstudio.js";
+import { Backend, isToolCallResponse, textResponse, toolCallResponse, } from "./types.js";
+export { Backend, isToolCallResponse, textResponse, toolCallResponse, LlamaCppBackend, LlamaCppServerBackend, OpenAICompatibleBackend, OllamaBackend, LMStudioBackend, };
+/**
+ * Build the right backend from the hierarchical config dict.
+ * Falls back to the legacy flat config when `llm` is absent.
+ */
+export function getBackend(cfg, tools = []) {
+    const hasLlm = cfg.llm !== undefined && cfg.llm !== null;
+    const prov = hasLlm
+        ? String(cfg.llm.active_provider ?? "llamacpp")
+        : String(cfg.provider ?? cfg.backend ?? "llamacpp")
+            .toLowerCase()
+            .trim();
+    const p = providerConfig(cfg, prov);
+    debug(`[Backend Factory] provider=${prov}`);
+    const num = (key, fallback) => {
+        const v = p[key];
+        const n = Number(v);
+        return Number.isFinite(n) ? n : fallback;
+    };
+    const str = (key, fallback) => {
+        const v = p[key];
+        return v === undefined || v === null || v === "" ? fallback : String(v);
+    };
+    if (prov === "openai" || prov === "openai_compatible") {
+        return new OpenAICompatibleBackend({
+            baseUrl: str("base_url", "https://api.openai.com/v1"),
+            apiKey: str("api_key", ""),
+            modelName: str("model_name", "gpt-4o"),
+            temperature: num("temperature", 0.2),
+            maxTokens: num("max_tokens", 4096),
+            tools,
+        });
+    }
+    if (prov === "ollama") {
+        return new OllamaBackend({
+            baseUrl: str("base_url", "http://localhost:11434"),
+            modelName: str("model_name", "llama3"),
+            temperature: num("temperature", 0.2),
+            maxTokens: num("max_tokens", 4096),
+            tools,
+        });
+    }
+    if (prov === "lmstudio") {
+        return new LMStudioBackend({
+            baseUrl: str("base_url", "http://localhost:1234"),
+            modelName: str("model_name", ""),
+            apiKey: str("api_key", "lm-studio"),
+            temperature: num("temperature", 0.2),
+            maxTokens: num("max_tokens", 4096),
+            autoLoad: p.auto_load === undefined ? true : Boolean(p.auto_load),
+            autoStart: Boolean(p.auto_start),
+            lmsBin: str("lms_bin", ""),
+            tools,
+        });
+    }
+    if (prov === "gguf_server" || prov === "llamacpp_server") {
+        return new LlamaCppServerBackend({
+            baseUrl: str("base_url", "http://localhost:8080"),
+            modelPath: str("model_path", ""),
+            temperature: num("temperature", 0.2),
+            maxTokens: num("max_tokens", 4096),
+            nCtx: num("n_ctx", 32768),
+            llamaBin: str("llama_bin", ""),
+            autoStart: Boolean(p.auto_start),
+            nGpuLayers: num("n_gpu_layers", -1),
+            tools,
+        });
+    }
+    // Default: llamacpp (in-process, node-llama-cpp)
+    return new LlamaCppBackend({
+        modelPath: str("model_path", ""),
+        temperature: num("temperature", 0.2),
+        maxTokens: num("max_tokens", 4096),
+        nCtx: num("n_ctx", 32768),
+        nGpuLayers: num("n_gpu_layers", -1),
+        tools,
+    });
+}
+/** All supported providers, for UI display. */
+export function listSupportedProviders() {
+    return [
+        {
+            id: "llamacpp",
+            name: "LlamaCpp (Direct GGUF)",
+            requires: "node-llama-cpp",
+            model_format: ".gguf file path",
+        },
+        {
+            id: "llamacpp_server",
+            name: "LlamaCpp Server",
+            requires: "llama-server binary",
+            model_format: ".gguf file path",
+        },
+        {
+            id: "lmstudio",
+            name: "LM Studio (LMS)",
+            requires: "LM Studio running",
+            model_format: "model name or path",
+        },
+        {
+            id: "openai",
+            name: "OpenAI / Compatible",
+            requires: "api_key + base_url",
+            model_format: "model name string",
+        },
+        {
+            id: "ollama",
+            name: "Ollama",
+            requires: "Ollama running",
+            model_format: "model name string",
+        },
+    ];
+}
+export { activeProvider };
+//# sourceMappingURL=index.js.map