Runtime comparison + Phases 0–7: correctness, loop control, streaming, durability v2, sessions, toolsets, model profiles

.github/workflows/ci.yml

@@ -39,28 +39,28 @@ jobs:
         run: cargo fmt --all -- --check
 
       - name: Clippy
-        run: cargo clippy --all-targets -- -D warnings
+        run: cargo clippy --workspace --all-targets -- -D warnings
 
       - name: Clippy all features
-        run: cargo clippy --all-targets --all-features -- -D warnings
+        run: cargo clippy --workspace --all-targets --all-features -- -D warnings
 
       - name: Build
-        run: cargo build --all-targets
+        run: cargo build --workspace --all-targets
 
       - name: Build all features
-        run: cargo build --all-targets --all-features
+        run: cargo build --workspace --all-targets --all-features
 
       - name: Test
-        run: cargo test
+        run: cargo test --workspace
 
       - name: Test all features
-        run: cargo test --all-features
+        run: cargo test --workspace --all-features
 
       - name: Test optional features independently
         run: |
-          cargo test --no-default-features --features sqlite
-          cargo test --no-default-features --features tools
-          cargo test --no-default-features --features multimodal
+          cargo test --workspace --no-default-features --features sqlite
+          cargo test --workspace --no-default-features --features tools
+          cargo test --workspace --no-default-features --features multimodal
 
       - name: Coverage gate
         uses: taiki-e/install-action@cargo-llvm-cov
@@ -70,3 +70,19 @@ jobs:
           cargo llvm-cov --all-features --workspace
           --ignore-filename-regex '(^|/)(tests?|examples)/|/test(_.*)?\.rs$'
           --fail-under-lines 80
+
+      # TODO: drop `continue-on-error` once the ~160 existing broken
+      # intra-doc link warnings across the workspace are fixed and this can
+      # block merges instead of only reporting.
+      - name: Doc lints
+        env:
+          RUSTDOCFLAGS: -D rustdoc::broken_intra_doc_links
+        run: cargo doc --workspace --no-deps
+        continue-on-error: true
+
+      # TODO: drop `continue-on-error` once the existing unused-dependency
+      # findings across the workspace are cleaned up and this can block
+      # merges instead of only reporting.
+      - name: Unused dependencies
+        uses: bnjbvr/cargo-machete@main
+        continue-on-error: true

.github/workflows/release.yml

@@ -52,10 +52,26 @@ jobs:
         run: cargo fmt --all -- --check
 
       - name: Run clippy
-        run: cargo clippy --all-targets -- -D warnings
+        run: cargo clippy --workspace --all-targets -- -D warnings
 
       - name: Run tests
-        run: cargo test
+        run: cargo test --workspace
+
+      # TODO: drop `continue-on-error` once the existing ~160 broken
+      # intra-doc link warnings across the workspace are fixed and this can
+      # block merges instead of only reporting.
+      - name: Doc lints
+        env:
+          RUSTDOCFLAGS: -D rustdoc::broken_intra_doc_links
+        run: cargo doc --workspace --no-deps
+        continue-on-error: true
+
+      # TODO: drop `continue-on-error` once the existing unused-dependency
+      # findings across the workspace are cleaned up and this can block
+      # merges instead of only reporting.
+      - name: Unused dependencies
+        uses: bnjbvr/cargo-machete@main
+        continue-on-error: true
 
       - name: Compute next version
         id: version

Cargo.toml

@@ -16,9 +16,24 @@ version = "2.1.2"
 edition = "2024"
 license = "GPL-3.0-only"
 repository = "https://github.com/tinyhumansai/tinyagents"
+rust-version = "1.88"
+
+[workspace.dependencies]
+anyhow = "1"
+async-trait = "0.1"
+chrono = { version = "0.4", features = ["serde"] }
+futures = "0.3"
+reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }
+rusqlite = { version = "0.40", features = ["bundled"] }
+serde = { version = "1", features = ["derive", "rc"] }
+serde_json = "1"
+tempfile = "3"
+tokio = { version = "1", default-features = false, features = ["macros", "rt-multi-thread"] }
+tracing = "0.1"
+uuid = { version = "1", features = ["v4"] }
 
 [workspace.lints.rust]
-unsafe_code = "allow"
+unsafe_code = "deny"
 
 [workspace.lints.clippy]
 all = { level = "warn", priority = -1 }

README.md

@@ -38,11 +38,16 @@ TinyAgents is a Cargo workspace, not one crate. Depend on the pieces you need:
   agents, graphs, and routers), plus an offline model price/capability catalog.
 - **`tinyagents-session`** — a SQLite-backed store for session history,
   messages, tool calls, cost, and run lineage.
+- **`tinyagents-definition`** — the host-owned agent definition vocabulary:
+  identity, description, declared model/tools/delegates, and a read-only
+  catalogue seam. Authorization, prompt construction, and execution stay with
+  the host and harness.
 - **`tinyagents-runtime`** — host-neutral stateful turns over the harness and
   append-only transcript seam; hosts retain policy, prompt composition,
   authorization, and durable-dialect conversion.
