@fraziym/axoniz 0.1.0

package/dist/core/models.js

@@ -0,0 +1,146 @@
+/**
+ * AXONIZ-ZERO Model Registry.
+ * Central registry of AI models with hardware requirements and guidance.
+ * Port of axoniz/core/models.py.
+ */
+export function hfUrl(m) {
+    return `https://huggingface.co/${m.repo}`;
+}
+/** Determines if the system has enough memory to run this model. */
+export function fits(m, availableRamGb = 14.0) {
+    return m.ram_gb <= availableRamGb;
+}
+/** The global model registry, vetted for typical mobile/desktop CPUs. */
+export const REGISTRY = {
+    "gemma3-4b": {
+        name: "gemma3-4b",
+        gguf_name: "Gemma-3-4B-VL-it-Gemini-Pro-Heretic-Uncensored-Thinking_Q8_0.gguf",
+        repo: "local",
+        size_gb: 4.5,
+        ram_gb: 6.0,
+        ctx: 8192,
+        temperature: 0.7,
+        max_tokens: 4096,
+        tags: ["local", "general", "multimodal", "vision", "reasoning"],
+        description: "Gemma 3 4B VL — A versatile multimodal model combining vision and language.",
+        best_for: "General assistance, visual analysis, and logical reasoning.",
+        speed_toks: "5–9 tok/s",
+        recommended: true,
+    },
+    "qwen-coder": {
+        name: "qwen-coder",
+        gguf_name: "qwen2.5-coder-7b-instruct-q6_k.gguf",
+        repo: "Qwen/Qwen2.5-Coder-7B-Instruct-GGUF",
+        size_gb: 5.9,
+        ram_gb: 8.5,
+        ctx: 8192,
+        temperature: 0.2,
+        max_tokens: 4096,
+        tags: ["coding", "professional", "agentic"],
+        description: "Qwen2.5-Coder 7B — A state-of-the-art model for software development.",
+        best_for: "Python, JavaScript, SQL, and complex architectural tasks.",
+        speed_toks: "3–5 tok/s",
+        recommended: false,
+    },
+    "phi35-mini": {
+        name: "phi35-mini",
+        gguf_name: "Phi-3.5-mini-instruct-Q4_K_M.gguf",
+        repo: "bartowski/Phi-3.5-mini-instruct-GGUF",
+        size_gb: 2.4,
+        ram_gb: 3.5,
+        ctx: 8192,
+        temperature: 0.3,
+        max_tokens: 2048,
+        tags: ["fast", "lightweight", "efficient"],
+        description: "Phi-3.5 Mini — A compact yet surprisingly powerful model from Microsoft.",
+        best_for: "Low-latency tasks and lightweight coding automation.",
+        speed_toks: "10–14 tok/s",
+        recommended: false,
+    },
+    "llama32-3b": {
+        name: "llama32-3b",
+        gguf_name: "Llama-3.2-3B-Instruct-Q4_K_M.gguf",
+        repo: "bartowski/Llama-3.2-3B-Instruct-GGUF",
+        size_gb: 2.0,
+        ram_gb: 3.0,
+        ctx: 4096,
+        temperature: 0.6,
+        max_tokens: 2048,
+        tags: ["fast", "standard", "chat"],
+        description: "Llama 3.2 3B — Meta's highly efficient model for general interaction.",
+        best_for: "Quick chat, simple explanations, and high-speed feedback.",
+        speed_toks: "12–18 tok/s",
+        recommended: false,
+    },
+};
+/** Retrieve a model configuration by registry name. */
+export function get(name) {
+    return REGISTRY[name];
+}
+/** The primary model recommended for AXONIZ-ZERO. */
+export function recommended() {
+    for (const m of Object.values(REGISTRY)) {
+        if (m.recommended)
+            return m;
+    }
+    return Object.values(REGISTRY)[0];
+}
+/** Filter the registry for models matching a capability tag. */
+export function byTag(tag) {
+    return Object.values(REGISTRY).filter((m) => m.tags.includes(tag));
+}
+/** All models that can safely operate within the specified RAM limit. */
+export function fitsDevice(ramGb = 14.0) {
+    return Object.values(REGISTRY).filter((m) => fits(m, ramGb));
+}
+/** Complete list of all registered model variants. */
+export function allModels() {
+    return Object.values(REGISTRY);
+}
+/** Render a colour-coded table of available models in the terminal. */
+export async function showTable() {
+    // Imported lazily: cli.ts also imports this module.
+    const { C } = await import("./cli.js");
+    const rows = [];
+    for (const m of Object.values(REGISTRY)) {
+        const rec = m.recommended ? " \u2605" : "";
+        rows.push([
+            m.name + rec,
+            `${m.size_gb}GB`,
+            m.speed_toks,
+            m.tags.slice(0, 3).join(", "),
+            m.best_for.slice(0, 45),
+        ]);
+    }
+    const colW = [20, 8, 14, 22, 46];
+    const header = ["MODEL", "SIZE", "SPEED (CPU)", "TAGS", "BEST FOR"];
+    const sep = `  ${"\u2500".repeat(colW.reduce((a, b) => a + b, 0) + colW.length * 2)}`;
+    console.log(`\n${C.BOLD}${C.WHITE}  Available Intelligence Variants${C.RESET}`);
+    console.log(sep);
+    console.log(`  ${header.map((h, i) => `${C.GRAY}${pad(h, colW[i])}${C.RESET}`).join("  ")}`);
+    console.log(sep);
+    for (const row of rows) {
+        const colored = row.map((cell, i) => {
+            let color;
+            if (i === 0)
+                color = cell.includes("\u2605") ? C.BLUE : C.WHITE;
+            else if (i === 1)
+                color = C.GRAY;
+            else if (i === 2)
+                color = C.GREEN;
+            else if (i === 3)
+                color = C.PURPLE;
+            else
+                color = C.DGRAY;
+            return `${color}${pad(cell, colW[i])}${C.RESET}`;
+        });
+        console.log(`  ${colored.join("  ")}`);
+    }
+    console.log(sep);
+    console.log(`  ${C.DGRAY}\u2605 = Standard Recommendation  \u00b7  Command: axoniz model use <name>${C.RESET}\n`);
+}
+/** Left-truncation-safe column padding (matches Python's str.ljust). */
+function pad(s, width) {
+    return s.length >= width ? s : s + " ".repeat(width - s.length);
+}
+//# sourceMappingURL=models.js.map

