README

Math expression evaluator toolkit for Coqui. Provides a token-efficient calculate tool that evaluates arithmetic, scientific, and algebraic expressions — powered by nxp/math-executor with 60+ built-in functions.

Requirements

• PHP 8.4+

Installation

composer require coquibot/coqui-toolkit-calculator

When installed alongside Coqui, the toolkit is auto-discovered via Composer's extra.php-agents.toolkits — no manual registration needed.

Tools Provided

calculate

Evaluate one or more math expressions in a single call.

Features:

• Batch evaluation — semicolon-delimited expressions evaluated in sequence
• Variable support — assign variables that carry forward within a call (x=5; 2*x+3)
• 60+ built-in functions — trig, logarithmic, rounding, statistics, base conversion
• Per-expression error handling — a bad expression doesn't kill the batch
• BCMath mode — arbitrary precision via precision: "bcmath:20"
• No credentials required — pure PHP computation

Supported Functions

Output Format

Single expression — returns the raw result value:

5

Batch expressions — returns a JSON array:

[{"expr":"2+3","result":5},{"expr":"sin(pi/4)","result":0.7071067812},{"expr":"x=10","result":10},{"expr":"x^2","result":100}]

Errors — per-expression error fields without stopping the batch:

[{"expr":"2+3","result":5},{"expr":"1/0","error":"Division by zero"},{"expr":"4*5","result":20}]

Standalone Usage

<?php

declare(strict_types=1);

use CoquiBot\Toolkits\Calculator\CalculatorToolkit;

require __DIR__ . '/vendor/autoload.php';

$toolkit = CalculatorToolkit::fromEnv();
$tool = $toolkit->tools()[0];

// Single expression
$result = $tool->execute(['expressions' => '2 + 3']);
echo $result->content; // 5

// Batch with variables
$result = $tool->execute(['expressions' => 'x=10; y=20; sqrt(x^2 + y^2)']);
echo $result->content;
// [{"expr":"x=10","result":10},{"expr":"y=20","result":20},{"expr":"sqrt(x^2 + y^2)","result":22.360679775}]

// BCMath precision
$result = $tool->execute([
    'expressions' => '1/3',
    'precision' => 'bcmath:30',
]);
echo $result->content; // 0.333333333333333333333333333333

Development

git clone https://github.com/AgentCoqui/coqui-toolkit-calculator.git
cd coqui-toolkit-calculator
composer install

Run tests

./vendor/bin/pest

Static analysis

./vendor/bin/phpstan analyse

License

MIT