vox-orchestrator-mcp API Reference (generated)
Crate: vox-orchestrator-mcp · Version: 0.6.0 · Target: Library (lib.rs)
MCP (Model Context Protocol) tool layer for vox-orchestrator. Extracted in 2026-05-08 reorg Phase 4.
Crate Overview
Section titled “Crate Overview”Unified tool registry and dispatcher for the Vox MCP server.
Extracted from vox-orchestrator/src/mcp_tools/ in 2026-05-08 reorg Phase 4.
Features
Section titled “Features”| Feature | Default / Enables |
|---|---|
default | toestub-gate, json-schema |
eval-gate | dep:wiremock |
gui-visual-review | — |
heavy-browser | — |
json-schema | vox-orchestrator/json-schema |
news-publish | dep:vox-publisher, vox-orchestrator/news-publish, vox-publisher/scientia-reddit, vox-publisher/scientia-youtube, vox-publisher/scholarly-external-jobs |
oratio-rerank | dep:vox-speech |
populi-transport | vox-orchestrator/populi-transport, vox-populi/transport |
toestub-gate | vox-orchestrator/toestub-gate |
token-counting | vox-orchestrator/token-counting |
web-scrape | vox-search/web-scrape |
Workspace Dependencies
Section titled “Workspace Dependencies”| Dependency | Kind |
|---|---|
vox-actor-runtime | Normal |
vox-bounded-fs | Normal |
vox-capability-registry | Normal |
vox-cli-core | Normal |
vox-code-audit | Normal |
vox-codegen | Normal |
vox-codegen-ts | Normal |
vox-compiler | Normal |
vox-config | Normal |
vox-corpus | Normal |
vox-crypto | Normal |
vox-db | Normal |
vox-diagram | Normal |
vox-foundation | Normal |
vox-gamify | Normal |
vox-grammar-export | Normal |
vox-graph-reader | Normal |
vox-http-client | Normal |
vox-jsonschema-util | Normal |
vox-lsp | Normal |
vox-mcp-registry | Normal |
vox-mesh-types | Normal |
vox-openai | Normal |
vox-openclaw-runtime | Normal |
vox-orchestrator | Normal |
vox-orchestrator-driver | Normal |
vox-orchestrator-types | Normal |
vox-package | Normal |
vox-plugin-catalog | Normal |
vox-plugin-host | Normal |
vox-plugin-types | Normal |
vox-populi | Normal |
vox-project-scaffold | Normal |
vox-publisher | Normal |
vox-redact | Normal |
vox-repository | Normal |
vox-research-events | Normal |
vox-research-shim | Normal |
vox-scientia | Normal |
vox-search | Normal |
vox-secrets | Normal |
vox-similarity | Normal |
vox-skill-discovery | Normal |
vox-skills | Normal |
vox-speech | Normal |
vox-telemetry | Normal |
vox-orchestrator | Development |
vox-plugin-api | Development |
Public API Surface
Section titled “Public API Surface”Modules
Section titled “Modules”| Module | Description |
|---|---|
services | HTTP routes (moved from vox-orchestrator/services/routes). |
autonomous_tool_dispatch | T1.5 follow-up: bridges AiTaskProcessor’s autonomous @tool intent lines into real MCP dispatch (handle_tool_call_with_mode), so autonomous dangerous-tool calls go through the same approval gate as GUI-invoked ones, with task_id threaded through as an explicit parameter. |
chat_fallback_tools | <TOOL_CALLS> XML fallback for LLM providers without native function-call support. |
daemon_extra | — |
daemon_route | T2.2: vox mcp stdio server’s tool-call forwarding to vox-orchestrator-d. |
feedback_tools | — |
hitl_rehydrate | T1.4: restore visibility for open approvals/feedback from the durable op-log on ServerState boot (MCP stdio + vox-orchestrator-d). |
params | — |
pending_approvals | — |
profiles | — |
server_state | — |
skill_promotion | — |
approval_allowlist | T0.3: persisted per-repo “always allow this tool” allowlist (tier 3 of the dangerous-tool gate’s precedence order). |
mcp_tool_access | MCP tool access matrix, 16 KiB model context, 20 KiB DOM shedding, and stateless DPoP auth (T3-HANDOFF-MCP-02..04). |
permission_modes | T0.3: registry-driven risk classification + PermissionMode auto-approve matrix (tier 2 of the dangerous-tool gate’s precedence order). |
t3_wave3_tools | Live MCP tool handlers for T3 Wave 2/3 subsystems (T3-MCP-RPC-WIRE-01..03). |
aci | — |
agent_tools | Agent native gateway and skill tools. |
benchmark_tools | Benchmark telemetry query tools (research_metrics). |
browser_tools | Chromium CDP browser automation (vox_browser_*). |
caller_role | Trusted caller role for browser control-lock authorization. |
capability_tools | vox_capability_explain / vox_capability_features: answers from the embedded capability index. |
chat_hop | — |
chat_model_resolve | Shared LLM model resolution for chat tools. |
chat_socrates_meta | Socrates grounding + telemetry helpers for chat tools. |
chat_tools | Chat, inline edit, ghost text, planning, and ambient editor decorations. |
code_validator | Structured .vox diagnostics and repair tools. |
codex_tools | Codex relational V17/V16 helpers over connected VoxDb. |
compiler_tools | cargo/LSP validation helpers (vox_validate_file, vox_run_tests, …). |
db_tools | Codex schema digest + sample row tools for .vox modules. |
diagram_tools | VoxDiagram validation (vox_validate_diagram). |
dispatch | — |
dispatch_domains | — |
dispatch_timeout | T4.3: per-tool-call execution timeout table (outer tokio::time::timeout wrapping actual tool dispatch — independent of the HITL approval-wait). |
exec_time_tools | Execution time tracking tools. |
git_exec | Central git executor with banned-command denylist and vox.vcs.exec telemetry. |
git_tools | Thin git CLI wrappers scoped to the discovered git root. |
grammar_tools | Grammar export tools |
graph_tools | Graphify corpus freshness and lexical search (vox_graphify_status, vox_graphify_search). |
gui_ops | GUI registry + validation tools (vox_gui_components, vox_gui_tokens, vox_gui_rules, vox_validate_vuv). |
gui_registry_tools | — |
history_tools | vox_search_history: first-parent repo history for agents (same facade as vox graph history). |
input_schemas | — |
introspection_tools | Introspection tools for language visualization (AST, surface, pipeline). |
llm_bridge | — |
news_tools | Unified News Publishing System tools |
openclaw_tools | OpenClaw native gateway and skill tools. |
operation_capture | Best-effort, redacted capture of every MCP tool call into agent_operations. |
oratio_tools | Oratio speech-to-text (Candle Whisper). |
persistence_tools | Orchestrator persistence outbox inspection helpers. |
populi_tools | Local mens registry status (vox_populi_local_status). |
post_verification | Automatic post-mutation .vox verification feedback (verification-driven agent loop). |
project_init_tools | vox init parity scaffold (vox_project_init). |
questioning_tools | Socrates questioning / clarification answer persistence (VoxDb). |
rag_tools | Multi-modal Visual Retrieval-Augmented Generation RAG handler. |
receipt_tools | Tool execution receipt claim verification. |
registry | — |
repo_catalog_tools | Explicit repo catalog + read-only polyrepo query tools. |
repo_index | Bounded repo walk + on-disk JSON cache under .vox/cache/repos/.... |
scientia_tools | Scientia publication lifecycle tools (manifest, approval, submission). |
scope_guard | — |
secrets_tools | Secrets credential tools. |
session_identity | — |
speech_pipeline_tools | Speech → codegen orchestration (vox_speech_to_code). |
sync_poison | — |
task_tools | Orchestrator task submit/status/cancel/drain tools. |
toestub_tools | TOESTUB (Todo/Stubs/Empty) finding ingestion and queue management. |
tool_aliases | — |
tool_envelope | — |
tool_images | Strip image_base64 from MCP tool JSON and build image parts for chat. |
tool_search | vox_tool_search — keyword search over the tool registry (progressive disclosure). |
training_tools | Training-intent submission via orchestrator (Mens CLI remains canonical executor). |
trust_tools | Trust rollup inspection tools (trust_rollups over VoxDb). |
vcs_tools | Snapshot / oplog / workspace orchestrator VCS tools. |
visus_review | GUI visual AI adversarial review (advisory; never gates CI). |
visus_tools | GUI Visual Intelligence tools. |
a2a_tools | — |
affinity_tools | — |
gamify_tools | — |
memory_tools | — |
qa_tools | — |
models_tools | — |
skill_permissions | — |
skill_search_index | — |
skills_hydrate | — |
skills_resources | — |
skills_tools | — |
workspace_mcp | — |
plugin_tools | — |
trace_tools | — |
dei_tools | — |
kb_resources | — |
kb_tools | — |
mcp_context | — |
mcp_client | — |
dei_ipc | — |
http_gateway | — |
journey_envelope | — |
populi_startup | — |
speech_constraints | — |
mens | VoxMens runtime integration — semantic tool retrieval (B3+). |
schema_guided | B4 — Schema-constrained decoding helpers (GuidedDecodingSpec, attach_guided_decoding). |
agy_doctor | — |
agy_exec | — |
agy_gates | — |
agy_ledger | — |
agy_pipeline | — |
agy_tools | — |
agy_worktree | — |
lifecycle | — |
plugin_skills_bridge | — |
server | — |
Dependency Topology
Section titled “Dependency Topology”Diagram source
graph { direction: right node vox_orchestrator_mcp: "vox-orchestrator-mcp" node vox_actor_runtime: "vox-actor-runtime" vox_orchestrator_mcp -> vox_actor_runtime node vox_bounded_fs: "vox-bounded-fs" vox_orchestrator_mcp -> vox_bounded_fs node vox_capability_registry: "vox-capability-registry" vox_orchestrator_mcp -> vox_capability_registry node vox_cli_core: "vox-cli-core" vox_orchestrator_mcp -> vox_cli_core node vox_code_audit: "vox-code-audit" vox_orchestrator_mcp -> vox_code_audit node vox_codegen: "vox-codegen" vox_orchestrator_mcp -> vox_codegen node vox_codegen_ts: "vox-codegen-ts" vox_orchestrator_mcp -> vox_codegen_ts node vox_compiler: "vox-compiler" vox_orchestrator_mcp -> vox_compiler node vox_config: "vox-config" vox_orchestrator_mcp -> vox_config node vox_corpus: "vox-corpus" vox_orchestrator_mcp -> vox_corpus node vox_crypto: "vox-crypto" vox_orchestrator_mcp -> vox_crypto node vox_db: "vox-db" vox_orchestrator_mcp -> vox_db node vox_cli: "vox-cli" vox_cli -> vox_orchestrator_mcp node vox_cli_ci: "vox-cli-ci" vox_cli_ci -> vox_orchestrator_mcp node vox_cli_research: "vox-cli-research" vox_cli_research -> vox_orchestrator_mcp node vox_gui: "vox-gui" vox_gui -> vox_orchestrator_mcp node vox_integration_tests: "vox-integration-tests" vox_integration_tests -> vox_orchestrator_mcp node vox_orchestrator_d: "vox-orchestrator-d" vox_orchestrator_d -> vox_orchestrator_mcp}Reverse Dependents (Used By)
Section titled “Reverse Dependents (Used By)”| Consumer Crate | Role |
|---|---|
vox-cli | Direct workspace dependent |
vox-cli-ci | Direct workspace dependent |
vox-cli-research | Direct workspace dependent |
vox-gui | Direct workspace dependent |
vox-integration-tests | Direct workspace dependent |
vox-orchestrator-d | Direct workspace dependent |
Deep Public Symbols (Source-Anchored)
Section titled “Deep Public Symbols (Source-Anchored)”| Kind | Symbol | Signature | Source | Description |
|---|---|---|---|---|
struct | a2a_tools::A2ASendParams | pub struct A2ASendParams | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L46-L63 | MCP tool arguments: point-to-point message on the orchestrator A2A bus. |
struct | a2a_tools::A2AInboxParams | pub struct A2AInboxParams | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L67-L78 | MCP tool arguments: fetch unacknowledged inbox entries for one agent. |
struct | a2a_tools::A2AAckParams | pub struct A2AAckParams | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L82-L89 | MCP tool arguments: mark one inbox message as read/processed. |
struct | a2a_tools::A2ABroadcastParams | pub struct A2ABroadcastParams | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L93-L102 | MCP tool arguments: fan-out to every agent except the sender. |
struct | a2a_tools::A2AHistoryParams | pub struct A2AHistoryParams | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L106-L111 | MCP tool arguments: audit trail query (since_ms filters by wall-clock ms; limit caps rows). |
struct | a2a_tools::A2AMessageInfo | pub struct A2AMessageInfo | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L119-L134 | JSON row returned in inbox/history tool responses (mirrors orchestrator message bus records). |
fn | a2a_tools::a2a_send | pub async fn a2a_send(state: &ServerState, params: A2ASendParams) -> String | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L307 | Send a targeted A2A message from one agent to another (async). |
fn | a2a_tools::a2a_inbox | pub async fn a2a_inbox(state: &ServerState, params: A2AInboxParams) -> String | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L589 | Read unacknowledged messages in an agent’s inbox (async). |
fn | a2a_tools::a2a_ack | pub async fn a2a_ack(state: &ServerState, params: A2AAckParams) -> String | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L715-L770 | Acknowledge a message in an agent’s inbox (async). |
fn | a2a_tools::a2a_broadcast | pub async fn a2a_broadcast(state: &ServerState, params: A2ABroadcastParams) -> String | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L773 | Broadcast an A2A message to all agents except sender (async). |
fn | a2a_tools::a2a_history | pub async fn a2a_history(state: &ServerState, params: A2AHistoryParams) -> String | crates/vox-orchestrator-mcp/src/a2a_tools.rs#L947-L993 | Query the A2A audit trail (async). |
struct | affinity_tools::FileOwnerParams | pub struct FileOwnerParams | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L19-L22 | MCP arguments: workspace-relative or absolute path to inspect for an owning agent. |
struct | affinity_tools::MyFilesParams | pub struct MyFilesParams | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L26-L29 | MCP arguments: list paths currently assigned to one agent. |
struct | affinity_tools::ClaimFileParams | pub struct ClaimFileParams | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L33-L38 | MCP arguments: agent takes exclusive affinity for path if unowned or already owned by them. |
struct | affinity_tools::TransferFileParams | pub struct TransferFileParams | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L42-L49 | MCP arguments: move affinity from from_agent to to_agent when the source owns the file. |
struct | affinity_tools::FileOwnerResponse | pub struct FileOwnerResponse | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L53-L58 | JSON fragment: resolved owner for a single path (owner is None if unassigned). |
struct | affinity_tools::MyFilesResponse | pub struct MyFilesResponse | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L62-L67 | JSON fragment: paths the affinity map associates with agent_id. |
fn | affinity_tools::file_owner | pub async fn file_owner(state: &ServerState, params: FileOwnerParams) -> String | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L70-L81 | Return JSON describing which agent (if any) owns params.path in the affinity map. |
fn | affinity_tools::my_files | pub async fn my_files(state: &ServerState, params: MyFilesParams) -> String | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L84-L97 | Return JSON listing all file paths owned by params.agent_id. |
fn | affinity_tools::claim_file | pub async fn claim_file(state: &ServerState, params: ClaimFileParams) -> String | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L100-L118 | Assign params.path to params.agent_id when not owned by another agent; mutates affinity map. |
fn | affinity_tools::transfer_file | pub async fn transfer_file(state: &ServerState, params: TransferFileParams) -> String | crates/vox-orchestrator-mcp/src/affinity_tools.rs#L121-L153 | Release then re-assign params.path from from_agent to to_agent; errors if ownership mismatches. |
fn | agent_tools::agent_list_remote | pub async fn agent_list_remote(_state: &ServerState) -> String | crates/vox-orchestrator-mcp/src/agent_tools.rs#L62-L87 | List remote/local agent skills. |
fn | agent_tools::agent_gateway_call | pub async fn agent_gateway_call(_state: &ServerState, params: OpenClawGatewayCallParams) -> String | crates/vox-orchestrator-mcp/src/agent_tools.rs#L90-L115 | Generic agent gateway method call. |
fn | agent_tools::agent_subscriptions | pub async fn agent_subscriptions(_state: &ServerState) -> String | crates/vox-orchestrator-mcp/src/agent_tools.rs#L118-L143 | List agent gateway subscriptions for the current session. |
fn | agent_tools::agent_subscribe | pub async fn agent_subscribe(_state: &ServerState, params: OpenClawDomainParams) -> String | crates/vox-orchestrator-mcp/src/agent_tools.rs#L146-L171 | Subscribe this session to a gateway domain. |
fn | agent_tools::agent_unsubscribe | pub async fn agent_unsubscribe(_state: &ServerState, params: OpenClawDomainParams) -> String | crates/vox-orchestrator-mcp/src/agent_tools.rs#L174-L199 | Unsubscribe this session from a gateway domain. |
fn | agent_tools::agent_notify | pub async fn agent_notify(_state: &ServerState, params: OpenClawNotifyParams) -> String | crates/vox-orchestrator-mcp/src/agent_tools.rs#L202-L227 | Notify a domain with a message payload. |
enum | agy_doctor::AgyStatus | pub enum AgyStatus | crates/vox-orchestrator-mcp/src/agy_doctor.rs#L8-L12 | — |
fn | agy_doctor::known_install_dirs | pub fn known_install_dirs() -> Vec<PathBuf> | crates/vox-orchestrator-mcp/src/agy_doctor.rs#L15-L25 | Best-effort platform install locations the installer documents, in addition to PATH. |
fn | agy_doctor::resolve_agy | pub fn resolve_agy() -> Option<PathBuf> | crates/vox-orchestrator-mcp/src/agy_doctor.rs#L38-L49 | Resolve the binary path via PATH (which) then known install dirs. |
fn | agy_doctor::detect | pub fn detect() -> AgyStatus | crates/vox-orchestrator-mcp/src/agy_doctor.rs#L53-L70 | Synchronous, fast classification (no long network calls). version is probed via agy --version; auth state is best-effort (see note in detect()). |
fn | agy_doctor::remediation | pub fn remediation(status: &AgyStatus) -> String | crates/vox-orchestrator-mcp/src/agy_doctor.rs#L72-L91 | — |
struct | agy_exec::AgySpec | pub struct AgySpec | crates/vox-orchestrator-mcp/src/agy_exec.rs#L12-L16 | — |
struct | agy_exec::AgyOutput | pub struct AgyOutput | crates/vox-orchestrator-mcp/src/agy_exec.rs#L19-L25 | — |
enum | agy_exec::AgyExecError | pub enum AgyExecError | crates/vox-orchestrator-mcp/src/agy_exec.rs#L28-L35 | — |
fn | agy_exec::validate_spec | pub fn validate_spec(spec: &AgySpec) -> Result<(), AgyExecError> | crates/vox-orchestrator-mcp/src/agy_exec.rs#L37-L42 | — |
fn | agy_exec::build_args | pub fn build_args(spec: &AgySpec) -> Vec<String> | crates/vox-orchestrator-mcp/src/agy_exec.rs#L44-L57 | — |
fn | agy_exec::sanitize_slug | pub fn sanitize_slug(s: &str) -> String | crates/vox-orchestrator-mcp/src/agy_exec.rs#L61-L76 | Lowercase, [a-z0-9-] only, collapsed dashes, max 40 chars. Prevents path traversal / illegal worktree paths. |
struct | agy_exec::AgyExec | pub struct AgyExec | crates/vox-orchestrator-mcp/src/agy_exec.rs#L79-L81 | — |
fn | agy_exec::new | pub fn new(cwd: impl Into<PathBuf>) -> Self | crates/vox-orchestrator-mcp/src/agy_exec.rs#L84-L86 | — |
fn | agy_exec::cwd | pub fn cwd(&self) -> &Path | crates/vox-orchestrator-mcp/src/agy_exec.rs#L87-L89 | — |
fn | agy_exec::run | pub async fn run(&self, spec: &AgySpec) -> Result<AgyOutput, AgyExecError> | crates/vox-orchestrator-mcp/src/agy_exec.rs#L91-L143 | — |
fn | agy_exec::classify_failure | pub fn classify_failure(stderr: &str, exit_code: i32, timed_out: bool) -> Option<&'static str> | crates/vox-orchestrator-mcp/src/agy_exec.rs#L147-L156 | Classify outcome for retry + ledger category. None on success. |
fn | agy_exec::should_retry | pub fn should_retry(class: &str, attempt: u32, max_attempts: u32) -> bool | crates/vox-orchestrator-mcp/src/agy_exec.rs#L159-L168 | Pure retry decision. attempt 0-based; max_attempts the cap. |
struct | agy_gates::Gate | pub struct Gate | crates/vox-orchestrator-mcp/src/agy_gates.rs#L16-L23 | — |