Class DataQueryEntries

java.lang.Object

ai.badmonkey.agentspaces.connect.DataQueryEntries

public final class DataQueryEntries
extends Object

The aspace:cap/data-query entry types (spec §6.1a): agents write DataQueryEntries.DataQuery entries, connectors take them and complete with DataQueryEntries.DataResult entries, and the space gives both sides retries, observability, and decoupling for free. The canonical query hash is the key to the economics (ENTERPRISE §3): identical queries share one hash, so one result under its freshness lease serves every asker in the window, and the source system sees one execution instead of one per agent per poll.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	DataQueryEntries.AssetChange	One change a materializing provider pushed (spec §6.1a), leased for the asset's freshness window so the lease is the retention policy.
static final record	DataQueryEntries.DataQuery	One query awaiting a connector.
static final record	DataQueryEntries.DataResult	One answered query, leased for its freshness window.

Method Summary

Modifier and Type	Method	Description
static String	canonicalHash(String asset, Map<String,String> parameters)	The canonical query hash: multibase(sha-256) over the asset name and the parameters in sorted key order, so parameter ordering never splits the cache.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

canonicalHash

public static String canonicalHash(String asset,
 Map<String,String> parameters)

The canonical query hash: multibase(sha-256) over the asset name and the parameters in sorted key order, so parameter ordering never splits the cache.

Parameters:

asset - the asset name

parameters - the query parameters

Returns:

the canonical hash