Getting started

pip install "rungent[fastapi,sqlalchemy]"
npm install @rungent/sdk

from typing import Annotated

from rungent import Agent, ToolContext, ToolResult, tool


@tool(effect="write", approval="never")
async def move_place(
    ctx: ToolContext,
    name: Annotated[str, "Exact place name"],
    day_number: Annotated[int | None, "Target day; null means unplanned"],
) -> ToolResult:
    """Move a place to a trip day."""
    trips = ctx.deps["trips"]
    await trips.move(ctx.resource["trip_id"], name, day_number)
    return ToolResult(message=f"Moved {name}")


agent = Agent(
    name="trip_planner",
    instructions="""
    You update a trip itinerary. Use a tool for every factual change.
    Ask for input when a place or target day is ambiguous.
    """,
    tools=[move_place],
)