@burtson-labs/bandit-engine 2.0.39 → 2.0.41

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 (52) hide show
  1. package/README.md +14 -11
  2. package/dist/{aiProviderStore-XN7GCBHJ.mjs → aiProviderStore-UQI33C5E.mjs} +2 -2
  3. package/dist/{chat-5QJNWB7I.mjs → chat-T5ANWWYQ.mjs} +5 -5
  4. package/dist/chat-provider.js +571 -122
  5. package/dist/chat-provider.js.map +1 -1
  6. package/dist/chat-provider.mjs +4 -4
  7. package/dist/{chunk-3A2527TE.mjs → chunk-22EY3ZDC.mjs} +3 -3
  8. package/dist/{chunk-ECRNIAG6.mjs → chunk-3E57HLDV.mjs} +4 -4
  9. package/dist/{chunk-QU5S5QQP.mjs → chunk-54ZQ3FSN.mjs} +481 -77
  10. package/dist/chunk-54ZQ3FSN.mjs.map +1 -0
  11. package/dist/{chunk-JRCDANLN.mjs → chunk-A6OBEF72.mjs} +75 -12
  12. package/dist/{chunk-JRCDANLN.mjs.map → chunk-A6OBEF72.mjs.map} +1 -1
  13. package/dist/{chunk-CDQYBO3Q.mjs → chunk-CX3INLYJ.mjs} +27 -5
  14. package/dist/chunk-CX3INLYJ.mjs.map +1 -0
  15. package/dist/{chunk-QYH2T4L5.mjs → chunk-LYWVYBKU.mjs} +3 -3
  16. package/dist/{chunk-WO5KFNNW.mjs → chunk-QFNEHSY4.mjs} +62 -24
  17. package/dist/chunk-QFNEHSY4.mjs.map +1 -0
  18. package/dist/{chunk-EOKIE5HZ.mjs → chunk-WPWWWUD7.mjs} +51 -46
  19. package/dist/chunk-WPWWWUD7.mjs.map +1 -0
  20. package/dist/{cli/cli.js → cli.js} +423 -10
  21. package/dist/cli.js.map +1 -0
  22. package/dist/{gateway-B0LJ3-jT.d.ts → gateway-5yt_3QDP.d.mts} +4 -4
  23. package/dist/{gateway-B0LJ3-jT.d.mts → gateway-5yt_3QDP.d.ts} +4 -4
  24. package/dist/index.d.mts +2 -2
  25. package/dist/index.d.ts +2 -2
  26. package/dist/index.js +756 -206
  27. package/dist/index.js.map +1 -1
  28. package/dist/index.mjs +8 -8
  29. package/dist/management/management.js +754 -204
  30. package/dist/management/management.js.map +1 -1
  31. package/dist/management/management.mjs +6 -6
  32. package/dist/modals/chat-modal/chat-modal.js +532 -88
  33. package/dist/modals/chat-modal/chat-modal.js.map +1 -1
  34. package/dist/modals/chat-modal/chat-modal.mjs +4 -4
  35. package/dist/public-types.d.mts +1 -1
  36. package/dist/public-types.d.ts +1 -1
  37. package/docs/01_quickstart.md +10 -4
  38. package/docs/02_gateway_api.md +19 -3
  39. package/docs/03_provider_integration.md +5 -4
  40. package/docs/api_reference/media/02_gateway_api.md +19 -3
  41. package/docs/api_reference/media/README.md +3 -1
  42. package/package.json +1 -1
  43. package/dist/chunk-CDQYBO3Q.mjs.map +0 -1
  44. package/dist/chunk-EOKIE5HZ.mjs.map +0 -1
  45. package/dist/chunk-QU5S5QQP.mjs.map +0 -1
  46. package/dist/chunk-WO5KFNNW.mjs.map +0 -1
  47. package/dist/cli/cli.js.map +0 -1
  48. /package/dist/{aiProviderStore-XN7GCBHJ.mjs.map → aiProviderStore-UQI33C5E.mjs.map} +0 -0
  49. /package/dist/{chat-5QJNWB7I.mjs.map → chat-T5ANWWYQ.mjs.map} +0 -0
  50. /package/dist/{chunk-3A2527TE.mjs.map → chunk-22EY3ZDC.mjs.map} +0 -0
  51. /package/dist/{chunk-ECRNIAG6.mjs.map → chunk-3E57HLDV.mjs.map} +0 -0
  52. /package/dist/{chunk-QYH2T4L5.mjs.map → chunk-LYWVYBKU.mjs.map} +0 -0
package/README.md CHANGED
@@ -20,7 +20,7 @@ An AI chat toolkit built for speed, design, and control. Power branded AI assist
20
20
  - 🔌 Plug-and-play React chat, modal, and management surfaces
21
21
  - 🧠 Memory, vector knowledge, and provider switching behind a secure gateway
22
22
  - 🎨 Full MUI theming, dark mode, and branding controls out of the box
