What CriogenAI is

from criogenai import Agent, ToolError, tool


@tool
async def get_order(order_id: str) -> dict:
    """Look up an order by id."""
    if order_id != "A-1001":
        raise ToolError(f"No order {order_id}")  # the model sees this and can recover
    return {"status": "shipped", "eta": "tomorrow"}


agent = Agent(
    "openai:gpt-5-mini",  # key from OPENAI_API_KEY
    instructions="You are a support agent. Be brief.",
    tools=[get_order],
)


async def main() -> None:
    result = await agent.run("Where is order A-1001?")
    print(result.text)


asyncio.run(main())

import { Agent, ToolError, tool } from "criogenai";

const getOrder = tool({
  name: "get_order",
  description: "Look up an order by id.",
  input: {
    type: "object",
    properties: { orderId: { type: "string" } },
    required: ["orderId"],
  },
  run: async ({ orderId }) => {
    if (orderId !== "A-1001") throw new ToolError(`No order ${orderId}`); // the model sees this
    return { status: "shipped", eta: "tomorrow" };
  },
});

const agent = new Agent({
  model: "openai:gpt-5-mini", // key from OPENAI_API_KEY
  instructions: "You are a support agent. Be brief.",
  tools: [getOrder],
});

const result = await agent.run("Where is order A-1001?");
console.log(result.text);

use criogenai_agent::{Agent, ToolError, tool_fn};
use criogenai_providers::{Endpoint, ProviderModel, ToolSpec};
use serde_json::json;

let model = ProviderModel::new(
    Endpoint::openai(std::env::var("OPENAI_API_KEY")?),
    "gpt-5-mini",
)?;

let get_order = tool_fn(
    ToolSpec::new(
        "get_order",
        "Look up an order by id.",
        json!({
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"]
        }),
    ),
    |args, _ctx| async move {
        match args["order_id"].as_str() {
            Some("A-1001") => Ok(json!({"status": "shipped", "eta": "tomorrow"})),
            other => Err(ToolError::new(format!("No order {other:?}"))),
        }
    },
);

let agent = Agent::builder(model)
    .instructions("You are a support agent. Be brief.")
    .tool(get_order)
    .build()?;

let result = agent.run("Where is order A-1001?").await?;
println!("{}", result.text().unwrap_or_default());