Interface: RawRetrievable
Defined in: lib/classes/retrievable.ts:38
Plain input object supplied to Retrievable 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 | SpooledArtifact | The retrieved content. A plain string or @nhtio/adk!Tokenizable for small inline text, or a @nhtio/adk!SpooledArtifact when the extracted text is large and lives in a consumer @nhtio/adk!ByteStore (persist it via @nhtio/adk!DispatchContext.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). | lib/classes/retrievable.ts:52 | | createdAt | string | number | Date | DateTime<boolean> | When the source record was created (publication date, upload date, etc.). | lib/classes/retrievable.ts:65 | | 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 | | kind? | string | Optional semantic label: 'policy' | 'reference' | 'web-page' | 'pdf' | etc. | lib/classes/retrievable.ts:61 | | score? | number | Optional relevance / similarity score in [0, 1] from the retrieval middleware. | lib/classes/retrievable.ts:63 | | source? | string | Optional provenance string: URL, document path, knowledge-base id, etc. | lib/classes/retrievable.ts:59 | | trustTier | RetrievableTrustTier | Trust tier declared by the retrieval middleware at construction time. Required — there is NO default. The decision must be conscious. See RetrievableTrustTier. | lib/classes/retrievable.ts:57 | | updatedAt | string | number | Date | DateTime<boolean> | When the source record was last modified. | lib/classes/retrievable.ts:67 |