23
- - 🌐 Multimodal support (voice, images, documents) with Ollama, OpenAI, Azure OpenAI, Anthropic, and xAI today — tell us which providers you need next so we can prioritize them
23
+ - 🌐 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
24
24
  - 🛠️ CLI scaffolding, sample gateway, and docs to launch in minutes
25
25
 
26
26
  ## Quick Links
@@ -44,7 +44,7 @@ npx @burtson-labs/bandit-engine create my-bandit-app
44
44
  What you get out of the box:
45
45
 
46
46
  - Vite + React project wired with `Chat`, `ChatModal`, and `ChatProvider`
47
- - Express gateway that proxies OpenAI, Azure OpenAI, Anthropic, xAI, or Ollama behind `/api`
47
+ - Express gateway that proxies Bandit AI, OpenAI, Azure OpenAI, Anthropic, xAI, or Ollama behind `/api`
48
48
  - Next.js App Router gateway scaffold (in `server/next-app/`) ready to copy into a Next project
49
49
  - Branding + persona config in `public/config.json`, ready for your logo or prompts
50
50
 
@@ -58,7 +58,7 @@ Customize the output with options such as:
58
58
 
59
59
  > 📦 The generated project installs directly from `https://registry.npmjs.org/` — no GitHub npm token is required once the package is public.
60
60
 
61
- > ⚠️ The scaffolded gateway focuses on OpenAI/xAI/Ollama chat and model discovery. All advanced routes (file storage uploads, vector embedding, voice, MCP, etc.) are generated as `501` placeholders so you can wire them to your own infrastructure. Implement the contracts below before turning on those features in production.
61
+ > ⚠️ 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 `501` placeholders so you can wire them to your own infrastructure. Implement the contracts below before turning on those features in production.
62
62
 
63
63
  Check out the [CLI quick start guide](./docs/05_cli_quickstart.md) for the full walkthrough, option matrix, and project anatomy.
64
64
 
