Operate
Workers and scheduling
A local always-on worker claims due jobs and launches your chosen agent adapter under short-lived, device-bound credentials.
Deployment
{
"executable": "/absolute/path/to/agent-adapter",
"args": [],
"inheritEnv": [
"OPENAI_API_KEY"
]
}fleetdeck worker ./worker.jsonRun one supervised process with the same parent key that schedules jobs. FleetDeck does not host the model, wake a sleeping laptop or infer the user’s timezone.
Lease loop
The worker polls every second. A due job must be claimed within 30 seconds or becomes missed and is not replayed. The claim starts a 15-second lease. Heartbeats run every 4 seconds, each request times out after 5 seconds, and extend the lease, child key and still-active child sessions up to the finite job deadline.
Child process contract
The executable receives one JSON line on stdin with task, deviceId and FleetDeck instructions. It receives FLEETDECK_API_KEY, FLEETDECK_BASE_URL and FLEETDECK_DEVICE_ID. FleetDeck uses shell:false. Only PATH, HOME, TMPDIR, LANG, TERM and explicitly allowlisted variables are inherited.
Completion meaning
Exit 0 records that the agent process exited successfully. It is not certification that a post published, media imported or app state changed. The adapter should retain fresh screenshot or inspect evidence and summarize its actual observation.
Failure handling
- Cancellation sends SIGTERM to the process group, then SIGKILL after two seconds.
- More than 8 MiB combined child stdout/stderr stops the process.
- The server revokes child credentials and closes child sessions on cancellation or completion.
- If completion reporting fails, do not run the job again automatically.