package/dist/core/models.js.map

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

package/dist/core/optimizer.d.ts

@@ -0,0 +1,34 @@
+export interface HardwareProfile {
+    os: string;
+    cpu_count: number;
+    total_ram_gb: number;
+    has_gpu: boolean;
+    gpu_info: string;
+}
+export declare function get_hardware_profile(): HardwareProfile;
+/** camelCase alias. */
+export declare const getHardwareProfile: typeof get_hardware_profile;
+/**
+ * Returns an optimized version of the config based on hardware.
+ * `setdefault` semantics are preserved: context size / GPU layers only fill in
+ * missing keys, while thread count and flash attention are always overwritten.
+ */
+export declare function optimize_config(currentCfg: Record<string, unknown>): Record<string, unknown>;
+/** camelCase alias. */
+export declare const optimizeConfig: typeof optimize_config;
+/** Minimal shape of the agent this module mutates (parent owns src/core/agent.ts). */
+export interface OptimizableAgent {
+    config: Record<string, unknown>;
+    _rebuild_llm?: () => unknown;
+}
+/**
+ * Applies optimizations directly to a running agent's backend.
+ * Returns the optimized config that was merged in.
+ *
+ * Note: `_rebuild_llm()` is awaited when it returns a promise (the TypeScript
+ * backend rebuild is async), hence this function is async.
+ */
+export declare function apply_optimizations(agent: OptimizableAgent): Promise<Record<string, unknown>>;
+/** camelCase alias. */
+export declare const applyOptimizations: typeof apply_optimizations;
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/core/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../src/core/optimizer.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgBD,wBAAgB,oBAAoB,IAAI,eAAe,CAyCtD;AAED,uBAAuB;AACvB,eAAO,MAAM,kBAAkB,6BAAuB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B5F;AAED,uBAAuB;AACvB,eAAO,MAAM,cAAc,wBAAkB,CAAC;AAE9C,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAQnG;AAED,uBAAuB;AACvB,eAAO,MAAM,kBAAkB,4BAAsB,CAAC"}

