{"id":"0409fc65-0641-4dd2-bbc7-20a55edc87a7","slug":"art","kind":"mcp","name":"ART","summary":"ART is a powerful, modular, and browser-first JavaScript/TypeScript framework for building sophisticated LLM-powered intelligent agents capable of complex reasoning, planning, and tool usage.","owner":"InferQ","repoUrl":"https://github.com/InferQ/ART","license":"MIT","licenseTier":"permissive","trust":"community","stars":2,"match":null,"fewStars":true,"format":"mcp","createdAt":"2025-04-03T03:09:32.000Z","addedAt":"2026-10-21T18:35:00.869Z","logoUrl":"https://avatars.githubusercontent.com/u/169370796?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["browser-web"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-22T21:47:03.582Z","sample":false,"url":"https://conduits.dev/tools/art","language":"TypeScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# ✨ ART: Agentic Runtime Framework \"Version\n\n

\n \"ART\n

\n

\n \"ART\n

\n\n**ART (Agentic Reactive Triad) is a powerful, modular, and browser-first TypeScript framework for building sophisticated LLM-powered agents capable of complex reasoning, planning, and tool usage.**\n\nIt provides the missing runtime for production-ready agentic systems, emphasizing **Reliability**, **Observability**, and **Resilience**.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\n[![Sponsor on Patreon](https://img.shields.io/badge/Sponsor%20on-Patreon-F96854?logo=patreon&style=flat)](https://www.patreon.com/HashanWickramasinghe)\n\n## The Reactive Triad\n\nART is architected around three core nodes that ensure your agents are production-ready:\n\n1. **Reactive Agent (Orchestration):** The flagship `PESAgent` uses a **Plan-Execute-Synthesize** workflow to handle complex, multi-step tasks with dynamic refinement.\n2. **Persistent State (Memory):** Durable state management that persists across sessions, crashes, and human-in-the-loop pauses.\n3. **Standardized UI (Observability):** A reactive socket system that streams granular \"thoughts,\" tool calls, and status updates directly to your frontend.\n\n## Key Features\n\n#### 🧠 Advanced Reasoning (PES Agent)\n\n- **Structured Planning:** Decomposes user intent into a discrete `TodoList` with dependency mapping.\n- **TAEF (Tool-Aware Execution Framework):** Strictly validates tool usage to eliminate hallucinations and ensure protocol adherence.\n- **Dynamic Refinement:** Self-correcting plans that adapt in real-time based on tool outputs.\n- **Synthesis Engine:** Aggregates task results into rich responses with UI metadata and citations.\n\n#### 🛡️ Production Robustness\n\n- **HITL V2 (Human-in-the-Loop):** Seamlessly pause execution for human approval with full state preservation and resumption.\n- **Crash Recovery:** Automatic state hydration ensures agents resume exactly where they left off.\n- **A2A (Agent-to-Agent) Delegation:** Coordinate complex workflows by delegating sub-tasks to specialized agents.\n- **Step Output Table:** Persists all historical tool results for consistent cross-step data access.\n\n#### 🔌 Universal Connectivity\n\n- **Multi-Provider Support:** First-class support for Gemini (Thinking), Claude (Extended Thinking), GPT (Reasoning), DeepSeek, Groq, and local models via Ollama.\n- **MCP (Model Context Protocol):** Dynamically discover and execute tools from any MCP-compliant server.\n- **Pluggable Storage:** Integrated adapters for IndexedDB (Browser), Supabase (Backend), and In-Memory.\n- **OAuth & Auth Strategies:** Built-in support for PKCE, Generic OAuth, and API key management.\n\n## Installation\n\n```bash\nnpm install art-framework\n# or\npnpm install art-framework\n```\n\n## Quick Start\n\n```typescript\nimport { createArtInstance, PESAgent, OpenAIAdapter, CalculatorTool } from 'art-framework';\n\nconst art = await createArtInstance({\n storage: { type: 'indexedDB', dbName: 'AgentDB' },\n providers: {\n availableProviders: [{ name: 'openai', adapter: OpenAIAdapter }],\n },\n tools: [new CalculatorTool()],\n agentCore: PESAgent, // Default flagship agent\n});\n\n// Configure the thread (Where API keys live)\nawait art.stateManager.setThreadConfig('my-thread', {\n providerConfig: {\n providerName: 'openai',\n modelId: 'gpt-4o',\n adapterOptions: { apiKey: process.env.OPENAI_API_KEY },\n },\n enabledTools: ['CalculatorTool'],\n});\n\n// Process a request\nconst result = await art.process({\n query: 'Calculate the compound interest for $1000 at 5% over 10 years.',\n threadId: 'my-thread',\n});\n\nconsole.log(result.response.content);\n```\n\n## Documentation\n\n- **[Concepts Guide](docs/concepts/pes-agent.md):** Deep dive into the PES Agent and Reactive Triad.\n- **[How-To Guides](./docs/how-to):** Practical tutorials for [HITL](./docs/how-to/using-hitl-pausing.md), [MCP](./docs/concepts/mcp-system.md), and [Custom UI](./docs/how-to/connecting-your-ui.md).\n- **[API Reference](https://inferq.github.io/ART/components/index.html):** Full technical documentation.\n- **[Website](https://inferq.github.io/ART/):** Marketing site & Live Demos.\n\n## Contributing\n\nContributions are welcome! Please refer to the [Contributing Guide](./CONTRIBUTING.md).\n\n## License\n\nART Framework is released under the [MIT License](https://opensource.org/licenses/MIT).\n"}