feat(lua): expose action-menu macros for CLI automation

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/json/main.lua

@@ -2,6 +2,7 @@ local voltmeter = require("./voltmeter")
 local slimepit = require("./slimepit")
 local artifact_analyzer = require("./artifact_analyzer")
 local lua_traits = require("./lua_traits")
+local action_menu_macros = require("lib.action_menu_macros")
 
 local mod = game.mod_runtime[game.current_mod]
 local storage = game.mod_storage[game.current_mod]
@@ -11,3 +12,4 @@ mod.slimepit = slimepit
 mod.artifact_analyzer = artifact_analyzer
 mod.lua_traits = lua_traits
 lua_traits.register(mod)
+action_menu_macros.register_defaults()

data/lua/lib/action_menu_macros.lua

@@ -0,0 +1,67 @@
+local ui = require("lib.ui")
+
+local action_menu_macros = {}
+
+local function popup_recent_messages()
+  local entries = gapi.get_messages(12)
+  if #entries == 0 then
+    ui.popup(locale.gettext("No recent messages."))
+    return
+  end
+
+  local lines = { locale.gettext("Recent Messages"), "" }
+  for _, entry in ipairs(entries) do
+    table.insert(lines, string.format("[%s] %s", entry.time, entry.text))
+  end
+
+  ui.popup(table.concat(lines, "\n"))
+end
+
+local function popup_recent_lua_log()
+  local entries = gapi.get_lua_log(20)
+  if #entries == 0 then
+    ui.popup(locale.gettext("No recent Lua log entries."))
+    return
+  end
+
+  local lines = { locale.gettext("Recent Lua Log"), "" }
+  for _, entry in ipairs(entries) do
+    local source_prefix = entry.from_user and "> " or ""
+    table.insert(lines, string.format("[%s] %s%s", entry.level, source_prefix, entry.text))
+  end
+
+  ui.popup(table.concat(lines, "\n"))
+end
+
+local function announce_current_turn()
+  local turn_value = gapi.current_turn():to_turn()
+  gapi.add_msg(string.format(locale.gettext("Current turn: %d"), turn_value))
+end
+
+action_menu_macros.register_defaults = function()
+  gapi.register_action_menu_entry({
+    id = "bn_macro_recent_messages",
+    name = locale.gettext("Recent Messages"),
+    description = locale.gettext("Show the latest in-game messages in a popup."),
+    category = "info",
+    fn = popup_recent_messages,
+  })
+
+  gapi.register_action_menu_entry({
+    id = "bn_macro_recent_lua_log",
+    name = locale.gettext("Recent Lua Log"),
+    description = locale.gettext("Show the latest Lua console log entries in a popup."),
+    category = "info",
+    fn = popup_recent_lua_log,
+  })
+
+  gapi.register_action_menu_entry({
+    id = "bn_macro_current_turn",
+    name = locale.gettext("Current Turn"),
+    description = locale.gettext("Print the current absolute turn in the message log."),
+    category = "info",
+    fn = announce_current_turn,
+  })
+end
+
+return action_menu_macros

scripts/curses-cli/common.ts

@@ -392,14 +392,21 @@ export const listAvailableInputs = (
   return detectPromptInputs(pane)
 }
 
-export const buildLaunchCommand = (
-  binPath: string,
-  userdir: string,
-  world: string,
-  seed = "",
-  availableKeysJson = "",
-  aiHelperOutput = "",
-): string => {
+type BuildLaunchCommandOptions = {
+  binPath: string
+  userdir: string
+  world: string
+  seed?: string
+  availableKeysJson?: string
+  availableMacrosJson?: string
+  aiHelperOutput?: string
+}
+
+export const buildLaunchCommand = (options: BuildLaunchCommandOptions): string => {
+  const seed = options.seed ?? ""
+  const availableKeysJson = options.availableKeysJson ?? ""
+  const availableMacrosJson = options.availableMacrosJson ?? ""
+  const aiHelperOutput = options.aiHelperOutput ?? ""
   const parts = [
     "TERM=xterm-256color",
     "COLORTERM=truecolor",
@@ -408,16 +415,19 @@ export const buildLaunchCommand = (
     ...(availableKeysJson.length > 0
       ? [`CATA_AVAILABLE_KEYS_JSON=${shellEscape(availableKeysJson)}`]
       : []),
+    ...(availableMacrosJson.length > 0
+      ? [`CATA_AVAILABLE_MACROS_JSON=${shellEscape(availableMacrosJson)}`]
+      : []),
     ...(aiHelperOutput.length > 0 ? [`AI_HELPER_OUTPUT=${shellEscape(aiHelperOutput)}`] : []),
-    shellEscape(binPath),
+    shellEscape(options.binPath),
     "--basepath",
     shellEscape(REPO_ROOT),
     "--userdir",
-    shellEscape(userdir),
+    shellEscape(options.userdir),
   ]
 
-  if (world.length > 0) {
-    parts.push("--world", shellEscape(world))
+  if (options.world.length > 0) {
+    parts.push("--world", shellEscape(options.world))
   }
 
   if (seed.length > 0) {
@@ -435,23 +445,25 @@ export const writeCodeBlockCapture = async (
   await Deno.writeTextFile(outputPath, body)
 }
 
-export const writeIndex = async (
-  outputPath: string,
-  sessionName: string,
-  captures: CaptureEntry[],
-  status: RunStatus,
-  castFile?: string,
-  failureMessage?: string,
-): Promise<void> => {
+type WriteIndexOptions = {
+  outputPath: string
+  sessionName: string
+  captures: CaptureEntry[]
+  status: RunStatus
+  castFile?: string
+  failureMessage?: string
+}
+
+export const writeIndex = async (options: WriteIndexOptions): Promise<void> => {
   const lines = [
     "# PR Verify Artifact",
     "",
-    `Session: ${sessionName}`,
-    `Status: ${status}`,
+    `Session: ${options.sessionName}`,
+    `Status: ${options.status}`,
     "",
     "## Captures",
     "",
-    ...captures.map((capture, index) => {
+    ...options.captures.map((capture, index) => {
       const title = capture.caption.length > 0 ? capture.caption : capture.id
       const screenshotSuffix = capture.screenshot_file
         ? `, screenshot: \`${capture.screenshot_file}\``
@@ -463,19 +475,19 @@ export const writeIndex = async (
     "",
   ]
 
-  if (castFile !== undefined) {
-    lines.push(`Cast recording: \`${castFile}\``)
+  if (options.castFile !== undefined) {
+    lines.push(`Cast recording: \`${options.castFile}\``)
     lines.push("")
   }
 
-  if (failureMessage !== undefined) {
+  if (options.failureMessage !== undefined) {
     lines.push("## Failure")
     lines.push("")
     lines.push("```text")
-    lines.push(failureMessage)
+    lines.push(options.failureMessage)
     lines.push("```")
     lines.push("")
   }
 
-  await Deno.writeTextFile(outputPath, lines.join("\n"))
+  await Deno.writeTextFile(options.outputPath, lines.join("\n"))
 }