# XWUISuperLLMTraces

LLM observability explorer: span tree per request with prompts, tool calls, tokens, cost, session grouping, feedback and add-to-dataset.

Langfuse/LangSmith made trace-level debugging table stakes; SuperObservability is a ResourceHub with a flat trace list. This SuperApp is the span-tree product and feeds EvalStudio datasets.

The constructor is `new XWUISuperLLMTraces(container, data, config)`. Navigation is the inherited SuperApp shell (`menuTree()` / `pages()` / `XWUISuperApp.merge()`). Every leaf composes an existing XWUI widget — a Super module that reimplements a grid or editor internally is a defect.

Autonomy defaults to `suggest` (GUIDE_16). The settings leaf shows the current mode. Model-proposed mutations go through `createXWUISuperLLMTracesLogic().propose()` / `applyProposal()` / `rejectProposal()` so an agent can drive the shell without the GUI. The pinned model is `qwen2.5:7b-instruct` unless `config.pinnedModel` overrides it.

## Basic Usage

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Standalone LLM Traces shell on the KPI dashboard.
```

## Arabic (RTL)

```example
file: examples/RtlArabic.ts
html: examples/RtlArabic.html
title: Arabic (RTL)
description: Deep-link under locale ar.
```

## Showcase

```example
file: examples/Showcase.ts
html: examples/Showcase.html
title: Showcase
description: Dashboard, collapsed deep-link, and RTL.
```

## Host extra page

```example
file: examples/WithExtraPage.ts
html: examples/WithExtraPage.html
title: Host extra page
description: extraTree / extraPages host leaf.
```

## Merged shell

```example
file: examples/MergedShell.ts
html: examples/MergedShell.html
title: Merged shell
description: XWUISuperApp.merge with XWUISuperAI.
```

```api
```