package/dist/core/optimizer.js

@@ -0,0 +1,131 @@
+/**
+ * AXONIZ BackendOptimizer — Hardware-aware performance tuning.
+ * Benchmarks the local device and optimizes LLM backend settings.
+ *
+ * Port of axoniz/core/optimizer.py
+ *
+ * Port notes:
+ *  - `psutil.virtual_memory().total` → `os.totalmem()`.
+ *  - `multiprocessing.cpu_count()` → `os.cpus().length`.
+ *  - `platform.system()` → the Python-style platform name derived from
+ *    `process.platform` ("Windows" / "Linux" / "Darwin").
+ *  - `subprocess.run([...])` → `execFileSync` (the profile API stays synchronous,
+ *    matching the Python contract used by `intelligence/reflex.py`).
+ *  - `which nvidia-smi` → `whichSync` from ./which.ts.
+ */
+import os from "node:os";
+import { execFileSync } from "node:child_process";
+import { whichSync } from "./which.js";
+/** Python-style platform name (`platform.system()`). */
+function pythonPlatform() {
+    switch (process.platform) {
+        case "win32":
+            return "Windows";
+        case "darwin":
+            return "Darwin";
+        case "linux":
+            return "Linux";
+        default:
+            return process.platform;
+    }
+}
+export function get_hardware_profile() {
+    const profile = {
+        os: pythonPlatform(),
+        cpu_count: os.cpus().length,
+        total_ram_gb: 0,
+        has_gpu: false,
+        gpu_info: "",
+    };
+    // RAM
+    try {
+        profile.total_ram_gb = Math.round((os.totalmem() / 1024 ** 3) * 100) / 100;
+    }
+    catch {
+        /* leave 0, mirroring the ImportError branch */
+    }
+    // GPU (basic NVIDIA check)
+    try {
+        if (profile.os === "Windows") {
+            try {
+                const stdout = execFileSync("nvidia-smi", ["--query-gpu=name,memory.total", "--format=csv,noheader"], { encoding: "utf-8", timeout: 2000, stdio: ["ignore", "pipe", "ignore"] });
+                profile.has_gpu = true;
+                profile.gpu_info = stdout.trim();
+            }
+            catch {
+                /* no nvidia-smi / non-zero exit → no GPU */
+            }
+        }
+        else {
+            // Linux/Mac check
+            if (whichSync("nvidia-smi")) {
+                profile.has_gpu = true;
+            }
+        }
+    }
+    catch {
+        /* best effort */
+    }
+    return profile;
+}
+/** camelCase alias. */
+export const getHardwareProfile = get_hardware_profile;
+/**
+ * Returns an optimized version of the config based on hardware.
+ * `setdefault` semantics are preserved: context size / GPU layers only fill in
+ * missing keys, while thread count and flash attention are always overwritten.
+ */
+export function optimize_config(currentCfg) {
+    const hw = get_hardware_profile();
+    const newCfg = { ...currentCfg };
+    // CPU threads: typically N-1, or N-2 on wider machines
+    let threads = Math.max(1, hw.cpu_count - 1);
+    if (hw.cpu_count > 8) {
+        threads = hw.cpu_count - 2;
+    }
+    newCfg["n_threads"] = threads;
+    // Context size: match RAM
+    if (hw.total_ram_gb > 32) {
+        if (!("n_ctx" in newCfg))
+            newCfg["n_ctx"] = 16384;
+    }
+    else if (hw.total_ram_gb > 16) {
+        if (!("n_ctx" in newCfg))
+            newCfg["n_ctx"] = 8192;
+    }
+    else if (!("n_ctx" in newCfg)) {
+        newCfg["n_ctx"] = 4096;
+    }
+    // GPU layers for llama.cpp
+    if (hw.has_gpu) {
+        if (!("n_gpu_layers" in newCfg))
+            newCfg["n_gpu_layers"] = 35;
+    }
+    else {
+        newCfg["n_gpu_layers"] = 0;
+    }
+    // Flash attention (if supported by the backend)
+    newCfg["flash_attn"] = true;
+    return newCfg;
+}
+/** camelCase alias. */
+export const optimizeConfig = optimize_config;
+/**
+ * Applies optimizations directly to a running agent's backend.
+ * Returns the optimized config that was merged in.
+ *
+ * Note: `_rebuild_llm()` is awaited when it returns a promise (the TypeScript
+ * backend rebuild is async), hence this function is async.
+ */
+export async function apply_optimizations(agent) {
+    const current = agent.config;
+    const optimized = optimize_config(current);
+    Object.assign(agent.config, optimized);
+    if (typeof agent._rebuild_llm === "function") {
+        await agent._rebuild_llm();
+    }
+    return optimized;
+}
+/** camelCase alias. */
+export const applyOptimizations = apply_optimizations;
+//# sourceMappingURL=optimizer.js.map

