feat(lua): add AI context action-menu macros

Assisted-by: openai/gpt-5.3-codex on opencode
Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

Author: scarf005

data/lua/lib/action_menu_macros.lua

@@ -38,6 +38,65 @@ local function announce_current_turn()
   gapi.add_msg(string.format(locale.gettext("Current turn: %d"), turn_value))
 end
 
+local function report_agent_context()
+  local avatar = gapi.get_avatar()
+  local map = gapi.get_map()
+  local pos = avatar:get_pos_ms()
+  local turn_value = gapi.current_turn():to_turn()
+  local details = string.format(
+    "[AI] turn=%d local_ms=(%d,%d,%d) outside=%s sheltered=%s",
+    turn_value,
+    pos.x,
+    pos.y,
+    pos.z,
+    tostring(map:is_outside(pos)),
+    tostring(map:is_sheltered(pos))
+  )
+  gapi.add_msg(details)
+end
+
+local function report_look_target()
+  local target = gapi.look_around()
+  if not target then
+    gapi.add_msg(locale.gettext("Look canceled."))
+    return
+  end
+
+  local target_abs = gapi.get_map():get_abs_ms(target)
+  gapi.add_msg(
+    string.format(
+      "[AI] look local_ms=(%d,%d,%d) abs_ms=(%d,%d,%d)",
+      target.x,
+      target.y,
+      target.z,
+      target_abs.x,
+      target_abs.y,
+      target_abs.z
+    )
+  )
+end
+
+local function report_adjacent_choice()
+  local target = gapi.choose_adjacent(locale.gettext("Choose adjacent tile for AI context"), true)
+  if not target then
+    gapi.add_msg(locale.gettext("Adjacent selection canceled."))
+    return
+  end
+
+  local target_abs = gapi.get_map():get_abs_ms(target)
+  gapi.add_msg(
+    string.format(
+      "[AI] adjacent local_ms=(%d,%d,%d) abs_ms=(%d,%d,%d)",
+      target.x,
+      target.y,
+      target.z,
+      target_abs.x,
+      target_abs.y,
+      target_abs.z
+    )
+  )
+end
+
 action_menu_macros.register_defaults = function()
   gapi.register_action_menu_entry({
     id = "bn_macro_recent_messages",
@@ -62,6 +121,30 @@ action_menu_macros.register_defaults = function()
     category = "info",
     fn = announce_current_turn,
   })
+
+  gapi.register_action_menu_entry({
+    id = "bn_macro_agent_context",
+    name = locale.gettext("AI Context Packet"),
+    description = locale.gettext("Print turn, local coordinates, and shelter/outside state."),
+    category = "info",
+    fn = report_agent_context,
+  })
+
+  gapi.register_action_menu_entry({
+    id = "bn_macro_look_target",
+    name = locale.gettext("AI Look Target"),
+    description = locale.gettext("Pick a tile via look-around and print local/absolute coordinates."),
+    category = "info",
+    fn = report_look_target,
+  })
+
+  gapi.register_action_menu_entry({
+    id = "bn_macro_adjacent_target",
+    name = locale.gettext("AI Adjacent Target"),
+    description = locale.gettext("Pick an adjacent tile and print local/absolute coordinates."),
+    category = "info",
+    fn = report_adjacent_choice,
+  })
 end
 
 return action_menu_macros