-- **`tinyagents-tracing`** — the `tracing` macros the other crates gate behind
-  their `tracing` feature. Compiled out by default.
+- **`tinyagents-orchestration`** — host-neutral composition of durable
+  multi-agent work (teams and workflows) over the graph, harness, and session
+  layers; depends one-way on those crates and stays host-free.
 - **`tinyagents-integration-tests`** — cross-crate tests and the runnable
   examples referenced below (not published, workspace-internal).
 

ROADMAP.md

@@ -25,7 +25,11 @@ build toward a production-grade Rust agent runtime.
 - expand live (network-gated) provider contract tests as new
   OpenAI-compatible endpoints are added
 - track and close the internal SDK feature-parity backlog in
-  [`docs/sdk-gaps.md`](docs/sdk-gaps.md)
+  [`docs/sdk-gaps/README.md`](docs/sdk-gaps/README.md)
+- execute the phased plan in
+  [`docs/runtime-comparison/plan.md`](docs/runtime-comparison/plan.md), which
+  ranks the correctness fixes and feature gaps found by comparing TinyAgents
+  with LangGraph, Pydantic AI and pi
 
 ## Parallel Agents And Sub-Agents
 

build.log

@@ -0,0 +1,4 @@
+   Compiling tinyagents-harness v2.1.2 (/home/enamakel/work/tinyagents/worktrees/runtime-comparison/crates/tinyagents-harness)
+   Compiling tinyagents-language v2.1.2 (/home/enamakel/work/tinyagents/worktrees/runtime-comparison/crates/tinyagents-language)
+   Compiling tinyagents-graph v2.1.2 (/home/enamakel/work/tinyagents/worktrees/runtime-comparison/crates/tinyagents-graph)
+    Finished `dev` profile [unoptimized + debuginfo] target(s) in 7.79s

crates/tinyagents-definition/Cargo.toml

@@ -5,14 +5,16 @@ version.workspace = true
 edition.workspace = true
 license.workspace = true
 repository.workspace = true
+rust-version.workspace = true
 description = "Host-owned agent definition contract."
 
 [dependencies]
-async-trait = "0.1"
-serde = { version = "1", features = ["derive"] }
+async-trait = { workspace = true }
+serde = { workspace = true }
 
 [dev-dependencies]
-tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
+serde_json = { workspace = true }
+tokio = { workspace = true, default-features = true, features = ["macros", "rt-multi-thread"] }
 
 [lints]
 workspace = true

crates/tinyagents-graph/Cargo.toml

@@ -5,29 +5,35 @@ version.workspace = true
 edition.workspace = true
 license.workspace = true
 repository.workspace = true
+rust-version.workspace = true
 description = "Durable typed state graphs for TinyAgents."
 
 [dependencies]
-anyhow = "1"
-async-trait = "0.1"
-futures = "0.3"
-rusqlite = { version = "0.40", features = ["bundled"], optional = true }
-serde = { version = "1", features = ["derive"] }
-serde_json = "1"
-tinyagents-harness = { path = "../tinyagents-harness", version = "2.1.2", default-features = false }
-tinyagents-tracing = { path = "../tinyagents-tracing", version = "2.1.2", default-features = false }
+anyhow = { workspace = true }
+async-trait = { workspace = true }
+futures = { workspace = true }
+rusqlite = { workspace = true, optional = true }
+serde = { workspace = true }
+serde_json = { workspace = true }
+tinyagents-harness = { path = "../tinyagents-harness", version = "2.1.2", default-features = false, features = [
+    "langfuse",
+] }
 tinyinference-llm = { path = "../../vendor/tinyinference/crates/tinyinference-llm", version = "0.3.0" }
 tinytools = { path = "../../vendor/tinytools/crates/tinytools", version = "0.3.0" }
-tokio = { version = "1", default-features = false, features = ["sync", "time", "macros", "rt", "rt-multi-thread", "fs"] }
+tokio = { workspace = true, features = ["sync", "time", "macros", "rt", "rt-multi-thread", "fs"] }
+tracing = { workspace = true }
 
 [features]
 default = []
 sqlite = ["dep:rusqlite"]
-tracing = ["tinyagents-harness/tracing", "tinyagents-tracing/tracing"]
+# Tracing instrumentation is now always compiled in (via the `tracing` crate
+# dependency above). This feature is retained as a no-op so downstream
+# feature forwards keep compiling.
+tracing = ["tinyagents-harness/tracing"]
 
 [dev-dependencies]
-tempfile = "3"
-tokio = { version = "1", features = ["macros", "rt-multi-thread", "time", "test-util"] }
+tempfile = { workspace = true }
+tokio = { workspace = true, default-features = true, features = ["macros", "rt-multi-thread", "time", "test-util"] }
 
 [lints]
 workspace = true