npm - @burtson-labs/bandit-engine - Versions diffs - 2.0.162 → 2.0.163 - Mend

@burtson-labs/bandit-engine 2.0.162 → 2.0.163

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (211) hide show

package/docs/api_reference/index.html CHANGED Viewed

@@ -5,34 +5,68 @@
     <img src="https://cdn.burtson.ai/logos/burtson-labs-logo.png" alt="Burtson Labs Logo" width="120" style="width: 120px !important; max-width: 120px !important; height: auto; display: inline-block;" />
   </picture>
 </a>
-<a id="md:bandit-engine-⚡" class="tsd-anchor"></a><h1 class="tsd-anchor-link">Bandit Engine ⚡<a href="#md:bandit-engine-⚡" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h1><p>An AI chat toolkit built for speed, design, and control. Power branded AI assistants with battle-tested React components and a secure gateway contract.</p>
+<a id="md:bandit-engine-" class="tsd-anchor"></a><h1 class="tsd-anchor-link">Bandit Engine <img src="https://icons.burtson.ai/svg-accent/zap.svg" width="18" align="center" alt="" /><a href="#md:bandit-engine-" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h1><p>An AI chat toolkit built for speed, design, and control. Power branded AI assistants with battle-tested React components and a secure gateway contract.</p>
 <p><a href="https://www.npmjs.com/package/@burtson-labs/bandit-engine" target="_blank" class="external"><img src="https://img.shields.io/npm/v/%40burtson-labs%2Fbandit-engine?logo=npm&amp;color=cb3837" alt="npm"></a>
 <a href="https://banditailabs.com/npm-package" target="_blank" class="external"><img src="https://img.shields.io/badge/docs-banditailabs.com%2Fnpm--package-0C7BD4" alt="Docs"></a>
 <a href="https://banditailabs.com/" target="_blank" class="external"><img src="https://img.shields.io/badge/live%20demo-banditailabs.com%2Fchat-7F56D9" alt="Live Demo"></a>
 <a href="https://www.typescriptlang.org/" target="_blank" class="external"><img src="https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript&amp;logoColor=white" alt="TypeScript"></a>
 <a href="./LICENSE"><img src="https://img.shields.io/badge/License-BUSL--1.1-red" alt="License: BUSL-1.1"></a></p>
 <a id="md:features" class="tsd-anchor"></a><h2 class="tsd-anchor-link">Features<a href="#md:features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><ul>
-<li>🔌 Plug-and-play React chat, modal, and management surfaces</li>
-<li>🧠 Memory, vector knowledge, and provider switching behind a secure gateway</li>
-<li>🎨 Full MUI theming, dark mode, and branding controls out of the box</li>
-<li>🌐 Multimodal support (voice, images, documents) with Ollama, OpenAI, Azure OpenAI, and Anthropic today — tell us which providers you need next so we can prioritize them</li>
-<li>🛠️ CLI scaffolding, sample gateway, and docs to launch in minutes</li>
-</ul>
+<li>Plug-and-play React chat, modal, and management surfaces</li>
+<li>Memory, searchable knowledge, and provider switching behind a secure gateway</li>
+<li>Full MUI theming, dark mode, and branding controls out of the box</li>
+<li>Multimodal support (voice, images, documents) with Bandit AI, Ollama, OpenAI, Azure OpenAI, Anthropic, and xAI today — tell us which providers you need next so we can prioritize them</li>
+<li>CLI scaffolding, sample gateway, and docs to launch in minutes</li>
+</ul>
+<p>Bandit keeps confidentiality, integrity, and availability front and center: data stays within your routes, answers stay auditable, and the UI falls back gracefully when a provider is unavailable.</p>
+<a id="md:bandit-package-ecosystem" class="tsd-anchor"></a><h2 class="tsd-anchor-link">Bandit package ecosystem<a href="#md:bandit-package-ecosystem" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>This package is the core React engine. Related packages:</p>
+<table>
+<thead>
+<tr>
+<th>Package</th>
+<th>Purpose</th>
+<th>Install weight</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>@burtson-labs/bandit-engine</code></td>
+<td>React chat, modal, and management UI — this package</td>
+<td>Full</td>
+</tr>
+<tr>
+<td><a href="https://banditailabs.com/npm-package" target="_blank" class="external"><code>@burtson-labs/bandit-cli</code></a></td>
+<td>Quickstart scaffolding CLI — <code>npx @burtson-labs/bandit-cli create</code></td>
+<td>Minimal (Node.js only)</td>
+</tr>
+<tr>
+<td><a href="https://banditailabs.com/npm-package" target="_blank" class="external"><code>@burtson-labs/bandit-themes</code></a></td>
+<td>MUI theme pack — use Bandit design tokens without the engine</td>
+<td>MUI only</td>
+</tr>
+<tr>
+<td><a href="https://banditailabs.com/npm-package" target="_blank" class="external"><code>@burtson-labs/bandit-types</code></a></td>
+<td>Gateway contract type definitions — type your own gateway or server</td>
+<td>Zero runtime deps</td>
+</tr>
+</tbody>
+</table>
 <a id="md:quick-links" class="tsd-anchor"></a><h2 class="tsd-anchor-link">Quick Links<a href="#md:quick-links" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><ul>
-<li>📚 Full docs: <a href="https://banditailabs.com/npm-package" target="_blank" class="external">banditailabs.com/npm-package</a> (mirrors <code>/docs</code> in this repo)</li>
-<li>🎯 Live demo with OAuth sign-in: <a href="https://banditailabs.com/" target="_blank" class="external">banditailabs.com</a></li>
-<li>🧪 Playground (no auth required): <a href="https://banditailabs.com/playground" target="_blank" class="external">banditailabs.com/playground</a></li>
-<li>🔁 Sample gateway: <a href="media/README.md"><code>examples/gateway-node</code></a></li>
+<li>Full docs: <a href="https://banditailabs.com/npm-package" target="_blank" class="external">banditailabs.com/npm-package</a> (mirrors <code>/docs</code> in this repo)</li>
+<li>Live demo with OAuth sign-in: <a href="https://banditailabs.com/" target="_blank" class="external">banditailabs.com</a></li>
+<li>Playground (no auth required): <a href="https://banditailabs.com/playground" target="_blank" class="external">banditailabs.com/playground</a></li>
+<li>Sample gateway: <a href="media/README.md"><code>examples/gateway-node</code></a></li>
 </ul>
 <a id="md:quick-start" class="tsd-anchor"></a><h2 class="tsd-anchor-link">Quick Start<a href="#md:quick-start" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:cli-scaffold" class="tsd-anchor"></a><h3 class="tsd-anchor-link">CLI Scaffold<a href="#md:cli-scaffold" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Want a working playground instantly? Scaffold a Bandit app and gateway in one command:</p>
-<pre><code class="bash"><span class="hl-0">npx</span><span class="hl-1"> </span><span class="hl-2">@burtson-labs/bandit-engine</span><span class="hl-1"> </span><span class="hl-2">create</span><span class="hl-1"> </span><span class="hl-2">my-bandit-app</span>
+<pre><code class="bash"><span class="hl-0">npx</span><span class="hl-1"> </span><span class="hl-2">@burtson-labs/bandit-cli</span><span class="hl-1"> </span><span class="hl-2">create</span><span class="hl-1"> </span><span class="hl-2">my-bandit-app</span>
 </code><button type="button">Copy</button></pre>
 <p><img src="https://cdn.burtson.ai/images/cli-quickstart.jpg" alt="Bandit CLI quickstart walkthrough"></p>
 <p>What you get out of the box:</p>
 <ul>
 <li>Vite + React project wired with <code>Chat</code>, <code>ChatModal</code>, and <code>ChatProvider</code></li>
-<li>Express gateway that proxies OpenAI or Ollama behind <code>/api</code></li>
+<li>Express gateway that proxies Bandit AI, OpenAI, Azure OpenAI, Anthropic, xAI, or Ollama behind <code>/api</code></li>
+<li>Next.js App Router gateway scaffold (in <code>server/next-app/</code>) ready to copy into a Next project</li>
 <li>Branding + persona config in <code>public/config.json</code>, ready for your logo or prompts</li>
 </ul>
 <p>Customize the output with options such as:</p>
@@ -44,10 +78,10 @@
 <li><code>--force</code> to overwrite a non-empty directory</li>
 </ul>
 <blockquote>
-<p>📦 The generated project installs directly from <code>https://registry.npmjs.org/</code> — no GitHub npm token is required once the package is public.</p>
+<p>The generated project installs directly from <code>https://registry.npmjs.org/</code> — no GitHub npm token is required once the package is public.</p>
 </blockquote>
 <blockquote>
-<p>⚠️ The scaffolded gateway focuses on OpenAI/Ollama chat and model discovery. All advanced routes (file storage uploads, vector embedding, voice, MCP, etc.) are generated as <code>501</code> placeholders so you can wire them to your own infrastructure. Implement the contracts below before turning on those features in production.</p>
+<p>The scaffolded gateway focuses on Bandit AI/OpenAI/xAI/Ollama chat and model discovery. All advanced routes (file storage uploads, vector embedding, voice, MCP, etc.) are generated as <code>501</code> placeholders so you can wire them to your own infrastructure. Implement the contracts below before turning on those features in production.</p>
 </blockquote>
 <p>Check out the <a href="media/05_cli_quickstart.md">CLI quick start guide</a> for the full walkthrough, option matrix, and project anatomy.</p>
 <a id="md:cli-options" class="tsd-anchor"></a><h3 class="tsd-anchor-link">CLI Options<a href="#md:cli-options" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><table>
@@ -94,7 +128,7 @@
 <li><strong>What’s simulated:</strong> Responses come from canned scripts – no external API keys, tokens, or backend required.</li>
 </ul>
 <p>The playground is ideal for product demos, initial stakeholder reviews, or QA before you connect real providers. When you’re ready to go live, swap the provider back to your gateway for production traffic.</p>
-<a id="md:🛠️-getting-started--plug--play-ai" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🛠️ Getting Started – Plug &amp; Play AI<a href="#md:🛠️-getting-started--plug--play-ai" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit ships with responsive layouts baked in — the chat surface, management console, and modal all collapse gracefully on phones and tablets. Install it inside a Vite project and you can ship a polished PWA: the package works offline when cached, supports mobile nav patterns, and plays nicely with add-to-home-screen flows.</p>
+<a id="md:-getting-started--plug--play-ai" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/wrench.svg" width="18" align="center" alt="" /> Getting Started – Plug &amp; Play AI<a href="#md:-getting-started--plug--play-ai" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit ships with responsive layouts baked in — the chat surface, management console, and modal all collapse gracefully on phones and tablets. Install it inside a Vite project and you can ship a polished PWA: the package works offline when cached, supports mobile nav patterns, and plays nicely with add-to-home-screen flows.</p>
 <ol>
 <li><strong>Add a config.json</strong> to your public folder (or host it on a CDN) and point <code>brandingConfigUrl</code> at it:</li>
 </ol>
@@ -106,14 +140,14 @@
 <ol start="2">
 <li><strong>Wrap your entire app with <code>ChatProvider</code> to enable Bandit features globally:</strong></li>
 </ol>
