1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
//! CrabMate 库：OpenAI 兼容多供应商 LLM、Agent 主循环、HTTP 服务、工具与工作流。
//! 二进制入口见 `src/main.rs` 的 [`run`] 包装。
//!
//! # 公开 API（semver）
//!
//! 白名单见仓库 `docs/design/crates_io_single_package.md` §2.4。
//!
//! - **承诺 `protocol`**（Client / WASM）：六个模块 [`cm_types`]、[`cm_display_rules`]、
//! [`cm_api_contract`]、[`cm_chat_export`]、[`cm_turn_layout`]、[`cm_sse_protocol`]。
//! **没有** `types` / `sse` / `config` 别名。
//! - **承诺 `server`**（默认，含 `protocol`）：组合面模块名 `agent` / `config` / `llm` / `sse` /
//! `types` 的**存在**；以及 `run`、`run_agent_turn`、`build_tools*`、`ProcessHandles`、
//! `tool_sandbox` 等根上显式 `pub use`。
//! - **不承诺**：`#[doc(hidden)]` 的 `cm_agent` / `cm_llm` / `cm_config` / `cm_workflow` /
//! `cm_internal`、`e2e_scenario`、`test_serve`；`agent::agent_turn` 等组合面内部路径。
//! `cm_tools` / `cmd_mate` 等为实现模块，`pub(crate)`。
//!
//! 本 crate 默认 feature 是带库的 **`serve` 服务器**，不是通用嵌入式 Agent SDK。
//! HTTP 线契约以 `docs/SSE协议.md`、`cm_api_contract` 与 `GET /openapi.json` 为准。
//!
//! 日志由 **`tracing`** 处理；**`observability::init_tracing_subscriber`**（`cm_internal`）安装 **`tracing-subscriber`** 并用 **`tracing-log`** 桥接既有 `log::` 调用。`RUST_LOG` 优先。未设置时：`--serve` 默认 **info**；其它 CLI 模式默认 **warn**（不输出 info）；`--log <FILE>` 在未设置 `RUST_LOG` 时默认 **info**。时间戳默认**本机本地时区**（RFC3339）。设 **`CM_LOG_JSON=1`** 时输出 JSON 行（便于 `jq` / 日志平台）。
// `web/openapi.rs` 中 `serde_json::json!` 体量较大，默认递归深度不足会无法编译。
include!;