refactor: rename engine/ to server/

server/packages/openapi-gen/Cargo.toml

@@ -0,0 +1,17 @@
+[package]
+name = "sandbox-agent-openapi-gen"
+version.workspace = true
+edition.workspace = true
+authors.workspace = true
+license.workspace = true
+build = "build.rs"
+
+[dependencies]
+tracing = "0.1"
+tracing-logfmt = "0.3"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+
+[build-dependencies]
+sandbox-agent-core = { path = "../sandbox-agent" }
+serde_json = "1.0"
+utoipa = "4.2"

server/packages/openapi-gen/build.rs

@@ -0,0 +1,31 @@
+use std::fs;
+use std::io::{self, Write};
+use std::path::Path;
+
+use sandbox_agent_core::router::ApiDoc;
+use utoipa::OpenApi;
+
+fn main() {
+    emit_stdout("cargo:rerun-if-changed=../sandbox-agent/src/router.rs");
+    emit_stdout("cargo:rerun-if-changed=../sandbox-agent/src/lib.rs");
+
+    let out_dir = std::env::var("OUT_DIR").expect("OUT_DIR not set");
+    let out_path = Path::new(&out_dir).join("openapi.json");
+
+    let openapi = ApiDoc::openapi();
+    let json = serde_json::to_string_pretty(&openapi)
+        .expect("Failed to serialize OpenAPI spec");
+
+    fs::write(&out_path, json).expect("Failed to write OpenAPI spec");
+    emit_stdout(&format!(
+        "cargo:warning=Generated OpenAPI spec at {}",
+        out_path.display()
+    ));
+}
+
+fn emit_stdout(message: &str) {
+    let mut out = io::stdout();
+    let _ = out.write_all(message.as_bytes());
+    let _ = out.write_all(b"\n");
+    let _ = out.flush();
+}

server/packages/openapi-gen/src/lib.rs

@@ -0,0 +1,3 @@
+//! Generated OpenAPI schema output.
+
+pub const OPENAPI_JSON: &str = include_str!(concat!(env!("OUT_DIR"), "/openapi.json"));

server/packages/openapi-gen/src/main.rs

@@ -0,0 +1,59 @@
+use std::env;
+use std::fs;
+use std::io::Write;
+use std::path::PathBuf;
+
+use tracing_subscriber::{layer::SubscriberExt, util::SubscriberInitExt, EnvFilter};
+
+fn main() {
+    init_logging();
+    let mut out: Option<PathBuf> = None;
+    let mut stdout = false;
+    let mut args = env::args().skip(1).peekable();
+    while let Some(arg) = args.next() {
+        if arg == "--stdout" {
+            stdout = true;
+            continue;
+        }
+        if arg == "--out" {
+            if let Some(value) = args.next() {
+                out = Some(PathBuf::from(value));
+            }
+            continue;
+        }
+        if let Some(value) = arg.strip_prefix("--out=") {
+            out = Some(PathBuf::from(value));
+            continue;
+        }
+        if out.is_none() {
+            out = Some(PathBuf::from(arg));
+        }
+    }
+
+    let schema = sandbox_agent_openapi_gen::OPENAPI_JSON;
+    if stdout {
+        write_stdout(schema);
+        return;
+    }
+
+    let out = out.unwrap_or_else(|| PathBuf::from("openapi.json"));
+    if let Err(err) = fs::write(&out, schema) {
+        tracing::error!(path = %out.display(), error = %err, "failed to write openapi schema");
+        std::process::exit(1);
+    }
+}
+
+fn init_logging() {
+    let filter = EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new("info"));
+    tracing_subscriber::registry()
+        .with(filter)
+        .with(tracing_logfmt::builder().layer().with_writer(std::io::stderr))
+        .init();
+}
+
+fn write_stdout(text: &str) {
+    let mut out = std::io::stdout();
+    let _ = out.write_all(text.as_bytes());
+    let _ = out.write_all(b"\n");
+    let _ = out.flush();
+}