pub mod agents; pub mod agents_sse; pub mod anthropic; pub mod assets; pub mod chat; pub mod context; pub mod health; pub mod io; pub mod mcp; pub mod model; pub mod settings; pub mod workflow; pub mod project; pub mod ws; use agents::AgentsApi; use anthropic::AnthropicApi; use chat::ChatApi; use context::AppContext; use health::HealthApi; use io::IoApi; use model::ModelApi; use poem::EndpointExt; use poem::{Route, get, post}; use poem_openapi::OpenApiService; use project::ProjectApi; use settings::SettingsApi; use std::path::{Path, PathBuf}; use std::sync::Arc; const DEFAULT_PORT: u16 = 3001; pub fn parse_port(value: Option) -> u16 { value .and_then(|v| v.parse::().ok()) .unwrap_or(DEFAULT_PORT) } pub fn resolve_port() -> u16 { parse_port(std::env::var("STORYKIT_PORT").ok()) } pub fn write_port_file(dir: &Path, port: u16) -> Option { let path = dir.join(".story_kit_port"); std::fs::write(&path, port.to_string()).ok()?; Some(path) } pub fn remove_port_file(path: &Path) { let _ = std::fs::remove_file(path); } pub fn build_routes(ctx: AppContext) -> impl poem::Endpoint { let ctx_arc = std::sync::Arc::new(ctx); let (api_service, docs_service) = build_openapi_service(ctx_arc.clone()); Route::new() .nest("/api", api_service) .nest("/docs", docs_service.swagger_ui()) .at("/ws", get(ws::ws_handler)) .at( "/agents/:story_id/:agent_name/stream", get(agents_sse::agent_stream), ) .at( "/mcp", post(mcp::mcp_post_handler).get(mcp::mcp_get_handler), ) .at("/health", get(health::health)) .at("/assets/*path", get(assets::embedded_asset)) .at("/", get(assets::embedded_index)) .at("/*path", get(assets::embedded_file)) .data(ctx_arc) } type ApiTuple = ( ProjectApi, ModelApi, AnthropicApi, IoApi, ChatApi, AgentsApi, SettingsApi, HealthApi, ); type ApiService = OpenApiService; /// All HTTP methods are documented by OpenAPI at /docs pub fn build_openapi_service(ctx: Arc) -> (ApiService, ApiService) { let api = ( ProjectApi { ctx: ctx.clone() }, ModelApi { ctx: ctx.clone() }, AnthropicApi::new(ctx.clone()), IoApi { ctx: ctx.clone() }, ChatApi { ctx: ctx.clone() }, AgentsApi { ctx: ctx.clone() }, SettingsApi { ctx: ctx.clone() }, HealthApi, ); let api_service = OpenApiService::new(api, "Story Kit API", "1.0").server("http://127.0.0.1:3001/api"); let docs_api = ( ProjectApi { ctx: ctx.clone() }, ModelApi { ctx: ctx.clone() }, AnthropicApi::new(ctx.clone()), IoApi { ctx: ctx.clone() }, ChatApi { ctx: ctx.clone() }, AgentsApi { ctx: ctx.clone() }, SettingsApi { ctx }, HealthApi, ); let docs_service = OpenApiService::new(docs_api, "Story Kit API", "1.0").server("http://127.0.0.1:3001/api"); (api_service, docs_service) } #[cfg(test)] mod tests { use super::*; #[test] fn parse_port_defaults_to_3001() { assert_eq!(parse_port(None), 3001); } #[test] fn parse_port_reads_valid_value() { assert_eq!(parse_port(Some("4200".to_string())), 4200); } #[test] fn parse_port_ignores_invalid_value() { assert_eq!(parse_port(Some("not_a_number".to_string())), 3001); } #[test] fn write_and_remove_port_file() { let tmp = tempfile::tempdir().unwrap(); let path = write_port_file(tmp.path(), 4567).expect("should write port file"); assert_eq!(std::fs::read_to_string(&path).unwrap(), "4567"); remove_port_file(&path); assert!(!path.exists()); } }