widget_intelligence 2.0.0

A Rust library for intelligent Kyma widget suggestion and learning
Documentation

Widget Intelligence

A Rust library for intelligent widget suggestion and learning based on user behavior patterns.

Used in production https://neverenginelabs.com/products/nel-vcs-player

Features

  • Simple API: Register widgets with Label, EventId, and values, then get suggestions
  • Smart Suggestions: Query by EventID or Label to get suggested values based on training
  • Persistent Storage: Sled-based database for long-term learning
  • Pure Rust: Pure Rust library without UI framework dependencies

Installation

Add this to your Cargo.toml:

[dependencies]
widget_intelligence = "0.1"

Usage

Simplified Use Case

The Widget Intelligence system has been simplified to focus on the following use case:

  1. Register widgets with Label, EventId, and a vector of values
  2. Query for suggested values by EventId or Label
use widget_intelligence::*;

// Create a new suggestion engine
let mut engine = WidgetSuggestionEngine::new();

// Register a widget with Label, EventId, and values
let widget = Widget::simplified(
    Some("Volume".to_string()),
    Some(101),
    vec![0.7, 0.8, 0.75]
);
engine.store_widget(widget);

// Add more values to an existing widget
let widget_update = Widget::simplified(
    Some("Volume".to_string()),
    Some(101),
    vec![0.65, 0.85]
);
engine.store_widget(widget_update);

// Query for a suggested value by EventId
let suggestions = engine.get_suggestions_by_event_id(101, 1);
if let Some(suggestion) = suggestions.first() {
    println!("Suggested value: {:?}", suggestion.suggested_value);
    println!("Alternative values: {:?}", suggestion.alternative_values);
}

// Query for a suggested value by Label
let query_widget = Widget::simplified(
    Some("Volume".to_string()),
    None,
    vec![]
);
let suggestions = engine.get_suggestions(&query_widget, 1);
if let Some(suggestion) = suggestions.first() {
    println!("Suggested value: {:?}", suggestion.suggested_value);
    println!("Alternative values: {:?}", suggestion.alternative_values);
}

Persistent Storage

For persistent storage, use the PersistentWidgetSuggestionEngine:

// Initialize with a database path
let mut system = init_intelligence_system("widget_db")?;

// Register widgets and get suggestions as above
let widget = Widget::simplified(
    Some("Volume".to_string()),
    Some(101),
    vec![0.7, 0.8, 0.75]
);
system.store_widget(widget)?;

// Flush changes to disk
system.flush()?;