Struct AgentOvenClient 

pub struct AgentOvenClient { /* private fields */ }

Client for interacting with the AgentOven control plane.

Implementations

impl AgentOvenClient

pub fn new(base_url: &str) -> Result<Self>

Create a new client connected to the control plane.

pub fn from_env() -> Result<Self>

Create from config file + environment variables.

Priority: CLI flags > env vars > ~/.agentoven/config.toml > defaults.

pub fn from_config(cfg: &AgentOvenConfig) -> Result<Self>

Create from an explicit config struct (no env-var lookup).

pub fn with_api_key(self, key: impl Into<String>) -> Self

Set API key.

pub fn with_kitchen(self, kitchen_id: impl Into<String>) -> Self

Set the active kitchen (workspace).

pub async fn register(&self, agent: &Agent) -> Result<Agent>

Register a new agent in the oven (menu).

Sends only the user-provided fields; server-managed fields (id, status, kitchen, timestamps, a2a_endpoint) are set server-side.

pub async fn get_agent( &self, name: &str, version: Option<&str>, ) -> Result<Agent>

Get an agent by name and optional version.

pub async fn list_agents(&self) -> Result<Vec<Agent>>

List all agents in the current kitchen.

pub async fn bake(&self, agent: &Agent, environment: &str) -> Result<Agent>

Bake (deploy) an agent to an environment.

pub async fn rewarm(&self, name: &str) -> Result<Value>

Rewarm a cooled agent (transition back to ready).

pub async fn create_recipe(&self, recipe: &Recipe) -> Result<Recipe>

Create a new recipe (workflow).

pub async fn bake_recipe( &self, recipe_name: &str, input: Value, ) -> Result<Value>

Bake (execute) a recipe with input.

pub async fn update_agent(&self, name: &str, updates: Value) -> Result<Agent>

Update an existing agent.

pub async fn delete_agent(&self, name: &str) -> Result<()>

Delete an agent.

pub async fn recook_agent(&self, name: &str, edits: Value) -> Result<Value>

Re-cook an agent with edits.

pub async fn cool_agent(&self, name: &str) -> Result<Value>

Cool (pause) an agent.

pub async fn retire_agent(&self, name: &str) -> Result<Value>

Retire an agent permanently.

pub async fn test_agent( &self, name: &str, message: &str, thinking: bool, ) -> Result<Value>

Test an agent (one-shot, via /test endpoint).

pub async fn invoke_agent( &self, name: &str, message: &str, variables: Option<Value>, thinking: bool, ) -> Result<Value>

Invoke a managed agent (full agentic loop with execution trace).

pub async fn agent_config(&self, name: &str) -> Result<Value>

Get the resolved configuration for a baked agent.

pub async fn agent_card(&self, name: &str) -> Result<Value>

Get the A2A Agent Card for an agent.

pub async fn agent_versions(&self, name: &str) -> Result<Vec<Value>>

List version history for an agent.

pub async fn list_providers(&self) -> Result<Vec<Value>>

List all model providers.

pub async fn add_provider(&self, provider: Value) -> Result<Value>

Add a new model provider.

pub async fn get_provider(&self, name: &str) -> Result<Value>

Get a specific model provider.

pub async fn update_provider( &self, name: &str, provider: Value, ) -> Result<Value>

Update a model provider.

pub async fn delete_provider(&self, name: &str) -> Result<()>

Delete a model provider.

pub async fn test_provider(&self, name: &str) -> Result<Value>

Test a provider’s connectivity and credentials.

pub async fn discover_provider(&self, name: &str) -> Result<Value>

Discover models available from a provider.

pub async fn list_tools(&self) -> Result<Vec<Value>>

List all MCP tools.

pub async fn add_tool(&self, tool: Value) -> Result<Value>

Add a new MCP tool.

pub async fn bulk_add_tools(&self, payload: Value) -> Result<Value>

Bulk-add multiple MCP tools in one request.

pub async fn get_tool(&self, name: &str) -> Result<Value>

Get a specific tool.

pub async fn update_tool(&self, name: &str, tool: Value) -> Result<Value>

Update a tool.

