dsh-math

Readme

# dsh-math

Scientific computing plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). It registers a single `math` tool that covers both numeric computation and symbolic algebra (CAS), so an agent can evaluate expressions and derive/simplify formulas without leaving the conversation.

## Features

The `math` tool takes an `operation`, an `expression`, and an optional `variable`.

| operation | description | engine |
|---|---|---|
| `eval` | numeric expression: units, matrices, statistics, complex numbers, big numbers | mathjs |
| `simplify` | simplify an expression | Algebrite |
| `expand` | expand an expression | Algebrite |
| `factor` | factor a polynomial | Algebrite |
| `derivative` | differentiate with respect to a variable | Algebrite |
| `integral` | symbolic indefinite integral | Algebrite |
| `solve` | find the roots of a polynomial | Algebrite |

Two engines share the work: **mathjs** handles numeric evaluation (units, matrices, statistics, complex numbers, big numbers), and **Algebrite** handles symbolic algebra (integration, factoring, and equation solving that mathjs does not provide).

## Install

From npm:

```sh
dsh plugin --profile web add dsh-math
```

From a git host (requires the repository's `prepare` script to build, or pin a commit):

```sh
dsh plugin --profile web add github:owner/dsh-math
```

## Usage

The agent calls the `math` tool automatically when it needs a computation. Examples of what it can answer:

- determinant: `det([[1,2],[3,4]])` → `-2`
- unit conversion: `5 cm to inch` → `1.9685039370078743 inch`
- big number: `2^100` → `1.2676506002282294e+30`
- derivative: `derivative(x^2, x)` → `2*x`
- integral: `integral(x^2, x)` → `1/3*x^3`
- solve: `roots(x^2 - 3x + 2)` → `[1,2]`

## License

MIT