Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Language

Toolang source files use the .too extension.

A .too file defines an agent and may contain:

  • cap references
  • inline cap definitions
  • structs
  • stashes
  • prompts
  • thunks

What Toolang is

Toolang is not only a syntax.

It includes:

  • the language for describing agents
  • the runtime for executing them
  • the CLI for running and managing them

Caps

Toolang works with four cap kinds:

  • skill
  • service
  • prompt
  • psyche

Caps can come from three default sources:

  • source caps
  • config caps
  • local caps

When names collide, precedence is:

  1. local caps
  2. config caps
  3. source caps

References

Capability references use the cap_ref form:

user-or-org/cap-name

The final resolution depends on the cap kind. A skill and a service may probe different GitHub repositories and paths for the same bare cap_ref.

Thunks

Thunks are the executable entrypoints of an agent. They define what the runtime prepares and what the model run is trying to do.

See CLI and Runtime Design for execution semantics.