preflight.action

The flagship advisory verb: ask ‘is this proposed action safe?’ before taking it. Returns an advisory verdict (allow/warn; block/require_approval only for opted-in classes) with cited memory/evidence provenance. A warn is normal data, not an error — the agent decides. Vectadyne never blocks inline. actor is optional: it defaults to your token’s principal and may only narrow (scope/clearance).

Input

Field	Type	Required
`action`	object	yes
`actor`	object
`options`	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	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
`include_resolution_trace`	boolean
`latency_budget_ms`	integer
`max_candidates`	integer

Output

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)

`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

`cited_memory.admission`

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

`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

`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

`cited_memory.score_breakdown`

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

`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

`reasons.decomposition`

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

`required_approvals`

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

`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

`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

`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