agent - v1.0.0

core/loop

Conversation loop — the core orchestrator.

Types

LoopResult

</> 
pub type LoopResult {
  Success(reply: String, history: List(completions.Message))
  ToolLoopLimit(
    reply: String,
    history: List(completions.Message),
  )
  Failed(message: String)
}

Constructors

Values

client_error_to_string

</> 
pub fn client_error_to_string(
  err: completions.ClientError,
) -> String

execute_tools

</> 
pub fn execute_tools(
  history: List(completions.Message),
  calls: List(completions.ToolCall),
  all_tools: List(tool.Tool),
) -> List(completions.Message)

run

</> 
pub fn run(
  client: completions.Client,
  persona: String,
  history: List(completions.Message),
  user_message: String,
  tool_defs: List(completions.ToolDefinition),
  max_rounds: Int,
  conn: sqlight.Connection,
  user_key: String,
) -> LoopResult

Run the conversation loop with the default tool registry.

run_with

</> 
pub fn run_with(
  client: completions.Client,
  persona: String,
  history: List(completions.Message),
  user_message: String,
  tool_defs: List(completions.ToolDefinition),
  max_rounds: Int,
  all_tools: List(tool.Tool),
  conn: sqlight.Connection,
  user_key: String,
) -> LoopResult

Run the conversation loop with a custom tool list (e.g. approval-enabled bash).

run_with_chat_fn

</> 
pub fn run_with_chat_fn(
  chat_fn: fn(
    completions.Client,
    List(completions.Message),
    List(completions.ToolDefinition),
  ) -> Result(completions.ChatResponse, completions.ClientError),
  client: completions.Client,
  persona: String,
  history: List(completions.Message),
  user_message: String,
  tool_defs: List(completions.ToolDefinition),
  max_rounds: Int,
  all_tools: List(tool.Tool),
  conn: sqlight.Connection,
  user_key: String,
) -> LoopResult

Run the conversation loop with a custom chat function (for testing).

tool_names_string

</> 
pub fn tool_names_string(all_tools: List(tool.Tool)) -> String

validate_tool_calls

</> 
pub fn validate_tool_calls(
  calls: List(completions.ToolCall),
  all_tools: List(tool.Tool),
) -> List(#(completions.ToolCall, Result(Nil, String)))
✨ Search Document