package/dist/core/optimizer.js.map

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

package/dist/core/persona.d.ts

@@ -0,0 +1,35 @@
+export interface RoleData {
+    id?: string;
+    name?: string;
+    title?: string;
+    personality?: string[];
+    core_traits?: string[];
+    authority_level?: number;
+    sub_roles?: unknown[];
+    heartbeat_instructions?: string;
+    system_prompt_template?: string;
+    [key: string]: unknown;
+}
+export declare class Persona {
+    readonly roleId: string;
+    readonly data: RoleData;
+    readonly name: string;
+    readonly title: string;
+    readonly authorityLevel: number;
+    readonly subRoles: unknown[];
+    readonly heartbeatInstructions: string;
+    constructor(role?: string);
+    /** Candidate locations for the role YAML, mirroring the Python search order. */
+    private rolePaths;
+    private loadRole;
+    /**
+     * Render the system prompt template.
+     * Mirrors Python's str.format with a manual fallback for unknown keys.
+     */
+    buildSystemPrompt(workspace?: string, toolNames?: string[], sessionId?: string): string;
+    buildHeartbeatPrompt(recentChat?: string): string;
+    getAuthorityLevel(action: string): number;
+    isAutonomous(action: string): boolean;
+}
+export declare function getPersona(role?: string): Persona;
+//# sourceMappingURL=persona.d.ts.map

package/dist/core/persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/core/persona.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgBD,qBAAa,OAAO;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAEvC,YAAY,IAAI,SAAS,EAWxB;IAED,gFAAgF;IAChF,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,QAAQ;IAiBhB;;;OAGG;IACH,iBAAiB,CAAC,SAAS,SAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,SAAY,GAAG,MAAM,CAmCtF;IAED,oBAAoB,CAAC,UAAU,SAAK,GAAG,MAAM,CAE5C;IAED,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMxC;IAED,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpC;CACF;AAQD,wBAAgB,UAAU,CAAC,IAAI,SAAS,GAAG,OAAO,CAKjD"}

package/dist/core/persona.js

