xai-tool-runtime

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

工具与工作区

xai-tool-runtime

定义统一 Tool trait、分派、错误分类、通知和搜索索引。

Cargo description: Unified Tool trait, dispatch trait, error taxonomy, notifications, and search index for the xAI Computer Hub

9生产文件

18Rust 文件总数

3,235生产代码行

30收录公开符号

职责与架构位置

xai-tool-runtime 位于“工具与工作区”层。它的首要职责是：定义统一 Tool trait、分派、错误分类、通知和搜索索引。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

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

关键入口

SOURCElib.rscrates/common/xai-tool-runtime/src/lib.rs:1–1146 行 · 模块入口↗SOURCEToolOutputcrates/common/xai-tool-runtime/src/render.rs:61–71732 行 · 公开符号入口↗SOURCEToolErrorKindcrates/common/xai-tool-runtime/src/error.rs:17–27555 行 · 公开符号入口↗SOURCEBashNotificationBasecrates/common/xai-tool-runtime/src/notification.rs:24–34531 行 · 公开符号入口↗SOURCEToolcrates/common/xai-tool-runtime/src/tool.rs:34–44441 行 · 公开符号入口↗SOURCEPartialResultPayloadcrates/common/xai-tool-runtime/src/streaming.rs:29–39440 行 · 公开符号入口↗

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

依赖与调用者

直接依赖

xai-grok-tools-apixai-tool-protocolxai-tool-types

直接调用者

xai-computer-hub-corexai-computer-hub-mcp-adapterxai-computer-hub-sdkxai-grok-mcpxai-grok-shellxai-grok-toolsxai-grok-workspacexai-grok-workspace-client

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

关键公开符号

类型	符号	文件与行号
struct	TypedExtensions	crates/common/xai-tool-runtime/src/context.rs:12
fn	new	crates/common/xai-tool-runtime/src/context.rs:17
fn	insert	crates/common/xai-tool-runtime/src/context.rs:21
fn	insert_arc	crates/common/xai-tool-runtime/src/context.rs:26
fn	get	crates/common/xai-tool-runtime/src/context.rs:31
fn	contains	crates/common/xai-tool-runtime/src/context.rs:38
fn	remove	crates/common/xai-tool-runtime/src/context.rs:42
fn	len	crates/common/xai-tool-runtime/src/context.rs:48
fn	is_empty	crates/common/xai-tool-runtime/src/context.rs:52
fn	merge_defaults	crates/common/xai-tool-runtime/src/context.rs:57
struct	ToolCallContext	crates/common/xai-tool-runtime/src/context.rs:66
fn	new	crates/common/xai-tool-runtime/src/context.rs:81
fn	insert	crates/common/xai-tool-runtime/src/context.rs:89
fn	get	crates/common/xai-tool-runtime/src/context.rs:95
struct	ListToolsContext	crates/common/xai-tool-runtime/src/context.rs:102
fn	new	crates/common/xai-tool-runtime/src/context.rs:107
struct	Cwd	crates/common/xai-tool-runtime/src/context.rs:118
struct	BehaviorVersion	crates/common/xai-tool-runtime/src/context.rs:123
struct	TraceContext	crates/common/xai-tool-runtime/src/context.rs:130
struct	SessionContext	crates/common/xai-tool-runtime/src/context.rs:136
struct	Cancellation	crates/common/xai-tool-runtime/src/context.rs:142
struct	WorkspaceViewerContext	crates/common/xai-tool-runtime/src/context.rs:150
struct	WorkspaceBindMetadata	crates/common/xai-tool-runtime/src/context.rs:165
trait	ToolDispatch	crates/common/xai-tool-runtime/src/dispatch.rs:32
enum	ToolErrorKind	crates/common/xai-tool-runtime/src/error.rs:19
fn	as_str	crates/common/xai-tool-runtime/src/error.rs:78
struct	ToolError	crates/common/xai-tool-runtime/src/error.rs:112
fn	new	crates/common/xai-tool-runtime/src/error.rs:160
fn	with_details	crates/common/xai-tool-runtime/src/error.rs:170
fn	with_source	crates/common/xai-tool-runtime/src/error.rs:176

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

关联深度文章

一次请求的端到端链路从用户输入追踪到模型采样、工具调用、工作区变更和最终渲染。

Tool Registry、Search Index 与 Bridge解释工具注册、索引、选择以及本地与 Hub 工具桥接。

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

完整 Rust 文件索引

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

生产源码crates/common/xai-tool-runtime/src/context.rs337 行 · 12 个公开符号生产源码crates/common/xai-tool-runtime/src/dispatch.rs69 行 · 1 个公开符号生产源码crates/common/xai-tool-runtime/src/error.rs555 行 · 12 个公开符号生产源码crates/common/xai-tool-runtime/src/lib.rs46 行 · 0 个公开符号生产源码crates/common/xai-tool-runtime/src/notification.rs531 行 · 12 个公开符号生产源码crates/common/xai-tool-runtime/src/render.rs732 行 · 8 个公开符号生产源码crates/common/xai-tool-runtime/src/search.rs84 行 · 6 个公开符号生产源码crates/common/xai-tool-runtime/src/streaming.rs440 行 · 2 个公开符号生产源码crates/common/xai-tool-runtime/src/tool.rs441 行 · 12 个公开符号测试crates/common/xai-tool-runtime/tests/context_extensions.rs264 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/error_conversion.rs227 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/notification_serde.rs404 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/search.rs104 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/should_list.rs178 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/tool_blocking.rs175 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/tool_dyn.rs493 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/tool_streaming.rs178 行 · 0 个公开符号测试crates/common/xai-tool-runtime/tests/trait_object_safety.rs151 行 · 0 个公开符号

覆盖说明

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