Skip to main content

Utelogy

@dougschaefer/utelogyv2026.10.08.1· 1mo agoBEHAVIORS
01README

Utelogy AV monitoring platform — rooms with CLM status and metrics, assets with driver/feature inventory, alerts with acknowledgement, and Global Device Library search. REST API integration with vault-based credentials.

02Release Notes

alert.acknowledge now writes a strict acknowledgement record instead of a placeholder alert, checks prior state via /api/alert/list/active (only an empty-list 404 is tolerated; auth, 5xx and timeout errors throw), and fails before writing when Utelogy refuses the acknowledge. Session and device fields are not stored. The pre-flight check passes when no alerts are active. HTTP errors name the request path, baseUrl must be https, and list endpoints must return arrays. Documentation cleanup.

03Behaviors4
@dougschaefer/utelogy-alertv2026.10.08.1utelogy/alert.ts
fn listActive()
List all currently active (unacknowledged) alerts across all devices.
fn list()
List alerts with optional date range filter.
fn acknowledge(id: string)
Acknowledge an alert by ID. Looks the alert up in the active-alert list first and skips the call only when that list shows it already acknowledged; an alert absent from the list is sent to the acknowledge endpoint, which decides. Writes an acknowledgement record.
ArgumentTypeDescription
idstringThe alert ID to acknowledge

Resources

alert(infinite)— Utelogy alert with target info, severity, and acknowledgment state
acknowledgement(30d)— Outcome of an acknowledge call: whether the alert was acknowledged, skipped as already acknowledged, and the API response
@dougschaefer/utelogy-assetv2026.10.08.1utelogy/asset.ts
fn list()
List all monitored assets (devices) across all rooms.
fn get(id: string)
Get detailed information about a specific asset by ID.
ArgumentTypeDescription
idstringUtelogy asset ID
fn sync()
Refresh all asset state from the Utelogy portal. Alias of list, intended for scheduled refresh.

Resources

asset(infinite)— Utelogy-monitored asset (AV device, compute endpoint, etc.)
@dougschaefer/utelogy-gdlv2026.10.08.1utelogy/gdl.ts
fn listManufacturers()
List all manufacturers in the Utelogy Global Device Library.
fn listDeviceKinds()
List all device kinds (categories) in the GDL.
fn listFeatureKinds()
List all feature kinds (capabilities like power, volume, input) in the GDL.
fn listDrivers()
List all device drivers in the Global Device Library.
fn searchDrivers(keywords: string)
Search for device drivers by keyword (manufacturer, model, etc.).
ArgumentTypeDescription
keywordsstringSearch keywords for driver lookup
fn getDriver()
Download one driver file from the GDL by filename (as returned by listDrivers or searchDrivers). The API returns the file base64-encoded; the decoded file is stored in driverFile and its metadata in driverDetail.

Resources

gdlEntry(7d)— A catalog collection from the Utelogy Global Device Library (manufacturers, device kinds, feature kinds, or drivers)
driverSearch(7d)— Result of a driver keyword search in the GDL
driverDetail(7d)— Metadata for a GDL driver file fetched by getDriver: filename, decoded byte size, content type, and the driverFile data name holding the file

Files

driverFile(application/octet-stream)— The decoded GDL driver file returned by getDriver, tagged with its original filename
@dougschaefer/utelogy-roomv2026.10.08.1utelogy/room.ts
fn list()
List all rooms in the Utelogy portal with metrics, CLM status, and active alerts.
fn get(id: string)
Get detailed information about a specific room by ID.
ArgumentTypeDescription
idstringUtelogy room ID
fn getAlerts(id: string)
List active alerts for a specific room.
ArgumentTypeDescription
idstringUtelogy room ID
fn sync()
Refresh all room state from the Utelogy portal. Alias of list, intended for scheduled refresh.

Resources

room(infinite)— Utelogy-monitored room with CLM status, metrics, and alerts
alertSet(7d)— Active alerts scoped to a specific room
04Previous Versions12
2026.10.07.1yanked

Adds getDriver: downloads a Global Device Library driver file (base64 per Utelogy's API), stores it as a file plus a metadata record under collision-free names, with a 25 MB cap. Refuses filenames that would reach other routes. Client errors give context without echoing bodies or credentials; requests time out after 60s.

Added 4, removed 1 behaviors

2026.05.27.1yanked

Modernization: idempotency, live pre-flight checks, sensitive-field marking, resource-write fixes per audit. No breaking API changes.

Modified 3 behaviors

2026.05.26.1yanked

Align model version fields with manifest (2026.05.26.1); republish under swamp 20260526 conventions

2026.05.13.1yanked

Add JSDoc to model entrypoints to satisfy rubric v2 symbols-docs factor

2026.04.27.1

Add curated README and LICENSE to tarball (additionalFiles), bringing extension's Swamp Club quality grade from F/B to A-/B.

2026.04.13.1

Add .meta({ sensitive: true }) to apiKey and authorization credentials

2026.04.02.1

Restore local source files with pinned zod@4.3.6, post-upgrade audit

2026.03.29.1

Pin zod to 4.3.6, use sanitizeId() for GDL search resource names

2026.03.28.1

Remove MSP-specific language from description and labels

2026.03.09.3

Fix repository URL: point to GitHub instead of ADO.

2026.03.09.2

Initial registry publish with manifest. Four models: room, asset, alert, GDL.

2026.03.09.1

Initial release — rooms, assets, alerts, and Global Device Library models with multi-tenant vault-based credential resolution.

05Stats
A
93 / 100
Downloads
38
Archive size
16.8 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License1/2partial

    no SPDX license declared

  • Verified public repository2/2earned
06Platforms
07Labels