tinyagents 1.0.0

A recursive language-model (RLM) harness for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

[package]
name = "tinyagents"
version = "1.0.0"
edition = "2024"
license = "GPL-3.0-only"
description = "A recursive language-model (RLM) harness for Rust."
repository = "https://github.com/tinyhumansai/tinyagents"
readme = "README.md"
keywords = ["llm", "agents", "graph", "langchain", "langgraph"]
categories = ["asynchronous", "api-bindings"]

[dependencies]
async-trait = "0.1"
# Runtime-agnostic future combinators (`join_all` for concurrent supersteps) and
# the `Stream`/`StreamExt` traits backing the real streaming pipeline
# (`harness::model::ModelStream`).
futures = "0.3"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
sha2 = "0.10"
thiserror = "2"

# Async runtime primitives used by the streaming pipeline. The library only
# needs the lightweight pieces (synchronization + timers); the full
# multi-threaded runtime stays a dev-dependency for examples and tests.
tokio = { version = "1", default-features = false, features = ["sync", "time", "macros"] }

# Optional HTTP client, pulled in only by hosted-provider features. The `stream`
# feature enables `Response::bytes_stream` for Server-Sent-Events streaming.
reqwest = { version = "0.12", default-features = false, features = [
    "json",
    "rustls-tls",
    "stream",
], optional = true }

# Optional embedded SQLite checkpointer backend (`graph::checkpoint::sqlite`).
# `bundled` compiles SQLite from vendored C source so no system library is
# required; the dependency is pulled in only by the `sqlite` feature.
rusqlite = { version = "0.40", features = ["bundled"], optional = true }

# Optional embedded Rhai scripting engine powering the `.ragsh` REPL session
# runtime (`repl::session`). The `sync` feature makes the engine and its values
# `Send + Sync` so a session can live inside an async graph node. Pulled in only
# by the `repl` feature to keep the default build light.
rhai = { version = "1", features = ["sync"], optional = true }

[features]
default = []
# Hosted OpenAI Chat Completions provider (`harness::providers::openai`).
openai = ["dep:reqwest"]
# Embedded SQLite-backed checkpointer (`graph::checkpoint::SqliteCheckpointer`).
sqlite = ["dep:rusqlite"]
# Embedded Rhai-backed `.ragsh` REPL session runtime (`repl::session`).
repl = ["dep:rhai"]

[dev-dependencies]
tokio = { version = "1", features = ["macros", "rt-multi-thread", "time", "test-util"] }
# `.env` loading for the runnable examples.
dotenvy = "0.15"
# Stream combinators (`StreamExt::next`) for integration tests that drive a
# `ModelStream` directly.
futures = "0.3"

# --- OpenAI-backed examples (require a network call + OPENAI_API_KEY) ---
# Gated behind the `openai` feature so the default build/test stays offline.
[[example]]
name = "openai_chat"
required-features = ["openai"]

[[example]]
name = "openai_tools"
required-features = ["openai"]

[[example]]
name = "openai_structured"
required-features = ["openai"]

[[example]]
name = "openai_graph_agent"
required-features = ["openai"]

[[example]]
name = "openai_self_blueprint"
required-features = ["openai"]

[[example]]
name = "orchestrator_subagents"
required-features = ["openai"]