pub async fn delete_tool(&self, name: &str) -> Result<()>

Delete a tool.

pub async fn list_prompts(&self) -> Result<Vec<Value>>

List all prompt templates.

pub async fn add_prompt(&self, prompt: Value) -> Result<Value>

Add a new prompt template.

pub async fn get_prompt(&self, name: &str) -> Result<Value>

Get a specific prompt template.

pub async fn update_prompt(&self, name: &str, prompt: Value) -> Result<Value>

Update a prompt template.

pub async fn delete_prompt(&self, name: &str) -> Result<()>

Delete a prompt template.

pub async fn validate_prompt(&self, name: &str) -> Result<Value>

Validate a prompt template.

pub async fn prompt_versions(&self, name: &str) -> Result<Vec<Value>>

List version history for a prompt.

pub async fn list_kitchens(&self) -> Result<Vec<Value>>

List all kitchens.

pub async fn get_kitchen(&self, id: &str) -> Result<Value>

Get a specific kitchen.

pub async fn create_kitchen(&self, kitchen: Value) -> Result<Value>

Create a new kitchen.

pub async fn delete_kitchen(&self, id: &str) -> Result<()>

Delete a kitchen.

pub async fn server_info(&self) -> Result<Value>

Get server info (edition, features, limits). The CLI calls this to discover what commands are available.

pub async fn get_settings(&self) -> Result<Value>

Get kitchen settings.

pub async fn update_settings(&self, settings: Value) -> Result<Value>

Update kitchen settings.

pub async fn list_sessions(&self, agent_name: &str) -> Result<Vec<Value>>

List sessions for an agent.

pub async fn create_session(&self, agent_name: &str) -> Result<Value>

Create a new session for an agent.

pub async fn get_session( &self, agent_name: &str, session_id: &str, ) -> Result<Value>

Get a specific session.

pub async fn delete_session( &self, agent_name: &str, session_id: &str, ) -> Result<()>

Delete a session.

pub async fn send_session_message( &self, agent_name: &str, session_id: &str, message: &str, thinking: bool, ) -> Result<Value>

Send a message within a session.

pub async fn rag_query(&self, query: Value) -> Result<Value>

Query the RAG pipeline.

pub async fn rag_ingest(&self, request: Value) -> Result<Value>

Ingest documents into the RAG pipeline.

pub async fn list_traces( &self, agent: Option<&str>, limit: u32, ) -> Result<Vec<Value>>

List recent traces.

pub async fn get_trace(&self, trace_id: &str) -> Result<Value>

Get a specific trace.

pub async fn model_catalog(&self) -> Result<Vec<Value>>

List model catalog.

pub async fn catalog_refresh(&self) -> Result<Value>

Refresh model catalog from providers.

pub async fn model_cost(&self) -> Result<Value>

Get cost summary.

pub async fn get_recipe(&self, name: &str) -> Result<Value>

Get a specific recipe.

pub async fn list_recipes(&self) -> Result<Vec<Value>>

List all recipes.

pub async fn delete_recipe(&self, name: &str) -> Result<()>

Delete a recipe.

pub async fn recipe_runs(&self, name: &str) -> Result<Vec<Value>>

List runs for a recipe.

pub async fn approve_gate( &self, recipe: &str, run_id: &str, step_name: &str, approved: bool, comment: Option<&str>, ) -> Result<Value>

Approve a human gate in a recipe run.

pub async fn list_audit(&self, limit: u32) -> Result<Vec<Value>>

List audit events.

pub async fn guardrail_kinds(&self) -> Result<Vec<Value>>

List available guardrail kinds.

pub async fn raw_get<T: DeserializeOwned>(&self, path: &str) -> Result<T>

Generic GET that returns deserialized JSON.

pub async fn raw_post<T: DeserializeOwned>( &self, path: &str, body: &Value, ) -> Result<T>

Generic POST that sends JSON and returns deserialized JSON.

pub async fn raw_delete(&self, path: &str) -> Result<()>

Generic DELETE.

Trait Implementations

impl Clone for AgentOvenClient

fn clone(&self) -> AgentOvenClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentOvenClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.