FleetDeckDocs

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

worker.json
{
  "executable": "/absolute/path/to/agent-adapter",
  "args": [],
  "inheritEnv": [
    "OPENAI_API_KEY"
  ]
}
bash
fleetdeck worker ./worker.json

Run 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.