-<pre><code class="tsx"><span class="hl-4">import</span><span class="hl-1"> </span><span class="hl-5">React</span><span class="hl-1"> </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;react&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> </span><span class="hl-5">ReactDOM</span><span class="hl-1"> </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;react-dom/client&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> </span><span class="hl-5">App</span><span class="hl-1"> </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;./App&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">CssBaseline</span><span class="hl-1">, </span><span class="hl-5">ThemeProvider</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@mui/material&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">banditDarkTheme</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;./theme/banditTheme&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AppInitializer</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;./app-initializer&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">ChatProvider</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@burtson-labs/bandit-engine&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">chatPackageSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-8">// New Gateway Provider Configuration (Recommended)</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1"> </span><span class="hl-4">as</span><span class="hl-1"> </span><span class="hl-6">const</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_GATEWAY_API_URL</span><span class="hl-1">!,</span><br/><span class="hl-1">    </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;openai&quot;</span><span class="hl-1"> </span><span class="hl-8">// Backend: openai, azure-openai, anthropic, ollama</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-8">// Direct Ollama configuration (development only)</span><br/><span class="hl-1">  </span><span class="hl-8">// ollamaUrl: import.meta.env.VITE_OLLAMA_URL!,</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-8">// Model Configuration</span><br/><span class="hl-1">  </span><span class="hl-5">defaultModel:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_DEFAULT_MODEL</span><span class="hl-1">!,</span><br/><span class="hl-1">  </span><span class="hl-5">fallbackModel:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_FALLBACK_MODEL</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-5">gatewayApiUrl:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_GATEWAY_API_URL</span><span class="hl-1">!,</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-8">// Branding and optional overrides</span><br/><span class="hl-1">  </span><span class="hl-5">brandingConfigUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;/config.json&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-8">// fileStorageApiUrl: import.meta.env.VITE_FILE_STORAGE_API_URL,</span><br/><span class="hl-1">  </span><span class="hl-8">// homeUrl: &quot;https://yourapp.com&quot;,</span><br/><span class="hl-1">  </span><span class="hl-8">// feedbackEmail: &quot;feedback@yourapp.com&quot;,</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-5">ReactDOM</span><span class="hl-1">.</span><span class="hl-0">createRoot</span><span class="hl-1">(</span><span class="hl-5">document</span><span class="hl-1">.</span><span class="hl-0">getElementById</span><span class="hl-1">(</span><span class="hl-2">&quot;root&quot;</span><span class="hl-1">)!).</span><span class="hl-0">render</span><span class="hl-1">(</span><br/><span class="hl-1">  </span><span class="hl-9">&lt;</span><span class="hl-10">React.StrictMode</span><span class="hl-9">&gt;</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;</span><span class="hl-10">ThemeProvider</span><span class="hl-1"> </span><span class="hl-11">theme</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-5">banditDarkTheme</span><span class="hl-6">}</span><span class="hl-9">&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">CssBaseline</span><span class="hl-1"> </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">AppInitializer</span><span class="hl-1"> </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">ChatProvider</span><span class="hl-1"> </span><span class="hl-11">packageSettings</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-5">chatPackageSettings</span><span class="hl-6">}</span><span class="hl-9">&gt;</span><br/><span class="hl-1">        </span><span class="hl-9">&lt;</span><span class="hl-10">App</span><span class="hl-1"> </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;/</span><span class="hl-10">ChatProvider</span><span class="hl-9">&gt;</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;/</span><span class="hl-10">ThemeProvider</span><span class="hl-9">&gt;</span><br/><span class="hl-1">  </span><span class="hl-9">&lt;/</span><span class="hl-10">React.StrictMode</span><span class="hl-9">&gt;</span><br/><span class="hl-1">);</span>
+<pre><code class="tsx"><span class="hl-4">import</span><span class="hl-1"> </span><span class="hl-5">React</span><span class="hl-1"> </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;react&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> </span><span class="hl-5">ReactDOM</span><span class="hl-1"> </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;react-dom/client&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> </span><span class="hl-5">App</span><span class="hl-1"> </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;./App&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">CssBaseline</span><span class="hl-1">, </span><span class="hl-5">ThemeProvider</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@mui/material&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">banditDarkTheme</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;./theme/banditTheme&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AppInitializer</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;./app-initializer&quot;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">ChatProvider</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@burtson-labs/bandit-engine&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">chatPackageSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-8">// New Gateway Provider Configuration (Recommended)</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1"> </span><span class="hl-4">as</span><span class="hl-1"> </span><span class="hl-6">const</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_GATEWAY_API_URL</span><span class="hl-1">!,</span><br/><span class="hl-1">    </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;bandit&quot;</span><span class="hl-1"> </span><span class="hl-8">// Backend: bandit, openai, azure-openai, anthropic, xai, ollama</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-8">// Direct Ollama configuration (development only)</span><br/><span class="hl-1">  </span><span class="hl-8">// ollamaUrl: import.meta.env.VITE_OLLAMA_URL!,</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-8">// Model Configuration</span><br/><span class="hl-1">  </span><span class="hl-5">defaultModel:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_DEFAULT_MODEL</span><span class="hl-1">!,</span><br/><span class="hl-1">  </span><span class="hl-5">fallbackModel:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_FALLBACK_MODEL</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-5">gatewayApiUrl:</span><span class="hl-1"> </span><span class="hl-4">import</span><span class="hl-1">.</span><span class="hl-5">meta</span><span class="hl-1">.</span><span class="hl-5">env</span><span class="hl-1">.</span><span class="hl-7">VITE_GATEWAY_API_URL</span><span class="hl-1">!,</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-8">// Branding and optional overrides</span><br/><span class="hl-1">  </span><span class="hl-5">brandingConfigUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;/config.json&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-8">// fileStorageApiUrl: import.meta.env.VITE_FILE_STORAGE_API_URL,</span><br/><span class="hl-1">  </span><span class="hl-8">// homeUrl: &quot;https://yourapp.com&quot;,</span><br/><span class="hl-1">  </span><span class="hl-8">// feedbackEmail: &quot;feedback@yourapp.com&quot;,</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-5">ReactDOM</span><span class="hl-1">.</span><span class="hl-0">createRoot</span><span class="hl-1">(</span><span class="hl-5">document</span><span class="hl-1">.</span><span class="hl-0">getElementById</span><span class="hl-1">(</span><span class="hl-2">&quot;root&quot;</span><span class="hl-1">)!).</span><span class="hl-0">render</span><span class="hl-1">(</span><br/><span class="hl-1">  </span><span class="hl-9">&lt;</span><span class="hl-10">React.StrictMode</span><span class="hl-9">&gt;</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;</span><span class="hl-10">ThemeProvider</span><span class="hl-1"> </span><span class="hl-11">theme</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-5">banditDarkTheme</span><span class="hl-6">}</span><span class="hl-9">&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">CssBaseline</span><span class="hl-1"> </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">AppInitializer</span><span class="hl-1"> </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">ChatProvider</span><span class="hl-1"> </span><span class="hl-11">packageSettings</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-5">chatPackageSettings</span><span class="hl-6">}</span><span class="hl-9">&gt;</span><br/><span class="hl-1">        </span><span class="hl-9">&lt;</span><span class="hl-10">App</span><span class="hl-1"> </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;/</span><span class="hl-10">ChatProvider</span><span class="hl-9">&gt;</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;/</span><span class="hl-10">ThemeProvider</span><span class="hl-9">&gt;</span><br/><span class="hl-1">  </span><span class="hl-9">&lt;/</span><span class="hl-10">React.StrictMode</span><span class="hl-9">&gt;</span><br/><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <blockquote>
-<p>🚀 Within minutes, you'll have a fully functional chat interface that can read, speak, and reason – all brandable, themeable, and extensible.</p>
+<p><img src="https://icons.burtson.ai/svg-accent/rocket.svg" width="18" align="center" alt="" /> Within minutes, you'll have a fully functional chat interface that can read, speak, and reason – all brandable, themeable, and extensible.</p>
 </blockquote>
-<a id="md:🔄-quick-provider-setup" class="tsd-anchor"></a><h3 class="tsd-anchor-link">🔄 Quick Provider Setup<a href="#md:🔄-quick-provider-setup" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p><strong>Option 1: Gateway Provider (Recommended)</strong></p>
-<pre><code class="tsx"><span class="hl-8">// Most secure - API keys stay on your backend</span><br/><span class="hl-8">// Your gateway can be built in ANY language: Node.js, Python, .NET, Java, PHP, Go, etc.</span><br/><span class="hl-12">aiProvider</span><span class="hl-1">: {</span><br/><span class="hl-1">  </span><span class="hl-12">type</span><span class="hl-1">: </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-12">gatewayUrl</span><span class="hl-1">: </span><span class="hl-2">&quot;https://your-api-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-8">// Your backend API</span><br/><span class="hl-1">  </span><span class="hl-12">provider</span><span class="hl-1">: </span><span class="hl-2">&quot;openai&quot;</span><span class="hl-1"> </span><span class="hl-8">// Specify which AI provider to use</span><br/><span class="hl-1">}</span>
+<a id="md:-quick-provider-setup" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/refresh.svg" width="18" align="center" alt="" /> Quick Provider Setup<a href="#md:-quick-provider-setup" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p><strong>Option 1: Gateway Provider (Recommended)</strong></p>
+<pre><code class="tsx"><span class="hl-8">// Most controlled - all traffic flows through your gateway</span><br/><span class="hl-8">// Your gateway can be built in ANY language: Node.js, Python, .NET, Java, PHP, Go, etc.</span><br/><span class="hl-12">aiProvider</span><span class="hl-1">: {</span><br/><span class="hl-1">  </span><span class="hl-12">type</span><span class="hl-1">: </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-12">gatewayUrl</span><span class="hl-1">: </span><span class="hl-2">&quot;https://your-api-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-8">// Your backend API</span><br/><span class="hl-1">  </span><span class="hl-12">provider</span><span class="hl-1">: </span><span class="hl-2">&quot;bandit&quot;</span><span class="hl-1"> </span><span class="hl-8">// Specify which AI provider to use (bandit, openai, azure-openai, anthropic, xai, ollama)</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <p><strong>Option 2: Direct Provider (Development)</strong></p>
@@ -132,10 +166,10 @@
 <li><strong>Chat &amp; text generation</strong>
 <ul>
 <li><code>POST /api/chat/completions</code> — default provider routing</li>
-<li><code>POST /api/{provider}/chat/completions</code> — provider-specific routing (e.g. <code>openai</code>, <code>azure-openai</code>, <code>anthropic</code>)</li>
+<li><code>POST /api/{provider}/chat/completions</code> — provider-specific routing (e.g. <code>bandit</code>, <code>openai</code>, <code>azure-openai</code>, <code>anthropic</code>, <code>xai</code>)</li>
 <li><code>POST /api/ollama/chat</code> — native Ollama chat format</li>
 <li><code>POST /api/generate</code> — non-chat generation (conversation starters, summaries, etc.)</li>
-<li><code>POST /api/{provider}/generate</code> — same contract, but scoped per provider (required for conversation starters to respect OpenAI vs. Ollama routing)</li>
+<li><code>POST /api/{provider}/generate</code> — same contract, but scoped per provider (required for conversation starters to respect Bandit/OpenAI/Azure routing)</li>
 </ul>
 </li>
 <li><strong>Knowledge &amp; vector search</strong> (required for memories, knowledge management, and MCP document tools)
@@ -165,10 +199,11 @@
 </li>
 </ul>
 <blockquote>
-<p><strong>⚠️ Important:</strong> The Bandit Engine automatically routes to provider-specific endpoints:</p>
+<p><strong><img src="https://icons.burtson.ai/svg-accent/alert-triangle.svg" width="16" align="center" alt="" /> Important:</strong> The Bandit Engine automatically routes to provider-specific endpoints:</p>
 <ul>
+<li><strong>Bandit AI</strong> → <code>/api/bandit/chat/completions</code> (OpenAI format, token or API key)</li>
 <li><strong>Ollama</strong> → <code>/api/ollama/chat</code> (native Ollama format)</li>
-<li><strong>OpenAI/Azure/Anthropic</strong> → <code>/api/{provider}/chat/completions</code> (OpenAI format)</li>
+<li><strong>OpenAI/Azure/xAI/Anthropic</strong> → <code>/api/{provider}/chat/completions</code> (OpenAI format)</li>
 <li><strong>TTS/STT</strong> → Technology-agnostic endpoints that work with any backend implementation</li>
 </ul>
 </blockquote>
@@ -197,7 +232,7 @@ OLLAMA_URL=http://localhost:11434 # or the remote daemon address
 <p><strong>Gateway tip</strong><br>
 Set <code>VITE_DEFAULT_MODEL</code> / <code>VITE_FALLBACK_MODEL</code> to the exact Ollama model tags you have available (<code>gemma</code>, <code>llava</code>, <code>moondream</code>, or your own custom builds). Bandit automatically detects multimodal Ollama models, so using <code>llava</code>, <code>moondream</code>, or other vision-capable variants enables image understanding with no extra code.</p>
 </blockquote>
-<a id="md:🎤-voice-services-ttsstt" class="tsd-anchor"></a><h3 class="tsd-anchor-link">🎤 Voice Services (TTS/STT)<a href="#md:🎤-voice-services-ttsstt" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The Bandit Engine supports Text-to-Speech (TTS) and Speech-to-Text (STT) through your gateway API. These services are <strong>technology-agnostic</strong> - you can implement them using any backend technology:</p>
+<a id="md:-voice-services-ttsstt" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/mic.svg" width="18" align="center" alt="" /> Voice Services (TTS/STT)<a href="#md:-voice-services-ttsstt" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The Bandit Engine supports Text-to-Speech (TTS) and Speech-to-Text (STT) through your gateway API. These services are <strong>technology-agnostic</strong> - you can implement them using any backend technology:</p>
 <p><strong>TTS Endpoint (<code>POST /api/tts</code>)</strong></p>
 <ul>
 <li><strong>Input</strong>: <code>{ text: string, voice?: string, speed?: number }</code></li>
