Human + external AI agent + v_ase

One live document, with a visible feedback loop

The agent applies semantic commands while the researcher watches and refines the same GUI.

Shared live state
1 / Natural language

Researcher instructs the AI Agent

"Create a pyridinic N3 vacancy, place Li 2.15 A above the site, preserve PBC, and prepare a clear rendered view."

The researcher can open human_url immediately. No separate copy is created.

2 / Structured control

External AI Agent uses the v_ase Skill

v_ase gui STRUCTURE --cli
1
Inspectcapabilities() and describe()
2
ApplyTyped operations with expectedRevision
3
VerifyAtom identity, coordinates, cell, camera, and render
Live v_ase GUI same document
Live v_ase GUI showing the edited graphene structure
← human edits remain authoritative
Researcher refines the GUI For example: orbit the camera, change atom radius, adjust bonds, or select atoms.
CLI NDJSON eventsource: human
{"protocol":"v_ase.collaboration.v1","revision":8,"document_revision":8,"source":"human","categories":["camera","display"],"changed_paths":["camera","display.atomRadiusScale"]}
Agent re-synchronizes Read the event, call describe(), respect the new revision, and continue without guessing from pixels.