@entrox/agent-brain

A lightweight, extensible AI Agent Runtime for Node.js.

Features

• Provider System
• Streaming Support
• Tool Calling
• Multi-Step Agent Loop
• Skills System
• Memory System
• Thread Memory
• MCP Adapter
• Event System
• Error Handling
• Logger
• TypeScript First

Installation

pnpm add entrox-agent-brain

Quick Start

import {
  createAgent,
  MockProvider
} from "entrox-agent-brain";

const agent = createAgent({
  provider: new MockProvider()
});

const result = await agent.invoke(
  "Hello Agent"
);

console.log(result);

Providers

Supported Providers:

• DeepSeek
• OpenRouter
• OpenAI
• Ollama

Example:

const agent = createAgent({
  provider: new DeepSeekProvider({
    apiKey: process.env.DEEPSEEK_API_KEY!
  })
});

Tools

registry.register(
  new TimeTool()
);

Tool Execution:

{
  "tool": "time"
}

Skills

registry.register(
  new BookingSkill()
);

Example:

await skillManager.execute(
  "book a room"
);

Memory

memory.set(
  "user",
  data
);

Thread Memory

await threadMemory.append(
  "thread-1",
  {
    role: "user",
    content: "Hello"
  }
);

MCP Adapter

registry.register(
  new MCPTool(
    client,
    "create_booking",
    "Create Booking"
  )
);

Streaming

for await (
  const chunk of provider.stream!(
    messages
  )
) {
  process.stdout.write(chunk);
}

Architecture

User
 ↓
Agent
 ↓
Orchestrator
 ↓
Skills
 ↓
Tools
 ↓
MCP
 ↓
External Systems

Roadmap

v1.0

• Runtime
• Providers
• Tools
• Memory
• Skills
• MCP

v1.1

• Multi-Agent Runtime
• Supervisor Agent

v1.2

• Distributed Agents
• Agent Marketplace

License

MIT