refactor!: reorganize crate into domain modules and simplify LLM client API

Cargo.toml

@@ -1,11 +1,11 @@
 [workspace]
 resolver = "2"
 members = [
-    "crates/agent-discourse",
+"crates/agent-discourse",
 ]
 
 [workspace.package]
-version = "0.3.0"
+version = "0.4.0"
 edition = "2021"
 authors = ["Travis Sharp <travis@kuipersys.com>"]
 license = "MIT OR Apache-2.0"
@@ -18,9 +18,10 @@ unsafe_code = "forbid"
 all = "warn"
 
 # Root package - the main MCP library
+
 [package]
 name = "agent-runtime"
-version = "0.3.0"
+version = "0.4.0"
 edition = "2021"
 authors = ["Travis Sharp <travis@kuipersys.com>"]
 license = "MIT OR Apache-2.0"
@@ -29,8 +30,16 @@ repository = "https://github.com/tsharp/agent-runtime"
 keywords = ["agent", "ai", "llm", "tools", "protocol"]
 categories = ["development-tools", "network-programming"]
 readme = "README.md"
+autotests = false
 
 [features]
+default = []
+# Enables the workflow runtime : `Workflow`, `WorkflowBuilder`, `Runtime`,
+# `WorkflowContext`, `ContextManager` strategies, and all built-in `Step`
+# implementations(`AgentStep`, `TransformStep`, `ConditionalStep`,
+# `SubWorkflowStep`). Off by default — enable when you want to compose
+# agents into multi-step pipelines.
+workflow = []
 
 [dependencies]
 # Core
@@ -57,94 +66,59 @@ serde_yaml = "0.9"
 # MCP - Model Context Protocol
 rust-mcp-sdk = { version = "0.9", features = ["client"] }
 
-# Optional - HTTP transport (client)
+# Optional - HTTP transport(client)
 reqwest = { version = "0.11", features = ["json", "stream"] }
 
-# Optional - HTTP server (for examples)
-actix-web = { version = "4"}
-
-[[bin]]
-name = "advanced_workflow_demo"
-path = "src/bin/advanced_workflow_demo.rs"
-
-[[bin]]
-name = "advanced_strategies_demo"
-path = "src/bin/advanced_strategies_demo.rs"
-
-[[bin]]
-name = "chat_history_demo"
-path = "src/bin/chat_history_demo.rs"
-
-[[bin]]
-name = "hello_workflow"
-path = "src/bin/hello_workflow.rs"
-
-[[bin]]
-name = "multi_subscriber"
-path = "src/bin/multi_subscriber.rs"
-
-[[bin]]
-name = "step_types_demo"
-path = "src/bin/step_types_demo.rs"
-
-[[bin]]
-name = "nested_workflow"
-path = "src/bin/nested_workflow.rs"
-
-[[bin]]
-name = "mermaid_viz"
-path = "src/bin/mermaid_viz.rs"
-
-[[bin]]
-name = "complex_viz"
-path = "src/bin/complex_viz.rs"
+[dev-dependencies]
+criterion = { version = "0.5", features = ["async_tokio", "html_reports"] }
 
-[[bin]]
-name = "workflow_demo"
-path = "src/bin/workflow_demo.rs"
+[[bench]]
+name = "agent_benchmarks"
+harness = false
 
-[[bin]]
-name = "llm_demo"
-path = "src/bin/llm_demo.rs"
+# --- Integration tests --------------------------------------------------
+# Tests that exercise only Agent/LLM/Tools/Events build in the default
+# feature set.
 
-[[bin]]
-name = "llama_demo"
-path = "src/bin/llama_demo.rs"
+[[test]]
+name = "chat_history_tests"
+path = "tests/chat_history_tests.rs"
 
-[[bin]]
-name = "two_agent_chain_demo"
-path = "src/bin/two_agent_chain_demo.rs"
+[[test]]
+name = "error_tests"
+path = "tests/error_tests.rs"
 
-[[bin]]
-name = "multi_user_message_demo"
-path = "src/bin/multi_user_message_demo.rs"
+[[test]]
+name = "integration_tests"
+path = "tests/integration_tests.rs"
 
-[[bin]]
-name = "multi_agent_discourse_demo"
-path = "src/bin/multi_agent_discourse_demo.rs"
+# Tests below construct `Workflow`/`Runtime` directly and therefore only
+# compile when the `workflow` feature is enabled.
 
-[[bin]]
-name = "scene_actor_demo"
-path = "src/bin/scene_actor_demo.rs"
+[[test]]
+name = "checkpoint_tests"
+path = "tests/checkpoint_tests.rs"
+required-features = ["workflow"]
 
-[[bin]]
-name = "agent_context_demo"
-path = "src/bin/agent_context_demo.rs"
+[[test]]
+name = "load_tests"
+path = "tests/load_tests.rs"
+required-features = ["workflow"]
 
-[dev-dependencies]
-criterion = { version = "0.5", features = ["async_tokio", "html_reports"] }
+[[test]]
+name = "subworkflow_context_tests"
+path = "tests/subworkflow_context_tests.rs"
+required-features = ["workflow"]
 
-[[bench]]
-name = "agent_benchmarks"
-harness = false
-tokio-test = "0.4"
-tempfile = "3.8"
-actix-web = "4"
+[[test]]
+name = "workflow_context_tests"
+path = "tests/workflow_context_tests.rs"
+required-features = ["workflow"]
 
 [lib]
 name = "agent_runtime"
 path = "src/lib.rs"
 
 [package.metadata.docs.rs]
 all-features = true
-rustdoc-args = ["--cfg", "docsrs"]
+rustdoc-args = ["--cfg", "docsrs"]

Makefile.toml

@@ -0,0 +1,9 @@
+[tasks.lint]
+description = "Run clippy linting checks"
+command = "cargo"
+args = ["clippy", "--all-targets", "--all-features", "--", "-D", "warnings"]
+
+[tasks.lint-fix]
+description = "Run clippy with auto-fix"
+command = "cargo"
+args = ["clippy", "--all-targets", "--all-features", "--fix", "--allow-dirty", "--", "-D", "warnings"]