Module tools 

Local-filesystem tools — lightweight executables a user drops into <base_dir>/tools/ for later exposure to agents (e.g. as MCP tools). Mirrors filesystem::plugins minus the install pipeline: tools are hand-placed, not fetched from GitHub.

Structs

Exec

Per-OS exec command. Reused from the SDK so the on-disk objectiveai.json shape and the tools get wire shape stay identical. Per-OS exec command for a tool. The current platform’s vector is the program plus its leading arguments; the caller’s --args are appended, and the result runs with CWD = the tool’s version folder (where objectiveai.json lives).

Manifest

Declarative metadata a local tool ships with. The wire shape is JSON: <base_dir>/tools/<owner>/<name>/<version>/objectiveai.json. The executable command is invoked with that version folder as the working directory.

ManifestWithNameAndSource

A Manifest enriched with the tool’s identifying name and the source it was loaded from. Same shape and ordering convention as filesystem::plugins::ManifestWithNameAndSource.