<!-- Glossary · Tin · https://tin.ad/docs/ref/glossary/ · generated from the built page -->

[Reference](https://tin.ad/docs/ref/)

-  [The language](https://tin.ad/docs/ref/language/)
-  [Agents and tools](https://tin.ad/docs/ref/agents/)
-  [Model providers](https://tin.ad/docs/ref/providers/)
-  [The Anthropic API](https://tin.ad/docs/ref/anthropic/)
-  [Talking agents](https://tin.ad/docs/ref/bidi/)
-  [Standard library](https://tin.ad/docs/ref/stdlib/)
-  [Glossary](https://tin.ad/docs/ref/glossary/)
- [agent](#agent)
- [capability](#capability)
- [grant](#grant)
- [guarded](#guarded)
- [mock model](#mock)
- [taint](#taint)
- [tape](#tape)
- [task](#task)
- [tool](#tool)
- [typed reply](#typed-reply)
-  [Package docs](https://tin.ad/docs/ref/api/)
-  [Telemetry](https://tin.ad/docs/ref/telemetry/)
-  [Robots](https://tin.ad/docs/ref/robot/)
-  [Servers](https://tin.ad/docs/ref/server/)
-  [Deploying](https://tin.ad/docs/ref/deploy/)
-  [tin.ad](https://tin.ad/docs/ref/cloud/)
-  [The tin command](https://tin.ad/docs/ref/cli/)
-  [How it works](https://tin.ad/docs/ref/internals/)

**Reference · Glossary

- [The language](https://tin.ad/docs/ref/language/)
- [Agents and tools](https://tin.ad/docs/ref/agents/)
- [Model providers](https://tin.ad/docs/ref/providers/)
- [The Anthropic API](https://tin.ad/docs/ref/anthropic/)
- [Talking agents](https://tin.ad/docs/ref/bidi/)
- [Standard library](https://tin.ad/docs/ref/stdlib/)
- [Glossary](https://tin.ad/docs/ref/glossary/)
- [Package docs](https://tin.ad/docs/ref/api/)
- [Telemetry](https://tin.ad/docs/ref/telemetry/)
- [Robots](https://tin.ad/docs/ref/robot/)
- [Servers](https://tin.ad/docs/ref/server/)
- [Deploying](https://tin.ad/docs/ref/deploy/)
- [tin.ad](https://tin.ad/docs/ref/cloud/)
- [The tin command](https://tin.ad/docs/ref/cli/)
- [How it works](https://tin.ad/docs/ref/internals/)

On this page

- [agent](#agent)
- [capability](#capability)
- [grant](#grant)
- [guarded](#guarded)
- [mock model](#mock)
- [taint](#taint)
- [tape](#tape)
- [task](#task)
- [tool](#tool)
- [typed reply](#typed-reply)

# Glossary

Tin’s own words, each in one sentence, with where to read more.

[agent](#agent) A declaration with a model, a prompt and tools; calling it runs the model loop and returns its reply. [Learn: your first agent](https://tin.ad/docs/learn/first-agent/)

[capability](#capability) Something a program can reach outside itself (network, files, a tool, a sub-agent); the compiler reports each agent’s before it runs. [Learn: capabilities](https://tin.ad/docs/learn/capabilities/)

[grant](#grant) What a server is allowed to do, written on its declaration (for example net.listen(8080)); anything it reaches beyond that is a compile error. [Servers: grants](https://tin.ad/docs/ref/server/#grants)

[guarded](#guarded) A guarded tool runs only after a person approves the call, and any path that skips the approval is a compile error. [Learn: guarded tools](https://tin.ad/docs/learn/approval/)

[mock model](#mock) A built-in model that answers offline and the same way every time, so examples and tests are repeatable. [Learn: your first agent](https://tin.ad/docs/learn/first-agent/#mock)

[taint](#taint) Text from a model or a request is tainted: it cannot reach outside code, a URL or a query until you parse it, encode it or approve it. [Servers: request taint](https://tin.ad/docs/ref/server/#taint)

[tape](#tape) A recording of a run (model replies, fetches, input, random numbers) that --replay plays back with no model and no network. [Learn: record and replay](https://tin.ad/docs/learn/replay/)

[task](#task) spawn starts a task that runs at the same time as the code that started it; await takes its result, within gives it a deadline. [Learn: spawn, await and within](https://tin.ad/docs/learn/concurrency/)

[tool](#tool) A function marked tool fn that a model may call; its JSON schema is generated from its signature and /// docs. [Learn: tools](https://tin.ad/docs/learn/tools/)

[typed reply](#typed-reply) Asking an agent for a type: the reply is decoded into a checked value of that type instead of text. [Learn: typed replies](https://tin.ad/docs/learn/typed-replies/)
