context.assemble

The one-call governed context for a proposed action (ADR 0036 §6): returns the preflight verdict + retrieved memory + resolved guides + a ready-to-inject prompt_block + server-estimated token counts, collapsing preflight.action -> memory.search -> guide.resolve into a single round-trip. Prefer this over the three granular verbs when you are about to act: the governance verdict comes attached to the context, and prompt_block is safe to inject verbatim (untrusted memory is sanitized; mandatory obligations always render). Only action is required — actor/scope/filters default from your token.

Input

Field	Type	Required
action	object	yes
actor	object (nullable)
options	object
search	object

action

Field	Type	Required	Description
action_type	ActionType	yes	from the closed high-risk action taxonomy (schemas.md §1)
changed_files	array of string (nullable)
diff_ref	string
env	string		level:id, e.g. repo:payments-service
purpose	Purpose	yes
repo	string		level:id, e.g. repo:payments-service
resources	array of string (nullable)
risk_class	RiskClass
summary	string
tool	string		level:id, e.g. repo:payments-service

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

options

Field	Type	Required	Description
include_resolution_trace	boolean
latency_budget_ms	integer		AGGREGATE budget for the whole call (default 800); exhaustion degrades, never errors
max_candidates	integer
response_format	ResponseFormat		prompt_block verbosity only; the structured sub-results are always complete

search

Field	Type	Required	Description
filters	object
top_k	integer		recall depth for the retrieved_memory segment (default 8) (range 1–50)

search.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		must equal or be narrower than the action’s effective scope
sensitivity_max	Sensitivity
statuses	array of Status (nullable)
subtypes	array of string (nullable)

Output

Field	Type	Required
degraded	boolean	yes
degraded_components	array of string (nullable)	yes
guides	object (nullable)	yes
memory	object (nullable)	yes
prompt_block	string	yes
request_id	string
segments	array (nullable)	yes
verdict	object (nullable)	yes

guides

Field	Type	Required
guides	array (nullable)	yes
request_id	string

guides.guides

Field	Type	Required	Description
binding	boolean	yes
checksum	string
guide_id	string	yes
prohibitions	array of string (nullable)
purpose	Purpose	yes
rendered_markdown_ref	string
required_checks	array of string (nullable)
scope_key	string	yes	level:id, e.g. repo:payments-service
title	string	yes
version	integer	yes

memory

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

memory.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

memory.hits.admission

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

memory.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

memory.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

memory.hits.score_breakdown

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

segments

Field	Type	Required
label	SegmentLabel	yes
tokens	integer	yes

verdict

Field	Type	Required
admitted_scopes	array of string (nullable)	yes
cited_memory	array (nullable)	yes
confidence	number	yes
decision	Decision	yes
decision_id	string	yes
degraded	boolean	yes
expires_at	string (date-time)	yes
forbidden_actions	array of string (nullable)	yes
latency_ms	integer	yes
reasons	array (nullable)	yes
request_id	string
required_approvals	array (nullable)	yes
required_checks	array of string (nullable)	yes
required_guides	array (nullable)	yes
resolution_trace	object (nullable)

verdict.cited_memory

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

verdict.cited_memory.admission

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

verdict.cited_memory.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

verdict.cited_memory.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

verdict.cited_memory.score_breakdown

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

verdict.reasons

Field	Type	Required
code	ReasonCode	yes
decomposition	object	yes
evidence_ids	array of string (nullable)
memory_ids	array of string (nullable)
message	string	yes
score	number	yes
severity	ReasonSeverity	yes

verdict.reasons.decomposition

Field	Type	Required
blast_radius	number	yes
contradiction	number	yes
novelty	number	yes

verdict.required_approvals

Field	Type	Required
approver_scope	string	yes
policy_rule_id	string	yes
reason	string	yes

verdict.required_guides

Field	Type	Required	Description
binding	boolean	yes
checksum	string
guide_id	string	yes
prohibitions	array of string (nullable)
purpose	Purpose	yes
rendered_markdown_ref	string
required_checks	array of string (nullable)
scope_key	string	yes	level:id, e.g. repo:payments-service
title	string	yes
version	integer	yes

verdict.resolution_trace

Field	Type	Required
fusion	string	yes
skipped_stages	array of string (nullable)	yes
stages_run	array of string (nullable)	yes
walk	array (nullable)	yes

verdict.resolution_trace.walk

Field	Type	Required	Description
guides	array of string (nullable)	yes
policies	array of string (nullable)	yes
scope_key	string	yes	level:id, e.g. repo:payments-service