Skip to main content

Crate vv_agent

Crate vv_agent 

Source
Expand description

VectorVein agent runtime, SDK, CLI, tools, memory, prompt, and workspace APIs.

This crate exposes a stable Rust library surface for building and running agent workflows with built-in tool dispatch and vv-llm backed chat clients.

Re-exports§

pub use agent::Agent;
pub use agent::ToolUseBehavior;
pub use config::apply_resolved_model_limits;
pub use config::build_vv_llm_from_local_settings;
pub use config::build_vv_llm_settings;
pub use config::decode_api_key;
pub use config::load_llm_settings_from_file;
pub use config::load_memory_summary_defaults_from_file;
pub use config::resolve_model_endpoint;
pub use config::ConfigError;
pub use config::EndpointConfig;
pub use config::EndpointOption;
pub use config::MemorySummaryDefaults;
pub use config::ResolvedModelConfig;
pub use context::RunContext;
pub use context::ToolCallContext;
pub use events::AgentErrorPayload;
pub use events::RunEvent;
pub use events::ToolStatus;
pub use execution_mode::ExecutionMode;
pub use guardrails::GuardrailOutcome;
pub use guardrails::InputGuardrail;
pub use guardrails::OutputGuardrail;
pub use handoffs::handoff;
pub use handoffs::Handoff;
pub use llm::EndpointTarget;
pub use llm::LlmClient;
pub use llm::LlmError;
pub use llm::LlmRequest;
pub use llm::LlmStreamCallback;
pub use llm::ScriptStep;
pub use llm::ScriptStepCallback;
pub use llm::ScriptedLlmClient;
pub use llm::VvLlmClient;
pub use memory::sanitize_for_resume;
pub use memory::CompactionExhaustedError;
pub use memory::LocalSummary;
pub use memory::MemoryManager;
pub use memory::MemoryManagerConfig;
pub use memory::SessionMemory;
pub use memory::SessionMemoryConfig;
pub use memory::SessionMemoryEntry;
pub use memory::SessionMemoryState;
pub use memory::SummaryCallback;
pub use model::ModelError;
pub use model::ModelProvider;
pub use model::ModelRef;
pub use model::ScriptedModelProvider;
pub use model::VvLlmModelProvider;
pub use model_settings::ModelSettings;
pub use model_settings::ResponseFormat;
pub use model_settings::RetryPolicy;
pub use model_settings::ToolChoice;
pub use result::RunResult;
pub use result::RunState;
pub use run_config::RunConfig;
pub use runner::NormalizedInput;
pub use runner::RunEventStream;
pub use runner::Runner;
pub use runtime::backends::run_checkpointed_cycle;
pub use runtime::backends::CycleDispatchResult;
pub use runtime::backends::CycleDispatcher;
pub use runtime::backends::DistributedBackend;
pub use runtime::backends::InlineBackend;
pub use runtime::backends::RuntimeExecutionBackend;
pub use runtime::backends::RuntimeRecipe;
pub use runtime::backends::ThreadBackend;
pub use runtime::background_sessions::background_session_manager;
pub use runtime::background_sessions::BackgroundSessionAdoptOptions;
pub use runtime::background_sessions::BackgroundSessionListener;
pub use runtime::background_sessions::BackgroundSessionManager;
pub use runtime::background_sessions::BackgroundSessionStartOptions;
pub use runtime::background_sessions::BackgroundSessionSubscription;
pub use runtime::shell::build_shell_invocation;
pub use runtime::shell::prepare_shell_execution;
pub use runtime::shell::resolve_shell_invocation;
pub use runtime::shell::PreparedShellCommand;
pub use runtime::shell::ShellInvocation;
pub use runtime::state::Checkpoint;
pub use runtime::state::InMemoryStateStore;
pub use runtime::state::StateStore;
pub use runtime::stores::redis::RedisStateStore;
pub use runtime::stores::sqlite::SqliteStateStore;
pub use runtime::sub_task_manager::ManagedSubTask;
pub use runtime::sub_task_manager::ManagedSubTaskSnapshot;
pub use runtime::sub_task_manager::SubTaskManager;
pub use runtime::sub_task_manager::SubTaskSessionAttachment;
pub use runtime::_register_sub_agent_session;
pub use runtime::_unregister_sub_agent_session;
pub use runtime::continue_sub_agent_session;
pub use runtime::get_sub_agent_session;
pub use runtime::register_sub_agent_session;
pub use runtime::steer_sub_agent_session;
pub use runtime::sub_agent_session_registry;
pub use runtime::subscribe_sub_agent_session;
pub use runtime::unregister_sub_agent_session;
pub use runtime::AfterLlmEvent;
pub use runtime::AfterToolCallEvent;
pub use runtime::AgentRuntime;
pub use runtime::BeforeCycleMessageProvider;
pub use runtime::BeforeLlmEvent;
pub use runtime::BeforeLlmPatch;
pub use runtime::BeforeMemoryCompactEvent;
pub use runtime::BeforeToolCallEvent;
pub use runtime::BeforeToolCallPatch;
pub use runtime::CancellationToken;
pub use runtime::CancelledError;
pub use runtime::CycleRunRequest;
pub use runtime::CycleRunner;
pub use runtime::ExecutionContext;
pub use runtime::InterruptionMessageProvider;
pub use runtime::RuntimeEventHandler;
pub use runtime::RuntimeHook;
pub use runtime::RuntimeHookManager;
pub use runtime::RuntimeRunControls;
pub use runtime::StreamCallback;
pub use runtime::SubAgentSession;
pub use runtime::SubAgentSessionListener;
pub use runtime::SubAgentSessionRegistry;
pub use runtime::SubAgentSessionUnsubscribe;
pub use runtime::ToolCallRunner;
pub use runtime::ToolRunOutcome;
pub use runtime::ToolRunRequest;
pub use runtime::MAX_PROMPT_TOO_LONG_RETRIES;
pub use runtime::MAX_PTL_RETRIES;
pub use sessions::session_store_conformance;
pub use sessions::MemorySession;
pub use sessions::Session;
pub use sessions::SessionItem;
pub use sessions::SessionStore;
pub use sessions::SqliteSessionStore;
pub use tools::build_default_registry;
pub use tools::dispatch_tool_call;
pub use tools::AgentTool;
pub use tools::AgentToolBuilder;
pub use tools::ApprovalDecision;
pub use tools::ApprovalPolicy;
pub use tools::BackgroundAgentTask;
pub use tools::BackgroundAgentTaskBuilder;
pub use tools::BackgroundAgentTaskHandle;
pub use tools::BackgroundAgentTaskSnapshot;
pub use tools::FunctionTool;
pub use tools::StaticTool;
pub use tools::Tool;
pub use tools::ToolContext;
pub use tools::ToolHandler;
pub use tools::ToolNotFoundError;
pub use tools::ToolOutput;
pub use tools::ToolPolicy;
pub use tools::ToolRegistry;
pub use tools::ToolSpec;
pub use tracing::JsonlTraceExporter;
pub use tracing::Span;
pub use tracing::TraceSink;
pub use types::AgentResult;
pub use types::AgentStatus;
pub use types::AgentTask;
pub use types::CycleRecord;
pub use types::CycleStatus;
pub use types::LLMResponse;
pub use types::Message;
pub use types::MessageRole;
pub use types::NoToolPolicy;
pub use types::SubAgentConfig;
pub use types::SubTaskOutcome;
pub use types::SubTaskRequest;
pub use types::TaskTokenUsage;
pub use types::TokenUsage;
pub use types::ToolCall;
pub use types::ToolDirective;
pub use types::ToolExecutionResult;
pub use types::ToolResultStatus;
pub use workspace::FileInfo;
pub use workspace::LocalWorkspaceBackend;
pub use workspace::MemoryWorkspaceBackend;
pub use workspace::S3WorkspaceBackend;
pub use workspace::S3WorkspaceConfig;
pub use workspace::WorkspaceBackend;

Modules§

agent
cli
config
constants
context
events
execution_mode
guardrails
handoffs
integrations
llm
memory
model
model_settings
prompt
result
run_config
runner
runtime
sessions
skills
tools
tracing
types
workspace