Provider factory for VirtualScrollWindowStrategy that simply extracts the already created VirtualScrollWindowStrategy from the given directive.

Creates an Observable that tracks alarm count for a specific asset. When real-time is paused and resumed, it re-fetches the current count from server to account for alarms that occurred during the pause.

Observable - Stream of alarm count values

Checks for errors in responses of requests made with @c8y/client services and displays them as alerts using AlertService.

Example

   const devices = await alertOnError(inventoryService.list({...}));

The original response (success or failure) of the @c8y/client service method invokation

Helper function to get the activated route in a service (as ActivatedRoute injection only works in components). Works as long as we only use a tree and no child is active at the same time.

A generic function to be used by specific implementations of the HOOK concept.

A Provider (either ValueProvider or ClassProvider) to be provided in a module.

Converts any value provided to an Observable that emits this value once and then completes. A convenience method to represent all the data as Observables rather than a mixture of Observables and other types.

Appends an extension derived from the MIME type when the filename lacks a useful one, so the inline editor can detect the language. Returns the name unchanged for unknown types (e.g. application/octet-stream) or when a matching extension is already present.

Resolves a served MIME type to a Monaco editor language id, falling back to plain text.

Apply mode constraints (hard rules) to filter controls based on refresh option.

Filtered array with mode constraints applied

Convert controls preset to GlobalContextSettings for registration.

Get supported modes from a preset definition. Modes are derived from features:

• LIVE mode: supported if preset has AUTO_REFRESH (LIVE_TIME is optional)
• HISTORY mode: supported if preset has HISTORY_TIME

Array of supported refresh options

Standard intervals, optionally prepended with "Lifetime" when the preset opts in.

Transforms and applies hierarchical settings to the widget controls structure.

Takes the simplified WidgetControlSettings format and distributes the configuration across the complete WidgetControls structure, populating both inline (settings) and configuration panel (configSettings) branches for each display mode and refresh option.

This function also processes defaultLinks and ensures they are properly distributed to match the control settings hierarchy.

Creates a comprehensive widget controls configuration for global context integration.

This factory function generates the complete control structure that determines how a widget interacts with the global context (time range, aggregation, auto-refresh). It handles:

• Feature support declaration
• Control visibility across different display modes and refresh options
• Default linking behavior between widget and global context
• Dynamic control behavior through custom handlers

Complete WidgetControls object ready for use in widget definitions

Wraps user-defined handlers into the stateHandlers format expected by WidgetControls.

This function transforms the simplified WidgetControlHandler format into the internal stateHandlers structure. Each handler receives the current widget state and returns modified control settings and link states.

The wrapper ensures handlers are always invoked (even without widget state) and properly propagates the widget state to the handler function for decision-making.

Map of handler names to wrapped functions compatible with WidgetControls.stateHandlers

Async version of validateArrayElements.

Note that Angular by design doesn't execute async validators if synchronous validators returns any error.

This method can alter how validators work. It can be used in cases where there is need to validate FormControl that as value, takes array of elements. This allows to reuse validators, that works for such elements. For example if Validators.minLength(3) is used on control that takes string as value, validator will return error if string is less than 3 characters. If same is done on array of strings, validator will return error if array has less than 3 elements.

validateArrayElements(Validators.minLength(3)) method makes it possible to check every member of array if it has minimum 3 characters. If there are elements that raise error, it will be possible to extract these errors using item index.

As a example, this can be used for custom form elements, which manipulates array of elements, and there is need to display corresponding error messages for every array member that is displayed, while still using Angular's Validation approach.

Errors that are generated by this helper are prefixed with 'INNER_ARRAY_ERROR_'. Reason for this is to prevent overwriting normal validation errors that could have same key

Adds aggregation visibility and default link behaviour on top of the baseline template.

Partial widget controls that enable aggregation.

Baseline control template used by most widgets. Mirrors the alarm list widget behaviour and serves as the foundation for additional presets.

Partial widget controls describing the baseline template.

Factory returning scroll-friendly auto-refresh handlers used by multiple presets.

Returns a deep-merged copy of the baseline and supplied partial overrides, unionising supported keys and concatenating handlers.

Combined partial controls.

