---
url: 'https://adk.nht.io/api/@nhtio/adk/common/interfaces/RawRetrievable.md'
description: 'Plain input object supplied to [`Retrievable`](https://adk.nht.io/api/@nhtio/adk/common/classes/Retrievable) at construction time.'
---

# Interface: RawRetrievable

Defined in: [lib/classes/retrievable.ts:38](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L38)

Plain input object supplied to [Retrievable](../classes/Retrievable.md) at construction time.

## Remarks

Validated against `rawRetrievableSchema` before the `Retrievable` instance is created.
Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,
`Date` objects, or existing `DateTime` instances.

## Properties

| Property                                    | Type                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Defined in                                                                                                          |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ---------- | ----- | ---- | ------------------------------------------------------------------------------------------------------------------- |
|  `content`     | | `string` | [`Tokenizable`](../classes/Tokenizable.md) | [`SpooledArtifact`](../../spooled_artifact/classes/SpooledArtifact.md) | The retrieved content. A plain `string` or [@nhtio/adk!Tokenizable](../classes/Tokenizable.md) for small inline text, or a [@nhtio/adk!SpooledArtifact](../../spooled_artifact/classes/SpooledArtifact.md) when the extracted text is large and lives in a consumer @nhtio/adk!ByteStore (persist it via [@nhtio/adk!DispatchContext.storeRetrievableBytes](../../types/interfaces/DispatchContext.md#property-storeretrievablebytes), wrap the returned reader in a `SpooledArtifact`, and pass it here). Reader-backed content keeps the body out of the permanent heap, but token estimation and render still materialise it transiently (see [Retrievable.estimateTokens](../classes/Retrievable.md#estimatetokens)). | [lib/classes/retrievable.ts:52](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L52) |
|  `createdAt` | `string` | `number` | `Date` | `DateTime`<`boolean`>                                                                           | When the source record was created (publication date, upload date, etc.).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [lib/classes/retrievable.ts:65](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L65) |
|  `id`               | `string`                                                                                                                            | Stable unique identifier for this retrieved record. Used as the closing-tag nonce in the rendered envelope, so it must be unguessable from the payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [lib/classes/retrievable.ts:43](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L43) |
|  `kind?`          | `string`                                                                                                                            | Optional semantic label: 'policy'                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 'reference'                                                                                                         | 'web-page' | 'pdf' | etc. | [lib/classes/retrievable.ts:61](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L61) |
|  `score?`        | `number`                                                                                                                            | Optional relevance / similarity score in `[0, 1]` from the retrieval middleware.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | [lib/classes/retrievable.ts:63](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L63) |
|  `source?`      | `string`                                                                                                                            | Optional provenance string: URL, document path, knowledge-base id, etc.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [lib/classes/retrievable.ts:59](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L59) |
|  `trustTier` | [`RetrievableTrustTier`](../type-aliases/RetrievableTrustTier.md)                                                                   | Trust tier declared by the retrieval middleware at construction time. Required — there is NO default. The decision must be conscious. See [RetrievableTrustTier](../type-aliases/RetrievableTrustTier.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | [lib/classes/retrievable.ts:57](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L57) |
|  `updatedAt` | `string` | `number` | `Date` | `DateTime`<`boolean`>                                                                           | When the source record was last modified.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [lib/classes/retrievable.ts:67](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/classes/retrievable.ts#L67) |