Glossary

Terms used when writing Digitorn app YAML.

Term	Definition
Action	A tool exposed by a module (for example bash.run, filesystem.write). Listed in capabilities as actions: [...].
Agent	An LLM-backed role with brain, system prompt, and tools. Declared under agents:.
App	One deployable unit: an app.yaml plus optional bundle files (prompts, skills, …). Identified by app.app_id.
Brain	Model config under agents[].brain (provider, model, backend, credentials, context).
Bundle	App directory with app.yaml and optional prompts/, skills/, behavior/, assets/.
Capability	Permission on tools: grant, deny, approve under tools.capabilities.
Channel	Background I/O declared under tools.channels (webhook, cron, rss, telegram, discord, whatsapp, …).
Compaction	Summarising or trimming old messages when context fills up (brain.context / compact_context hooks).
Context window	Token budget for a model call. Often set via agents[].brain.context.
Coordinator	Agent that delegates with the agent tool (role: coordinator).
Credential	Named secret referenced from YAML ({{secret.X}} or credential refs on the brain).
Discovery	Tool injection where the model uses search_tools / get_tool instead of seeing every schema up front.
FQN	Fully-qualified tool id: module.action (example filesystem.write).
Hook	Declarative callback under runtime.hooks (on + condition + action).
Middleware	Wrappers around module calls or the LLM turn (audit, retry, filters, …).
Module	Tool package you enable under tools.modules (filesystem, bash, mcp, …).
Provider	LLM backend hint on brain.provider (OpenAI, Anthropic, DeepSeek, Ollama, …).
Risk level	Per-action classification (low / medium / high) used with capabilities.
Session	One conversation: messages, tool history, memory for that chat.
Skill	Markdown workflow loaded on demand (dev.skills, slash commands, use_skill).
Trigger	Inbound wake-up (runtime.triggers and/or channels) for background-style apps.
Variable	Compile-time substitution: {{env.X}}, {{secret.X}}, {{prompt.X}}, {{skill.X}}, …
Workspace (UI)	ui.workspace: how the client shows files in a side pane.
Workspace (module)	Git revise / approve tools (baseline, diff, approve, …). Not file I/O.
Workdir	Directory the app uses for filesystem and bash (runtime.workdir / workdir_mode).