Creates a fully hydrated WidgetControls by expanding the selected presets (and optional customiser) against the default template.

Fully merged widget controls ready for consumption.

Removes duplicate preset names while preserving the first occurrence.

Deduplicated preset array.

Merges partial control metadata into a cloned base instance, unionising the supported keys array and deep-merging nested settings/link structures.

Combined widget controls instance.

Normalises caller input to a deduplicated, ordered preset array.

Ordered list of preset identifiers without duplicates.

Retrieves the preset definition or throws if it does not exist.

Preset definition from the registry.

Emits a console warning whenever multiple presets from the same exclusiveGroup are composed, signalling that later presets override earlier ones.

Creates an Observable that tracks the count of child assets for a specific asset. Supports real-time updates when child assets are added or removed.

Observable - Stream of child assets count values

Shared function that tracks the count of child items (devices or assets) for a specific managed object. Supports real-time updates when child items are added or removed.

Observable - Stream of child items count values

Creates an Observable that tracks the count of child devices for a specific asset. Supports real-time updates when child devices are added or removed.

Observable - Stream of child devices count values

Configures and returns widget providers.

This function allows selective loading of widget providers with their configuration hooks. Unlike cockpitWidgets() which only provides widget definitions, this includes the full providers with hookWidgetConfig registrations for features like widget preview.

Array of providers to be included in app.module.ts

Converts from our UI-friendly message format back to the format the API requires when sending message history back to the agent manager service.

Currently the format is Vercel v6 ModelMessage (so this is a little similar to Vercel's convertToModelMessages).

We do not bother with details such as reasoning (not worth the tokens) or in-progress tool calls (since this method is only used on completed responses).

Produces the baseline alarm list controls preset mirroring the default widget behaviour.

Fresh baseline controls instance for the alarm list widget.

Produces the legacy alarm controls preset shared by the "recent" and "critical" alarm widgets. It hides the refresh interval and exposes the manual refresh button inline.

Alarm controls tailored for legacy alarm widgets.

Helper that clones the baseline controls and applies the provided overrides.

Combined control definition.

Resolves the appropriate controls preset based on the widget identifier.

Fully materialised controls for the widget.

Creates a complete default global context state

A complete GlobalContextState with all required properties set to sensible defaults

Fills missing or invalid properties in a partial global context state with defaults

Complete GlobalContextState with all required properties

Formats dateTimeContext for emission, handling date conversions and defaults. Delegates to central utility for consistency.

Formatted context with properly formatted dateTimeContext

Checks if a dateTimeContext diff object is complete (has all 3 required fields). Delegates to central utility for consistency.

true if dateTimeContext is absent, has only 1 field, or has all 3 fields; false if it has 2 fields (incomplete)

Checks if a date time context object has all required valid properties Delegates to central utility for consistency.

true if the context is complete and valid

Validates if a value is a valid date (either Date object or ISO string) Delegates to central utility for consistency.

true if the value represents a valid date

Creates a device with external identity information

Exports a configuration with asset information enriched for export

Check if a configuration has a valid device property

Imports a configuration with asset information adapted to the current context

Transforms a single target object for export

Transforms a single exported target object for import

Transforms an array of exported target objects for import

Transforms an array of target objects for export

Creates a standardized result object for widget state handler responses.

Standardized widget state handler result

Sets auto-refresh control visibility and link state based on display mode.

Implements inverse visibility pattern: auto-refresh is shown in dashboard mode (where it can be linked) and hidden in inline mode (where widgets handle it directly).

Complete widget state handler result with settings and links

Sets auto-refresh link state for dashboard display mode.

Updated link states (empty object for non-dashboard modes)

Updates both inline and dashboard control settings simultaneously.

Updated inline and dashboard control settings

The default implementation of for reducing the size of the message history so it is ready to be sent to the LLM agent.

This is important since old tool inputs and outputs can be very large and fill up the agent's context window.

Implements pruneMessagesFunction.

When sending an AI request you can provide your own function instead of using this one, or you can write your own function that calls this and adds extra logic, for example to suppress specific tools from the AIMessage, or retain only the final step text in multi-step responses, etc.

The current default implementation preserves text content, but does not include any tool calls. This may change in future releases.