xai-tool-protocol

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

工具与工作区

xai-tool-protocol

定义 Computer Hub 工具调用的稳定传输协议类型。

Cargo description: Wire-protocol types for the xAI Computer Hub

17生产文件

21Rust 文件总数

4,400生产代码行

30收录公开符号

职责与架构位置

xai-tool-protocol 位于“工具与工作区”层。它的首要职责是：定义 Computer Hub 工具调用的稳定传输协议类型。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

成员路径为 crates/common/xai-tool-protocol，清单位于 Cargo.toml。

关键入口

SOURCElib.rscrates/common/xai-tool-protocol/src/lib.rs:1–1174 行 · 模块入口↗SOURCEToolCallParamscrates/common/xai-tool-protocol/src/frames.rs:25–351,550 行 · 公开符号入口↗SOURCEBEFORE_TURN_KINDcrates/common/xai-tool-protocol/src/turn_hook.rs:8–18701 行 · 公开符号入口↗SOURCESessionEventcrates/common/xai-tool-protocol/src/session_event.rs:20–30405 行 · 公开符号入口↗SOURCEERROR_CODEScrates/common/xai-tool-protocol/src/error_codes.rs:14–24301 行 · 公开符号入口↗SOURCEJsonRpcVersioncrates/common/xai-tool-protocol/src/envelope.rs:22–32258 行 · 公开符号入口↗

入口文件优先按 lib.rs/main.rs、公开符号密度和文件规模选择。这是一条面向阅读的路径，不表示其他文件不重要；下方完整文件索引覆盖该 crate 的全部 Rust 源码、测试、示例、基准与 Fuzz 文件。

依赖与调用者

直接依赖

xai-tool-types

直接调用者

xai-computer-hub-corexai-computer-hub-mcp-adapterxai-computer-hub-sdkxai-grok-mcpxai-grok-shellxai-grok-toolsxai-grok-tools-apixai-grok-workspacexai-grok-workspace-clientxai-tool-runtime

依赖边来自固定提交中的 Cargo manifest，只表示编译期直接依赖。运行时控制流还需结合 trait 实现、构造位置和消息通道判断；反向依赖为空也不代表 crate 没有入口，它可能直接生成二进制或由外部协议调用。

关键公开符号

类型	符号	文件与行号
struct	ToolCapabilities	crates/common/xai-tool-protocol/src/capabilities.rs:10
struct	StreamingSpec	crates/common/xai-tool-protocol/src/capabilities.rs:58
enum	HookKind	crates/common/xai-tool-protocol/src/capabilities.rs:73
enum	ToolScope	crates/common/xai-tool-protocol/src/capabilities.rs:88
struct	NotificationSchemas	crates/common/xai-tool-protocol/src/capabilities.rs:98
enum	ConnectionKind	crates/common/xai-tool-protocol/src/connection.rs:9
enum	ToolDefinitionMode	crates/common/xai-tool-protocol/src/connection.rs:27
struct	JsonRpcVersion	crates/common/xai-tool-protocol/src/envelope.rs:24
const	VERSION	crates/common/xai-tool-protocol/src/envelope.rs:27
enum	JsonRpcId	crates/common/xai-tool-protocol/src/envelope.rs:72
fn	new_string	crates/common/xai-tool-protocol/src/envelope.rs:78
fn	new_uuid_v7	crates/common/xai-tool-protocol/src/envelope.rs:83
fn	from_request_id	crates/common/xai-tool-protocol/src/envelope.rs:87
fn	as_request_id	crates/common/xai-tool-protocol/src/envelope.rs:93
struct	JsonRpcRequest	crates/common/xai-tool-protocol/src/envelope.rs:116
struct	JsonRpcNotification	crates/common/xai-tool-protocol/src/envelope.rs:132
struct	JsonRpcError	crates/common/xai-tool-protocol/src/envelope.rs:148
struct	JsonRpcResponse	crates/common/xai-tool-protocol/src/envelope.rs:161
enum	ResponseOutcome	crates/common/xai-tool-protocol/src/envelope.rs:170
fn	ok	crates/common/xai-tool-protocol/src/envelope.rs:235
fn	err	crates/common/xai-tool-protocol/src/envelope.rs:244
fn	with_session	crates/common/xai-tool-protocol/src/envelope.rs:253
const	ERROR_CODES	crates/common/xai-tool-protocol/src/error_codes.rs:16
fn	numeric_for	crates/common/xai-tool-protocol/src/error_codes.rs:49
fn	string_for	crates/common/xai-tool-protocol/src/error_codes.rs:56
fn	from_tool_error_wire	crates/common/xai-tool-protocol/src/error_codes.rs:65
const	WORKSPACE_UNAVAILABLE_SUBCODE	crates/common/xai-tool-protocol/src/error_codes.rs:89
const	WORKSPACE_UNAVAILABLE_MESSAGE	crates/common/xai-tool-protocol/src/error_codes.rs:92
const	WORKSPACE_UNAVAILABLE_JSONRPC_CODE	crates/common/xai-tool-protocol/src/error_codes.rs:97
enum	WorkspaceGoneReason	crates/common/xai-tool-protocol/src/error_codes.rs:104

