Documentation Index
Fetch the complete documentation index at: https://docs.asymptotelabs.ai/llms.txt
Use this file to discover all available pages before exploring further.
Factory Droid
Beacon supports Factory Droid through an OTLP HTTP launch environment plus optional hook telemetry.Prerequisites
Before enabling Factory Droid telemetry, make sure:- Factory Droid is installed and available as the
droidexecutable for the user or managed endpoint. beacon endpoint installhas run so the local collector, shared endpoint config, and runtime log paths exist.- Droid’s launch environment sets
OTEL_TELEMETRY_ENDPOINT=http://127.0.0.1:4318through MDM or another customer-owned policy. - Optional hook telemetry is installed with
beacon endpoint hooks install --harness factory. - Factory Droid is restarted after launch-environment or hook changes so new sessions use the updated settings.
Collection path
Factory Droid can send OTLP HTTP telemetry to Beacon’s local collector. Factory hooks can also invoke Beacon’s hook adapter for richer runtime events where Factory exposes hook payloads.Discovery and status
Beacon detects Factory Droid through thedroid executable and validates OTEL_TELEMETRY_ENDPOINT in the effective launch environment.
Use beacon endpoint discover, beacon endpoint status, or beacon endpoint hooks status --harness factory to inspect Factory Droid support.
Install or configuration support
beacon endpoint install prepares the collector, shared endpoint config, and runtime log paths. Factory Droid’s launch environment is managed by MDM or customer policy.
Install optional Factory hooks separately:
--harness droid is also accepted for Factory Droid hook installs.
Telemetry coverage
| Area | Support |
|---|---|
| Prompt telemetry | Supported through UserPromptSubmit hooks |
| Command, tool, and file telemetry | Supported for session, write/edit/create tool use, stop, session-end, and available OTLP telemetry |
| Local JSONL and dashboard | Supported |
| MDM deployment | Supported for the endpoint agent; Factory launch environment and user/project hooks are managed in the user’s Droid context |
Deployment notes
Factory Droid OTLP is controlled by Droid’s launch environment. SetOTEL_TELEMETRY_ENDPOINT=http://127.0.0.1:4318 through MDM or another customer-owned launch policy.
Beacon discovers Droid and validates the endpoint, but it does not mutate shell profiles for Droid. Restart Factory Droid after installing or removing hooks so new sessions pick up the updated hook configuration.
Related
Supported agent harnesses
Return to the runtime support overview.
Hooks
Install, inspect, and uninstall runtime hook integrations.

