Fleet docs v0.2.0-rc.448

Graph

The Graph page, at /graph, is a live map of the whole fleet. Every dot is a thing in the fleet, and every line is a relation between two things. The map moves by itself as the fleet works.

What the dots are

Colour Kind What it is
Magenta Channel A named area of work. Its chats and their agents hang off it.
Cyan, with a ring Chief A chief session.
Blue Chat A chat that a person started.
Green Worker An agent that another agent spawned.
Orange Merge train The agent that merges finished branches.
Yellow Ticket A ticket on the Work board.
White Release The release a live ticket went out in.
Violet Machine A computer that runs agents. A dashed ring means an elastic (rented) machine.
Pink Process A program that an agent runs.
  • Size and glow of a machine or a process follow its live CPU and memory. The thin ring around a machine is the share of its memory in use.
  • A machine's label shows its hourly rate when it has one (for example €0.006/h), or own for your own hardware. The top bar adds up the rate of every machine with a known rate.
  • A ring that runs out of an agent means it just started a tool.
  • A coloured ring on an agent: yellow waits for an answer, orange is blocked, red failed or lost.
  • Particles on a line are live traffic: a working agent on its machine, a busy process, a ticket in work. A bright particle on a dashed line is a message from one agent to another.
  • A new thing appears with a small burst. A finished thing fades out.

The page shows no API prices and no token counts.

Network and Oilfield

The buttons Network | Oilfield at the top switch the drawing. The choice is in the URL (?view=oilfield) and is remembered. Both show the same fleet and use the same side panel.

The Oilfield is built from 3D models: rigs, pumpjacks, wellheads, a tank battery on each pad, trucks, refineries. Drag to move, turn the wheel or pinch to zoom, right-drag or turn two fingers to rotate, double-click to fit. Tilt it low to look at the wells under the ground. The gauges on a pad's tanks show the share of that pad's tickets that are merged or live. The beacon on a refinery's tall column is that repo's main: green, amber while a check runs, flashing red when main is red. A red main also burns the flare high and pours dark smoke, and the refinery's name says since when.

In the Oilfield each channel is a field, each repo is a pad in it and a refinery at the back of the map, and each worker is a well with a rig. A tool call is a frac stage on the well's horizontal leg (orange Bash, blue Read/Grep/Glob, green Edit/Write, purple Agent, red failed). The merge train is the processing plant and a release is a tanker. A ticket with no worker on it is a well too: a pink survey stake when filed, a red valve when blocked, a pumpjack when live. The ground is cut away, so the bores and frac stages show through it. Drag to pan, scroll to zoom, double-click to fit, click anything for its panel. Lenses do not apply here.

Drive

The third button, Drive (?view=drive), puts you on the ground in the same oilfield. You start in an orange truck on the road in front of the refineries.

The ? beside the view buttons (or the ? or H key) shows these controls on the page. It opens by itself the first time you drive.

To do this Keyboard and mouse Phone
Drive, or walk W A S D or the arrow keys; Shift goes faster The stick at the bottom left
Get out of the truck, or back in E, or the button at the bottom right The button
Look around Drag Drag
Move the camera closer The wheel. On foot, all the way in is your own eyes
See what a thing is Click it Tap it

A click on a well, a trailer or a plant opens the same side panel as the other views. A click on a refinery, a tank battery or a frac stage shows a short card. When you have walked far from the truck, the button reads Call the truck and brings it to you. Rigs, trailers, tanks and refineries are solid.

Jobs. Drive lists who waits for you, at the bottom right above a small map: an agent that asked you something, an open question in your inbox, a blocked worker, a red main. The nearest one is chosen; click another to choose it. A beam in the sky marks the chosen one, and each is a dot on the map (the white arrow is your truck). A new one is called out as Radio.

Talk. On foot, walk up to a rig or a trailer: the yellow button reads Talk to <name> (or press T). It shows what that agent asked, or the last thing it did. What you type goes back as your answer; when it asked nothing, it goes as a message, which starts its next turn. Esc or Later closes it and sends nothing.

The truck is a textured pickup and the person is a rigged worker who idles, walks and runs. Both are open-licence models; their sources are in fleet/internal/web/graph/models/drive/CREDITS.md.

Lenses and filters

The lens buttons show the map by one relation:

  • Lineage: who spawned whom.
  • Channels: the channels and the agents in each one.
  • Tickets: the agents, their tickets, the channel each ticket belongs to, and the release of each live ticket.
  • Machines: the agents on each machine.
  • Processes: the processes of each agent, on its machine.
  • Everything: all of them.

hide finished hides agents that are done or stopped, and closed tickets. The time window hides finished agents and tickets with no activity inside it. Agents that are still running always show.

Explore

  • Drag the background to pan. Scroll, or pinch on a phone, to zoom. Drag a dot to move it.
  • Click (or tap) a dot to focus it. The map zooms to it and its neighbours, and the others fade. A card opens with its status in plain words, its newest activity, and links to its chat, ticket or machine card.
  • Double-click an agent to show its processes in every lens. Double-click again to hide them.
  • Type a name in the search box and press Enter to focus it.
  • The breadcrumb at the top shows where you are. Click a step to go back, or Fleet to see everything. Escape goes back one step.
  • 3D shows the map in three dimensions (desktop only). Click it again for 2D.

The address keeps the lens and the focus, so a link to the page opens the same view.

What it reads

The page reads the same API as the other pages: the agents, the chats (for the channel of each agent), the channels, the Work view stream, the machines stream, the processes, and the event stream of each live swarm (spawns, tool runs, messages). Over plain HTTP the browser allows few connections to one server, so there the 3 busiest swarms stream; over HTTPS, up to 12.