Scan user extensions directory for enabled services with health endpoints. Returns a dict keyed by service_id in the same format as ``SERVICES``

Check if an ISO timestamp is older than max_age_seconds.

Resolve the exact request ID Lemonade assigned to a local GGUF. Prefer the live model catalog, whose checkpoint metadata survives naming chan

Match a runtime identity to exact supported aliases, never substrings.

Split a list-form port string into (host_part, rest). Naive ``str.split(":")`` is wrong for the sanctioned ``${VAR:-127.0.0.1}`` pattern beca

Remove all cache entries.

Read cached health check results. Returns None if no poll has completed yet.

Return one IndividualGPU per AMD GPU by iterating all amdgpu sysfs cards. Uses topology JSON (if available) for stable UUIDs and assignment mappi

Validate generated routing-state metadata and return a public route.

Build the full status payload. Runs ALL sync helpers (GPU, disk, CPU, RAM, model, bootstrap) concurrently in the thread pool while async heal

Compute the runtime status of an extension.

Acquire the global lock for short extension filesystem mutations.

Write a validated .env file. Dashboard-api delegates here because the container mount is :ro — only the host agent may write secrets to disk.

Resolve a lifecycle hook script from an extension manifest. Checks ``hooks`` map first, falls back to ``setup_hook`` for ``post_install`` onl

Switch egress service traffic to the candidate provider.

Get GPU metrics from nvidia-smi. Handles multi-GPU systems by summing VRAM across all GPUs and reporting aggregate utilization and peak tempe

Atomically replace a UTF-8 text file.

Ask host agent to drop the .compose-flags cache after a compose mutation.

Swap active model: update .env + models.ini + restart llama-server.

Apply a remote-provider lifecycle request through host-owned state.

Restart one known ODS service container.

Build a minimal manifest dict.

Split an SSE response body into one dict per frame.

Resolve the host-agent bind address without exposing LAN by default.

Split a `nmcli -t` (terse) line on UNESCAPED colons, then unescape. nmcli's terse mode escapes literal colons in values as ``\\:`` (and backs

Regenerate lemonade.yaml with the correct model ID for LiteLLM. Lemonade exposes models as ``extra.<GGUF_FILE>`` — the LiteLLM config must re

Write a manifest.yaml into the given extension directory.

Return one IndividualGPU per NVIDIA GPU, with assigned_services populated. Returns None if nvidia-smi is unavailable or returns no data.

Get inference metrics from llama-server Prometheus /metrics endpoint. Accepts an optional *model_hint* so callers that already resolved the l

Raise 403 if the service_id is an always-on base-compose service. Only blocks the 4 services from docker-compose.base.yml (llama-server, open

Release lifecycle ownership held by ``operation``.

Get a connection from the pool.

Direct HTTP POST to /v1/extension/sync_config so callers can assert on the raw status code (the dashboard-api helper masks 4xx as a ge

Override base for the magic-link URL (operator escape hatch). Set ODS_PUBLIC_URL to an absolute URL (e.g., a Tailscale tunnel or custom domai

Return a connection to the pool.

Read progress file for a service. Returns None if no active progress.

Accumulate tokens across server restarts using a persistent file.

Validate service_id format, raising 404 if invalid.

Write model download status JSON atomically.

Decode GPU_ASSIGNMENT_JSON_B64, preferring the live .env file over the container startup environment so reassignments are reflected without restar

Get GPU metrics from amdgpu sysfs.

Get GPU metrics for Apple Silicon via system_profiler (native) or env vars (container).

Query llama-server /props for the actual n_ctx. Accepts an optional *model_hint* to skip the redundant ``get_loaded_model()`` call when the c

Best-effort bootout of a bridge that would collide with a direct bind.

Find extension directory for a service_id (user-installed or built-in).

Find GPU temperature via hwmon label-based discovery (junction > edge > temp1).

Return a Bash executable that can run shell scripts on this host.

Return current model download progress.

Return whether the catalog entry represents a one-shot CLI/setup tool. Prefer the explicit catalog copy of ``service.startup_check: false``. Fall

Read and return the parsed manifest from an extension directory.

Restart managed Windows Lemonade from the host-agent process. Dashboard model activation runs through the persistent host-agent. Launching Le

Tests that exercise the bridge run several coroutines on the SAME event loop so the background sweeper task doesn't get orphaned across loop s

Add a new throughput sample

Clear the entire dir_size_gb cache (e.g. after bulk operations).