vox-actor-runtime API Reference (generated)

`vox-actor-runtime`

Crate: vox-actor-runtime · Version: 0.6.0 · Target: Library (lib.rs)

Process-oriented runtime: actors, mailboxes, supervision, scheduling, LLM/Mens activity primitives.

Crate Overview

Process-oriented runtime primitives for Vox: actors, mailboxes, supervision, and scheduling.

Submodules implement the durable / distributed process story; this crate root mostly re-exports stable names for embedders. Detailed behavior is documented on the defining types inside each module; blanket Rustdoc on every pub use alias would add noise without semantic value.

Features

Feature	Default / Enables
`database`	dep:vox-db, vox-db/host-integration
`default`	—

Workspace Dependencies

Dependency	Kind
`vox-bounded-fs`	Normal
`vox-config`	Normal
`vox-db`	Normal
`vox-foundation`	Normal
`vox-http-client`	Normal
`vox-llm-egress`	Normal
`vox-openai`	Normal
`vox-openclaw-runtime`	Normal
`vox-orchestrator-types`	Normal
`vox-plugin-host`	Normal
`vox-secrets`	Normal
`vox-shell-stdlib-types`	Normal
`vox-skills`	Normal
`vox-telemetry`	Normal
`vox-crypto`	Development

Public API Surface

Modules

Module	Description
`semcov_wave28_tests`	Adversarial semantic-coverage tests (wave 28).
`activity`	Durable activity execution: retries, timeouts, and backoff around async work.
`auth`	Authentication helpers for generated Vox services: API key / bearer validation and retry-after parsing.
`builtins`	Host-callable builtins surfaced to generated code (hashing, small helpers).
`db`	Optional Codex / Turso database handle when the `database` feature is enabled.
`durable_scheduler`	Durable / cron scheduler primitives for `@scheduled` + `@durable` (GA-11).
`gc`	Garbage collection arena and !Send pointers for actor memory isolation.
`inference_env`	Hugging Face router, Hub listings, and Mens/Ollama capability probes.
`llm`	OpenAI-compatible chat/embed clients, registry entries, and usage metrics.
`llm_result`	Typed result wrapper for structured LLM activity returns (parse-safe).
`mailbox`	Actor mailboxes: envelopes, messages, requests, and process signals.
`mens`	Mens/Ollama HTTP client for generate, embed, classify, and RAG helpers.
`model_resolution`	SSOT chat routing: manual URL, Mens, HF dedicated/router, OpenRouter.
`notify`	Multi-channel notification dispatch (GA-14): Email / SMS / WebPush.
`pid`	Opaque process identifiers for actors and messaging.
`presence`	Cursor-presence channel for real-time multiplayer (GA-25).
`process`	Actor `ProcessContext`, `ProcessHandle`, and `spawn_process`.
`prompt_canonical`	Prompt normalization, conflict detection, and safety pass for LLM ingress.
`registry`	Global map of live actors by [`Pid`] and optional name.
`resilient_http`	Retry policy and HTTP client with fallback endpoints.
`retrieval`	RAG-style chunk retrieval, context budgets, and provenance records.
`route_capability_policy`	`VOX_ROUTE_*` capability policy snapshot (shared with orchestrator explain/MCP paths).
`routing_telemetry`	Shared routing decision telemetry for DB joins (bounded `reason_json`).
`scheduler`	Cooperative Tokio-backed scheduler registering spawned actors.
`state_machine`	Reactive state-machine instance helper consumed by emitted state-machine hooks (Phase G of the Svelte-mineable features plan).
`subscription`	Per-table reactive mutation notifications (broadcast channels for reactive queries).
`supervisor`	Supervision strategies and child restart loops for actor trees.