DICE API Documentation/com.embabel.dice.proposition/PropositionQuery

PropositionQuery

data class PropositionQuery(val contextId: <Error class: unknown class>? = null, val entityId: String? = null, val anyEntityIds: List<String>? = null, val allEntityIds: List<String>? = null, val statuses: Set<PropositionStatus>? = null, val minLevel: Int? = null, val maxLevel: Int? = null, val createdAfter: Instant? = null, val createdBefore: Instant? = null, val revisedAfter: Instant? = null, val revisedBefore: Instant? = null, val accessedAfter: Instant? = null, val accessedBefore: Instant? = null, val minConfidence: Double? = null, val minEffectiveConfidence: Double? = null, val effectiveConfidenceAsOf: Instant? = null, val decayK: Double = 2.0, val minImportance: Double? = null, val minReinforceCount: Int? = null, val minTrustScore: Double? = null, val pinned: Boolean? = null, val orderBy: PropositionQuery.OrderBy = OrderBy.NONE, val limit: Int? = null, val belowEffectiveConfidence: Double? = null)

Composable query specification for propositions.

Important: Always start with a scoped factory method to avoid accidentally querying all propositions. Use againstContext or forContextId as the entry point.

Kotlin usage (direct construction with defaults):

val query = PropositionQuery(
    contextId = sessionContext,
    entityId = "user-123",
    minLevel = 0,
    orderBy = OrderBy.EFFECTIVE_CONFIDENCE_DESC,
)

Java usage (builder pattern via withers):

PropositionQuery query = PropositionQuery.againstContext("session-123")
    .withEntityId("user-123")
    .withMinLevel(0)
    .withOrderBy(OrderBy.EFFECTIVE_CONFIDENCE_DESC);

Constructors

PropositionQuery

constructor(contextId: <Error class: unknown class>? = null, entityId: String? = null, anyEntityIds: List<String>? = null, allEntityIds: List<String>? = null, statuses: Set<PropositionStatus>? = null, minLevel: Int? = null, maxLevel: Int? = null, createdAfter: Instant? = null, createdBefore: Instant? = null, revisedAfter: Instant? = null, revisedBefore: Instant? = null, accessedAfter: Instant? = null, accessedBefore: Instant? = null, minConfidence: Double? = null, minEffectiveConfidence: Double? = null, effectiveConfidenceAsOf: Instant? = null, decayK: Double = 2.0, minImportance: Double? = null, minReinforceCount: Int? = null, minTrustScore: Double? = null, pinned: Boolean? = null, orderBy: PropositionQuery.OrderBy = OrderBy.NONE, limit: Int? = null, belowEffectiveConfidence: Double? = null)

Types

Companion

object Companion

OrderBy

enum OrderBy : Enum<PropositionQuery.OrderBy>

Ordering options for query results.

Properties

accessedAfter

val accessedAfter: Instant? = null

accessedBefore

val accessedBefore: Instant? = null

allEntityIds

val allEntityIds: List<String>? = null

anyEntityIds

val anyEntityIds: List<String>? = null

belowEffectiveConfidence

val belowEffectiveConfidence: Double? = null

contextId

val contextId: <Error class: unknown class>? = null

createdAfter

val createdAfter: Instant? = null

createdBefore

val createdBefore: Instant? = null

decayK

val decayK: Double = 2.0

effectiveConfidenceAsOf

val effectiveConfidenceAsOf: Instant? = null

entityId

val entityId: String? = null

limit

val limit: Int? = null

maxLevel

val maxLevel: Int? = null

minConfidence

val minConfidence: Double? = null

minEffectiveConfidence

val minEffectiveConfidence: Double? = null

minImportance

val minImportance: Double? = null

minLevel

val minLevel: Int? = null

minReinforceCount

val minReinforceCount: Int? = null

minTrustScore

val minTrustScore: Double? = null

orderBy

val orderBy: PropositionQuery.OrderBy

pinned

val pinned: Boolean? = null

revisedAfter

val revisedAfter: Instant? = null

revisedBefore

val revisedBefore: Instant? = null

statuses

val statuses: Set<PropositionStatus>? = null

Functions

accessedSince

fun accessedSince(duration: Duration): PropositionQuery

Filter to propositions accessed within the given duration from now.

createdSince

fun createdSince(duration: Duration): PropositionQuery

Filter to propositions created within the given duration from now.

getContextIdValue

fun getContextIdValue(): String?

Get the context ID value as a String (Java-friendly).

orderedByCreated

fun orderedByCreated(): PropositionQuery

orderedByEffectiveConfidence

fun orderedByEffectiveConfidence(): PropositionQuery

orderedByImportance

fun orderedByImportance(): PropositionQuery

orderedByLastAccessed

fun orderedByLastAccessed(): PropositionQuery

orderedByReinforceCount

fun orderedByReinforceCount(): PropositionQuery

orderedByRevised

fun orderedByRevised(): PropositionQuery

revisedSince

fun revisedSince(duration: Duration): PropositionQuery

Filter to propositions revised within the given duration from now.

withAccessedAfter

fun withAccessedAfter(accessedAfter: Instant): PropositionQuery

withAccessedBefore

fun withAccessedBefore(accessedBefore: Instant): PropositionQuery

withAccessedBetween

fun withAccessedBetween(start: Instant, end: Instant): PropositionQuery

withAllEntities

fun withAllEntities(vararg entityIds: String): PropositionQuery

withAllEntityIds

fun withAllEntityIds(entityIds: List<String>): PropositionQuery

withAnyEntity

fun withAnyEntity(vararg entityIds: String): PropositionQuery

withAnyEntityIds

fun withAnyEntityIds(entityIds: List<String>): PropositionQuery

withBelowEffectiveConfidence

fun withBelowEffectiveConfidence(threshold: Double): PropositionQuery

Keep only propositions whose effective confidence is strictly below threshold.

withContextId

fun withContextId(contextId: <Error class: unknown class>): PropositionQuery

withContextIdValue

fun withContextIdValue(contextIdValue: String): PropositionQuery

withCreatedAfter

fun withCreatedAfter(createdAfter: Instant): PropositionQuery

withCreatedBefore

fun withCreatedBefore(createdBefore: Instant): PropositionQuery

withCreatedBetween

fun withCreatedBetween(start: Instant, end: Instant): PropositionQuery

withDecayK

fun withDecayK(k: Double): PropositionQuery

withEffectiveConfidenceAsOf

fun withEffectiveConfidenceAsOf(asOf: Instant): PropositionQuery

withEntityId

fun withEntityId(entityId: String): PropositionQuery

withLimit

fun withLimit(limit: Int): PropositionQuery

withMaxLevel

fun withMaxLevel(maxLevel: Int): PropositionQuery

withMinConfidence

fun withMinConfidence(threshold: Double): PropositionQuery

Filter on raw (un-decayed) confidence — "was this ever reliable?". Use this for membership / eager-inclusion gates; use withMinEffectiveConfidence (or orderedByEffectiveConfidence) for ranking, so decay lowers a fact's position without evicting it.

withMinEffectiveConfidence