memory.search

Search the governed memory graph for scoped, ranked, provenance-bearing knowledge relevant to the current task (‘what should I know here?’). Read-time admission (tenant/scope/clearance) is applied; results carry score_breakdown and 1-hop edges. Supports as_of bi-temporal time-travel.

Input

Field	Type	Required
actor	object (nullable)
filters	object
include	object
query	string
ranking	object

actor

Field	Type	Required	Description
actor_id	string
actor_type	ActorType
clearance	array of Sensitivity (nullable)
role	string
scope_key	string		level:id, e.g. repo:payments-service

filters

Field	Type	Required	Description
as_of	string (nullable) (date-time)		bi-temporal time-travel: recall memory as it was valid/asserted at this instant
kinds	array of Kind (nullable)
scope_prefix	string		narrowing-only: bounds the visible set to this scope
sensitivity_max	Sensitivity
statuses	array of Status (nullable)
subtypes	array of string (nullable)

include

Field	Type	Required
edges	boolean
evidence	boolean

ranking

Field	Type	Required	Description
graph_expand_hops	integer — one of 0, 1
mode	RankingMode
top_k	integer		how many hits to return

At least one of these. query (non-empty) or filters (at least 1 field).

Output

Field	Type	Required
as_of	string (nullable) (date-time)
degraded	boolean	yes
hits	array (nullable)	yes
latency_ms	integer	yes
request_id	string
returned	integer	yes
skipped_stages	array of string (nullable)	yes
stage_latencies_ms	object
stages_run	array of string (nullable)	yes
total_candidates	integer	yes

hits

Field	Type	Required	Description
admission	object (nullable)
asserted_at	string (date-time)	yes
canonical_text	string	yes
confidence	number	yes
edges	array (nullable)
evidence	array (nullable)
kind	Kind	yes
memory_id	string	yes
provenance	object
scope_key	string	yes	level:id, e.g. repo:payments-service
score	number
score_breakdown	object (nullable)
sensitivity	Sensitivity	yes
status	Status	yes
subtype	string
title	string	yes
valid_from	string (nullable) (date-time)
valid_to	string (nullable) (date-time)
version	integer

hits.admission

Field	Type	Required
admitted	boolean	yes
checks	array of string (nullable)	yes

hits.edges

Field	Type	Required
dst_memory_id	string	yes
edge_type	EdgeType	yes
src_memory_id	string
valid_to	string (nullable) (date-time)
weight	number	yes

hits.evidence

Field	Type	Required	Description
action_type	ActionType		from the closed high-risk action taxonomy (schemas.md §1)
actor_id	string	yes
actor_type	ActorType	yes
artifact_refs	array of string (nullable)
download_url	string
entity_mentions	array of string (nullable)
event_hash	string	yes
event_ts	string (date-time)	yes
id	string	yes
labels	array of string (nullable)
metadata	object
payload_ref	string
prev_hash	string
risk_class	RiskClass
scope_key	string	yes	level:id, e.g. repo:payments-service
sensitivity	Sensitivity	yes
source_ref	string	yes
source_type	SourceType	yes
summary	string	yes
tenant_id	string	yes
workspace_id	string	yes	optional; defaults to your token’s workspace

hits.score_breakdown

Field	Type	Required
dense	number	yes
graph_proximity	number	yes
lexical	number	yes
rrf	number	yes