refactor: restructure into 3-crate workspace per ADR-03

Cargo.toml

@@ -1,37 +1,16 @@
-[package]
-name = "agentic-api"
+[workspace]
+members = ["crates/*"]
+resolver = "3"
+
+[workspace.package]
 version = "0.1.0"
 edition = "2024"
-description = "Stateful API logic for agentic applications using vLLM"
 license = "Apache-2.0"
 repository = "https://github.com/vllm-project/agentic-api"
 
-[dependencies]
-axum = "0.8"
-bytes = "1"
-clap = { version = "4", features = ["derive", "env"] }
-futures = "0.3"
-http = "1"
-reqwest = { version = "0.12", features = ["stream"] }
-serde = { version = "1", features = ["derive"] }
-serde_json = "1"
-thiserror = "2"
-tokio = { version = "1", features = ["full"] }
-tower-http = { version = "0.6", features = ["cors"] }
-tracing = "0.1"
-tracing-subscriber = { version = "0.3", features = ["env-filter"] }
-
-[dev-dependencies]
-criterion = { version = "0.5", features = ["async_tokio"] }
-reqwest = { version = "0.12", features = ["json"] }
-
-[[bench]]
-name = "proxy_bench"
-harness = false
-
-[lints.rust]
+[workspace.lints.rust]
 unsafe_code = "forbid"
 
-[lints.clippy]
+[workspace.lints.clippy]
 all = { level = "deny", priority = -1 }
 pedantic = { level = "warn", priority = -1 }

crates/agentic-core/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "agentic-core"
+description = "Framework-agnostic core library for agentic-api"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+
+[dependencies]
+bytes = "1"
+futures = "0.3"
+http = "1"
+reqwest = { version = "0.12", features = ["stream"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+thiserror = "2"
+tokio = { version = "1", features = ["time"] }
+tracing = "0.1"
+
+[lints]
+workspace = true

src/config.rs → crates/agentic-core/src/config.rs

@@ -1,24 +1,9 @@
-use clap::Args;
-
-#[derive(Debug, Clone, Args)]
-pub struct RuntimeConfig {
-    #[arg(skip)]
+#[derive(Debug, Clone)]
+pub struct Config {
     pub llm_api_base: String,
-
-    #[arg(long, env = "OPENAI_API_KEY", hide_env_values = true)]
     pub openai_api_key: Option<String>,
-
-    #[arg(long, default_value = "0.0.0.0")]
-    pub gateway_host: String,
-
-    #[arg(long, default_value_t = 9000)]
-    pub gateway_port: u16,
-
-    #[arg(long, default_value_t = 600.0)]
-    pub vllm_ready_timeout_s: f64,
-
-    #[arg(long, default_value_t = 2.0)]
-    pub vllm_ready_interval_s: f64,
+    pub llm_ready_timeout_s: f64,
+    pub llm_ready_interval_s: f64,
 }
 
 #[must_use]

src/error.rs → crates/agentic-core/src/error.rs

@@ -5,11 +5,11 @@ pub enum Error {
     #[error("failed to build HTTP client")]
     HttpClient(#[source] reqwest::Error),
 
-    #[error("vLLM not ready within {timeout_s:.0}s at {url}")]
-    VllmTimeout { url: String, timeout_s: f64 },
+    #[error("LLM not ready within {timeout_s:.0}s at {url}")]
+    LlmTimeout { url: String, timeout_s: f64 },
 
-    #[error("vLLM subprocess exited before becoming ready: {status}")]
-    VllmProcessExited { status: String },
+    #[error("LLM subprocess exited before becoming ready: {status}")]
+    LlmProcessExited { status: String },
 
     #[error(transparent)]
     Io(#[from] io::Error),

src/lib.rs → crates/agentic-core/src/lib.rs

@@ -1,5 +1,4 @@
-pub mod app;
 pub mod config;
 pub mod error;
 pub mod proxy;
-pub mod server;
+pub mod readiness;