Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xhipai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Calculator

Evaluate math expressions safely using a sandboxed math environment. Supports arithmetic, exponentiation, and common Math functions — no eval() used internally.

​
Quick Start

import { Agent, openai, CalculatorToolkit } from "@agentium/core";

const calc = new CalculatorToolkit();

const agent = new Agent({
  name: "math-assistant",
  model: openai("gpt-4o"),
  instructions: "Help users with calculations. Always show your work.",
  tools: [...calc.getTools()],
});

const result = await agent.run("What is the square root of 144 plus 2^10?");

​
Config

​
precision
number
default:"10"
Decimal precision for results (number of significant digits).

​
Tools

ToolDescription
calculateEvaluate a math expression. Supports +, -, *, /, ^, %, parentheses, and functions like sqrt, pow, sin, cos, log, abs, ceil, floor, round, min, max. Constants: PI, E.

​
Supported Functions

FunctionExample
sqrt(x)sqrt(144) → 12
pow(x, y)pow(2, 10) → 1024
abs(x)abs(-5) → 5
sin(x), cos(x), tan(x)Trigonometric functions (radians)
log(x), log2(x), log10(x)Logarithmic functions
ceil(x), floor(x), round(x)Rounding
min(a, b), max(a, b)Min/max
exp(x)e^x
cbrt(x)Cube root