libghostty: add API for getting commands

src/apprt/embedded.zig

@@ -1487,6 +1487,23 @@ pub const CAPI = struct {
         return @intCast(@as(input.Mods.Backing, @bitCast(result)));
     }
 
+    /// Returns the current possible commands for a surface
+    /// in the output parameter. The memory is owned by libghostty
+    /// and doesn't need to be freed.
+    export fn ghostty_surface_commands(
+        surface: *Surface,
+        out: *[*]const input.Command.C,
+        len: *usize,
+    ) void {
+        // In the future we may use this information to filter
+        // some commands.
+        _ = surface;
+
+        const commands = input.command.defaultsC;
+        out.* = commands.ptr;
+        len.* = commands.len;
+    }
+
     /// Send this for raw keypresses (i.e. the keyDown event on macOS).
     /// This will handle the keymap translation and send the appropriate
     /// key and char events.