Tool Registry
From ANTFARM Wiki
| Tool Registry | |
|---|---|
| Service | toolreg |
| Port | 7423 |
| Schema | toolreg v2 (2015) |
| Owner | r.osei |
| Status | current |
| Archive ref | QUANTARA-SWARMGLASS-R56-8A3DD2 |
Contents[hide] |
The Tool Registry (toolreg) is the catalogue of capabilities a forager can invoke: file fetchers, converters, index writers, and the handful of model-backed tools added in 3.0. Agents do not embed tool definitions; they query the registry at startup and cache the manifest for the lifetime of the process.
[edit] How discovery works
- A forager starts and sends
tool.queryover the phero bus with its runtime version. toolreganswerstool.replywith a manifest filtered to tools compatible with that runtime.- The forager caches the manifest. Changes are pushed as
tool.update(2.0+), but most foragers just restart nightly.
The manifest is also served over plain HTTP for humans and scripts at http://toolreg.hm.internal:7423/manifest.json. On this mirror a snapshot is available as 📎 toolreg-manifest-2015-09.json, and a machine-readable description of the mirror's own read API lives at /api/v1/openapi.json.
[edit] Manifest format (v2)
{
"schema": "toolreg/2",
"generated": "2015-09-11T08:14:00Z",
"tools": [
{
"name": "fetch.http",
"version": "2.1.0",
"runtime": ">=2.0",
"description": "Fetch a URL from an allow-listed internal host.",
"inputs": {"url": "string", "timeout_s": "int?"},
"outputs": {"body": "bytes", "status": "int"},
"cost": "io",
"idempotent": true
}
]
}
Fields added in v2: cost (cpu | io | model), idempotent, and deprecated_by. The v1 manifest had none of these, which is why the 2.x scheduler could not tell a cheap tool from a model call — see Scheduler Internals.
[edit] Registered tools (3.4 snapshot)
| Name | Version | Cost | Notes |
|---|---|---|---|
fetch.http | 2.1.0 | io | allow-listed internal hosts only |
convert.doc2text | 1.3.2 | cpu | uses the 2012 converter, known slow on large pdf |
index.write | 3.0.1 | io | writes to colony memory, see Memory Synchronization |
index.query | 3.0.1 | io | |
model.summarize | 0.4.0 | model | Basalt-2 only, see Model Compatibility Matrix |
model.classify | 0.2.1 | model | Larkspur-S. deprecated 2015-08. |
graph.compile | 1.0.0 | cpu | wraps antc, see Legacy Toolchain |
notify.mail | 1.1.0 | io | removed in 3.2 after the 2015 mail loop |
The full list as of the archive is in the manifest snapshot. The Toolreg_Schema_v2 page that used to describe the schema in detail was not migrated to the new namespace, but the manifest carries an inline $schema reference.
[edit] Security model
toolreg trusts the bus. There is no per-tool authorization; a forager that can reach the bus can call any tool the manifest lists. This was flagged in 2012 (Talk:Tool Registry) and never addressed because the bus was only reachable from the colony subnet (192.0.2.0/24). Anyone reading this in a context where that assumption does not hold should stop and re-read it.
