Metadata-Version: 2.5
Name: tokenloop
Version: 0.1.2
Summary: Add your description here
Project-URL: Homepage, https://github.com/RahulDas-dev/loop
Project-URL: Repository, https://github.com/RahulDas-dev/loop
Project-URL: Releases, https://github.com/RahulDas-dev/loop/releases
Author-email: RahulDas-dev <r.das699@gmail.com>
Requires-Python: >=3.10
Requires-Dist: ag-ui-protocol>=0.1.20
Requires-Dist: anthropic>=0.125.0
Requires-Dist: mcp>=2.0.0
Requires-Dist: openai>=2.48.0
Description-Content-Type: text/markdown

# ⚡ tokenloop

> A lightweight, modular, model-agnostic agent loop and token-streaming framework designed for maximum performance and zero bloat.

## Features

*   **Modular Execution Loop**  
    A clean, unopinionated event loop built on the Unix philosophy. Step through prompts, model inferences, and tool executions predictably without heavy state abstractions.

*   **Model-Agnostic Provider Support**  
    Bring your own provider. Seamlessly switch between local models, cloud APIs, or custom backends with zero code refactoring.

*   **Skills Support**
    Add Local Skills with Validation tokenloops responsibilty    

*   **First-Class Tool Calling**  
    Effortlessly register native functions or structured Python/Rust/Go methods as executable agent tools with automatic schema generation.

*   **Model Context Protocol (MCP) Integration**  
    Out-of-the-box client support for MCP servers, allowing your agents to dynamically discover and consume external resources and tools.

*   **Human-in-the-Loop (HITL) Checkpoints**  
    Inject asynchronous approval hooks before executing critical or sensitive tool calls, ensuring absolute safety and human oversight.

*   **Intelligent Context Compression**  
    Built-in utilities to prune, summarize, and compress long conversation histories to keep token windows tight and latency low.

*   **AGUI & Real-Time Token Streaming**  
    First-class support for streaming tokens and structured UI events simultaneously, powering responsive agent-driven user interfaces.

*   **Multi-Language Ergonomics**  
    Consistent, idiomatic APIs available natively across Python, Rust, Go, and Node.js.

*   **Zero Bloat Architecture**  
    Extremely lightweight core footprint with zero unnecessary dependencies, giving you total control over performance.