公开符号用于快速判断 crate 对外暴露的数据、trait 和执行入口。私有实现仍会出现在完整文件索引中；本文不会仅凭 pub 推断某个符号就是长期稳定 API。

关联深度文章

Rust Workspace 与 Crate 分层解释 73 个一方 crate 如何按协议、基础设施、运行时和交互层协作。

Tool Contract、Protocol、Runtime 与 API分解 Tool trait、wire protocol、错误分类、通知和 Protobuf API。

完整 Rust 文件索引

共 21 个 Rust 文件，其中 17 个被覆盖校验认定为生产源码。测试、示例、基准和 Fuzz 文件不会从图谱删除，而是使用不同标签展示。

生产源码crates/common/xai-tool-protocol/src/capabilities.rs107 行 · 5 个公开符号生产源码crates/common/xai-tool-protocol/src/connection.rs39 行 · 2 个公开符号生产源码crates/common/xai-tool-protocol/src/envelope.rs258 行 · 12 个公开符号生产源码crates/common/xai-tool-protocol/src/error_codes.rs301 行 · 11 个公开符号生产源码crates/common/xai-tool-protocol/src/error_wire.rs97 行 · 1 个公开符号生产源码crates/common/xai-tool-protocol/src/frames.rs1,550 行 · 12 个公开符号生产源码crates/common/xai-tool-protocol/src/handshake.rs53 行 · 3 个公开符号生产源码crates/common/xai-tool-protocol/src/hook.rs23 行 · 1 个公开符号生产源码crates/common/xai-tool-protocol/src/ids.rs242 行 · 9 个公开符号生产源码crates/common/xai-tool-protocol/src/lib.rs74 行 · 0 个公开符号生产源码crates/common/xai-tool-protocol/src/methods.rs209 行 · 5 个公开符号生产源码crates/common/xai-tool-protocol/src/notification_wire.rs87 行 · 6 个公开符号生产源码crates/common/xai-tool-protocol/src/output_wire.rs41 行 · 2 个公开符号生产源码crates/common/xai-tool-protocol/src/registration.rs165 行 · 7 个公开符号生产源码crates/common/xai-tool-protocol/src/registry_error.rs48 行 · 1 个公开符号生产源码crates/common/xai-tool-protocol/src/session_event.rs405 行 · 3 个公开符号生产源码crates/common/xai-tool-protocol/src/turn_hook.rs701 行 · 12 个公开符号测试crates/common/xai-tool-protocol/tests/identifier_validation.rs193 行 · 0 个公开符号测试crates/common/xai-tool-protocol/tests/jsonrpc_envelope.rs266 行 · 0 个公开符号测试crates/common/xai-tool-protocol/tests/serde_roundtrip.rs1,681 行 · 0 个公开符号测试crates/common/xai-tool-protocol/tests/tool_id_derivation.rs94 行 · 0 个公开符号

覆盖说明

该页面由固定源码基线生成。CI 会重新扫描 crates/common/xai-tool-protocol，验证文件数量、行数、公开符号、依赖和入口是否与提交到站点的数据一致。若上游基线升级而图谱没有重新生成，构建会失败，避免页面显示已经不存在的路径。