babylon.engine.actions.investigate

INVESTIGATE verb resolver (verb-dispatch engine).

Intelligence gathering (ActionType.MAP_NETWORK). Investigate is the one canonical verb that mutates NO material graph state — it resolves against the information/fog-of-war layer. It returns a direct_effects payload naming which attributes of the target were revealed; the bridge/UI consumes it from the persisted result. No graph writes (the consciousness simplex is untouched).

Functions

resolve_investigate(action, org_attrs, ...)

Resolve a player INVESTIGATE action (information-layer only).
babylon.engine.actions.investigate.resolve_investigate(action, org_attrs, graph, services)[source]

Resolve a player INVESTIGATE action (information-layer only).

Parameters:

  • action (Action) – The INVESTIGATE action (action_type == ActionType.MAP_NETWORK).

  • org_attrs (dict[str, Any]) – Acting organization’s node attributes (unused).

  • graph (BabylonGraph) – World graph (read-only — no mutation).

  • services (ServicesProtocol) – ServicesProtocol (unused; no InvestigateDefines exist yet).

Return type:

ActionResult

Returns:

ActionResult with direct_effects naming revealed attributes; success=False if the target is absent.