Build IntelligentAgent Systems

import alcyoneus as alc
from alcyoneus.core import StateGraph, Agent, ToolNode, START, END
from alcyoneus.storage.checkpointer import InMemoryCheckpointer
from alcyoneus.prebuilt.tools import safe_calculator, google_web_search

# 1. Define custom domain tools
def check_inventory(sku: str) -> dict:
    """Check live warehouse stock for an SKU."""
    return {"sku": sku, "in_stock": True, "warehouse": "us-east-1"}

# 2. Build graph with Agent + ToolNode
graph = StateGraph()
graph.add_node("agent", Agent(model="gemini/gemini-2.5-flash", tool_node="tools"))
graph.add_node("tools", ToolNode([check_inventory, safe_calculator, google_web_search]))

# 3. Add cyclic execution edges
graph.add_edge("agent", "tools")
graph.add_edge("tools", "agent")
graph.set_entry_point("agent")

# 4. Compile with persistence
compiled = graph.compile(checkpointer=InMemoryCheckpointer())

# 5. Run stateful invocation
result = compiled.invoke(
    {"messages": [{"role": "user", "content": "Check stock for SKU-9821 and calculate tax at 8.5%"}]},
    config={"thread_id": "session-42"}
)