Add observer_agent_id parameter to obs_features for agent-specific observations

[daveey]

TL;DR

Added an observer_agent_id parameter to the obs_features() method to support agent-specific observations.

What changed?

• Modified the GridObject::obs_features() virtual method to accept an optional observer_agent_id parameter (defaulting to UINT_MAX to indicate no specific observer)
• Added documentation explaining that this parameter is used by Assembler to report agent-specific cooldowns
• Updated all derived class implementations of obs_features() to include the new parameter
• Added (void)observer_agent_id to implementations that don't use the parameter to prevent unused variable warnings
• Included <climits> header to support the UINT_MAX constant

How to test?

• Verify that all existing code using obs_features() continues to work without changes
• Create a test case where an Assembler reports different cooldown values to different agents
• Ensure that agent-specific observations are correctly generated when the parameter is used

Why make this change?

This change enables objects to provide different observation features depending on which agent is observing them. This is particularly useful for Assemblers that need to report agent-specific cooldown information, allowing for more personalized and accurate observations in the grid environment.

[daveey]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat: add station sprites to mettascope #4603 : 2 dependent PRs (#4590 , #4604 )
• feat: add gear stations that clear inventory and provide specific gear #4589
• feat: add activation handler system for object interactions #4588
• Add window state persistence and AOE visualization to MettaScope #4566
• feat: add AOE overlays and make Assembler implement Alignable interface #4587
• Add align action and update related action handlers #4565
• Add observer_agent_id parameter to obs_features for agent-specific observations #4539 👈 (View in Graphite)
• Add Area of Effect (AOE) resource effects to grid objects #4538
• Add CommonsChest for shared inventory access across agents #4537
• Add Commons system for shared inventories between grid objects #4536
• Rename cog_arena.py to cogsguard.py and remove unused imports #4477
• feat: enforce inventory limits in cpp #4602
• Enhance attack system with armor, weapons, and configurable loot #4313 : 1 other dependent PR (#4321 )
• Make Transfer action optional and add vibe-triggered attack #4315
• Implement bidirectional resource transfer system with vibe-based triggers #4314
• feat: support metta://policy/<short_name_or_class_path> URIs for built-in policies #4561
• feat: allow negative inventory_regen_amounts for decay #4564
• Add clarification about when to run install commands #4563
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[openhands-ai]

Looks like there are a few issues preventing this PR from being merged!

• GitHub Actions are failing:
  • Test and Benchmark

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #4539 at branch `daveey-observer-obs`

Feel free to include any additional details that might help me get this PR into a better state.

_{^{You can manage your notification settings}}