Tools

from orxhestra import function_tool

async def search_web(query: str) -> str:
    """Search the web and return results."""
    ...

tool = function_tool(search_web)
# or: function_tool(search_web, name="web_search", description="...")

from orxhestra import LlmAgent
from orxhestra.tools.agent_tool import AgentTool

research_agent = LlmAgent(name="ResearchAgent", model=model, tools=[search_tool])

parent = LlmAgent(
    name="Coordinator",
    model=model,
    tools=[AgentTool(research_agent)],
    instructions="Delegate research to ResearchAgent.",
)

def check_event(event, child_ctx):
    if child_ctx.state.get("needs_approval"):
        return "Paused: awaiting approval."  # short-circuits, returns this as tool result
    return None  # continue

tool = AgentTool(research_agent, before_agent_callback=check_event)

if ctx.event_callback is not None:
    ctx.event_callback(my_event)

from orxhestra import make_transfer_tool

transfer = make_transfer_tool([billing_agent, support_agent, tech_agent])
# The LLM can call "transfer_to_agent" with the target agent name.
# EventActions.transfer_to_agent is set; the parent routes accordingly.

from orxhestra import exit_loop_tool

loop_agent = LoopAgent(
    name="RefineLoop",
    agents=[refine_agent],
    # refine_agent has exit_loop_tool in its tools list
)

from orxhestra.tools import CallContext

class MyStatefulTool(BaseTool):
    _ctx: CallContext | None = None

    def inject_context(self, ctx: InvocationContext) -> None:
        self._ctx = CallContext(ctx)

    async def _arun(self, query: str) -> str:
        self._ctx.state["last_query"] = query
        return "done"

from orxhestra.tools import make_filesystem_tools

tools = make_filesystem_tools(workspace="/tmp/my-workspace")
# or use $AGENT_WORKSPACE env var / default /tmp/agent-workspace

agent = LlmAgent(name="coder", model=model, tools=tools)

tools:
  fs:
    builtin: filesystem

from orxhestra.tools import make_shell_tools

tools = make_shell_tools(
    workspace="/tmp/my-workspace",
    timeout=30,                          # max seconds per command
    max_output_bytes=102400,             # truncate beyond 100KB
    allowed_commands=["python", "npm"],   # whitelist (optional)
    denied_commands=["rm", "shutdown"],   # blocklist (optional)
    env={"NODE_ENV": "test"},            # extra env vars (optional)
)

tools:
  sh:
    builtin: shell