Token Reduction Benchmark - Unity 6000.5.0f1

One-line summary: on Unity 6000.5.0f1, the v0.0.43 low-token discovery behavior holds: list --compact is 93 estimated tokens and find_gameobjects --ids is 55 estimated tokens in the smoke scene.

• Measured on: 2026-06-22
• CLI: hera-agent-unity v0.0.29
• Connector under test: AgentConnector/package.json 0.0.43 as a local UPM package
• Unity: 6000.5.0f1
• Project: %UNITY_PROJECT% (Test6000.5.0f1 fixture)
• Scene: Assets/HeraSmoke/Scenes/Smoke_6000_5.unity
• Token estimate: UTF-8 output bytes divided by 4, rounded up

This benchmark measures the CLI output payload that comes back into an agent context. It does not include the outer tool-call framing overhead of a specific AI client.

---

0. TL;DR

Command / scenario	Bytes	Est. tokens	Result
list --names	371	93 T	flat names array
list --compact	371	93 T	same as --names
default list	7426	1857 T	descriptions included; not for bootstrap
find_gameobjects --name Pickup --limit 20 --ids	217	55 T	lowest-token object handoff
find_gameobjects --name Pickup --limit 20	1145	287 T	default {instance_id,name}
find_gameobjects --name Pickup --limit 20 --fields all	3185	797 T	legacy verbose shape

The measured find_gameobjects values are slightly larger than earlier versions because this smoke scene used longer object names such as PickupCrate_Instance_00.

---

1. Bootstrap and Package State

Initial bootstrap:

Connected: Test6000.5.0f1 · port=8090 · unity=6000.5.0f1 · state=ready · tools=26

The project initially did not resolve com.notnull92.hera-agent-unity:

{"version":null,"source":null,"resolved":null}

For a same-code benchmark, it was switched to the local connector under test:

hera-agent-unity manage_packages add "file:%HERA_REPO%/AgentConnector"

After switching:

{"version":"0.0.43","source":"Local","resolved":"C:\\Users\\PC\\Desktop\\Cowork\\hera-agent-unity\\AgentConnector"}

Compile and connector state:

• editor refresh --compile --wait: success
• console --type error --lines 50: matched: 0
• Unity state: ready

---

2. Smoke Scene

The smoke scene was created in the disposable test project under:

Assets/HeraSmoke/

The scene mirrors the previous benchmark workflow:

• HeraSmoke_Level_6000_5 hierarchy;
• Geometry, Gameplay, Pickups, and Enemies groups;
• floor, 12 wall blocks, trigger volume, six enemy capsules with kinematic Rigidbody;
• 32 pickup spheres with trigger colliders;
• camera and directional light;
• Assets/HeraSmoke/Prefabs/PickupCrate.prefab;
• 15 prefab instances during scene setup, plus 15 more during the prefab smoke step;
• overlay HUD canvas with three interactive buttons.

Scene creation output:

Step	Exit	Bytes	Est. tokens
create 6000.5 smoke scene	0	65	17

Hierarchy and renderer verification:

{"scene":"Assets/HeraSmoke/Scenes/Smoke_6000_5.unity","roots":5}

{"renderers":67,"colliders":67}

---

3. Token Measurements

Baseline

Case	Bytes	Est. tokens
status	117	30
scene info	236	59
list --names	371	93
list --compact	371	93
list	7426	1857
list --tool exec	1783	446
package probe	116	29

GameObject Search

Case	Bytes	Est. tokens
find_gameobjects --name Pickup --limit 5	355	89
find_gameobjects --name Pickup --limit 20	1145	287
find_gameobjects --name Pickup --limit 50	2462	616
find_gameobjects --name Pickup --limit 20 --ids	217	55
find_gameobjects --name Pickup --limit 20 --names	545	137
find_gameobjects --name Pickup --limit 20 --fields instance_id,name,path	2445	612
find_gameobjects --name Pickup --limit 20 --fields all	3185	797

Interpretation:

• --ids remains the best follow-up path when the next command accepts instance_id.
• Default find_gameobjects stays much cheaper than the verbose --fields all shape.
• Path/scene/active costs are still explicit and opt-in.

Components

Case	Bytes	Est. tokens
manage_components add Rigidbody on floor	130	33
manage_components set Rigidbody m_Mass	133	34
manage_components get Rigidbody m_Mass	133	34
manage_components list enemy components	533	134

Prefab

Case	Bytes	Est. tokens
instantiate 15 prefab instances via exec	3	1
find_gameobjects --name PickupCrate_BenchInstance --limit 20	993	249

UI and Capture

Case	Bytes	Est. tokens
find_gameobjects --name HUD_ --fields instance_id,name,path	595	149
ui_doc export --path /HeraSmoke_Level_6000_5/HUD_Canvas	1313	329
ui_doc capture --out %TEMP%/hera-smoke-6000-5-hud.png	128	32
screenshot --view scene --output_path %TEMP%/hera-smoke-6000-5-scene.png	103	26

Visual observation:

• ui_doc capture rendered the overlay HUD and visible scene geometry.
• screenshot --view scene rendered the game objects correctly in this disposable Unity 6000.5 project.
• The background-only scene capture issue observed in the Unity 6000.3 Inventoria run did not reproduce here.

PlayMode

Case	Bytes	Est. tokens
console --type error before PlayMode	105	27
editor play --wait	31	8
runtime probe	60	15
console --type error --lines 5	105	27
console --lines 20	380	95
console --type error --stacktrace full	105	27
editor stop	18	5
final console --type error --lines 50	105	27

Runtime probe:

{"playing":true,"frame":313,"time":1.02270174,"pickups":32}

---

4. Verification

Observed:

• Unity 6000.5.0f1 returned to ready.
• com.notnull92.hera-agent-unity resolved as local connector 0.0.43.
• list --names found 26 tools.
• Final console error query returned matched: 0.
• PlayMode entered, runtime probe succeeded, and PlayMode exited.
• ui_doc capture and screenshot --view scene both produced nonblank images.

Note:

• The active project was Test6000.5.0f1, a disposable blank test project.
• The benchmark created assets under Assets/HeraSmoke/ and switched the project dependency to the local connector for measurement.

---

5. Conclusion

On Unity 6000.5.0f1, the v0.0.43 token-reduction behavior remains stable:

• list --compact is 93 estimated tokens and is safe for bootstrap discovery.
• default list is still about 1857 estimated tokens and should be reserved for descriptive browsing.
• find_gameobjects --ids is 55 estimated tokens for a 20-result pickup search.
• --fields all remains available but costs 797 estimated tokens for the same 20-result search.

The low-token CLI path is stable across 2022.3.62f2, 2023.2.22f1, 6000.3.5f2, and 6000.5.0f1 for the tested smoke workflow.