Log inGet started
Package

client.toolbox

Newest version

This package holds more than this page lists. See all of its files in its world.

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.