> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tai42.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# toolbox

> Reference contrib package for the TAI ecosystem: opt-in, manifest-loaded generic tools and tool extensions (a tool extension extends a single tool).

<Info>`Tool` plugin · listing `tai42/toolbox`</Info>

## Install

```bash theme={null}
tai plugins install tai42-toolbox
```

## Permissions

| Capability | Declared |
| ---------- | -------- |
| Network    | yes      |
| Subprocess | no       |
| Filesystem | no       |

## Provides

<h3 id="current-time-info">
  current\_time\_info
</h3>

`Tool` — Return the current time as a structured object.

<h3 id="generate-embeddings">
  generate\_embeddings
</h3>

`Tool` — Generate embeddings for a single string or a list of strings.

<h3 id="generate-uuid">
  generate\_uuid
</h3>

`Tool` — Generate a random UUID (version 4).

<h3 id="pad-embeddings">
  pad\_embeddings
</h3>

`Tool` — Pad each embedding vector with zeros up to a target dimension.

<h3 id="request">
  request
</h3>

`Tool` — Execute an HTTP request through a curl-backed session.

<h3 id="batch">
  batch
</h3>

`Extension` · group `extensions` — Branch a tool into a variant that runs many instances at once.

<h3 id="cache">
  cache
</h3>

`Extension` · group `extensions` — Branch a tool into a variant that memoizes results by call arguments.

<h3 id="chain">
  chain
</h3>

`Extension` · group `extensions` — Branch a tool into a variant that transforms its output and calls a next tool.

<h3 id="output-schema">
  output\_schema
</h3>

`Extension` · group `extensions` — Branch a tool into a variant that forces a configured JSON Schema as its output schema and validates every result against it.

<h3 id="prometheus-metrics">
  prometheus\_metrics
</h3>

`Extension` · group `extensions` — Branch a tool into a variant that records a Prometheus call metric.

<h3 id="proxy">
  proxy
</h3>

`Extension` · group `extensions` — Branch a tool into a variant that runs the wrapped tool through a proxy.

The standard toolbox: five general-purpose tools and six tool extensions, each loaded
by name into a manifest. The tool-and-extension model and the day-to-day guide stay
central (linked below); this page is the per-item index and the extension settings.

## Tools

### current\_time\_info

Returns the current time as a structured object.

### generate\_embeddings

Generates embeddings for a single string or a list of strings.

### generate\_uuid

Generates a random UUID (version 4).

### pad\_embeddings

Pads each embedding vector with zeros up to a target dimension.

### request

Executes an HTTP request through a curl-backed session.

## Extensions

Each extension branches a tool into a variant; attach one through a manifest's
`extensions` map.

### batch

Branches a tool into a variant that runs many instances at once.

| Variable                       | Default | Effect                                                                                     |
| ------------------------------ | ------- | ------------------------------------------------------------------------------------------ |
| `BATCH_DEFAULT_MAX_CONCURRENT` | `5`     | Concurrency for a parallel call that names no `max_concurrent`, floored to the input size. |
| `BATCH_MAX_BATCH_SIZE`         | `100`   | Hard ceiling on the params per call; an over-limit call raises loudly.                     |

### cache

Branches a tool into a variant that memoizes results by call arguments.

| Variable            | Default | Effect                                                          |
| ------------------- | ------- | --------------------------------------------------------------- |
| `CACHE_MAX_ENTRIES` | `1024`  | Live entries a single cache branch retains before evicting LRU. |

### chain

Branches a tool into a variant that transforms its output and calls a next tool.

### output\_schema

Branches a tool into a variant that forces a configured JSON Schema as its output
schema and validates every result against it.

### prometheus\_metrics

Branches a tool into a variant that records a Prometheus call metric.

### proxy

Branches a tool into a variant that runs the wrapped tool through a proxy.

| Variable                  | Default | Effect                                         |
| ------------------------- | ------- | ---------------------------------------------- |
| `PROXY_POOL`              | empty   | Proxy URLs the pool routes over.               |
| `PROXY_ALLOW_CALLER_URLS` | `false` | Whether a caller may supply its own proxy URL. |
| `PROXY_CONNECT_TIMEOUT`   | `30`    | Connect timeout in seconds; must be positive.  |

## See also

* [Tools and extensions](/concepts/tools-and-extensions) — the model.
* [Standard toolbox](/guides/standard-toolbox) — the day-to-day guide.