Builtin Library
README.md
client
Your sub-client and the user's client: list, check, create, restart and delete the clients of this world you work in.
Every agent works in its own sub-client (subclient): a headless client of
the same world that the user's editor runs for it. The tools that run code
(execute, bash, capture, play, edit, pause, wait, the file
tools, use_tool, tool_exec and input) run in your sub-client when the
call names no client, so the user's screen never stalls, never shows your
errors, and keeps its own play or edit mode. Pass client: "user" on a call
to run it in the user's client, to show the user something or to see what
they see; pass client: "<id>" to run it in another sub-client.
list: the user's client and every sub-client, with id, state, branch, scene, start, whose it is and who called it lately, plus the limit and the memory available.status: one sub-client, yours when no id is given.create: start another sub-client under an id you choose, optionally on another branch, scene or profile.restart: start a sub-client afresh on the world and branch it is on, optionally on another scene or profile.delete: stop a sub-client and free its process, port, world session and memory.
man subclient explains how sub-clients work.