Skip to content

Workers

The Workers page gives you a unified view of all workers and active Hall enrollment sessions across every namespace you own.

Hall Enrollment Sessions

The sessions table shows every enrollment session across all your namespaces. Each row includes:

ColumnDescription
Session IDTruncated unique identifier for the session
NamespaceWhich namespace this session belongs to
EnrolledWhen the Hall API instance enrolled
ExpiresWhen this session expires
Last PollMost recent heartbeat from the Hall API instance

Sessions are created when a Hall API server calls the enroll endpoint with a valid API key. They expire automatically — the Hall API renews them on a configurable interval. Expired sessions remain visible for auditing.

Use this view to verify that your Hall API instances are actively polling. If Last Poll is old or Status shows Expired unexpectedly, the Hall API server may have stopped or lost connectivity.

Registered Workers

The workers table shows every worker registered across all your namespaces. Each row shows:

ColumnDescription
Worker IDFully qualified worker identifier (e.g., x.alice.handler-v1)
NamespaceWhich namespace this worker belongs to
Display NameHuman-readable label set at registration
StatusActive or Retired
AttestationAttested or Not attested
RegisteredRegistration date

Click any row to expand a detail panel with the full worker record including description, registration IP, and retirement information.

Worker Status

Active

Worker is registered and available for dispatch routing. The capability router will consider this worker when matching capability requests.

Retired

Worker has been intentionally retired (decommissioned). Retired workers are excluded from routing but remain in the registry for audit purposes. Retirement is irreversible — create a new worker if you need to re-register.

Attestation Status

Attested

The worker’s package hash has been submitted and verified. The registry holds a SHA256 fingerprint of the current package. If the hash changes without a new attestation, routing decisions will reflect the mismatch.

Not Attested

No attestation record exists for this worker. The worker can still be routed to, but WCP compliance requires attestation for production use.

Per-Namespace View

You can also view workers and sessions scoped to a single namespace from the Namespaces page. Navigate to a namespace and click Manage to see that namespace’s sessions and workers.