Wargame Query

Get all friendly (blue force) units. Use for "our forces" queries.

result = wargame_query_skill("friendly_units")
# Returns: list of friendly units with names, types, locations

Note: Friendly unit names typically start with "F-" (e.g., F-1, F-2)

3. hostile_units

Get all hostile (red force/enemy) units.

result = wargame_query_skill("hostile_units")
# Returns: list of enemy units with names, types, locations

Note: Hostile unit names typically start with "H-" (e.g., H-1, H-2)

4. unit_details

Get detailed information about a specific unit.

result = wargame_query_skill("unit_details", unit_name="Alpha Company")
# Returns: id, name, affiliation, unit_type, echelon, sidc, location, waypoints

5. unit_waypoints

Get movement waypoints (planned route) for a unit.

result = wargame_query_skill("unit_waypoints", unit_name="Bravo Platoon")
# Returns: unit_location, waypoints list, num_waypoints

6. units_by_type

Find all units of a specific type.

result = wargame_query_skill("units_by_type", unit_type="ARMOR")
# Returns: units with friendly_count, hostile_count breakdowns

Valid Unit Types

• INFANTRY, ARMOR, ARTILLERY, AIR_DEFENSE
• AVIATION, ENGINEER, RECONNAISSANCE, SIGNAL
• MEDICAL, SUPPLY, HEADQUARTERS, MECHANIZED
• MOTORIZED, AIRBORNE, SPECIAL_FORCES, NAVY
• CYBER, ELECTRONIC_WARFARE, UAV

Critical: Keep Results Separate

When comparing friendly and hostile forces, never mix up the results:

# Get both sides - KEEP SEPARATE!
friendly_result = wargame_query_skill("friendly_units")
hostile_result = wargame_query_skill("hostile_units")

# Process friendly units from friendly_result ONLY
friendly_units = friendly_result["result"]["units"]

# Process hostile units from hostile_result ONLY
hostile_units = hostile_result["result"]["units"]

# Report separately
print("FRIENDLY FORCES:")
for unit in friendly_units:
    print(f"  {unit['name']} at {unit['location']}")

print("HOSTILE FORCES:")
for unit in hostile_units:
    print(f"  {unit['name']} at {unit['location']}")

Integrating with Video Analysis

Correlate video findings with map positions:

# Step 1: Find tanks in video
video_tanks = videodb_query_skill("object_search", object_type="tank")

# Step 2: Get armor units on tactical map
map_armor = wargame_query_skill("units_by_type", unit_type="ARMOR")

# Step 3: Correlate and report

Error Handling

result = wargame_query_skill("tactical_situation")

if result["status"] == "error":
    # Map may not be initialized
    print("Tactical map not available")
    # Proceed with video-only analysis
elif result["status"] == "success":
    if result["result"]["total_units"] == 0:
        print("No units on tactical map")
    else:
        # Process tactical data

Best Practices

1. Check if tactical map is available before querying
2. Keep friendly and hostile results separate
3. Include unit movement info (waypoints) when relevant
4. Correlate map data with video analysis
5. Always specify which side (friendly/hostile) units belong to