@@ -228,7 +263,46 @@ Set <code>VITE_DEFAULT_MODEL</code> / <code>VITE_FALLBACK_MODEL</code> to the ex
 <li>Build with <code>tsup</code>.</li>
 </ul>
 <hr>
-<a id="md:🧩-consuming-the-components" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🧩 Consuming the Components<a href="#md:🧩-consuming-the-components" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Once you've wrapped your app with <code>ChatProvider</code>, you can selectively integrate Bandit's components as needed:</p>
+<a id="md:-compatibility" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/badge-check.svg" width="18" align="center" alt="" /> Compatibility<a href="#md:-compatibility" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>What each release is tested against. <code>scripts/check-consumer.sh</code> packs the build and loads it in a fresh app with these versions.</p>
+<table>
+<thead>
+<tr>
+<th>Host</th>
+<th>Supported</th>
+<th>Notes</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>React</td>
+<td>19.x</td>
+<td>The engine ships its own React for custom-element hosts. A React app must be on 19 so both share one copy; on 18 the engine's hooks fail.</td>
+</tr>
+<tr>
+<td>MUI (<code>@mui/material</code>)</td>
+<td>7.x</td>
+<td>Earlier versions are not tested.</td>
+</tr>
+<tr>
+<td>Module formats</td>
+<td>ESM and CommonJS</td>
+<td>Both entry points are loaded by the consumer check.</td>
+</tr>
+<tr>
+<td>Icons</td>
+<td><a href="https://icons.burtson.ai" target="_blank" class="external"><code>@burtson-labs/icons</code></a> 0.5</td>
+<td>A dependency, not a peer: the engine's icons are Burtson Icons through its MUI entry (<code>@burtson-labs/icons/mui/&lt;name&gt;</code>), so nothing extra is installed and no other icon library is bundled.</td>
+</tr>
+<tr>
+<td>Angular / Vue</td>
+<td>Experimental</td>
+<td>Through <code>defineCustomElement</code>. Not covered by the consumer check.</td>
+</tr>
+</tbody>
+</table>
+<p>Earlier releases declared <code>react &gt;=18</code> and <code>@mui/material &gt;=5</code>. Those ranges were never tested; the declarations now match what is.</p>
+<a id="md:sending-and-attachments" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Sending and attachments<a href="#md:sending-and-attachments" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>In <code>&lt;Chat /&gt;</code>, a message that fails before the model starts answering goes back into the composer with its attachments, and the thread shows that nothing came back. Enter that confirms an IME candidate doesn't send, and a second Enter while a send is in flight is ignored. Attached documents keep their text as written (accents, CJK, emoji, code blocks); a file that can't be read, or has no text, stops the send with a message instead of being dropped.</p>
+<a id="md:-consuming-the-components" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/extension-slot.svg" width="18" align="center" alt="" /> Consuming the Components<a href="#md:-consuming-the-components" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Once you've wrapped your app with <code>ChatProvider</code>, you can selectively integrate Bandit's components as needed:</p>
 <ul>
 <li><code>&lt;Chat /&gt;</code>: The main chat interface, designed to be used on a dedicated page or embedded into your product.</li>
 <li><code>&lt;Management /&gt;</code>: A full-featured admin and model configuration UI. This should not be on the same page as <code>&lt;Chat /&gt;</code>. Use this to allow authenticated users to manage themes, models, and embedded knowledge.</li>
@@ -245,7 +319,7 @@ Set <code>VITE_DEFAULT_MODEL</code> / <code>VITE_FALLBACK_MODEL</code> to the ex
 <pre><code class="tsx"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Chat</span><span class="hl-1">, </span><span class="hl-5">Management</span><span class="hl-1">, </span><span class="hl-5">ChatModal</span><span class="hl-1">, </span><span class="hl-5">ChatProvider</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@burtson-labs/bandit-engine&#39;</span><span class="hl-1">;</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">useState</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&#39;react&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">YourPage</span><span class="hl-1">() {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> [</span><span class="hl-7">isModalOpen</span><span class="hl-1">, </span><span class="hl-7">setIsModalOpen</span><span class="hl-1">] = </span><span class="hl-0">useState</span><span class="hl-1">(</span><span class="hl-6">false</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-4">return</span><span class="hl-1"> (</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">Chat</span><span class="hl-1"> </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">      </span><span class="hl-6">{</span><span class="hl-8">/* Use &lt;Management /&gt; on a separate admin route with access controls */</span><span class="hl-6">}</span><br/><span class="hl-1">      </span><br/><span class="hl-1">      </span><span class="hl-6">{</span><span class="hl-8">/* Trigger the AI modal anywhere in your app */</span><span class="hl-6">}</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-13">button</span><span class="hl-1"> </span><span class="hl-11">onClick</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-14">() </span><span class="hl-6">=&gt;</span><span class="hl-14"> </span><span class="hl-0">setIsModalOpen</span><span class="hl-14">(</span><span class="hl-6">true</span><span class="hl-14">)</span><span class="hl-6">}</span><span class="hl-9">&gt;</span><br/><span class="hl-1">        Ask AI</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;/</span><span class="hl-13">button</span><span class="hl-9">&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">ChatModal</span><span class="hl-1"> </span><br/><span class="hl-1">        </span><span class="hl-11">open</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-5">isModalOpen</span><span class="hl-6">}</span><span class="hl-1"> </span><br/><span class="hl-1">        </span><span class="hl-11">onClose</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-14">() </span><span class="hl-6">=&gt;</span><span class="hl-14"> </span><span class="hl-0">setIsModalOpen</span><span class="hl-14">(</span><span class="hl-6">false</span><span class="hl-14">)</span><span class="hl-6">}</span><br/><span class="hl-1">      </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;/&gt;</span><br/><span class="hl-1">  );</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
