# panto base agent tree

Contents of this directory are embedded into the `panto` binary at
build time and staged onto disk at bootstrap into
`$XDG_DATA_HOME/panto/agent/`, or `~/.local/share/panto/agent/` if
`XDG_DATA_HOME` is unset.

The staged tree is the "base" layer of panto's extension/tool
search path — sitting underneath the user layer
(`$XDG_CONFIG_HOME/panto/`) and the project layer
(`./.panto/`). Project shadows user shadows base.

Files are written with `writeIfDifferent` semantics: on each
bootstrap, embedded contents are compared against what's on disk and
only rewritten when they differ. This keeps mtimes stable across
reruns.

The staged tree is **panto's territory** — local edits will be
overwritten on the next bootstrap. To customize a base tool,
override it at the user or project layer (a file with the same
basename under `$XDG_CONFIG_HOME/panto/tools/` or `./.panto/tools/`
shadows the base copy).

## Layout

    agent/
      tools/            single-file tools, one per `.lua`
      extensions/       multi-tool extensions