---
url: 'https://adk.nht.io/api/@nhtio/adk/batteries/interfaces/RetrievableAttrs.md'
description: Attribute bag rendered onto a retrievable block.
---

# Interface: RetrievableAttrs

Defined in: [src/batteries/llm/chat\_common/types.ts:183](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L183)

Attribute bag rendered onto a retrievable block.

## Properties

| Property                                     | Type     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Defined in                                                                                                                                    |
| -------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
|  `createdAt?` | `string` | ISO-8601 creation timestamp of the retrievable.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | [src/batteries/llm/chat\_common/types.ts:197](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L197) |
|  `kind?`           | `string` | Retrievable classifier.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | [src/batteries/llm/chat\_common/types.ts:199](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L199) |
|  `nonce`          | `string` | Nonce binding the block's open and close markers together — it becomes part of the tag NAME (`<..._<nonce>>`) so a model mirroring the block cannot forge a sibling's closer. FOOTGUN: this nonce MUST be unguessable AND non-path-shaped. It is typically the source record's id; a path-shaped id (e.g. `chunk-assembly-events-9`) is copied by small models as a CITATION (`/assembly/events-9`), which a doc-path validator then rejects → re-cite loop. Mint record ids with `crypto.randomUUID()`; carry page/human provenance in `source=` (rendered before `nonce=`), never in the id. | [src/batteries/llm/chat\_common/types.ts:193](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L193) |
|  `score?`         | `number` | Relevance score from the retrieval query.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | [src/batteries/llm/chat\_common/types.ts:201](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L201) |
|  `source?`       | `string` | Origin of the retrievable (e.g. the source document or system).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | [src/batteries/llm/chat\_common/types.ts:195](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L195) |