@@ -125,7 +125,7 @@ const chatPackageSettings = {
125
125
  aiProvider: {
126
126
  type: "gateway" as const,
127
127
  gatewayUrl: import.meta.env.VITE_GATEWAY_API_URL!,
128
- provider: "openai" // Backend: openai, azure-openai, anthropic, ollama
128
+ provider: "bandit" // Backend: bandit, openai, azure-openai, anthropic, xai, ollama
129
129
  },
130
130
 
131
131
  // Direct Ollama configuration (development only)
@@ -168,7 +168,7 @@ ReactDOM.createRoot(document.getElementById("root")!).render(
168
168
  aiProvider: {
169
169
  type: "gateway",
170
170
  gatewayUrl: "https://your-api-gateway.com", // Your backend API
171
- provider: "openai" // Specify which AI provider to use
171
+ provider: "bandit" // Specify which AI provider to use (bandit, openai, azure-openai, anthropic, xai, ollama)
172
172
  }
173
173
  ```
174
174
 
@@ -189,10 +189,10 @@ aiProvider: {
189
189
  - `GET /api/memory` — hydrate personal memory when the feature is enabled
190
190
  - **Chat & text generation**
191
191
  - `POST /api/chat/completions` — default provider routing
192
- - `POST /api/{provider}/chat/completions` — provider-specific routing (e.g. `openai`, `azure-openai`, `anthropic`)
192
+ - `POST /api/{provider}/chat/completions` — provider-specific routing (e.g. `bandit`, `openai`, `azure-openai`, `anthropic`, `xai`)
193
193
  - `POST /api/ollama/chat` — native Ollama chat format
194
194
  - `POST /api/generate` — non-chat generation (conversation starters, summaries, etc.)
195
- - `POST /api/{provider}/generate` — same contract, but scoped per provider (required for conversation starters to respect OpenAI vs. Ollama routing)
195
+ - `POST /api/{provider}/generate` — same contract, but scoped per provider (required for conversation starters to respect Bandit/OpenAI/Azure routing)
196
196
  - **Knowledge & vector search** (required for memories, knowledge management, and MCP document tools)
197
197
  - `POST /api/embedding/embed-memory`
198
198
  - `POST /api/embedding/batch-embed-memories`
@@ -211,6 +211,7 @@ aiProvider: {
211
211
  - `GET /subscription/{userId}` and `PUT /subscription/{userId}` — synchronize subscription tiers used by the feature-flag system
212
212
 
213
213
  > **⚠️ Important:** The Bandit Engine automatically routes to provider-specific endpoints:
214
+ > - **Bandit AI** → `/api/bandit/chat/completions` (OpenAI format, token or API key)
214
215
  > - **Ollama** → `/api/ollama/chat` (native Ollama format)
215
216
  > - **OpenAI/Azure/xAI/Anthropic** → `/api/{provider}/chat/completions` (OpenAI format)
216
217
  > - **TTS/STT** → Technology-agnostic endpoints that work with any backend implementation
@@ -674,10 +675,12 @@ Bandit Engine features a unified, gateway-based AI provider architecture that su
674
675
  ### Supported Providers
675
676
 
676
677
  - **🌟 Gateway Provider** (Recommended): Routes all requests through your secure backend
678
+ - **Bandit AI**: Bandit Core models served through the secure gateway
677
679
  - **Ollama**: Self-hosted models and Ollama-compatible endpoints
678
680
  - **OpenAI**: GPT models via OpenAI API
679
681
  - **Azure OpenAI**: Azure-hosted OpenAI models
680
682
  - **Anthropic**: Claude models via Anthropic API
683
+ - **xAI**: Grok models via xAI API
681
684
 
682
685
  > We do not support every AI provider yet. Let us know which services you rely on—community interest directly shapes the integration roadmap.
683
686
 
@@ -691,7 +694,7 @@ const chatPackageSettings = {
691
694
  aiProvider: {
692
695
  type: "gateway" as const,
693
696
  gatewayUrl: "https://your-gateway-api.example.com",
694
- provider: "openai" // Backend provider: openai, azure-openai, anthropic, ollama
697
+ provider: "bandit" // Backend provider: bandit, openai, azure-openai, anthropic, xai, ollama
695
698
  },
696
699
  // ... other settings
697
700
  };
@@ -709,7 +712,7 @@ Your gateway API can be built with any technology (Node.js, Python, .NET, Java,
709
712
  - `GET /api/health` — Health check endpoint that lists available providers.
710
713
  - `GET /api/models` and `GET /api/models/{provider}` — Model discovery for the management UI.
711
714
  - `POST /api/chat/completions` and `POST /api/generate` — Default OpenAI-style routes when no provider override is present.
712
- - `POST /api/{provider}/chat/completions` and `POST /api/{provider}/generate` — Provider-specific routing for `openai`, `azure-openai`, and `anthropic`.
715
+ - `POST /api/{provider}/chat/completions` and `POST /api/{provider}/generate` — Provider-specific routing for `bandit`, `openai`, `azure-openai`, `anthropic`, and `xai`.
713
716
  - `POST /api/ollama/chat` and `POST /api/ollama/generate` — Native Ollama routes (no `/chat/completions` suffix).
714
717
 
715
718
  ### Legacy Direct Providers
@@ -1135,7 +1138,7 @@ const chatPackageSettings = {
1135
1138
  aiProvider: {
1136
1139
  type: "gateway",
1137
1140
  gatewayUrl: "https://your-api-gateway.com",
1138
- provider: "openai" // or "anthropic", "azure-openai", "ollama"
1141
+ provider: "bandit" // or "openai", "anthropic", "azure-openai", "xai", "ollama"
1139
1142
  },
1140
1143
  gatewayApiUrl: "https://your-api-gateway.com", // Same URL for TTS/STT services
1141
1144
  // No API keys in frontend code
@@ -1157,7 +1160,7 @@ const oldSettings = {
1157
1160
 
1158
1161
  // ✅ Recommended (unified gateway approach)
1159
1162
  const newSettings = {
1160
- aiProvider: { type: "gateway", gatewayUrl: "https://your-gateway.com", provider: "openai" },
1163
+ aiProvider: { type: "gateway", gatewayUrl: "https://your-gateway.com", provider: "bandit" },
1161
1164
  gatewayApiUrl: "https://your-gateway.com", // Handles TTS, STT, and MCP
1162
1165
  };
1163
1166
  ```
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  useAIProviderStore
3
- } from "./chunk-QU5S5QQP.mjs";
3
+ } from "./chunk-54ZQ3FSN.mjs";
4
4
  import "./chunk-KCI46M23.mjs";
5
5
  import "./chunk-BJTO5JO5.mjs";
6
6
  export {
7
7
  useAIProviderStore
8
8
  };
9
- //# sourceMappingURL=aiProviderStore-XN7GCBHJ.mjs.map
9
+ //# sourceMappingURL=aiProviderStore-UQI33C5E.mjs.map
@@ -1,15 +1,15 @@
1
1
  import {
2
2
  chat_default
3
- } from "./chunk-WO5KFNNW.mjs";
3
+ } from "./chunk-QFNEHSY4.mjs";
4
4
  import "./chunk-ONQMRE2G.mjs";
5
5
  import "./chunk-RTQDQ6TC.mjs";
6
- import "./chunk-QYH2T4L5.mjs";
7
- import "./chunk-CDQYBO3Q.mjs";
6
+ import "./chunk-LYWVYBKU.mjs";
7
+ import "./chunk-CX3INLYJ.mjs";
8
8
  import "./chunk-XUBYA5I7.mjs";
9
- import "./chunk-QU5S5QQP.mjs";
9
+ import "./chunk-54ZQ3FSN.mjs";
10
10
  import "./chunk-KCI46M23.mjs";
11
11
  import "./chunk-BJTO5JO5.mjs";
12
12
  export {
13
13
  chat_default as default
14
14
  };
15
- //# sourceMappingURL=chat-5QJNWB7I.mjs.map
15
+ //# sourceMappingURL=chat-T5ANWWYQ.mjs.map