@@ -0,0 +1,126 @@
+/**
+ * AXONIZ Persona Engine — concise identity and role system.
+ * Loads roles from YAML and builds compact system prompts.
+ * Port of axoniz/core/persona.py (PyYAML -> js-yaml).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import * as yaml from "js-yaml";
+import { getLogger } from "./logger.js";
+const logger = getLogger();
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+const DEFAULT_ROLE = {
+    name: "BERU",
+    title: "AI Agent",
+    personality: ["efficient", "analytical", "accountable"],
+    system_prompt_template: "You are {name}, {title}.\n" +
+        "Rules: read before edit, use tools only, verify after changes, summarize on done.\n" +
+        "Tools: {tool_list}\n" +
+        "Personality: {personality_list}",
+    authority_level: 5,
+    sub_roles: [],
+    heartbeat_instructions: "Check system status and pending tasks.",
+};
+export class Persona {
+    roleId;
+    data;
+    name;
+    title;
+    authorityLevel;
+    subRoles;
+    heartbeatInstructions;
+    constructor(role = "beru") {
+        this.roleId = role;
+        this.data = this.loadRole(role);
+        this.name = String(this.data.name ?? "BERU");
+        this.title = String(this.data.title ?? "AI Agent");
+        this.authorityLevel = Number(this.data.authority_level ?? 5);
+        this.subRoles = Array.isArray(this.data.sub_roles) ? this.data.sub_roles : [];
+        this.heartbeatInstructions = String(this.data.heartbeat_instructions ??
+            "Check system status, pending tasks, and trajectory health.");
+    }
+    /** Candidate locations for the role YAML, mirroring the Python search order. */
+    rolePaths(roleId) {
+        return [
+            path.join(HERE, "..", "roles", `${roleId}.yaml`),
+            path.join(HERE, "..", "..", "roles", `${roleId}.yaml`),
+            path.join(process.cwd(), "axoniz", "roles", `${roleId}.yaml`),
+            path.join(process.cwd(), "roles", `${roleId}.yaml`),
+        ];
+    }
+    loadRole(roleId) {
+        for (const p of this.rolePaths(roleId)) {
+            if (!fs.existsSync(p))
+                continue;
+            try {
+                const data = yaml.load(fs.readFileSync(p, "utf-8"));
+                if (data && typeof data === "object")
+                    return data;
+            }
+            catch (e) {
+                logger.error(`Failed to load role ${roleId} from ${p}: ${errMsg(e)}`, "axoniz.persona");
+            }
+        }
+        logger.warning(`[Persona] Role YAML '${roleId}.yaml' not found — using built-in default`, "axoniz.persona");
+        return structuredClone(DEFAULT_ROLE);
+    }
+    /**
+     * Render the system prompt template.
+     * Mirrors Python's str.format with a manual fallback for unknown keys.
+     */
+    buildSystemPrompt(workspace = ".", toolNames, sessionId = "default") {
+        const template = String(this.data.system_prompt_template ?? DEFAULT_ROLE.system_prompt_template ?? "");
+        const personality = (Array.isArray(this.data.personality) ? this.data.personality : []).join(", ");
+        const toolList = (toolNames ?? []).join(", ");
+        const context = {
+            name: this.name,
+            title: this.title,
+            personality_list: personality,
+            workspace,
+            session_id: sessionId,
+            tool_list: toolList,
+        };
+        let prompt = template;
+        let unknownKey = null;
+        for (const [key, value] of Object.entries(context)) {
+            const placeholder = `{${key}}`;
+            if (!prompt.includes(placeholder))
+                continue;
+            prompt = prompt.split(placeholder).join(value);
+        }
+        // Detect any remaining placeholders and warn like the Python KeyError branch.
+        const leftover = prompt.match(/\{([a-zA-Z_][a-zA-Z0-9_]*)\}/);
+        if (leftover)
+            unknownKey = leftover[1];
+        if (unknownKey) {
+            logger.warning(`[Persona] template referenced unknown key '${unknownKey}', rendered with fallbacks`, "axoniz.persona");
+        }
+        return prompt.trim();
+    }
+    buildHeartbeatPrompt(recentChat = "") {
+        return `System check: ${this.heartbeatInstructions}\nRecent context:\n${recentChat}`;
+    }
+    getAuthorityLevel(action) {
+        if (action.includes("delete") || action.includes("format") || action.includes("dangerous")) {
+            return 4;
+        }
+        if (action.includes("write"))
+            return 2;
+        return 1;
+    }
+    isAutonomous(action) {
+        return this.getAuthorityLevel(action) <= this.authorityLevel;
+    }
+}
+function errMsg(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+let personaInstance = null;
+export function getPersona(role = "beru") {
+    if (personaInstance === null || personaInstance.roleId !== role) {
+        personaInstance = new Persona(role);
+    }
+    return personaInstance;
+}
+//# sourceMappingURL=persona.js.map

package/dist/core/persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../src/core/persona.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAe1D,MAAM,YAAY,GAAa;IAC7B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC;IACvD,sBAAsB,EACpB,4BAA4B;QAC5B,qFAAqF;QACrF,sBAAsB;QACtB,iCAAiC;IACnC,eAAe,EAAE,CAAC;IAClB,SAAS,EAAE,EAAE;IACb,sBAAsB,EAAE,wCAAwC;CACjE,CAAC;AAEF,MAAM,OAAO,OAAO;IACT,MAAM,CAAS;IACf,IAAI,CAAW;IACf,IAAI,CAAS;IACb,KAAK,CAAS;IACd,cAAc,CAAS;IACvB,QAAQ,CAAY;IACpB,qBAAqB,CAAS;IAEvC,YAAY,IAAI,GAAG,MAAM;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC,qBAAqB,GAAG,MAAM,CACjC,IAAI,CAAC,IAAI,CAAC,sBAAsB;YAC9B,4DAA4D,CAC/D,CAAC;IACJ,CAAC;IAED,gFAAgF;IACxE,SAAS,CAAC,MAAc;QAC9B,OAAO;YACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;YAChD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;SACpD,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,MAAc;QAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,SAAS;YAChC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAgC,CAAC;gBACnF,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,OAAO,IAAI,CAAC;YACpD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,uBAAuB,MAAM,SAAS,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QACD,MAAM,CAAC,OAAO,CACZ,wBAAwB,MAAM,2CAA2C,EACzE,gBAAgB,CACjB,CAAC;QACF,OAAO,eAAe,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,SAAS,GAAG,GAAG,EAAE,SAAoB,EAAE,SAAS,GAAG,SAAS;QAC5E,MAAM,QAAQ,GAAG,MAAM,CACrB,IAAI,CAAC,IAAI,CAAC,sBAAsB,IAAI,YAAY,CAAC,sBAAsB,IAAI,EAAE,CAC9E,CAAC;QACF,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnG,MAAM,QAAQ,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,MAAM,OAAO,GAA2B;YACtC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,gBAAgB,EAAE,WAAW;YAC7B,SAAS;YACT,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE,QAAQ;SACpB,CAAC;QAEF,IAAI,MAAM,GAAG,QAAQ,CAAC;QACtB,IAAI,UAAU,GAAkB,IAAI,CAAC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,WAAW,GAAG,IAAI,GAAG,GAAG,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,SAAS;YAC5C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,8EAA8E;QAC9E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9D,IAAI,QAAQ;YAAE,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEvC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,CACZ,8CAA8C,UAAU,4BAA4B,EACpF,gBAAgB,CACjB,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,oBAAoB,CAAC,UAAU,GAAG,EAAE;QAClC,OAAO,iBAAiB,IAAI,CAAC,qBAAqB,sBAAsB,UAAU,EAAE,CAAC;IACvF,CAAC;IAED,iBAAiB,CAAC,MAAc;QAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3F,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC;IAC/D,CAAC;CACF;AAED,SAAS,MAAM,CAAC,CAAU;IACxB,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,IAAI,eAAe,GAAmB,IAAI,CAAC;AAE3C,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,MAAM;IACtC,IAAI,eAAe,KAAK,IAAI,IAAI,eAAe,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAChE,eAAe,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/core/rate_limit.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Local rate limiting using an in-memory store. No Redis or external services required.
+ * Port of axoniz/core/rate_limit.py (sliding-window log, single-threaded JS event loop).
+ */
+export declare class RateLimiter {
+    protected readonly buckets: Map<string, number[]>;
+    /**
+     * Check whether a request is allowed under the rate limit.
+     * Records the request when allowed, mirroring the Python implementation.
+     */
+    isAllowed(key: string, maxRequests?: number, windowSeconds?: number): boolean;
+    /** Remaining requests for a key within the current window. */
+    getRemaining(key: string, maxRequests?: number, windowSeconds?: number): number;
+    /** Seconds until the oldest request in the window expires (0 when not limited). */
+    getRetryAfter(key: string, windowSeconds?: number): number;
+    /** Reset rate limit for a key. */
+    reset(key: string): void;
+    /** Number of tracked keys (useful for metrics/tests). */
+    size(): number;
+}
+/** Get the global rate limiter instance. */
+export declare function getRateLimiter(): RateLimiter;
+//# sourceMappingURL=rate_limit.d.ts.map

package/dist/core/rate_limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate_limit.d.ts","sourceRoot":"","sources":["../../src/core/rate_limit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,WAAW;IACtB,SAAS,CAAC,QAAQ,CAAC,OAAO,wBAA+B;IAEzD;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,SAAM,EAAE,aAAa,SAAK,GAAG,OAAO,CAoBrE;IAED,8DAA8D;IAC9D,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,SAAM,EAAE,aAAa,SAAK,GAAG,MAAM,CAMvE;IAED,mFAAmF;IACnF,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,SAAK,GAAG,MAAM,CAKrD;IAED,kCAAkC;IAClC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,yDAAyD;IACzD,IAAI,IAAI,MAAM,CAEb;CACF;AAKD,4CAA4C;AAC5C,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}

