@luxoai-dev/observability
Observability
Stablev0.7.0The shared signal layer for LuxoAI services. Standardizes service identity, health, readiness, metrics, logs, LLM telemetry, tool & action counters, feedback totals, and operational dashboards.
- Package
- @luxoai-dev/observability
- Layer
- Telemetry layer
- Version
- v0.7.0
- Used by
- LearnAgent metrics · SupplyAgent metrics · landing metrics · control-plane dashboards
Architecture
The package sits between the host application and runtime outputs. The host owns auth, data, and side effects; the package validates and shapes flow.
Host
Application workflow
Auth, data, product state, and side effects stay owned by the host app.
Package
Observability
The shared signal layer for LuxoAI services. Standardizes service identity, health, readiness, metrics, logs, LLM telemetry, tool & action counters, feedback totals, and operational dashboards.
Outcome
Agent outcome
Approved actions, responses, feedback, metrics, or model signals flow back to the product.
Capabilities
The contract surface, summarized.
| Capability | Detail |
|---|---|
| 01 | Health, readiness, Prometheus, and monitoring-token-protected route handlers. |
| 02 | Service identity across environment, version, component, node, and OTLP endpoint. |
| 03 | Standard LLM metrics for requests, latency, tokens, errors, in-flight work, and policy blocks. |
| 04 | Per-tool counters (luxo_llm_tool_use_total) for what the gateway exposed vs what the model actually invoked. |
| 05 | Per-action counters (luxo_action_total) for assistant-proposed and user-executed Luxo chat actions. |
| 06 | Pull-based service metrics snapshot (app_info, dependencies, Node memory/CPU/event-loop) for /api/metrics. |
| 07 | Redacted JSON logging (case-insensitive key match) and feedback metrics for production dashboards. |
Used by
Concrete consumers in the LuxoAI fleet.
Integration shape
Drop into a host app. The host keeps auth, persistence, and side effects.
import {
createHealthRoute,
createMetricsRoute,
} from "@luxoai-dev/observability/next";
export const health = createHealthRoute({
service: "invoiceagent",
version: process.env.APP_VERSION ?? "local",
});
export const metrics = createMetricsRoute();API Reference
Every export, every signature, every parameter. The production-grade reference your code or your agent needs to call this package without reading source.
Open Observability API reference