-<a id="md:🛠️-utility-functions--hooks" class="tsd-anchor"></a><h3 class="tsd-anchor-link">🛠️ Utility Functions &amp; Hooks<a href="#md:🛠️-utility-functions--hooks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Bandit Engine exports several utility functions for advanced use cases:</p>
+<a id="md:-utility-functions--hooks" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/wrench.svg" width="18" align="center" alt="" /> Utility Functions &amp; Hooks<a href="#md:-utility-functions--hooks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Bandit Engine exports several utility functions for advanced use cases:</p>
 <a id="md:debug-logger" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Debug Logger<a href="#md:debug-logger" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><p>Replace console statements with structured logging:</p>
 <pre><code class="tsx"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">debugLogger</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@burtson-labs/bandit-engine&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">debugLogger</span><span class="hl-1">.</span><span class="hl-0">info</span><span class="hl-1">(</span><span class="hl-2">&#39;Chat session started&#39;</span><span class="hl-1">);</span><br/><span class="hl-5">debugLogger</span><span class="hl-1">.</span><span class="hl-0">warn</span><span class="hl-1">(</span><span class="hl-2">&#39;Fallback model selected&#39;</span><span class="hl-1">);</span><br/><span class="hl-5">debugLogger</span><span class="hl-1">.</span><span class="hl-0">error</span><span class="hl-1">(</span><span class="hl-2">&#39;Connection failed&#39;</span><span class="hl-1">, { </span><span class="hl-5">error:</span><span class="hl-1"> </span><span class="hl-5">details</span><span class="hl-1"> });</span>
 </code><button type="button">Copy</button></pre>
@@ -256,32 +330,32 @@ Set <code>VITE_DEFAULT_MODEL</code> / <code>VITE_FALLBACK_MODEL</code> to the ex
 <a id="md:datetime-context" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Date/Time Context<a href="#md:datetime-context" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><p>All AI interactions automatically include current date/time context to improve relevance and accuracy of responses.</p>
 <blockquote>
-<p>⚠️ <strong>Important:</strong> Each component (<code>&lt;Chat /&gt;</code>, <code>&lt;Management /&gt;</code>, <code>&lt;ChatModal /&gt;</code>) <strong>must</strong> be wrapped in a <code>ChatProvider</code> to function correctly.<br>
+<p><img src="https://icons.burtson.ai/svg-accent/alert-triangle.svg" width="16" align="center" alt="" /> <strong>Important:</strong> Each component (<code>&lt;Chat /&gt;</code>, <code>&lt;Management /&gt;</code>, <code>&lt;ChatModal /&gt;</code>) <strong>must</strong> be wrapped in a <code>ChatProvider</code> to function correctly.<br>
 In React, you can wrap your app once at the root.<br>
 In Angular or Vue, you may need to wrap each usage with a <code>&lt;bandit-chat-provider&gt;</code> tag and pass settings each time until full reactive context is supported.</p>
 </blockquote>
 <hr>
-<a id="md:🎛️-chat-control-center-chatmodal-feature" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🎛️ Chat Control Center (ChatModal Feature)<a href="#md:🎛️-chat-control-center-chatmodal-feature" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>The <code>&lt;ChatModal /&gt;</code> includes a comprehensive Chat Control Center that provides advanced session management:</p>
-<a id="md:🔧-core-features" class="tsd-anchor"></a><h3 class="tsd-anchor-link">🔧 Core Features<a href="#md:🔧-core-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
+<a id="md:-chat-control-center-chatmodal-feature" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/sliders.svg" width="18" align="center" alt="" /> Chat Control Center (ChatModal Feature)<a href="#md:-chat-control-center-chatmodal-feature" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>The <code>&lt;ChatModal /&gt;</code> includes a comprehensive Chat Control Center that provides advanced session management:</p>
+<a id="md:-core-features" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/wrench.svg" width="18" align="center" alt="" /> Core Features<a href="#md:-core-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
 <li><strong>Session vs. Conversation Context</strong>: Toggle between local modal session and persistent conversation history</li>
 <li><strong>Voice Model Selection</strong>: Real-time voice switching with preview greetings (requires TTS gateway configuration)</li>
 <li><strong>Memory Management</strong>: View and manage AI personal memory entries</li>
 <li><strong>Conversation Navigation</strong>: Seamless transition from modal to full chat interface</li>
 <li><strong>Manual Refresh</strong>: Force reload of conversations and voice models for troubleshooting</li>
 </ul>
-<a id="md:🎤-voice-integration" class="tsd-anchor"></a><h3 class="tsd-anchor-link">🎤 Voice Integration<a href="#md:🎤-voice-integration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>When your gateway API includes TTS endpoints, the Chat Control Center provides:</p>
+<a id="md:-voice-integration" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/mic.svg" width="18" align="center" alt="" /> Voice Integration<a href="#md:-voice-integration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>When your gateway API includes TTS endpoints, the Chat Control Center provides:</p>
 <ul>
 <li><strong>Voice Selection Dropdown</strong>: Choose from available voice models (e.g., Mark, Amy, Kathleen, Lessac, Ryan)</li>
 <li><strong>Real-time Preview</strong>: Hear voice greetings when switching models</li>
 <li><strong>Consistent Formatting</strong>: Voice names display as proper titles (e.g., &quot;Mark&quot; instead of &quot;en_US-mark-premium&quot;)</li>
 <li><strong>Availability Detection</strong>: Automatic detection and fallback when voice services are unavailable</li>
 </ul>
-<a id="md:🔄-context-switching" class="tsd-anchor"></a><h3 class="tsd-anchor-link">🔄 Context Switching<a href="#md:🔄-context-switching" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
+<a id="md:-context-switching" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/refresh.svg" width="18" align="center" alt="" /> Context Switching<a href="#md:-context-switching" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
 <li><strong>Local Session</strong>: Quick interactions within the modal scope</li>
 <li><strong>Main Conversation</strong>: Access full conversation history with automatic navigation to <code>/chat</code> route</li>
 <li><strong>Smart Conversation Selection</strong>: Automatically loads most recent conversation when switching contexts</li>
 </ul>
-<a id="md:💾-memory-features" class="tsd-anchor"></a><h3 class="tsd-anchor-link">💾 Memory Features<a href="#md:💾-memory-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
+<a id="md:-memory-features" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/save.svg" width="18" align="center" alt="" /> Memory Features<a href="#md:-memory-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
 <li><strong>Personal Memory Display</strong>: View AI's stored personal information about the user</li>
 <li><strong>Memory Entry Count</strong>: Real-time count of stored memory entries</li>
 <li><strong>Memory Management Modal</strong>: Full CRUD operations for memory entries</li>
@@ -290,7 +364,7 @@ In Angular or Vue, you may need to wrap each usage with a <code>&lt;bandit-chat-
 <pre><code class="tsx"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">ChatModal</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@burtson-labs/bandit-engine&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">App</span><span class="hl-1">() {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> [</span><span class="hl-7">modalOpen</span><span class="hl-1">, </span><span class="hl-7">setModalOpen</span><span class="hl-1">] = </span><span class="hl-0">useState</span><span class="hl-1">(</span><span class="hl-6">false</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-4">return</span><span class="hl-1"> (</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-13">button</span><span class="hl-1"> </span><span class="hl-11">onClick</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-14">() </span><span class="hl-6">=&gt;</span><span class="hl-14"> </span><span class="hl-0">setModalOpen</span><span class="hl-14">(</span><span class="hl-6">true</span><span class="hl-14">)</span><span class="hl-6">}</span><span class="hl-9">&gt;</span><br/><span class="hl-1">        Open AI Assistant</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;/</span><span class="hl-13">button</span><span class="hl-9">&gt;</span><br/><span class="hl-1">      </span><span class="hl-9">&lt;</span><span class="hl-10">ChatModal</span><span class="hl-1"> </span><br/><span class="hl-1">        </span><span class="hl-11">open</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-5">modalOpen</span><span class="hl-6">}</span><span class="hl-1"> </span><br/><span class="hl-1">        </span><span class="hl-11">onClose</span><span class="hl-1">=</span><span class="hl-6">{</span><span class="hl-14">() </span><span class="hl-6">=&gt;</span><span class="hl-14"> </span><span class="hl-0">setModalOpen</span><span class="hl-14">(</span><span class="hl-6">false</span><span class="hl-14">)</span><span class="hl-6">}</span><br/><span class="hl-1">        </span><span class="hl-8">// Chat Control Center is automatically included</span><br/><span class="hl-1">      </span><span class="hl-9">/&gt;</span><br/><span class="hl-1">    </span><span class="hl-9">&lt;/&gt;</span><br/><span class="hl-1">  );</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
-<a id="md:📧-feedback-system" class="tsd-anchor"></a><h3 class="tsd-anchor-link">📧 Feedback System<a href="#md:📧-feedback-system" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The Bandit Engine includes a comprehensive feedback system that can be configured and customized for your application.</p>
+<a id="md:-feedback-system" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/mail.svg" width="18" align="center" alt="" /> Feedback System<a href="#md:-feedback-system" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The Bandit Engine includes a comprehensive feedback system that can be configured and customized for your application.</p>
 <p><strong>Configuration:</strong></p>
 <pre><code class="tsx"><span class="hl-8">// Package Settings - Configure feedback email</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">chatPackageSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-8">// ... other settings</span><br/><span class="hl-1">  </span><span class="hl-5">feedbackEmail:</span><span class="hl-1"> </span><span class="hl-2">&quot;feedback@yourcompany.com&quot;</span><span class="hl-1">, </span><span class="hl-8">// Optional: custom feedback email</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-8">// Preferences - Enable/disable feedback in management UI</span><br/><span class="hl-8">// Users can toggle feedback button on/off in preferences</span>
 </code><button type="button">Copy</button></pre>
@@ -301,13 +375,13 @@ In Angular or Vue, you may need to wrap each usage with a <code>&lt;bandit-chat-
 <p><strong>Features:</strong></p>
 <ul>
-<li>📱 <strong>Responsive Design</strong>: Automatic floating FAB on desktop, inline button on mobile</li>
-<li>🎨 <strong>Category System</strong>: Bug reports, feature requests, general feedback</li>
-<li>📊 <strong>Priority Levels</strong>: Low, medium, high, critical</li>
-<li>😤 <strong>Annoyance Slider</strong>: Measure user frustration (1-5 scale)</li>
-<li>📎 <strong>Single Image Support</strong>: Automatic clipboard integration</li>
-<li>📧 <strong>Email Fallback</strong>: Generates mailto URLs when API unavailable</li>
-<li>⚙️ <strong>User Preferences</strong>: Can be enabled/disabled in management UI</li>
+<li><img src="https://icons.burtson.ai/svg-accent/smartphone.svg" width="18" align="center" alt="" /> <strong>Responsive Design</strong>: Automatic floating FAB on desktop, inline button on mobile</li>
+<li><img src="https://icons.burtson.ai/svg-accent/palette.svg" width="18" align="center" alt="" /> <strong>Category System</strong>: Bug reports, feature requests, general feedback</li>
+<li><img src="https://icons.burtson.ai/svg-accent/chart-bar.svg" width="18" align="center" alt="" /> <strong>Priority Levels</strong>: Low, medium, high, critical</li>
+<li><img src="https://icons.burtson.ai/svg-accent/frown.svg" width="18" align="center" alt="" /> <strong>Annoyance Slider</strong>: Measure user frustration (1-5 scale)</li>
+<li><img src="https://icons.burtson.ai/svg-accent/paperclip.svg" width="18" align="center" alt="" /> <strong>Single Image Support</strong>: Automatic clipboard integration</li>
+<li><img src="https://icons.burtson.ai/svg-accent/mail.svg" width="18" align="center" alt="" /> <strong>Email Fallback</strong>: Generates mailto URLs when API unavailable</li>
+<li><img src="https://icons.burtson.ai/svg-accent/settings.svg" width="18" align="center" alt="" /> <strong>User Preferences</strong>: Can be enabled/disabled in management UI</li>
 </ul>
 <p><strong>Auto-Integration:</strong></p>
 <ul>
@@ -316,7 +390,7 @@ In Angular or Vue, you may need to wrap each usage with a <code>&lt;bandit-chat-
 <li>Preferences: Toggle available in management interface</li>
 </ul>
 <hr>
-<a id="md:⚙️-angular-integration-experimental" class="tsd-anchor"></a><h2 class="tsd-anchor-link">⚙️ Angular Integration (Experimental)<a href="#md:⚙️-angular-integration-experimental" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>To use Bandit Engine in an Angular project:</p>
+<a id="md:-angular-integration-experimental" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/settings.svg" width="18" align="center" alt="" /> Angular Integration (Experimental)<a href="#md:-angular-integration-experimental" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>To use Bandit Engine in an Angular project:</p>
 <ol>
 <li>Install the package:</li>
 </ol>
@@ -336,7 +410,7 @@ In Angular or Vue, you may need to wrap each usage with a <code>&lt;bandit-chat-
 <p>Note: You only need to define the elements you intend to use. Don't mount all components on the same page. Use <code>&lt;bandit-management&gt;</code> for secure admin routes and <code>&lt;bandit-modal&gt;</code> for contextual triggers.</p>
 <hr>
-<a id="md:⚙️-vuejs-integration-experimental" class="tsd-anchor"></a><h2 class="tsd-anchor-link">⚙️ Vue.js Integration (Experimental)<a href="#md:⚙️-vuejs-integration-experimental" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>To use Bandit Engine in a Vue 3 project:</p>
+<a id="md:-vuejs-integration-experimental" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/settings.svg" width="18" align="center" alt="" /> Vue.js Integration (Experimental)<a href="#md:-vuejs-integration-experimental" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>To use Bandit Engine in a Vue 3 project:</p>
 <ol>
 <li>Install the package:</li>
 </ol>
@@ -359,7 +433,7 @@ In Angular or Vue, you may need to wrap each usage with a <code>&lt;bandit-chat-
 <p><code>defineCustomElement</code> allows usage in Vue and Angular apps via native Web Components, making Bandit fully framework-agnostic.</p>
 </blockquote>
 <blockquote>
-<p>🔄 Similar to Angular, when using <code>&lt;Management /&gt;</code> or <code>&lt;ChatModal /&gt;</code>, wrap each one with a <code>&lt;bandit-chat-provider&gt;</code> to ensure proper context injection.</p>
+<p><img src="https://icons.burtson.ai/svg-accent/refresh.svg" width="18" align="center" alt="" /> Similar to Angular, when using <code>&lt;Management /&gt;</code> or <code>&lt;ChatModal /&gt;</code>, wrap each one with a <code>&lt;bandit-chat-provider&gt;</code> to ensure proper context injection.</p>
 </blockquote>
 <blockquote>
 <p>Make sure <code>packageSettings</code> is passed as a serialized JSON string when using with HTML-based custom elements.</p>
@@ -368,13 +442,13 @@ In Angular or Vue, you may need to wrap each usage with a <code>&lt;bandit-chat-
 <p>Note: Ensure React and ReactDOM are correctly bundled and available to your Vue project. You may need additional tooling or wrappers to handle lifecycle and rendering behavior between frameworks. Full Vue support is on our roadmap.</p>
 </blockquote>
 <hr>
-<a id="md:📦-custom-element-support" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📦 Custom Element Support<a href="#md:📦-custom-element-support" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>To use Bandit components (<code>Chat</code>, <code>Management</code>, <code>ChatModal</code>) in any modern JS framework (Angular, Vue, Svelte, etc.), you can register them as native custom elements:</p>
+<a id="md:-custom-element-support" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/package-build.svg" width="18" align="center" alt="" /> Custom Element Support<a href="#md:-custom-element-support" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>To use Bandit components (<code>Chat</code>, <code>Management</code>, <code>ChatModal</code>) in any modern JS framework (Angular, Vue, Svelte, etc.), you can register them as native custom elements:</p>
 <pre><code class="ts"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">defineCustomElement</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@burtson-labs/bandit-engine&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">BanditModal</span><span class="hl-1"> = </span><span class="hl-0">defineCustomElement</span><span class="hl-1">(</span><span class="hl-2">&#39;ChatModal&#39;</span><span class="hl-1">);</span><br/><span class="hl-5">customElements</span><span class="hl-1">.</span><span class="hl-0">define</span><span class="hl-1">(</span><span class="hl-2">&#39;bandit-modal&#39;</span><span class="hl-1">, </span><span class="hl-5">BanditModal</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <p>Wrap it in <code>&lt;bandit-chat-provider&gt;</code> and you’re ready to go. Ideal for environments where React isn’t used directly.</p>
 <blockquote>
-<p>🧠 <strong>Note for Non-React Users:</strong><br>
+<p><img src="https://icons.burtson.ai/svg-accent/memory-layers.svg" width="18" align="center" alt="" /> <strong>Note for Non-React Users:</strong><br>
 When using Bandit components as custom elements (e.g., in Angular, Vue, or static HTML), make sure the compiled custom elements script is loaded before usage. You can do this by importing or referencing it in your HTML or entry file. This ensures the custom elements are defined before being rendered.</p>
 </blockquote>
 <p>To create custom elements, you must import the React components and pass them to <code>defineCustomElement</code>. For example:</p>
@@ -382,7 +456,7 @@ When using Bandit components as custom elements (e.g., in Angular, Vue, or stati
 </code><button type="button">Copy</button></pre>
 <hr>
-<a id="md:📸-live-preview" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📸 Live Preview<a href="#md:📸-live-preview" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Here are some screenshots of Bandit Chat in action:</p>
+<a id="md:-live-preview" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/camera.svg" width="18" align="center" alt="" /> Live Preview<a href="#md:-live-preview" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Here are some screenshots of Bandit Chat in action:</p>
 <p><strong>Chat Demo – Your AI-powered UI</strong></p>
 <p align="center">
   <a href="https://cdn.burtson.ai/images/chat-demo.jpg" target="_blank" rel="noopener">
@@ -420,7 +494,7 @@ When using Bandit components as custom elements (e.g., in Angular, Vue, or stati
   </a>
 </p>
 <ol start="4">
-<li><strong>🌐 CDN-Based Config (Optional)</strong></li>
+<li><strong><img src="https://icons.burtson.ai/svg-accent/globe.svg" width="18" align="center" alt="" /> CDN-Based Config (Optional)</strong></li>
 </ol>
 <p>To streamline configuration, you can host your <code>config.json</code> (and related assets like model presets or branding) via your own CDN or edge cache.</p>
 <p>Update the <code>brandingConfigUrl</code> like this:</p>
@@ -429,10 +503,10 @@ When using Bandit components as custom elements (e.g., in Angular, Vue, or stati
 <p>This enables remote control of Bandit appearance, available models, and more — without redeploying your frontend.</p>
 <blockquote>
-<p>ℹ️ Note: All CDN assets such as logos, avatars, config, and workers are available at <code>https://cdn.burtson.ai/</code>. You may override these by hosting your own versions and pointing <code>packageSettings</code> to the appropriate URLs.</p>
+<p><img src="https://icons.burtson.ai/svg-accent/info.svg" width="16" align="center" alt="" /> Note: All CDN assets such as logos, avatars, config, and workers are available at <code>https://cdn.burtson.ai/</code>. You may override these by hosting your own versions and pointing <code>packageSettings</code> to the appropriate URLs.</p>
 </blockquote>
 <hr>
-<a id="md:⚙️-configuration-options" class="tsd-anchor"></a><h2 class="tsd-anchor-link">⚙️ Configuration Options<a href="#md:⚙️-configuration-options" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><ul>
+<a id="md:-configuration-options" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/settings.svg" width="18" align="center" alt="" /> Configuration Options<a href="#md:-configuration-options" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><ul>
 <li><code>defaultModel</code>: Primary chat model (string; required)</li>
 <li><code>fallbackModel</code>: Optional fallback model if the default is unavailable</li>
 <li><code>gatewayApiUrl</code>: Gateway API base URL for AI, TTS, STT, and MCP</li>
@@ -456,28 +530,30 @@ When using Bandit components as custom elements (e.g., in Angular, Vue, or stati
 <blockquote>
 <p>Quickstart note: the bundled Express gateway does not implement these upload/download routes; they currently return <code>501</code> until you connect real storage.</p>
 </blockquote>
-<a id="md:🤖-ai-provider-system" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🤖 AI Provider System<a href="#md:🤖-ai-provider-system" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine features a unified, gateway-based AI provider architecture that supports multiple AI services through a secure backend:</p>
+<a id="md:-ai-provider-system" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/agent.svg" width="18" align="center" alt="" /> AI Provider System<a href="#md:-ai-provider-system" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine features a unified, gateway-based AI provider architecture that supports multiple AI services through a secure backend:</p>
 <a id="md:supported-providers" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Supported Providers<a href="#md:supported-providers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
-<li><strong>🌟 Gateway Provider</strong> (Recommended): Routes all requests through your secure backend</li>
+<li><strong><img src="https://icons.burtson.ai/svg-accent/star.svg" width="18" align="center" alt="" /> Gateway Provider</strong> (Recommended): Routes all requests through your secure backend</li>
+<li><strong>Bandit AI</strong>: Bandit Core models served through the secure gateway</li>
 <li><strong>Ollama</strong>: Self-hosted models and Ollama-compatible endpoints</li>
 <li><strong>OpenAI</strong>: GPT models via OpenAI API</li>
 <li><strong>Azure OpenAI</strong>: Azure-hosted OpenAI models</li>
 <li><strong>Anthropic</strong>: Claude models via Anthropic API</li>
+<li><strong>xAI</strong>: Grok models via xAI API</li>
 </ul>
 <blockquote>
 <p>We do not support every AI provider yet. Let us know which services you rely on—community interest directly shapes the integration roadmap.</p>
 </blockquote>
 <a id="md:gateway-provider-recommended" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Gateway Provider (Recommended)<a href="#md:gateway-provider-recommended" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The gateway provider offers the most secure and scalable approach by routing all requests through your backend API:</p>
-<pre><code class="tsx"><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">chatPackageSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-8">// Gateway provider configuration</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1"> </span><span class="hl-4">as</span><span class="hl-1"> </span><span class="hl-6">const</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-gateway-api.example.com&quot;</span><span class="hl-1">, </span><br/><span class="hl-1">    </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;openai&quot;</span><span class="hl-1"> </span><span class="hl-8">// Backend provider: openai, azure-openai, anthropic, ollama</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-8">// ... other settings</span><br/><span class="hl-1">};</span>
+<pre><code class="tsx"><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">chatPackageSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-8">// Gateway provider configuration</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1"> </span><span class="hl-4">as</span><span class="hl-1"> </span><span class="hl-6">const</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-gateway-api.example.com&quot;</span><span class="hl-1">, </span><br/><span class="hl-1">    </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;bandit&quot;</span><span class="hl-1"> </span><span class="hl-8">// Backend provider: bandit, openai, azure-openai, anthropic, xai, ollama</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-8">// ... other settings</span><br/><span class="hl-1">};</span>
 </code><button type="button">Copy</button></pre>
 <p><strong>Benefits:</strong></p>
 <ul>
-<li>🔒 <strong>Security</strong>: API keys stay on your server</li>
-<li>📊 <strong>Monitoring</strong>: Request logging and usage analytics</li>
-<li>🚦 <strong>Rate Limiting</strong>: Built-in throttling and quotas</li>
-<li>🔄 <strong>Provider Switching</strong>: Change backends without frontend updates</li>
-<li>🛡️ <strong>Authentication</strong>: Unified auth across all AI services</li>
+<li><img src="https://icons.burtson.ai/svg-accent/lock.svg" width="18" align="center" alt="" /> <strong>Control</strong>: Your gateway owns credentials, routing, and policy enforcement</li>
+<li><img src="https://icons.burtson.ai/svg-accent/chart-bar.svg" width="18" align="center" alt="" /> <strong>Monitoring</strong>: Request logging and usage analytics</li>
+<li><img src="https://icons.burtson.ai/svg-accent/gauge.svg" width="18" align="center" alt="" /> <strong>Rate Limiting</strong>: Built-in throttling and quotas</li>
+<li><img src="https://icons.burtson.ai/svg-accent/refresh.svg" width="18" align="center" alt="" /> <strong>Provider Switching</strong>: Change backends without frontend updates</li>
+<li><img src="https://icons.burtson.ai/svg-accent/shield.svg" width="18" align="center" alt="" /> <strong>Authentication</strong>: Unified auth and request validation across services</li>
 </ul>
 <p><strong>Gateway Requirements:</strong><br>
 Your gateway API can be built with any technology (Node.js, Python, .NET, Java, etc.) as long as it implements:</p>
@@ -485,7 +561,7 @@ Your gateway API can be built with any technology (Node.js, Python, .NET, Java,
 <li><code>GET /api/health</code> — Health check endpoint that lists available providers.</li>
 <li><code>GET /api/models</code> and <code>GET /api/models/{provider}</code> — Model discovery for the management UI.</li>
 <li><code>POST /api/chat/completions</code> and <code>POST /api/generate</code> — Default OpenAI-style routes when no provider override is present.</li>
-<li><code>POST /api/{provider}/chat/completions</code> and <code>POST /api/{provider}/generate</code> — Provider-specific routing for <code>openai</code>, <code>azure-openai</code>, and <code>anthropic</code>.</li>
+<li><code>POST /api/{provider}/chat/completions</code> and <code>POST /api/{provider}/generate</code> — Provider-specific routing for <code>bandit</code>, <code>openai</code>, <code>azure-openai</code>, <code>anthropic</code>, and <code>xai</code>.</li>
 <li><code>POST /api/ollama/chat</code> and <code>POST /api/ollama/generate</code> — Native Ollama routes (no <code>/chat/completions</code> suffix).</li>
 </ul>
 <a id="md:legacy-direct-providers" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Legacy Direct Providers<a href="#md:legacy-direct-providers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Direct providers are still supported but marked as deprecated for production use:</p>
@@ -508,13 +584,13 @@ Your gateway API can be built with any technology (Node.js, Python, .NET, Java,
 </ul>
 <p><strong>Key Features:</strong></p>
 <ul>
-<li>🖼️ <strong>Universal Image Input</strong>: Drop, paste, or upload images directly in chat</li>
-<li>🔄 <strong>Provider-Specific Formatting</strong>: Automatic conversion to each provider's image format</li>
-<li>📱 <strong>Multi-Image Support</strong>: Send multiple images in a single message</li>
-<li>🎯 <strong>Vision Models</strong>: Seamless integration with multimodal AI models</li>
+<li><img src="https://icons.burtson.ai/svg-accent/image.svg" width="18" align="center" alt="" /> <strong>Universal Image Input</strong>: Drop, paste, or upload images directly in chat</li>
+<li><img src="https://icons.burtson.ai/svg-accent/refresh.svg" width="18" align="center" alt="" /> <strong>Provider-Specific Formatting</strong>: Automatic conversion to each provider's image format</li>
+<li><img src="https://icons.burtson.ai/svg-accent/smartphone.svg" width="18" align="center" alt="" /> <strong>Multi-Image Support</strong>: Send multiple images in a single message</li>
+<li><img src="https://icons.burtson.ai/svg-accent/crosshair.svg" width="18" align="center" alt="" /> <strong>Vision Models</strong>: Seamless integration with multimodal AI models</li>
 </ul>
 <p><strong>Usage Example:</strong></p>
-<pre><code class="tsx"><span class="hl-8">// Images are automatically handled by the chat interface</span><br/><span class="hl-8">// Users can:</span><br/><span class="hl-8">// 1. Drag &amp; drop images into the chat input</span><br/><span class="hl-8">// 2. Paste images from clipboard (Ctrl+V / Cmd+V)  </span><br/><span class="hl-8">// 3. Use the attach button to select image files</span><br/><span class="hl-8">// 4. Ask questions about the images naturally</span><br/><br/><span class="hl-8">// The gateway provider automatically formats images correctly:</span><br/><span class="hl-8">// - Ollama: base64 arrays in message.images</span><br/><span class="hl-8">// - OpenAI/Azure/Anthropic: structured content with image_url objects</span>
+<pre><code class="tsx"><span class="hl-8">// Images are automatically handled by the chat interface</span><br/><span class="hl-8">// Users can:</span><br/><span class="hl-8">// 1. Drag &amp; drop images into the chat input</span><br/><span class="hl-8">// 2. Paste images from clipboard (Ctrl+V / Cmd+V)  </span><br/><span class="hl-8">// 3. Use the attach button to select image files</span><br/><span class="hl-8">// 4. Ask questions about the images naturally</span><br/><br/><span class="hl-8">// The gateway provider automatically formats images correctly:</span><br/><span class="hl-8">// - Ollama: base64 arrays in message.images</span><br/><span class="hl-8">// - OpenAI/Azure/xAI/Anthropic: structured content with image_url objects</span>
 </code><button type="button">Copy</button></pre>
 <p><strong>Backend Requirements:</strong>
@@ -526,7 +602,7 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <pre><code class="tsx"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">useAIProvider</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@burtson-labs/bandit-engine&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">MyComponent</span><span class="hl-1">() {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> { </span><span class="hl-7">generateResponse</span><span class="hl-1">, </span><span class="hl-7">isLoading</span><span class="hl-1"> } = </span><span class="hl-0">useAIProvider</span><span class="hl-1">();</span><br/><span class="hl-1">  </span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-0">handleChat</span><span class="hl-1"> = </span><span class="hl-6">async</span><span class="hl-1"> (</span><span class="hl-5">message</span><span class="hl-1">: </span><span class="hl-10">string</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">response</span><span class="hl-1"> = </span><span class="hl-4">await</span><span class="hl-1"> </span><span class="hl-0">generateResponse</span><span class="hl-1">(</span><span class="hl-5">message</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-5">response</span><span class="hl-1">);</span><br/><span class="hl-1">  };</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
-<a id="md:🔧-model-context-protocol-mcp-integration" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🔧 Model Context Protocol (MCP) Integration<a href="#md:🔧-model-context-protocol-mcp-integration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine now supports <strong>Model Context Protocol (MCP)</strong> for extending AI capabilities with external tools and services:</p>
+<a id="md:-model-context-protocol-mcp-integration" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/wrench.svg" width="18" align="center" alt="" /> Model Context Protocol (MCP) Integration<a href="#md:-model-context-protocol-mcp-integration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine now supports <strong>Model Context Protocol (MCP)</strong> for extending AI capabilities with external tools and services:</p>
 <a id="md:mcp-features" class="tsd-anchor"></a><h3 class="tsd-anchor-link">MCP Features<a href="#md:mcp-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
 <li><strong>Tool Integration</strong>: Connect external APIs and services to your AI conversations</li>
 <li><strong>Dynamic Tool Discovery</strong>: Automatically detect and configure available MCP tools</li>
@@ -546,7 +622,7 @@ Your gateway API should accept images in the standardized format sent by the Ban
 </code><button type="button">Copy</button></pre>
 <hr>
-<a id="md:🎛️-feature-flags--subscription-tiers" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🎛️ Feature Flags &amp; Subscription Tiers<a href="#md:🎛️-feature-flags--subscription-tiers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine includes a comprehensive <strong>tier-based feature flag system</strong> that enables subscription-based access control and feature gating:</p>
+<a id="md:-feature-flags--subscription-tiers" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/sliders.svg" width="18" align="center" alt="" /> Feature Flags &amp; Subscription Tiers<a href="#md:-feature-flags--subscription-tiers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine includes a comprehensive <strong>tier-based feature flag system</strong> that enables subscription-based access control and feature gating:</p>
 <a id="md:subscription-tiers" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Subscription Tiers<a href="#md:subscription-tiers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The engine supports multiple subscription tiers with different feature access levels:</p>
 <ul>
 <li><strong>Basic</strong>: Core chat functionality with limitations</li>
@@ -575,75 +651,75 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <tbody>
 <tr>
 <td><strong>Core Chat</strong></td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>Text-to-Speech</strong></td>
-<td>❌</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>Speech-to-Text</strong></td>
-<td>❌</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>Document Upload</strong></td>
-<td>❌</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
-<td>✅</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>Model Management</strong></td>
-<td>❌</td>
-<td>❌</td>
-<td>✅</td>
-<td>✅</td>
-<td>❌</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>Admin Dashboard</strong></td>
-<td>❌</td>
-<td>❌</td>
-<td>✅</td>
-<td>✅</td>
-<td>❌</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>API Access</strong></td>
-<td>❌</td>
-<td>❌</td>
-<td>✅</td>
-<td>✅</td>
-<td>❌</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>Team Collaboration</strong></td>
-<td>❌</td>
-<td>❌</td>
-<td>❌</td>
-<td>✅</td>
-<td>❌</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 <tr>
 <td><strong>Custom Branding</strong></td>
-<td>❌</td>
-<td>❌</td>
-<td>❌</td>
-<td>✅</td>
-<td>❌</td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /></td>
+<td><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /></td>
 </tr>
 </tbody>
 </table>
@@ -675,16 +751,16 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <p>This feature flag system enables you to build sophisticated subscription-based AI products with fine-grained access control and seamless upgrade flows.</p>
 <hr>
-<a id="md:🐛-debug-logger" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🐛 Debug Logger<a href="#md:🐛-debug-logger" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine exports a debug logger for consistent logging across your application:</p>
+<a id="md:-debug-logger" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/bug.svg" width="18" align="center" alt="" /> Debug Logger<a href="#md:-debug-logger" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine exports a debug logger for consistent logging across your application:</p>
 <pre><code class="tsx"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">debugLogger</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@burtson-labs/bandit-engine&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// Use instead of console.log/warn/error</span><br/><span class="hl-5">debugLogger</span><span class="hl-1">.</span><span class="hl-0">info</span><span class="hl-1">(</span><span class="hl-2">&#39;Chat message sent&#39;</span><span class="hl-1">);</span><br/><span class="hl-5">debugLogger</span><span class="hl-1">.</span><span class="hl-0">warn</span><span class="hl-1">(</span><span class="hl-2">&#39;Fallback model used&#39;</span><span class="hl-1">);</span><br/><span class="hl-5">debugLogger</span><span class="hl-1">.</span><span class="hl-0">error</span><span class="hl-1">(</span><span class="hl-2">&#39;Failed to connect to AI service&#39;</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
-<a id="md:🔒-security-best-practices" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🔒 Security Best Practices<a href="#md:🔒-security-best-practices" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p><strong>⚠️ Important Security Notice:</strong></p>
+<a id="md:-security-best-practices" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/lock.svg" width="18" align="center" alt="" /> Security Best Practices<a href="#md:-security-best-practices" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p><strong><img src="https://icons.burtson.ai/svg-accent/alert-triangle.svg" width="16" align="center" alt="" /> Important Security Notice:</strong></p>
 <p>While Bandit Engine supports direct API key configuration for development and testing, <strong>we strongly recommend against using API keys directly in frontend applications</strong> for production environments.</p>
 <a id="md:recommended-architecture" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Recommended Architecture<a href="#md:recommended-architecture" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ol>
 <li><strong>Use an API Gateway/Wrapper</strong>: Deploy the OllamaGateway (soon to be renamed AiGateway) or similar backend service</li>
 <li><strong>Proxy AI Requests</strong>: Route all AI requests through your secure backend</li>
-<li><strong>Environment Isolation</strong>: Keep API keys and sensitive configuration on the server side</li>
+<li><strong>Environment Isolation</strong>: Keep credentials and sensitive configuration in backend services (not the browser bundle)</li>
 <li><strong>Authentication</strong>: Implement proper user authentication and request validation</li>
 </ol>
 <a id="md:gateway-setup" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Gateway Setup<a href="#md:gateway-setup" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The recommended approach is to use a gateway service that:</p>
@@ -695,11 +771,11 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <li>Manages provider switching and fallback logic</li>
 <li><strong>Technology-agnostic</strong>: Works with any backend implementation</li>
 </ul>
-<pre><code class="tsx"><span class="hl-8">// Recommended: Use gateway with unified API</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">chatPackageSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-api-gateway.com&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;openai&quot;</span><span class="hl-1"> </span><span class="hl-8">// or &quot;anthropic&quot;, &quot;azure-openai&quot;, &quot;ollama&quot;</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-5">gatewayApiUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-api-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-8">// Same URL for TTS/STT services</span><br/><span class="hl-1">  </span><span class="hl-8">// No API keys in frontend code</span><br/><span class="hl-1">  </span><span class="hl-8">// ... other settings</span><br/><span class="hl-1">};</span>
+<pre><code class="tsx"><span class="hl-8">// Recommended: Use gateway with unified API</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">chatPackageSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-api-gateway.com&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;bandit&quot;</span><span class="hl-1"> </span><span class="hl-8">// or &quot;openai&quot;, &quot;anthropic&quot;, &quot;azure-openai&quot;, &quot;xai&quot;, &quot;ollama&quot;</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-5">gatewayApiUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-api-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-8">// Same URL for TTS/STT services</span><br/><span class="hl-1">  </span><span class="hl-8">// No API keys in frontend code</span><br/><span class="hl-1">  </span><span class="hl-8">// ... other settings</span><br/><span class="hl-1">};</span>
 </code><button type="button">Copy</button></pre>
-<a id="md:legacy-configuration-deprecated" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Legacy Configuration (Deprecated)<a href="#md:legacy-configuration-deprecated" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>⚠️ <strong>Legacy TTS/STT URLs are deprecated.</strong> Use the unified <code>gatewayApiUrl</code> instead:</p>
-<pre><code class="tsx"><span class="hl-8">// ❌ Deprecated (still works but not recommended)</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">oldSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">ttsUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;/api/tts&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">sttUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;/api/stt/transcribe&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">ollamaUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;http://localhost:11434&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-8">// ✅ Recommended (unified gateway approach)</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">newSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> { </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1">, </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;openai&quot;</span><span class="hl-1"> },</span><br/><span class="hl-1">  </span><span class="hl-5">gatewayApiUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-8">// Handles TTS, STT, and MCP</span><br/><span class="hl-1">};</span>
+<a id="md:legacy-configuration-deprecated" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Legacy Configuration (Deprecated)<a href="#md:legacy-configuration-deprecated" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p><img src="https://icons.burtson.ai/svg-accent/alert-triangle.svg" width="16" align="center" alt="" /> <strong>Legacy TTS/STT URLs are deprecated.</strong> Use the unified <code>gatewayApiUrl</code> instead:</p>
+<pre><code class="tsx"><span class="hl-8">// ❌ Deprecated (still works but not recommended)</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">oldSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">ttsUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;/api/tts&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">sttUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;/api/stt/transcribe&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">ollamaUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;http://localhost:11434&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">};</span><br/><br/><span class="hl-8">// ✅ Recommended (unified gateway approach)</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">newSettings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">aiProvider:</span><span class="hl-1"> { </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&quot;gateway&quot;</span><span class="hl-1">, </span><span class="hl-5">gatewayUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&quot;bandit&quot;</span><span class="hl-1"> },</span><br/><span class="hl-1">  </span><span class="hl-5">gatewayApiUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-gateway.com&quot;</span><span class="hl-1">, </span><span class="hl-8">// Handles TTS, STT, and MCP</span><br/><span class="hl-1">};</span>
 </code><button type="button">Copy</button></pre>
 <a id="md:development-vs-production" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Development vs Production<a href="#md:development-vs-production" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
@@ -755,7 +831,7 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <li><strong>PDF Worker</strong>: For document embedding features, the engine uses the PDF parsing worker from <code>https://cdn.burtson.ai/scripts/pdf.worker.js</code></li>
 <li><strong>CDN Resources</strong>: Default avatars, logos, and configurations load from <code>https://cdn.burtson.ai/</code> if not overridden locally</li>
 </ul>
-<a id="md:💡-vision--roadmap" class="tsd-anchor"></a><h2 class="tsd-anchor-link">💡 Vision &amp; Roadmap<a href="#md:💡-vision--roadmap" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine isn't just a component – it's a foundation. Coming soon:</p>
+<a id="md:-vision--roadmap" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/lightbulb.svg" width="18" align="center" alt="" /> Vision &amp; Roadmap<a href="#md:-vision--roadmap" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>Bandit Engine isn't just a component – it's a foundation. Coming soon:</p>
 <ul>
 <li>Multi-modal input: image, voice, document uploads</li>
 <li>Agentic flow support with visualized cards and suggestions</li>
@@ -765,7 +841,7 @@ Your gateway API should accept images in the standardized format sent by the Ban
 </ul>
 <p>We’re building this to be the interface layer of your AI-first products. Own the UX. Own the brand. Own the experience.</p>
 <hr>
-<a id="md:📌-migration-guide" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📌 Migration Guide<a href="#md:📌-migration-guide" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:from-legacy-ttsstt-urls-to-gateway-api" class="tsd-anchor"></a><h3 class="tsd-anchor-link">From Legacy TTS/STT URLs to Gateway API<a href="#md:from-legacy-ttsstt-urls-to-gateway-api" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>If you're currently using separate <code>ttsUrl</code> and <code>sttUrl</code> settings, migrate to the unified gateway approach:</p>
+<a id="md:-migration-guide" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/pin.svg" width="18" align="center" alt="" /> Migration Guide<a href="#md:-migration-guide" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:from-legacy-ttsstt-urls-to-gateway-api" class="tsd-anchor"></a><h3 class="tsd-anchor-link">From Legacy TTS/STT URLs to Gateway API<a href="#md:from-legacy-ttsstt-urls-to-gateway-api" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>If you're currently using separate <code>ttsUrl</code> and <code>sttUrl</code> settings, migrate to the unified gateway approach:</p>
 <p><strong>Before (Deprecated):</strong></p>
 <pre><code class="tsx"><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">settings</span><span class="hl-1"> = {</span><br/><span class="hl-1">  </span><span class="hl-5">ttsUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-tts-service.com/api/tts&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">sttUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-stt-service.com/api/stt/transcribe&quot;</span><span class="hl-1">, </span><br/><span class="hl-1">  </span><span class="hl-5">ollamaUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://your-ollama.com&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">};</span>
 </code><button type="button">Copy</button></pre>
@@ -776,21 +852,21 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <p>The new approach provides:</p>
 <ul>
-<li>✅ <strong>Unified API</strong>: One endpoint for all services</li>
-<li>✅ <strong>Better Security</strong>: Centralized authentication and rate limiting</li>
-<li>✅ <strong>Technology Flexibility</strong>: Use any backend implementation</li>
-<li>✅ <strong>Automatic Discovery</strong>: Real-time service availability detection</li>
+<li><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /> <strong>Unified API</strong>: One endpoint for all services</li>
+<li><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /> <strong>Better Security</strong>: Centralized authentication and rate limiting</li>
+<li><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /> <strong>Technology Flexibility</strong>: Use any backend implementation</li>
+<li><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /> <strong>Automatic Discovery</strong>: Real-time service availability detection</li>
 </ul>
 <hr>
-<a id="md:🛡️-license--protection" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🛡️ License &amp; Protection<a href="#md:🛡️-license--protection" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>This software is protected under the <strong>Business Source License (BUSL) 1.1</strong> by Burtson Labs LLC.</p>
-<a id="md:⚖️-license-summary" class="tsd-anchor"></a><h3 class="tsd-anchor-link">⚖️ License Summary<a href="#md:⚖️-license-summary" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
-<li>✅ <strong>Development &amp; Evaluation</strong>: Free for internal development, testing, and evaluation</li>
-<li>✅ <strong>Non-Commercial Use</strong>: Free for educational, research, and personal projects</li>
-<li>❌ <strong>Commercial Production</strong>: Requires commercial license for production deployment</li>
-<li>❌ <strong>Competitive Use</strong>: Cannot be used to create competing AI chat products</li>
-<li>❌ <strong>AI Training</strong>: Cannot be used as training data for AI models</li>
+<a id="md:-license--protection" class="tsd-anchor"></a><h2 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/shield.svg" width="18" align="center" alt="" /> License &amp; Protection<a href="#md:-license--protection" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>This software is protected under the <strong>Business Source License (BUSL) 1.1</strong> by Burtson Labs LLC.</p>
+<a id="md:-license-summary" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/scale.svg" width="18" align="center" alt="" /> License Summary<a href="#md:-license-summary" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ul>
+<li><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /> <strong>Development &amp; Evaluation</strong>: Free for internal development, testing, and evaluation</li>
+<li><img src="https://icons.burtson.ai/svg-accent/check-circle.svg" width="16" align="center" alt="" /> <strong>Non-Commercial Use</strong>: Free for educational, research, and personal projects</li>
+<li><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /> <strong>Commercial Production</strong>: Requires commercial license for production deployment</li>
+<li><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /> <strong>Competitive Use</strong>: Cannot be used to create competing AI chat products</li>
+<li><img src="https://icons.burtson.ai/svg-accent/x-circle.svg" width="16" align="center" alt="" /> <strong>AI Training</strong>: Cannot be used as training data for AI models</li>
 </ul>
-<a id="md:📋-usage-rights" class="tsd-anchor"></a><h3 class="tsd-anchor-link">📋 Usage Rights<a href="#md:📋-usage-rights" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p><strong>Permitted:</strong></p>
+<a id="md:-usage-rights" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/clipboard-list.svg" width="18" align="center" alt="" /> Usage Rights<a href="#md:-usage-rights" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p><strong>Permitted:</strong></p>
 <ul>
 <li>Internal development and testing</li>
 <li>Educational and research purposes</li>
@@ -804,15 +880,15 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <li>Using as training data for AI/ML models</li>
 <li>Removing or modifying license notices and watermarks</li>
 </ul>
-<a id="md:🔒-protection-features" class="tsd-anchor"></a><h3 class="tsd-anchor-link">🔒 Protection Features<a href="#md:🔒-protection-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>This codebase includes multiple protection layers:</p>
+<a id="md:-protection-features" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/lock.svg" width="18" align="center" alt="" /> Protection Features<a href="#md:-protection-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>This codebase includes multiple protection layers:</p>
 <ul>
 <li><strong>Embedded Watermarks</strong>: Visible and stealth fingerprints in all source files</li>
 <li><strong>Audit Trails</strong>: Usage tracking and compliance monitoring</li>
 <li><strong>License Validation</strong>: Runtime checks for compliance</li>
 <li><strong>Honey Pot Files</strong>: Trap files that trigger license violations when accessed</li>
 </ul>
-<p><strong>⚠️ Warning</strong>: Removing, modifying, or bypassing these protection mechanisms constitutes a license violation and may result in immediate license termination.</p>
-<a id="md:💼-commercial-licensing" class="tsd-anchor"></a><h3 class="tsd-anchor-link">💼 Commercial Licensing<a href="#md:💼-commercial-licensing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p><strong>Production License</strong>: Required for commercial deployment</p>
+<p><strong><img src="https://icons.burtson.ai/svg-accent/alert-triangle.svg" width="16" align="center" alt="" /> Warning</strong>: Removing, modifying, or bypassing these protection mechanisms constitutes a license violation and may result in immediate license termination.</p>
+<a id="md:-commercial-licensing" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/briefcase.svg" width="18" align="center" alt="" /> Commercial Licensing<a href="#md:-commercial-licensing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p><strong>Production License</strong>: Required for commercial deployment</p>
 <ul>
 <li>Full production rights</li>
 <li>Priority support and maintenance</li>
@@ -825,28 +901,16 @@ Your gateway API should accept images in the standardized format sent by the Ban
 <li><strong>Website</strong>: <a href="https://burtson.ai/license" target="_blank" class="external">https://burtson.ai/license</a></li>
 <li><strong>Sales</strong>: <a href="mailto:sales@burtson.ai">sales@burtson.ai</a></li>
 </ul>
-<a id="md:👨💻-for-contributors--developers" class="tsd-anchor"></a><h3 class="tsd-anchor-link">👨‍💻 For Contributors &amp; Developers<a href="#md:👨💻-for-contributors--developers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Before contributing or publishing a new Pull Request, run the available validation scripts:</p>
-<pre><code class="bash"><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">lint</span><span class="hl-1">               </span><span class="hl-8"># Static analysis for the src tree</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">test</span><span class="hl-1">               </span><span class="hl-8"># Vitest suite</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">build</span><span class="hl-1">              </span><span class="hl-8"># Generate the dist bundle with tsup</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">validate-protection</span><span class="hl-1"> </span><span class="hl-8"># Ensure license headers and fingerprints are intact</span>
+<a id="md:-for-contributors--developers" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><img src="https://icons.burtson.ai/svg-accent/code.svg" width="18" align="center" alt="" /> For Contributors &amp; Developers<a href="#md:-for-contributors--developers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Before contributing or publishing a new Pull Request, run the available validation scripts:</p>
+<pre><code class="bash"><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">lint</span><span class="hl-1">               </span><span class="hl-8"># Static analysis for the src tree</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">test</span><span class="hl-1">               </span><span class="hl-8"># Vitest suite</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">build</span><span class="hl-1">              </span><span class="hl-8"># Generate the dist bundle with tsup</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">validate-protection</span><span class="hl-1"> </span><span class="hl-8"># Check source notice presence</span>
 </code><button type="button">Copy</button></pre>
-<p><strong>Developer Resources:</strong></p>
+<p><strong>Developer resources:</strong></p>
 <ul>
-<li><strong><a href="media/PROTECTION-README.md">PROTECTION-README.md</a></strong> - Quick protection system guide</li>
-<li><strong><a href="media/PRE-PUSH-CHECKLIST.md">PRE-PUSH-CHECKLIST.md</a></strong> - Complete workflow documentation</li>
-<li><strong><a href="media/PROTECTION-NOTICE.md">PROTECTION-NOTICE.md</a></strong> - Legal notices and compliance requirements</li>
-<li><strong><a href="media/LICENSE">LICENSE</a></strong> - Full BUSL 1.1 license text</li>
+<li><a href="media/PRE-PUSH-CHECKLIST.md">PRE-PUSH-CHECKLIST.md</a> — build, test, and package checks.</li>
+<li><a href="media/PROTECTION-NOTICE.md">PROTECTION-NOTICE.md</a> — source notices and deprecated compatibility helpers.</li>
+<li><a href="media/LICENSE">LICENSE</a> — the repository's current license terms.</li>
 </ul>
-<a id="md:📝-license-compliance" class="tsd-anchor"></a><h3 class="tsd-anchor-link">📝 License Compliance<a href="#md:📝-license-compliance" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>All source files must include proper license headers and watermarks. The protection system automatically:</p>
-<ul>
-<li>Adds license headers to new files</li>
-<li>Validates compliance on every build</li>
-<li>Tracks usage and modifications</li>
-<li>Prevents unauthorized distribution</li>
-</ul>
-<p><strong>Quick Commands:</strong></p>
-<pre><code class="bash"><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">protect</span><span class="hl-1">             </span><span class="hl-8"># Apply protection to new files</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">validate-protection</span><span class="hl-1"> </span><span class="hl-8"># Check for license violations  </span>
-</code><button type="button">Copy</button></pre>
-<hr>
-<p><strong>© 2025 Burtson Labs LLC. All rights reserved.</strong></p>
-</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="assets/icons.svg#icon-chevronDown"></use></svg>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#md:bandit-engine-⚡"><span>Bandit <wbr/>Engine ⚡</span></a><ul><li><a href="#md:features"><span>Features</span></a></li><li><a href="#md:quick-links"><span>Quick <wbr/>Links</span></a></li><li><a href="#md:quick-start"><span>Quick <wbr/>Start</span></a></li><li><ul><li><a href="#md:cli-scaffold"><span>CLI <wbr/>Scaffold</span></a></li><li><a href="#md:cli-options"><span>CLI <wbr/>Options</span></a></li><li><a href="#md:playground-password-free-preview"><span>Playground (<wbr/>Password-<wbr/>Free <wbr/>Preview)</span></a></li></ul></li><li><a href="#md:🛠️-getting-started--plug--play-ai"><span>🛠️ <wbr/>Getting <wbr/>Started – <wbr/>Plug &amp; <wbr/>Play AI</span></a></li><li><ul><li><a href="#md:🔄-quick-provider-setup"><span>🔄 <wbr/>Quick <wbr/>Provider <wbr/>Setup</span></a></li><li><a href="#md:ollama-env-setup"><span>Ollama .env <wbr/>Setup</span></a></li><li><a href="#md:🎤-voice-services-ttsstt"><span>🎤 <wbr/>Voice <wbr/>Services (TTS/STT)</span></a></li></ul></li><li><a href="#md:🧩-consuming-the-components"><span>🧩 <wbr/>Consuming the <wbr/>Components</span></a></li><li><ul><li><a href="#md:🛠️-utility-functions--hooks"><span>🛠️ <wbr/>Utility <wbr/>Functions &amp; <wbr/>Hooks</span></a></li><li><ul><li><a href="#md:debug-logger"><span>Debug <wbr/>Logger</span></a></li><li><a href="#md:ai-prompt-utilities"><span>AI <wbr/>Prompt <wbr/>Utilities</span></a></li><li><a href="#md:datetime-context"><span>Date/<wbr/>Time <wbr/>Context</span></a></li></ul></li></ul></li><li><a href="#md:🎛️-chat-control-center-chatmodal-feature"><span>🎛️ <wbr/>Chat <wbr/>Control <wbr/>Center (<wbr/>Chat<wbr/>Modal <wbr/>Feature)</span></a></li><li><ul><li><a href="#md:🔧-core-features"><span>🔧 <wbr/>Core <wbr/>Features</span></a></li><li><a href="#md:🎤-voice-integration"><span>🎤 <wbr/>Voice <wbr/>Integration</span></a></li><li><a href="#md:🔄-context-switching"><span>🔄 <wbr/>Context <wbr/>Switching</span></a></li><li><a href="#md:💾-memory-features"><span>💾 <wbr/>Memory <wbr/>Features</span></a></li><li><a href="#md:📧-feedback-system"><span>📧 <wbr/>Feedback <wbr/>System</span></a></li></ul></li><li><a href="#md:⚙️-angular-integration-experimental"><span>⚙️ <wbr/>Angular <wbr/>Integration (<wbr/>Experimental)</span></a></li><li><a href="#md:⚙️-vuejs-integration-experimental"><span>⚙️ <wbr/>Vue.js <wbr/>Integration (<wbr/>Experimental)</span></a></li><li><a href="#md:📦-custom-element-support"><span>📦 <wbr/>Custom <wbr/>Element <wbr/>Support</span></a></li><li><a href="#md:📸-live-preview"><span>📸 <wbr/>Live <wbr/>Preview</span></a></li><li><a href="#md:⚙️-configuration-options"><span>⚙️ <wbr/>Configuration <wbr/>Options</span></a></li><li><ul><li><a href="#md:file-storage-api-contract"><span>File <wbr/>Storage API <wbr/>Contract</span></a></li></ul></li><li><a href="#md:🤖-ai-provider-system"><span>🤖 AI <wbr/>Provider <wbr/>System</span></a></li><li><ul><li><a href="#md:supported-providers"><span>Supported <wbr/>Providers</span></a></li><li><a href="#md:gateway-provider-recommended"><span>Gateway <wbr/>Provider (<wbr/>Recommended)</span></a></li><li><a href="#md:legacy-direct-providers"><span>Legacy <wbr/>Direct <wbr/>Providers</span></a></li><li><a href="#md:migration-to-gateway"><span>Migration to <wbr/>Gateway</span></a></li><li><a href="#md:imagemultimodal-support"><span>Image/<wbr/>Multimodal <wbr/>Support</span></a></li><li><a href="#md:using-the-ai-provider"><span>Using the AI <wbr/>Provider</span></a></li></ul></li><li><a href="#md:🔧-model-context-protocol-mcp-integration"><span>🔧 <wbr/>Model <wbr/>Context <wbr/>Protocol (MCP) <wbr/>Integration</span></a></li><li><ul><li><a href="#md:mcp-features"><span>MCP <wbr/>Features</span></a></li><li><a href="#md:using-mcp-tools"><span>Using MCP <wbr/>Tools</span></a></li><li><a href="#md:mcp-tool-configuration"><span>MCP <wbr/>Tool <wbr/>Configuration</span></a></li><li><a href="#md:mcp-service-api"><span>MCP <wbr/>Service API</span></a></li></ul></li><li><a href="#md:🎛️-feature-flags--subscription-tiers"><span>🎛️ <wbr/>Feature <wbr/>Flags &amp; <wbr/>Subscription <wbr/>Tiers</span></a></li><li><ul><li><a href="#md:subscription-tiers"><span>Subscription <wbr/>Tiers</span></a></li><li><a href="#md:feature-flag-configuration"><span>Feature <wbr/>Flag <wbr/>Configuration</span></a></li><li><a href="#md:tier-based-feature-matrix"><span>Tier-<wbr/>Based <wbr/>Feature <wbr/>Matrix</span></a></li><li><a href="#md:jwt-based-authentication"><span>JWT-<wbr/>Based <wbr/>Authentication</span></a></li><li><a href="#md:using-feature-flags-in-components"><span>Using <wbr/>Feature <wbr/>Flags in <wbr/>Components</span></a></li><li><a href="#md:subscription-state-management"><span>Subscription <wbr/>State <wbr/>Management</span></a></li><li><a href="#md:feature-restrictions--upgrade-prompts"><span>Feature <wbr/>Restrictions &amp; <wbr/>Upgrade <wbr/>Prompts</span></a></li><li><a href="#md:development--testing"><span>Development &amp; <wbr/>Testing</span></a></li><li><a href="#md:backend-integration"><span>Backend <wbr/>Integration</span></a></li></ul></li><li><a href="#md:🐛-debug-logger"><span>🐛 <wbr/>Debug <wbr/>Logger</span></a></li><li><a href="#md:🔒-security-best-practices"><span>🔒 <wbr/>Security <wbr/>Best <wbr/>Practices</span></a></li><li><ul><li><a href="#md:recommended-architecture"><span>Recommended <wbr/>Architecture</span></a></li><li><a href="#md:gateway-setup"><span>Gateway <wbr/>Setup</span></a></li><li><a href="#md:legacy-configuration-deprecated"><span>Legacy <wbr/>Configuration (<wbr/>Deprecated)</span></a></li><li><a href="#md:development-vs-production"><span>Development vs <wbr/>Production</span></a></li></ul></li><li><a href="#md:requirements"><span>Requirements</span></a></li><li><ul><li><a href="#md:gateway-api-services"><span>Gateway API <wbr/>Services</span></a></li><li><a href="#md:technology-agnostic-implementation"><span>Technology-<wbr/>Agnostic <wbr/>Implementation</span></a></li><li><a href="#md:additional-resources"><span>Additional <wbr/>Resources</span></a></li></ul></li><li><a href="#md:💡-vision--roadmap"><span>💡 <wbr/>Vision &amp; <wbr/>Roadmap</span></a></li><li><a href="#md:📌-migration-guide"><span>📌 <wbr/>Migration <wbr/>Guide</span></a></li><li><ul><li><a href="#md:from-legacy-ttsstt-urls-to-gateway-api"><span>From <wbr/>Legacy TTS/STT URLs to <wbr/>Gateway API</span></a></li></ul></li><li><a href="#md:🛡️-license--protection"><span>🛡️ <wbr/>License &amp; <wbr/>Protection</span></a></li><li><ul><li><a href="#md:⚖️-license-summary"><span>⚖️ <wbr/>License <wbr/>Summary</span></a></li><li><a href="#md:📋-usage-rights"><span>📋 <wbr/>Usage <wbr/>Rights</span></a></li><li><a href="#md:🔒-protection-features"><span>🔒 <wbr/>Protection <wbr/>Features</span></a></li><li><a href="#md:💼-commercial-licensing"><span>💼 <wbr/>Commercial <wbr/>Licensing</span></a></li><li><a href="#md:👨💻-for-contributors--developers"><span>👨‍💻 <wbr/>For <wbr/>Contributors &amp; <wbr/>Developers</span></a></li><li><a href="#md:📝-license-compliance"><span>📝 <wbr/>License <wbr/>Compliance</span></a></li></ul></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="modules.html" class="current"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="assets/icons.svg#icon-1"></use></svg><span>@burtson-labs/bandit-engine</span></a><ul class="tsd-small-nested-navigation" id="tsd-nav-container" data-base="."><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+<p>Source notices are attribution, not telemetry or enforcement. They do not track usage or prevent distribution. The legacy helpers with integrity and validation names are deprecated and must not be used as security controls.</p>
+<p>© 2025 Burtson Labs LLC.</p>
+</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="assets/icons.svg#icon-chevronDown"></use></svg>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#md:bandit-engine-"><span>Bandit <wbr/>Engine &lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/zap.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt;</span></a><ul><li><a href="#md:features"><span>Features</span></a></li><li><a href="#md:bandit-package-ecosystem"><span>Bandit package ecosystem</span></a></li><li><a href="#md:quick-links"><span>Quick <wbr/>Links</span></a></li><li><a href="#md:quick-start"><span>Quick <wbr/>Start</span></a></li><li><ul><li><a href="#md:cli-scaffold"><span>CLI <wbr/>Scaffold</span></a></li><li><a href="#md:cli-options"><span>CLI <wbr/>Options</span></a></li><li><a href="#md:playground-password-free-preview"><span>Playground (<wbr/>Password-<wbr/>Free <wbr/>Preview)</span></a></li></ul></li><li><a href="#md:-getting-started--plug--play-ai"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/wrench.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Getting <wbr/>Started – <wbr/>Plug &amp; <wbr/>Play AI</span></a></li><li><ul><li><a href="#md:-quick-provider-setup"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/refresh.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Quick <wbr/>Provider <wbr/>Setup</span></a></li><li><a href="#md:ollama-env-setup"><span>Ollama .env <wbr/>Setup</span></a></li><li><a href="#md:-voice-services-ttsstt"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/mic.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Voice <wbr/>Services (TTS/STT)</span></a></li></ul></li><li><a href="#md:-compatibility"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/badge-<wbr/>check.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Compatibility</span></a></li><li><ul><li><a href="#md:sending-and-attachments"><span>Sending and attachments</span></a></li></ul></li><li><a href="#md:-consuming-the-components"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/extension-<wbr/>slot.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Consuming the <wbr/>Components</span></a></li><li><ul><li><a href="#md:-utility-functions--hooks"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/wrench.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Utility <wbr/>Functions &amp; <wbr/>Hooks</span></a></li><li><ul><li><a href="#md:debug-logger"><span>Debug <wbr/>Logger</span></a></li><li><a href="#md:ai-prompt-utilities"><span>AI <wbr/>Prompt <wbr/>Utilities</span></a></li><li><a href="#md:datetime-context"><span>Date/<wbr/>Time <wbr/>Context</span></a></li></ul></li></ul></li><li><a href="#md:-chat-control-center-chatmodal-feature"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/sliders.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Chat <wbr/>Control <wbr/>Center (<wbr/>Chat<wbr/>Modal <wbr/>Feature)</span></a></li><li><ul><li><a href="#md:-core-features"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/wrench.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Core <wbr/>Features</span></a></li><li><a href="#md:-voice-integration"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/mic.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Voice <wbr/>Integration</span></a></li><li><a href="#md:-context-switching"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/refresh.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Context <wbr/>Switching</span></a></li><li><a href="#md:-memory-features"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/save.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Memory <wbr/>Features</span></a></li><li><a href="#md:-feedback-system"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/mail.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Feedback <wbr/>System</span></a></li></ul></li><li><a href="#md:-angular-integration-experimental"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/settings.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Angular <wbr/>Integration (<wbr/>Experimental)</span></a></li><li><a href="#md:-vuejs-integration-experimental"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/settings.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Vue.js <wbr/>Integration (<wbr/>Experimental)</span></a></li><li><a href="#md:-custom-element-support"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/package-<wbr/>build.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Custom <wbr/>Element <wbr/>Support</span></a></li><li><a href="#md:-live-preview"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/camera.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Live <wbr/>Preview</span></a></li><li><a href="#md:-configuration-options"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/settings.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Configuration <wbr/>Options</span></a></li><li><ul><li><a href="#md:file-storage-api-contract"><span>File <wbr/>Storage API <wbr/>Contract</span></a></li></ul></li><li><a href="#md:-ai-provider-system"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/agent.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; AI <wbr/>Provider <wbr/>System</span></a></li><li><ul><li><a href="#md:supported-providers"><span>Supported <wbr/>Providers</span></a></li><li><a href="#md:gateway-provider-recommended"><span>Gateway <wbr/>Provider (<wbr/>Recommended)</span></a></li><li><a href="#md:legacy-direct-providers"><span>Legacy <wbr/>Direct <wbr/>Providers</span></a></li><li><a href="#md:migration-to-gateway"><span>Migration to <wbr/>Gateway</span></a></li><li><a href="#md:imagemultimodal-support"><span>Image/<wbr/>Multimodal <wbr/>Support</span></a></li><li><a href="#md:using-the-ai-provider"><span>Using the AI <wbr/>Provider</span></a></li></ul></li><li><a href="#md:-model-context-protocol-mcp-integration"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/wrench.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Model <wbr/>Context <wbr/>Protocol (MCP) <wbr/>Integration</span></a></li><li><ul><li><a href="#md:mcp-features"><span>MCP <wbr/>Features</span></a></li><li><a href="#md:using-mcp-tools"><span>Using MCP <wbr/>Tools</span></a></li><li><a href="#md:mcp-tool-configuration"><span>MCP <wbr/>Tool <wbr/>Configuration</span></a></li><li><a href="#md:mcp-service-api"><span>MCP <wbr/>Service API</span></a></li></ul></li><li><a href="#md:-feature-flags--subscription-tiers"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/sliders.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Feature <wbr/>Flags &amp; <wbr/>Subscription <wbr/>Tiers</span></a></li><li><ul><li><a href="#md:subscription-tiers"><span>Subscription <wbr/>Tiers</span></a></li><li><a href="#md:feature-flag-configuration"><span>Feature <wbr/>Flag <wbr/>Configuration</span></a></li><li><a href="#md:tier-based-feature-matrix"><span>Tier-<wbr/>Based <wbr/>Feature <wbr/>Matrix</span></a></li><li><a href="#md:jwt-based-authentication"><span>JWT-<wbr/>Based <wbr/>Authentication</span></a></li><li><a href="#md:using-feature-flags-in-components"><span>Using <wbr/>Feature <wbr/>Flags in <wbr/>Components</span></a></li><li><a href="#md:subscription-state-management"><span>Subscription <wbr/>State <wbr/>Management</span></a></li><li><a href="#md:feature-restrictions--upgrade-prompts"><span>Feature <wbr/>Restrictions &amp; <wbr/>Upgrade <wbr/>Prompts</span></a></li><li><a href="#md:development--testing"><span>Development &amp; <wbr/>Testing</span></a></li><li><a href="#md:backend-integration"><span>Backend <wbr/>Integration</span></a></li></ul></li><li><a href="#md:-debug-logger"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/bug.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Debug <wbr/>Logger</span></a></li><li><a href="#md:-security-best-practices"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/lock.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Security <wbr/>Best <wbr/>Practices</span></a></li><li><ul><li><a href="#md:recommended-architecture"><span>Recommended <wbr/>Architecture</span></a></li><li><a href="#md:gateway-setup"><span>Gateway <wbr/>Setup</span></a></li><li><a href="#md:legacy-configuration-deprecated"><span>Legacy <wbr/>Configuration (<wbr/>Deprecated)</span></a></li><li><a href="#md:development-vs-production"><span>Development vs <wbr/>Production</span></a></li></ul></li><li><a href="#md:requirements"><span>Requirements</span></a></li><li><ul><li><a href="#md:gateway-api-services"><span>Gateway API <wbr/>Services</span></a></li><li><a href="#md:technology-agnostic-implementation"><span>Technology-<wbr/>Agnostic <wbr/>Implementation</span></a></li><li><a href="#md:additional-resources"><span>Additional <wbr/>Resources</span></a></li></ul></li><li><a href="#md:-vision--roadmap"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/lightbulb.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Vision &amp; <wbr/>Roadmap</span></a></li><li><a href="#md:-migration-guide"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/pin.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Migration <wbr/>Guide</span></a></li><li><ul><li><a href="#md:from-legacy-ttsstt-urls-to-gateway-api"><span>From <wbr/>Legacy TTS/STT URLs to <wbr/>Gateway API</span></a></li></ul></li><li><a href="#md:-license--protection"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/shield.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>License &amp; <wbr/>Protection</span></a></li><li><ul><li><a href="#md:-license-summary"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/scale.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>License <wbr/>Summary</span></a></li><li><a href="#md:-usage-rights"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/clipboard-<wbr/>list.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Usage <wbr/>Rights</span></a></li><li><a href="#md:-protection-features"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/lock.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Protection <wbr/>Features</span></a></li><li><a href="#md:-commercial-licensing"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/briefcase.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>Commercial <wbr/>Licensing</span></a></li><li><a href="#md:-for-contributors--developers"><span>&lt;img src=&quot;https://icons.burtson.ai/svg-<wbr/>accent/code.svg&quot; width=&quot;18&quot; align=&quot;center&quot; alt=&quot;&quot; /&gt; <wbr/>For <wbr/>Contributors &amp; <wbr/>Developers</span></a></li></ul></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="modules.html" class="current"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="assets/icons.svg#icon-1"></use></svg><span>@burtson-labs/bandit-engine</span></a><ul class="tsd-small-nested-navigation" id="tsd-nav-container" data-base="."><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>