package/dist/core/rate_limit.js

@@ -0,0 +1,62 @@
+/**
+ * Local rate limiting using an in-memory store. No Redis or external services required.
+ * Port of axoniz/core/rate_limit.py (sliding-window log, single-threaded JS event loop).
+ */
+export class RateLimiter {
+    buckets = new Map();
+    /**
+     * Check whether a request is allowed under the rate limit.
+     * Records the request when allowed, mirroring the Python implementation.
+     */
+    isAllowed(key, maxRequests = 100, windowSeconds = 60) {
+        const now = Date.now() / 1000;
+        const cutoff = now - windowSeconds;
+        let requests = this.buckets.get(key);
+        if (!requests) {
+            requests = [];
+            this.buckets.set(key, requests);
+        }
+        // Drop entries outside the window (oldest first, so shift from the front).
+        let drop = 0;
+        while (drop < requests.length && requests[drop] < cutoff)
+            drop++;
+        if (drop > 0)
+            requests.splice(0, drop);
+        if (requests.length < maxRequests) {
+            requests.push(now);
+            return true;
+        }
+        return false;
+    }
+    /** Remaining requests for a key within the current window. */
+    getRemaining(key, maxRequests = 100, windowSeconds = 60) {
+        const now = Date.now() / 1000;
+        const cutoff = now - windowSeconds;
+        const requests = this.buckets.get(key) ?? [];
+        const current = requests.filter((t) => t > cutoff).length;
+        return Math.max(0, maxRequests - current);
+    }
+    /** Seconds until the oldest request in the window expires (0 when not limited). */
+    getRetryAfter(key, windowSeconds = 60) {
+        const requests = this.buckets.get(key) ?? [];
+        if (requests.length === 0)
+            return 0;
+        const elapsed = Date.now() / 1000 - requests[0];
+        return Math.max(0, Math.ceil(windowSeconds - elapsed));
+    }
+    /** Reset rate limit for a key. */
+    reset(key) {
+        this.buckets.delete(key);
+    }
+    /** Number of tracked keys (useful for metrics/tests). */
+    size() {
+        return this.buckets.size;
+    }
+}
+/* Global rate limiter instance */
+const limiter = new RateLimiter();
+/** Get the global rate limiter instance. */
+export function getRateLimiter() {
+    return limiter;
+}
+//# sourceMappingURL=rate_limit.js.map

package/dist/core/rate_limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate_limit.js","sourceRoot":"","sources":["../../src/core/rate_limit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,WAAW;IACH,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEzD;;;OAGG;IACH,SAAS,CAAC,GAAW,EAAE,WAAW,GAAG,GAAG,EAAE,aAAa,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,GAAG,GAAG,aAAa,CAAC;QAEnC,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,2EAA2E;QAC3E,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM;YAAE,IAAI,EAAE,CAAC;QACjE,IAAI,IAAI,GAAG,CAAC;YAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAEvC,IAAI,QAAQ,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8DAA8D;IAC9D,YAAY,CAAC,GAAW,EAAE,WAAW,GAAG,GAAG,EAAE,aAAa,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,GAAG,GAAG,aAAa,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,mFAAmF;IACnF,aAAa,CAAC,GAAW,EAAE,aAAa,GAAG,EAAE;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,GAAW;QACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,yDAAyD;IACzD,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AAED,kCAAkC;AAClC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,4CAA4C;AAC5C,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC"}