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
v_ase api "$command_url" METHOD
1
InspectHTTP JSON capabilities and describe
2
ApplyTyped HTTP operations with expectedRevision
3
VerifySemantic state, saved output, and the same live GUI
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 HTTP describe, respect the new revision, and continue without guessing from pixels.