Touba documentation
Touba, Thinking Orchestration Using Bounded Agency, lets you program agents with explicit responsibilities, access and approvals.
Describing what an agent should do guides its choices. Defining what it can do gives developers and organizations enforceable controls. Traces then explain actions and refusals. Why Touba?
This documentation is also optimized for coding assistants: explicit syntax, checked examples, and a clear distinction between complete programs and explanatory fragments.
The language source code will soon be available on GitHub under Apache 2.0, so you can study it, contribute and build on it. Explore the next steps.
Get started
| Your goal | Path |
|---|---|
| Install and try Touba | Installation, first program |
| Use VS Code | Touba Language Toolkit |
| Understand the architecture | Components, Agents as Code |
| Integrate an application | JavaScript SDK, Python SDK |
| Follow a business example | Tutorials |
| Create a reusable component | Package guide, complete tutorial |
Available Capabilities
Language and composition
- Types, enumerations, optional values and pure functions.
- Composable skills and strategies, conditions and iteration.
- Multi-agent composition and bounded parallelism.
Agents and human interaction
- Agentic decisions with structured and native interfaces.
showandaskinteractions.- Approvals with roles, deadlines, resumption and explicit escalation.
Governance and security
- Call authority, permissions, secrets and scopes.
- Execution budgets and provider costs.
- Platform-dependent sandbox confinement and policies in the hardened profile.
Memory and context
- Scoped memory and data provenance.
- Conversation history, RAM or SQLite persistence.
- Context management and compaction.
Integrations and execution
- JavaScript or Python handlers, MCP and REST/OpenAPI integrations.
- Packages installed locally, from archives or from an explicit registry.
touba serveproject server, triggers and resumption.
Traceability and audit
- Traces of decisions, calls, results and refusals.
- Audit and handler integrity locks.
- Business tests to check results and controls.
Find your way
Concepts explain the language model; guides address specific needs; tutorials build an example from start to finish. The reference covers syntax, commands and formats.
See versions, the roadmap and authors and citations as needed.
AI was used to improve the wording of this documentation. If you spot an error, please contact the authors.