Condukt.Tools (Condukt v0.16.1)

Copy Markdown View Source

Built-in tools for Condukt.

Default Tool Sets

Individual Tools

Every built-in tool routes its filesystem and process work through the active Condukt.Sandbox, so the same tool list works against the host filesystem (Sandbox.Local) or an isolated virtual filesystem (Sandbox.Virtual). Command tools also receive session secrets as environment variables when configured at start_link/1.

Usage

defmodule MyAgent do
  use Condukt

  @impl true
  def tools do
    Condukt.Tools.coding_tools()
  end
end

Or pick specific tools:

def tools do
  [
    Condukt.Tools.Read,
    Condukt.Tools.Bash
  ]
end

Summary

Functions

Returns all built-in tools that can be attached directly to an agent.

Returns the default coding tools: Read, Bash, Edit, Write, Glob, Grep.

Returns read-only tools: Read, Bash, Glob, Grep.

Functions

all()

Returns all built-in tools that can be attached directly to an agent.

Condukt.Tools.Subagent is injected automatically when an agent declares sub-agents, so it is not included here.

coding_tools()

Returns the default coding tools: Read, Bash, Edit, Write, Glob, Grep.

These tools provide full filesystem access for coding agents through the active sandbox.

read_only_tools()

Returns read-only tools: Read, Bash, Glob, Grep.

Use these when you want the agent to explore but not modify files. Note that Bash can still execute arbitrary commands. Prefer a parameterized Condukt.Tools.Command when you want to grant a specific executable such as git, gh, or mix.