aurix-ai 0.1.0

package/README.md

@@ -0,0 +1,329 @@
+# AURIX
+
+<p align="center">
+  <img src="https://img.shields.io/badge/license-MIT-22c55e?style=for-the-badge" alt="MIT" />
+  <img src="https://img.shields.io/npm/v/aurix-ai?style=for-the-badge&color=cb3837&logo=npm&logoColor=white" alt="npm" />
+  <img src="https://img.shields.io/badge/runtime-Node.js%20%7C%20Bun-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Runtime" />
+  <img src="https://img.shields.io/badge/language-TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript" />
+  <img src="https://img.shields.io/badge/native-Rust-dea584?style=for-the-badge&logo=rust&logoColor=white" alt="Rust" />
+  <img src="https://img.shields.io/badge/interface-Terminal%20%2B%20Chat-7c3aed?style=for-the-badge" alt="Interface" />
+</p>
+
+<p align="center">
+  <b>Open-source terminal AI agent that codes, researches, browses, and solves — with real hands.</b>
+</p>
+
+<p align="center">
+  AURIX is a developer-first AI workspace that lives in your terminal.<br/>
+  It inspects repos, edits files, runs commands, performs cited research, automates stealth browsers<br/>
+  with built-in CAPTCHA solving, generates documents — and stays accessible from Discord, Telegram, and WhatsApp.
+</p>
+
+---
+
+<!--
+  TODO: Add terminal demo GIF here
+  Record with: asciinema rec demo.cast && agg demo.cast demo.gif
+  Or use: terminalizer record demo && terminalizer render demo
+-->
+
+![AURIX Demo](docs/assets/aurix-demo.png)
+
+## What is AURIX?
+
+AURIX is an **Autonomous Multi-Agent AI Workspace**. It is not a chat wrapper — it is an AI that has hands, eyes, and memory.
+
+Instead of just generating text, AURIX operates directly inside your environment to close the execution loop. It comes packed with **46+ built-in tools**, a **Rust-powered token counter** for accurate context management, a **stealth browser engine** with CAPTCHA solving, and **100+ CTF/security skills** for offensive security testing.
+
+1. **It Reads & Browses:** Navigates your folders, reads your codebase, searches the web, and automates a stealth Chromium browser (CloakBrowser) that solves CAPTCHAs including image challenges, sliders, and FunCaptcha.
+2. **It Thinks:** Delegates complex tasks to a swarm of sub-agents. Accurate BPE token counting via a native Rust module ensures context is never wasted.
+3. **It Acts:** Writes files, runs shell commands, creates Git commits, manages Docker containers, queries databases, drags sliders, and clicks image tiles.
+4. **It Verifies:** If a test fails or a build crashes, AURIX reads the error log and fixes the code autonomously.
+5. **It Hunts:** Ships with 100+ CTF and penetration testing skills covering web exploitation, binary pwn, crypto, reverse engineering, forensics, OSINT, and AI/ML security.
+
+## Standout Features
+
+### Stealth Browser with CAPTCHA Solving
+
+AURIX ships with **CloakBrowser** — a patched Chromium with source-level anti-detection that passes reCAPTCHA scoring, Cloudflare Turnstile, and fingerprint checks. The built-in CAPTCHA solver handles:
+
+| CAPTCHA Type | Method |
+|---|---|
+| **reCAPTCHA v2** | Auto-click checkbox + image grid solver (screenshots each tile, AI vision picks matches) |
+| **hCaptcha** | Same image grid solving flow |
+| **Cloudflare Turnstile** | Managed challenge auto-click |
+| **FunCaptcha (Arkose Labs / Microsoft)** | Puzzle type detection + rotation, drag-drop, image-match solving |
+| **GeeTest / MTCaptcha** | Slider drag with human-like easing + micro-jitter |
+| **Text CAPTCHA** | Screenshot + OCR via AI vision |
+
+New browser actions: `captcha-grid`, `click-tile`, `captcha-verify`, `drag-to`, `hold-click` — all with human-like mouse behavior (eased curves, random delays, micro-jitter).
+
+### Rust-Powered Token Counter
+
+Token counting was wildly inaccurate (`Math.ceil(text.length / 4)` underestimates by 30-60% for code). Now uses a **native Rust BPE tokenizer** via napi-rs:
+
+- **tiktoken-rs** with `cl100k_base` (GPT-4) and `o200k_base` (GPT-4o) encodings
+- Accurate context management — no more premature overflow or wasted context window
+- Real API usage tracking from `response.usage.promptTokens` / `completionTokens`
+- Automatic JS fallback if Rust toolchain unavailable
+
+### Bug Hunt Skill — 100+ CTF & Security Skills
+
+Bundled with comprehensive offensive security skills covering every CTF category:
+
+| Category | Files | Covers |
+|---|---|---|
+| **Web** | 20 | SQLi, XSS, SSTI, SSRF, JWT, prototype pollution, file upload RCE, 500+ techniques |
+| **Pwn** | 18 | Buffer overflow, ROP, heap, format string, kernel exploitation, seccomp bypass |
+| **Crypto** | 16 | RSA, AES, ECC, PRNG, ZKP, lattice, Coppersmith, padding oracle |
+| **Reverse** | 18 | ELF/PE analysis, VMs, WASM, obfuscation, game clients |
+| **Forensics** | 14 | Disk images, memory dumps, PCAP, steganography, event logs |
+| **Misc** | 12 | Jails, encodings, RF/SDR, esoteric languages, game theory |
+| **Malware** | 3 | C2 traffic, packers, .NET analysis |
+| **OSINT** | 3 | Social media, geolocation, DNS, public records |
+| **AI/ML** | 3 | Adversarial examples, prompt injection, model extraction |
+
+## What's New in v1.0.0
+
+This is a major release with significant new capabilities:
+
+### CAPTCHA Resolver
+Full end-to-end CAPTCHA solving built into the browser tool — not a third-party API, the agent itself solves challenges:
+- **Image Grid Solver** — Screenshots each tile individually, AI vision analyzes which match the instruction ("select traffic lights"), clicks matching tiles, handles dynamic tile replacement in reCAPTCHA
+- **Slider Solver** — Human-like drag with eased curves + micro-jitter for GeeTest, MTCaptcha, and custom sliders
+- **FunCaptcha Solver** — Auto-detects puzzle type (rotation, drag-drop, image-match, counting) from Arkose Labs / Microsoft CAPTCHA
+- **Hold-Click** — Press-and-hold interactions with human jitter for advanced challenge types
+- **Structured Error Returns** — All CAPTCHA actions return `[OK]`, `[ERROR]`, or `[WARN]` status so the agent knows exactly what succeeded and what to retry
+
+### CloakBrowser Engine
+Replaced plain Playwright with **CloakBrowser** — a patched Chromium with source-level anti-detection:
+- Undetectable webdriver spoof, WebGL/Canvas fingerprint, plugin/language spoofing
+- Persistent browser profiles (cookies, sessions survive across runs)
+- Human-like mouse, keyboard, and scroll behavior built-in
+- Auto-downloads patched Chromium binary on first run
+
+### Rust Native Token Counter
+New `native/token-counter/` module built with **tiktoken-rs** via napi-rs:
+- Accurate BPE token counting (was underestimating by 30-60%)
+- Supports `cl100k_base` (GPT-4) and `o200k_base` (GPT-4o) encodings
+- Real API usage tracking from `response.usage.promptTokens` / `completionTokens`
+- Automatic JS fallback if Rust unavailable
+
+### Bug Hunt Skill
+Imported 100+ CTF and penetration testing skills from `ljagiello/ctf-skills`:
+- 9 categories covering web, pwn, crypto, reverse, forensics, misc, malware, OSINT, AI/ML
+- Dispatcher skill that categorizes challenges by file type, keywords, and service behavior
+- Routes to the matching sub-skill with deep specialized techniques
+
+### Other Improvements
+- **1000 iteration limit** (up from 200) — agents can work on complex tasks without stopping prematurely
+- **Structured tool responses** — `[OK]` / `[ERROR]` / `[WARN]` prefixes for unambiguous agent feedback
+- **30 browser actions** — from basic navigation to full CAPTCHA solving workflows
+- **One-command install** — `npm install -g aurix-ai` and you're ready to go
+
+## Real-World Use Cases
+
+### The "Hands-Free" Developer
+> **You:** *"Look at `auth.ts`. There's a bug where JWT tokens expire too early. Fix it, run the test suite, and if it passes, push it."*
+> **AURIX:** Reads the file, edits the code, runs tests, sees an error, fixes it, runs again, executes `git push`.
+
+### The Deep Researcher
+> **You:** *"Write a 5-page PDF report on how Vercel alternatives are perceived on Reddit and HackerNews."*
+> **AURIX:** Spawns a 13-agent research pipeline. Scrapes forums, debates claims, compiles data into markdown, converts to styled PDF.
+
+### The Browser Automator
+> **You:** *"Go to this site, fill the registration form, solve whatever CAPTCHA pops up, and submit."*
+> **AURIX:** Opens stealth browser, fills form, detects reCAPTCHA image challenge, screenshots each tile, uses vision to pick matching images, clicks verify.
+
+### The CTF Player
+> **You:** *"Here's a challenge file. Find the flag."*
+> **AURIX:** Triages the file, categorizes it (crypto? web? pwn?), loads the matching Bug Hunt sub-skill, applies specialized techniques, captures the flag.
+
+## Key Features
+
+- **Terminal-First UI (TUI):** Beautiful, interactive CLI built with React Ink.
+- **Multi-Platform Gateway:** Access from Terminal, Discord, Telegram, or WhatsApp. Memory and context persist everywhere.
+- **Self-Extending:** `> install skill from github.com/user/awesome-skill` — clones, validates, and rebuilds without restarting.
+- **Accurate Token Counting:** Native Rust BPE tokenizer prevents context waste.
+- **Stealth Browser:** CloakBrowser with source-level Chromium patches, human-like behavior, and full CAPTCHA solving.
+- **1000 Iteration Limit:** Agents can work on complex tasks without hitting premature limits.
+
+## How It Works Under the Hood
+
+AURIX is powered by a LangGraph-based architecture that orchestrates multiple specialized AI agents:
+
+1. **The Orchestrator (Supervisor Agent):** Analyzes your request and delegates to specialist agents.
+2. **The Specialists:** Code Reviewer, Security Analyst, Deep Researcher, CTF Player — working in parallel.
+3. **The Execution Engine:** 46+ built-in tools including a stealth browser, Rust token counter, and Docker manager.
+4. **The Verification Loop:** A Critic Agent reviews output before returning. If execution fails, the loop retries with exponential backoff.
+
+## Quick Start
+
+### Requirements
+
+- **Node.js 22+** or [Bun](https://bun.sh) v1.0+
+- API key for at least one LLM provider (OpenAI, Anthropic, or others)
+- Rust toolchain (optional — improves token counting accuracy)
+- Python 3.12+ (optional, for research-forums skill)
+
+### Install via npm (Recommended)
+
+The fastest way to get started. Works on any machine with Node.js 22+.
+
+```bash
+npm install -g aurix-ai
+```
+
+Then run:
+```bash
+aurix setup     # Configure LLM provider + API key (first time only)
+aurix           # Launch the terminal AI workspace
+```
+
+That's it. The `aurix` command is now available globally in your terminal.
+
+To update later:
+```bash
+npm update -g aurix-ai
+```
+
+### Install via Git Clone (For Development)
+
+Use this method if you want to modify the source code or contribute.
+
+```bash
+git clone https://github.com/DekaPrayoga/AurixAgent.git
+cd AurixAgent
+npm install         # installs dependencies + builds Rust token counter
+npm run build       # compiles TypeScript
+npm link            # links `aurix` command to your PATH
+```
+
+After linking, `aurix` works from any directory:
+```bash
+aurix setup
+aurix
+```
+
+### Building the Rust Token Counter (Optional)
+
+The npm package ships with a pre-built `.node` binary (7.2 MB). If you install from source and have Rust installed, the postinstall script automatically builds it via napi-rs.
+
+**Why does the Rust build directory take ~150 MB?** The `target/release/deps/` folder contains ~147 MB of intermediate `.rlib` compilation files — one for every crate in the dependency tree (tiktoken-rs embeds the full BPE vocabulary of 100k+ tokens). The final compiled binary is only 7.2 MB, and that's the only file included in the npm package.
+
+If Rust is not available, the agent falls back to a JS-based token counter automatically — no functionality is lost, just slightly less accurate counting.
+
+```bash
+# Install Rust (if not already installed)
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+
+# Then rebuild the native module
+cd native/token-counter
+npx napi build --release --platform
+```
+
+## Usage
+
+### 1. Initial Setup
+```bash
+aurix setup        # Configure LLM provider, API key, model
+```
+
+### 2. Start Interactive Session
+```bash
+aurix              # Launch the terminal AI workspace
+```
+
+### 3. Start Multi-Platform Gateway
+```bash
+aurix gateway      # Run as Discord/Telegram/WhatsApp bot
+```
+
+### Other Commands
+```bash
+aurix sessions     # List previous sessions
+aurix --resume ID  # Resume a specific session
+aurix update       # Update to latest version
+aurix --help       # Show all commands
+```
+
+## Architecture
+
+```text
+src/
+  agent/       Core agent loop, context, memory, TokenCounter
+  tools/       46+ tools (Browser, Research, Docker, Git, etc.)
+  cli/         Terminal UI (React Ink)
+  gateway/     Discord / Telegram / WhatsApp integration
+  providers/   LLM providers (OpenAI, Anthropic, LangChain)
+  skills/      Skill registry and loader
+
+native/
+  token-counter/   Rust BPE tokenizer (tiktoken-rs via napi-rs)
+    Cargo.toml     Rust crate config
+    src/lib.rs     count_tokens(), count_tokens_batch()
+
+skills/
+  bug-hunt/        100+ CTF & security testing skills
+    ctf-web/       Web exploitation (SQLi, XSS, SSTI, SSRF, JWT...)
+    ctf-pwn/       Binary exploitation (ROP, heap, kernel...)
+    ctf-crypto/    Cryptography (RSA, AES, ECC, PRNG, ZKP...)
+    ctf-reverse/   Reverse engineering (ELF/PE, VMs, WASM...)
+    ctf-forensics/ Forensics (disk, memory, PCAP, stego...)
+    ctf-misc/      Jails, encodings, RF/SDR, game theory
+    ctf-malware/   Malware analysis (C2, packers, .NET)
+    ctf-osint/     OSINT (social media, geolocation, DNS)
+    ctf-ai-ml/     AI/ML security (adversarial, prompt injection)
+    ctf-writeup/   Write-up generator
+```
+
+## The Arsenal: 46+ Built-in Tools
+
+| Category | Capabilities |
+| --- | --- |
+| **File & Code** | Read, write, edit, search files, terminal exec, code sandbox |
+| **Browser** | Stealth Chromium (CloakBrowser), CAPTCHA solving (reCAPTCHA, hCaptcha, FunCaptcha, Turnstile, GeeTest, sliders), drag-to, hold-click, persistent profiles |
+| **Web** | Web search, scraper, YouTube |
+| **Office** | PDF, Excel, PowerPoint generation, SMTP Email |
+| **DevOps** | Docker, VPS management, deployments, cloud provisioning |
+| **Finance** | Trading analysis, EVM/Solana blockchain tools |
+| **Security** | Bug Hunt skills (100+ CTF techniques), OSINT, vulnerability scanning |
+| **Creative** | GIF search, text humanizer, architecture diagrams |
+| **Utility** | Maps, notifier, music player, todo, memory |
+| **GitHub** | PR creation, issue management, repo info |
+| **MCP** | Manage Model Context Protocol servers |
+| **Planning** | Project planning, Kanban, story decomposition |
+
+## Self-Extension
+
+AURIX can install new skills from any GitHub repository at runtime:
+
+```text
+> install skill from github.com/user/awesome-skill
+```
+
+It clones, validates, registers, and rebuilds automatically. No restart needed.
+
+## Supported LLM Providers
+
+- OpenAI (GPT-4, GPT-4o, etc.)
+- Anthropic (Claude 3.5, Claude 4)
+- Any OpenAI-compatible endpoint
+- LangChain integrations
+
+## Environment Variables
+
+```bash
+cp .env.example .env
+```
+
+Key variables:
+- `OPENAI_API_KEY` — OpenAI access
+- `ANTHROPIC_API_KEY` — Anthropic access
+- `DISCORD_TOKEN` — Discord bot gateway
+- `TELEGRAM_BOT_TOKEN` — Telegram gateway
+- `BRAVE_API_KEY` — Enhanced web search (optional)
+
+## License
+
+MIT

package/bin/aurix

@@ -0,0 +1,172 @@
+#!/usr/bin/env bash
+# AURIX Agent — modern CLI launcher
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")/.." && pwd)"
+DIST="$SCRIPT_DIR/dist/index.js"
+VERSION=$(sed -n 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$SCRIPT_DIR/package.json" 2>/dev/null || echo "0.1.0")
+
+export AURIX_HOME="$SCRIPT_DIR"
+export PATH="$HOME/.bun/bin:$PATH"
+
+# --- runtime detection ---
+RUNTIME=""
+if [ -x "$HOME/.bun/bin/bun" ]; then
+  RUNTIME="$HOME/.bun/bin/bun"
+elif command -v bun &>/dev/null; then
+  RUNTIME="bun"
+elif command -v node &>/dev/null; then
+  RUNTIME="node"
+else
+  echo -e "\033[38;2;224;108;117merror\033[0m: node or bun is required"
+  echo "  install node: https://nodejs.org"
+  echo "  install bun:  curl -fsSL https://bun.sh/install | bash"
+  exit 1
+fi
+
+# --- auto-build if dist missing or stale ---
+NEED_BUILD=0
+if [ ! -f "$DIST" ]; then
+  NEED_BUILD=1
+else
+  SRC_NEWEST=$(find "$SCRIPT_DIR/src" -name '*.ts' -o -name '*.tsx' 2>/dev/null | xargs stat -c '%Y' 2>/dev/null | sort -rn | head -1)
+  DIST_TIME=$(stat -c '%Y' "$DIST" 2>/dev/null || echo 0)
+  if [ -n "$SRC_NEWEST" ] && [ "$SRC_NEWEST" -gt "$DIST_TIME" ]; then
+    NEED_BUILD=1
+  fi
+fi
+if [ "$NEED_BUILD" -eq 1 ]; then
+  echo -e "\033[90mbuilding...\033[0m"
+  cd "$SCRIPT_DIR" && npx tsc >/dev/null 2>&1
+fi
+
+# --- help ---
+show_help() {
+  echo ""
+  echo -e "  \033[38;2;250;178;131mAURIX\033[0m v${VERSION} — agentic ai terminal workspace"
+  echo ""
+  echo -e "  \033[1mUsage:\033[0m aurix [command] [options]"
+  echo ""
+  echo -e "  \033[1mCommands:\033[0m"
+  echo -e "    \033[38;2;250;178;131m(default)\033[0m      Start interactive session"
+  echo -e "    \033[38;2;250;178;131msetup\033[0m          Configure provider, API key, model"
+  echo -e "    \033[38;2;250;178;131mgateway\033[0m        Start messaging gateway (Telegram, Discord, etc.)"
+  echo -e "    \033[38;2;250;178;131mupdate\033[0m         Update AURIX to latest version"
+  echo -e "    \033[38;2;250;178;131msessions\033[0m       List saved sessions"
+  echo ""
+  echo -e "  \033[1mOptions:\033[0m"
+  echo -e "    --resume <id>   Resume a previous session"
+  echo -e "    --continue      Continue last session"
+  echo -e "    --setup         Force setup wizard"
+  echo -e "    --no-kitty      Skip kitty terminal detection"
+  echo -e "    -v, --version   Show version"
+  echo -e "    -h, --help      Show this help"
+  echo ""
+  echo -e "  \033[90mExamples:\033[0m"
+  echo -e "    aurix"
+  echo -e "    aurix setup"
+  echo -e "    aurix --resume abc123"
+  echo -e "    aurix gateway"
+  echo ""
+}
+
+# --- version ---
+show_version() {
+  echo "aurix v${VERSION}"
+}
+
+# --- list sessions ---
+list_sessions() {
+  local sessions_dir="$HOME/.aurix/memories/sessions"
+  if [ ! -d "$sessions_dir" ] || [ -z "$(ls -A "$sessions_dir"/*.md 2>/dev/null)" ]; then
+    echo -e "  \033[90mno saved sessions found\033[0m"
+    return
+  fi
+  echo ""
+  echo -e "  \033[38;2;250;178;131mSaved sessions:\033[0m"
+  echo ""
+  for f in "$sessions_dir"/*.md; do
+    local name=$(basename "$f" .md)
+    local lines=$(wc -l < "$f" | tr -d ' ')
+    echo -e "    \033[38;2;92;156;245m${name}\033[0m  \033[90m(${lines} lines)\033[0m"
+  done
+  echo ""
+  echo -e "  \033[90mresume with:\033[0m aurix --resume <id>"
+  echo ""
+}
+
+# --- update ---
+do_update() {
+  echo -e "  \033[38;2;250;178;131mUpdating AURIX...\033[0m"
+  cd "$SCRIPT_DIR"
+  if [ -f "package.json" ]; then
+    $RUNTIME install 2>/dev/null || npm install 2>/dev/null
+    npx tsc >/dev/null 2>&1
+    echo -e "  \033[38;2;127;216;143m✓\033[0m updated to latest"
+  else
+    echo -e "  \033[38;2;224;108;117merror\033[0m: not a valid aurix installation"
+    exit 1
+  fi
+}
+
+# --- run with optional kitty ---
+run_aurix() {
+  if [ "${AURIX_KITTY:-}" = "1" ] && command -v kitty &>/dev/null && [ -z "${KITTY_WINDOW_ID:-}" ]; then
+    exec kitty \
+      --override background='#0a0a0a' \
+      --override foreground='#eeeeee' \
+      --override cursor='#fab283' \
+      --override cursor_text_color='#0a0a0a' \
+      --override selection_background='#282828' \
+      --override selection_foreground='#eeeeee' \
+      --override tab_bar_background='#0a0a0a' \
+      --override active_tab_background='#1e1e1e' \
+      --override active_tab_foreground='#fab283' \
+      --override inactive_tab_background='#0a0a0a' \
+      --override inactive_tab_foreground='#808080' \
+      --override hide_window_decorations='yes' \
+      --title 'AURIX Agent' \
+      $RUNTIME "$DIST" "$@"
+  else
+    exec $RUNTIME "$DIST" "$@"
+  fi
+}
+
+# --- parse args ---
+case "${1:-}" in
+  -h|--help|help)
+    show_help
+    exit 0
+    ;;
+  -v|--version|version)
+    show_version
+    exit 0
+    ;;
+  setup)
+    shift
+    run_aurix --setup "$@"
+    ;;
+  gateway)
+    shift
+    run_aurix gateway "$@"
+    ;;
+  update)
+    do_update
+    exit 0
+    ;;
+  sessions|session|ls)
+    list_sessions
+    exit 0
+    ;;
+  --no-kitty)
+    shift
+    export AURIX_NO_KITTY=1
+    run_aurix "$@"
+    ;;
+  "")
+    run_aurix
+    ;;
+  *)
+    run_aurix "$@"
+    ;;
+esac

package/bin/aurix.cmd

@@ -0,0 +1,23 @@
+@echo off
+setlocal
+
+set "SCRIPT_DIR=%~dp0.."
+set "DIST=%SCRIPT_DIR%\dist\index.js"
+
+for /f "tokens=*" %%i in ('node -e "console.log(require('%SCRIPT_DIR%\package.json').version)"') do set VERSION=%%i
+
+set "AURIX_HOME=%SCRIPT_DIR%"
+
+if not exist "%DIST%" (
+    echo building...
+    pushd "%SCRIPT_DIR%" && npx tsc >nul 2>nul && popd
+)
+
+where bun >nul 2>nul
+if %errorlevel% equ 0 (
+    bun "%DIST%" %*
+) else (
+    echo error: bun is required (OpenTUI needs bun runtime)
+    echo   install bun: npm install -g bun
+    exit /b 1
+)

package/dist/agent/AgentLoop.d.ts

@@ -0,0 +1,52 @@
+import type { AurixConfig } from './Config.js';
+import type { Message } from '../providers/index.js';
+import type { ToolRegistry } from '../tools/Registry.js';
+import { MemoryEngine } from './MemoryEngine.js';
+import type { ResearchDepth } from './research/types.js';
+export interface AgentEvent {
+    type: 'text' | 'tool_start' | 'tool_end' | 'error' | 'done' | 'route' | 'compact' | 'research';
+    data: string;
+    toolName?: string;
+    toolArgs?: Record<string, unknown>;
+}
+export declare class AgentLoop {
+    private provider;
+    private registry;
+    private config;
+    private messages;
+    private maxIterations;
+    private multiAgentMode;
+    private multiAgent?;
+    private contextManager;
+    private memoryEngine;
+    private researchPipeline?;
+    private interrupted;
+    private _inputTokens;
+    private _outputTokens;
+    private _safetyRefusalCount;
+    constructor(config: AurixConfig, registry: ToolRegistry);
+    toggleMultiAgent(): boolean;
+    isMultiAgent(): boolean;
+    interrupt(): void;
+    setMaxIterations(n: number): void;
+    getContextStats(): import("./ContextManager.js").ContextStats;
+    getTokenStats(): {
+        input: number;
+        output: number;
+        total: number;
+        pct: number;
+    };
+    run(userMessage: string): AsyncGenerator<AgentEvent>;
+    private runMultiAgent;
+    getResearchMode(): ResearchDepth;
+    runResearch(query: string): AsyncGenerator<AgentEvent>;
+    getMessages(): Message[];
+    clearHistory(): void;
+    setProvider(config: Partial<AurixConfig>): void;
+    getModel(): string;
+    getProviderName(): string;
+    getMemoryEngine(): MemoryEngine;
+    loadSession(sessionId: string): number;
+    saveSession(sessionId?: string): string;
+}
+//# sourceMappingURL=AgentLoop.d.ts.map

package/dist/agent/AgentLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentLoop.d.ts","sourceRoot":"","sources":["../../src/agent/AgentLoop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA8DzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY;IAWvD,gBAAgB,IAAI,OAAO;IAQ3B,YAAY,IAAI,OAAO;IAIvB,SAAS,IAAI,IAAI;IAIjB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjC,eAAe;IAIf,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAUvE,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;YAuW5C,aAAa;IAyB5B,eAAe,IAAI,aAAa;IAIzB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IAgC7D,WAAW,IAAI,OAAO,EAAE;IAIxB,YAAY,IAAI,IAAI;IAKpB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAW/C,QAAQ,IAAI,MAAM;IAIlB,eAAe,IAAI,MAAM;IAIzB,eAAe,IAAI,YAAY;IAI/B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQtC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;CAcxC"}