DICE API Documentation/com.embabel.dice.ingestion/IngestedArtifact

IngestedArtifact

data class IngestedArtifact constructor(val sourceId: String, val locator: SourceLocator, val text: String, val contentHash: String? = null, val trust: AuthorityTier = AuthorityTier.UNKNOWN, val createdAt: Instant? = null, val ingestedAt: Instant? = null)

A normalized unit of source material handed to DICE at the front door.

Adapters parse their native formats (documents, web pages, connector payloads) into already-extracted text before constructing an artifact — core never parses. The artifact carries the source identity, a SourceLocator for provenance, an optional caller-supplied contentHash used as the deduplication key, trust metadata, and optional timestamps.

The locator and trust fields are caller-asserted claims about the source, not proofs DICE can independently verify; downstream authority resolution derives tiers structurally from the locator kind.

Constructors

IngestedArtifact

constructor(sourceId: String, locator: SourceLocator, text: String, contentHash: String? = null, trust: AuthorityTier = AuthorityTier.UNKNOWN, createdAt: Instant? = null, ingestedAt: Instant? = null)

Types

object Companion

class WithLocator

Builder step: has source id and locator, needs text; yields a complete artifact.

class WithSourceId

Builder step: has source id, needs a locator.

Properties

val contentHash: String? = null

Optional caller-supplied deduplication key. When present it is authoritative for dedup; when absent the consuming handler computes one.

val createdAt: Instant? = null

Optional timestamp for when the source material was created.

val ingestedAt: Instant? = null

Optional timestamp for when the material was ingested.

val locator: SourceLocator

Provenance reference describing where the material lives.

val sourceId: String

Stable source key used as the chunk parent identity and the per-artifact deduplication record key. Must not be blank.

val text: String

Already-extracted text content. Must not be blank.

val trust: AuthorityTier

Caller-asserted authority of the source; defaults to AuthorityTier.UNKNOWN, the fail-safe lowest authority.

Functions

withContentHash

fun withContentHash(contentHash: String): IngestedArtifact

Returns a copy with the deduplication content hash set.

fun withTimestamps(createdAt: Instant? = null, ingestedAt: Instant? = null): IngestedArtifact

Returns a copy with the created and ingested timestamps set.

fun withTrust(trust: AuthorityTier): IngestedArtifact

Returns a copy with the trust tier set.