> ## Documentation Index
> Fetch the complete documentation index at: https://oxy.tech/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Semantic Type System, User Management, and Enhanced Chat Streaming

> Introducing semantics.yml - a comprehensive approach to data modeling that unifies all entity definitions across your entire Oxygen deployment:

<Icon icon="calendar" iconType="regular" size={16} /> **July 3, 2025**

### **Entity-First Unified Semantic Layer**

Introducing `semantics.yml` - a comprehensive approach to data modeling that unifies all entity definitions across your entire Oxygen deployment:

* **Automatic Semantic Collection** - Run `oxy sync` to bootstrap unified semantic definitions from all your models, then customize as needed
* **Agent Integration** - Reference semantic types directly within agents or workflows using Jinja syntax with dimensions object, e.g., `{{ dimensions.month }}`
* **Workflow Variables with JSON Schema** - Implement semantic type referencing as JSON Schema within workflow variables for structured validation
* **Centralized Entity Management** - Entire semantic layer consolidated in `semantics.yml` for consistency across your deployment
  *Note: This is an early release feature and may encounter some edge cases during initial use.*

Example of \[semantics.yml, which you can find in our public source code

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/54394.png?fit=max&auto=format&n=2ysRwFKWr6jO2xCq&q=85&s=4719063f48c3f15b9127f7ce44c9baac" alt="Image" width="1230" height="698" data-path="changelog/images/2025-07-03/54394.png" />

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/71016.png?fit=max&auto=format&n=2ysRwFKWr6jO2xCq&q=85&s=2b76ec6c1b6d882ee60d3ce3cae2912a" alt="Image" width="1134" height="660" data-path="changelog/images/2025-07-03/71016.png" />

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/18722.png?fit=max&auto=format&n=2ysRwFKWr6jO2xCq&q=85&s=134af868164e051dc573e78a6b3196f0" alt="Image" width="1864" height="1550" data-path="changelog/images/2025-07-03/18722.png" />

### **User Management & Admin Controls**

Complete user administration system with role-based access control:

* **Admin Configuration** - Define administrators directly in `config.yml` with simple email list
* **User Management Interface** - Access full user management at `/users` endpoint
* **User Lifecycle Management** - Admins can delete and restore user accounts
* **Role-Based Authorization** - Clear separation between admin and standard user capabilities

Example \[config.yml, which you can find in our public source code:

```yaml theme={null}
authentication:
  basic:
    smtp_user: example@gmail.com
    smtp_password_var: AUTH_SMTP_PASSWORD
    smtp_server: smtp.gmail.com
    smtp_port: 587
  admins:
    - example1@oxygen-hq.com
    - example2@oxygen-hq.com
```

Users can then be managed at `your-deployment-url/users`

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/81463.png?fit=max&auto=format&n=2ysRwFKWr6jO2xCq&q=85&s=7e6a0a88cede9ef82376cf4941f2adde" alt="Image" width="2442" height="1526" data-path="changelog/images/2025-07-03/81463.png" />

### **Revamped Management Interface**

Database management and API Keys management UIs are slightly reworked to follow a unified design language with consistent styling and interaction patterns

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/97926.png?fit=max&auto=format&n=2ysRwFKWr6jO2xCq&q=85&s=f7f31243f87994ace2cef4163e8cdc67" alt="Image" width="2520" height="1642" data-path="changelog/images/2025-07-03/97926.png" />

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/46822.png?fit=max&auto=format&n=2ysRwFKWr6jO2xCq&q=85&s=8ac5b94ff508c091837ec7b254237d25" alt="Image" width="2542" height="1750" data-path="changelog/images/2025-07-03/46822.png" />

### **Enhanced Chat Streaming Experience**

Conversations with agents now persist seamlessly across page navigation and reloads, with improved first message flow for smoother user experience

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/ezgif-158fd4cdb05ec8.gif?s=6719a319bf7f376d08e3704372b9fb21" alt="Image" width="396" height="480" data-path="changelog/images/2025-07-03/ezgif-158fd4cdb05ec8.gif" />

### Document update

Added more endpoints to the API reference. Visit `your-deployment-url/apidoc` for a closer look at our latest Openapi documentation

<img src="https://mintcdn.com/oxy-internal/2ysRwFKWr6jO2xCq/changelog/images/2025-07-03/92645.png?fit=max&auto=format&n=2ysRwFKWr6jO2xCq&q=85&s=9e70115b1b376bd98a415ead8fdf557d" alt="Image" width="1730" height="1964" data-path="changelog/images/2025-07-03/92645.png" />

### **Other Improvements**

Updated to Rust 1.88 (latest version), resolved ClickHouse stability issues, and improved artifact panel scrolling behavior. Enhanced dependency management for better overall platform reliability
