@burtson-labs/bandit-engine 2.0.8 → 2.0.10

package/dist/index.js

@@ -5387,6 +5387,185 @@ var init_gateway_provider = __esm({
   }
 });
 
+// src/services/ai-provider/providers/playground.provider.ts
+var import_rxjs8, PLAYGROUND_MODELS, PLAYGROUND_CONVERSATION_STARTERS, PLAYGROUND_SCRIPTS, FALLBACK_RESPONSE, STREAM_DELAY_MS, PlaygroundProvider;
+var init_playground_provider = __esm({
+  "src/services/ai-provider/providers/playground.provider.ts"() {
+    "use strict";
+    import_rxjs8 = require("rxjs");
+    init_common_types();
+    PLAYGROUND_MODELS = [
+      {
+        name: "bandit-playground",
+        details: {
+          format: "chat",
+          family: "bandit",
+          families: ["bandit", "demo"],
+          parameter_size: "demo",
+          quantization_level: "synthetic"
+        },
+        digest: "playground-demo-001",
+        modified_at: (/* @__PURE__ */ new Date()).toISOString()
+      },
+      {
+        name: "bandit-starter",
+        details: {
+          format: "chat",
+          family: "bandit",
+          families: ["bandit", "demo"],
+          parameter_size: "demo",
+          quantization_level: "synthetic"
+        },
+        digest: "playground-demo-002",
+        modified_at: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    ];
+    PLAYGROUND_CONVERSATION_STARTERS = [
+      "What can I build with Bandit Engine if my backend is not ready yet?",
+      "How does the gateway contract keep API keys out of the browser?",
+      "Can I theme the chat UI to match my product brand?",
+      "How do I switch between Ollama and OpenAI without redeploying the frontend?",
+      "Show me how the management console handles personas and models."
+    ];
+    PLAYGROUND_SCRIPTS = [
+      {
+        match: (input) => /model|switch|personas|management/i.test(input),
+        response: [
+          "Absolutely \u2014 the management console ships with live model switching, persona editing, and feature toggles.",
+          "",
+          "- Use the **Models** tab to expose whichever gateway-backed models you want customers to see.",
+          "- Personas hydrate the chat with branded system prompts, voice preferences, and avatars.",
+          "- Everything persists through the gateway, so you can roll out changes without shipping a new build."
+        ].join("\n")
+      },
+      {
+        match: (input) => /gateway|api|contract|backend/i.test(input),
+        response: [
+          "The gateway contract keeps secrets on the server while giving the UI a unified AI API.",
+          "",
+          "Key highlights:",
+          "1. `/api/chat/completions` is the default OpenAI-format endpoint when no provider override is set.",
+          "2. `/api/{provider}/chat/completions` handles OpenAI, Azure OpenAI, and Anthropic while `/api/ollama/chat` streams Ollama responses.",
+          "3. The contract is language-agnostic \u2014 Express, FastAPI, .NET, Go\u2026 anything works as long as it speaks HTTP."
+        ].join("\n")
+      },
+      {
+        match: (input) => /style|theme|brand|ui/i.test(input),
+        response: [
+          "Every surface in Bandit Engine is themeable.",
+          "",
+          "- Drop a JSON config into your `public/` folder (or host it on a CDN) to control themes, logos, and accent colors.",
+          "- The React components expose hooks for custom headers, menus, and call-to-action buttons.",
+          "- Need a modal? `ChatModal` reuses the same store, so the handoff between embedded chat and floating assistant stays seamless."
+        ].join("\n")
+      },
+      {
+        match: (input) => /voice|tts|audio/i.test(input),
+        response: [
+          "Voice is opt-in, but the plumbing is ready.",
+          "",
+          "- Configure `/api/tts` and `/api/stt` on the gateway to unlock the speak/listen controls.",
+          "- The UI lazily loads voices and respects feature flags, so you can leave it disabled in the playground.",
+          "- Everything streams \u2014 the assistant starts speaking before the full response lands."
+        ].join("\n")
+      },
+      {
+        match: (input) => /deploy|production|secure/i.test(input),
+        response: [
+          "Production hardening is front and center.",
+          "",
+          "- Gateway tokens ride in the `Authorization` header; rotate them server-side without touching the bundle.",
+          "- Feature flags gate premium surfaces, letting you trial the UI before wiring billing.",
+          "- Vector search, knowledge, and memories are isolated behind `/api/embedding/*` so you can plug in your own storage policies."
+        ].join("\n")
+      }
+    ];
+    FALLBACK_RESPONSE = [
+      "Bandit Engine is running in playground mode. I'm simulating how streaming works so you can explore the UX without connecting a live model.",
+      "",
+      "Try asking about the gateway contract, theming, voice features, or model management to see tailored walkthroughs."
+    ].join("\n");
+    STREAM_DELAY_MS = 350;
+    PlaygroundProvider = class {
+      config;
+      constructor(config) {
+        this.config = { type: "playground" /* PLAYGROUND */, ...config };
+      }
+      chat(request) {
+        const lastUserMessage = [...request.messages].reverse().find((m) => m.role === "user")?.content ?? "";
+        const script = PLAYGROUND_SCRIPTS.find(
+          (scenario) => scenario.match(lastUserMessage)
+        );
+        const responseText = script?.response ?? FALLBACK_RESPONSE;
+        const chunks = this.splitIntoChunks(responseText);
+        return new import_rxjs8.Observable((observer) => {
+          let index = 0;
+          const emitChunk = () => {
+            if (index >= chunks.length) {
+              observer.complete();
+              return;
+            }
+            const chunk = chunks[index];
+            observer.next({
+              message: {
+                content: chunk,
+                role: "assistant"
+              },
+              done: index === chunks.length - 1
+            });
+            index += 1;
+            setTimeout(emitChunk, STREAM_DELAY_MS);
+          };
+          emitChunk();
+          return () => {
+            index = chunks.length;
+          };
+        });
+      }
+      generate(_request) {
+        const starters = PLAYGROUND_CONVERSATION_STARTERS.join("\n");
+        return new import_rxjs8.Observable((observer) => {
+          observer.next({
+            response: starters,
+            done: true
+          });
+          observer.complete();
+        });
+      }
+      listModels() {
+        return new import_rxjs8.Observable((observer) => {
+          observer.next(PLAYGROUND_MODELS);
+          observer.complete();
+        });
+      }
+      async validateServiceAvailability(args) {
+        const simulatedUrl = this.config.baseUrl ?? "playground://local";
+        if (args.timeoutMs > 0) {
+          await new Promise((resolve) => setTimeout(resolve, Math.min(args.timeoutMs, 250)));
+        }
+        return {
+          url: simulatedUrl,
+          isAvailable: true
+        };
+      }
+      getProviderType() {
+        return "playground" /* PLAYGROUND */;
+      }
+      getConfig() {
+        return this.config;
+      }
+      splitIntoChunks(response) {
+        const paragraphs = response.split("\n\n").map((p) => p.trim()).filter(Boolean);
+        if (paragraphs.length <= 1) {
+          const sentences = response.split(/(?<=[.!?])\s+/).filter(Boolean);
+          return sentences.length > 0 ? sentences : [response];
+        }
+        return paragraphs;
+      }
+    };
+  }
+});
+
 // src/services/ai-provider/ai-provider.factory.ts
 var AIProviderFactory;
 var init_ai_provider_factory = __esm({
@@ -5398,6 +5577,7 @@ var init_ai_provider_factory = __esm({
     init_azure_openai_provider();
     init_anthropic_provider();
     init_gateway_provider();
+    init_playground_provider();
     AIProviderFactory = class {
       static createProvider(config) {
         switch (config.type) {
@@ -5411,6 +5591,8 @@ var init_ai_provider_factory = __esm({
             return new AnthropicProvider(config);
           case "gateway" /* GATEWAY */:
             return new GatewayProvider(config);
+          case "playground" /* PLAYGROUND */:
+            return new PlaygroundProvider(config);
           default:
             throw new Error(`Unsupported AI provider type: ${config.type}`);
         }
@@ -5421,7 +5603,8 @@ var init_ai_provider_factory = __esm({
           "openai" /* OPENAI */,
           "azure-openai" /* AZURE_OPENAI */,
           "anthropic" /* ANTHROPIC */,
-          "gateway" /* GATEWAY */
+          "gateway" /* GATEWAY */,
+          "playground" /* PLAYGROUND */
         ];
       }
       static validateConfig(config) {
@@ -5437,6 +5620,8 @@ var init_ai_provider_factory = __esm({
             return !!config.apiKey;
           case "gateway" /* GATEWAY */:
             return !!(config.gatewayUrl && config.provider);
+          case "playground" /* PLAYGROUND */:
+            return true;
           default:
             return false;
         }
@@ -5791,11 +5976,11 @@ var init_notificationService = __esm({
 });
 
 // src/services/prompts/conversationStarters.ts
-var import_rxjs8, generateConversationStarters;
+var import_rxjs9, generateConversationStarters;
 var init_conversationStarters = __esm({
   "src/services/prompts/conversationStarters.ts"() {
     "use strict";
-    import_rxjs8 = require("rxjs");
+    import_rxjs9 = require("rxjs");
     init_aiProviderStore();
     init_packageSettingsStore();
     init_getStableQuestionPrompt();
@@ -5816,13 +6001,13 @@ var init_conversationStarters = __esm({
           stream: false,
           options: { temperature: 1.5, num_predict: 250 }
         });
-        const questions$ = data$.pipe((0, import_rxjs8.map)((d) => {
+        const questions$ = data$.pipe((0, import_rxjs9.map)((d) => {
           const lines = d.response.split("\n").map((line) => line.trim()).filter((line) => {
             return line.length > 10 && !line.toLowerCase().includes("sorry") && !line.toLowerCase().includes("i cannot") && !line.toLowerCase().includes("i can't") && !line.toLowerCase().includes("unable to") && !line.toLowerCase().startsWith("as an ai") && line.includes("?");
           });
           return lines;
         }));
-        const starters = await (0, import_rxjs8.lastValueFrom)(questions$);
+        const starters = await (0, import_rxjs9.lastValueFrom)(questions$);
         if (starters.length === 0) {
           debugLogger.warn("No meaningful conversation starters generated");
           return [];
@@ -5838,11 +6023,11 @@ var init_conversationStarters = __esm({
 });
 
 // src/services/prompts/moodDetection.ts
-var import_rxjs9, detectMessageMood;
+var import_rxjs10, detectMessageMood;
 var init_moodDetection = __esm({
   "src/services/prompts/moodDetection.ts"() {
     "use strict";
-    import_rxjs9 = require("rxjs");
+    import_rxjs10 = require("rxjs");
     init_aiProviderStore();
     init_packageSettingsStore();
     init_debugLogger();
@@ -5873,8 +6058,8 @@ Response:`;
           options: { temperature: 0.3, num_predict: 10 }
         });
         const chunks$ = response$.pipe(
-          (0, import_rxjs9.map)((chunk) => chunk.response.trim().toLowerCase()),
-          (0, import_rxjs9.toArray)()
+          (0, import_rxjs10.map)((chunk) => chunk.response.trim().toLowerCase()),
+          (0, import_rxjs10.toArray)()
         );
         const result = await chunks$.toPromise();
         const finalResult = (result || []).join("").trim();
@@ -5891,11 +6076,11 @@ Response:`;
 });
 
 // src/services/prompts/detectUserInterestAndExcitement.ts
-var import_rxjs10, detectUserInterestAndExcitement;
+var import_rxjs11, detectUserInterestAndExcitement;
 var init_detectUserInterestAndExcitement = __esm({
   "src/services/prompts/detectUserInterestAndExcitement.ts"() {
     "use strict";
-    import_rxjs10 = require("rxjs");
+    import_rxjs11 = require("rxjs");
     init_aiProviderStore();
     init_packageSettingsStore();
     init_debugLogger();
@@ -5942,10 +6127,10 @@ var init_detectUserInterestAndExcitement = __esm({
           options: { temperature: 0.1, num_predict: 5 }
         });
         const chunks$ = response$.pipe(
-          (0, import_rxjs10.map)((chunk) => chunk.response.trim().toUpperCase()),
-          (0, import_rxjs10.toArray)()
+          (0, import_rxjs11.map)((chunk) => chunk.response.trim().toUpperCase()),
+          (0, import_rxjs11.toArray)()
         );
-        const result = await (0, import_rxjs10.lastValueFrom)(chunks$);
+        const result = await (0, import_rxjs11.lastValueFrom)(chunks$);
         const decision = result.join("").trim();
         debugLogger.llmDebug("detectUserInterestAndExcitement result", { decision });
         return decision.includes("YES");
@@ -5958,11 +6143,11 @@ var init_detectUserInterestAndExcitement = __esm({
 });
 
 // src/services/prompts/documentSummarization.ts
-var import_rxjs11, summarizeDocument;
+var import_rxjs12, summarizeDocument;
 var init_documentSummarization = __esm({
   "src/services/prompts/documentSummarization.ts"() {
     "use strict";
-    import_rxjs11 = require("rxjs");
+    import_rxjs12 = require("rxjs");
     init_aiProviderStore();
     init_packageSettingsStore();
     init_debugLogger();
@@ -5990,8 +6175,8 @@ ${content.slice(0, 4e3)}
           stream: false,
           options: { temperature: 0.3, num_predict: 100 }
         });
-        const summary$ = data$.pipe((0, import_rxjs11.map)((d) => d.response.trim()));
-        const summary = await (0, import_rxjs11.lastValueFrom)(summary$);
+        const summary$ = data$.pipe((0, import_rxjs12.map)((d) => d.response.trim()));
+        const summary = await (0, import_rxjs12.lastValueFrom)(summary$);
         debugLogger.ragDebug("summarizeDocument result", { name, summary });
         return summary || `Document summary for ${name}`;
       } catch (error) {
@@ -6003,11 +6188,11 @@ ${content.slice(0, 4e3)}
 });
 
 // src/services/prompts/documentRelevance.ts
-var import_rxjs12, determineRelevantDocuments;
+var import_rxjs13, determineRelevantDocuments;
 var init_documentRelevance = __esm({
   "src/services/prompts/documentRelevance.ts"() {
     "use strict";
-    import_rxjs12 = require("rxjs");
+    import_rxjs13 = require("rxjs");
     init_aiProviderStore();
     init_packageSettingsStore();
     init_debugLogger();
@@ -6048,10 +6233,10 @@ Response:`;
           options: { temperature: 0.2, num_predict: 50 }
         });
         const chunks$ = response$.pipe(
-          (0, import_rxjs12.map)((chunk) => chunk.response.trim()),
-          (0, import_rxjs12.toArray)()
+          (0, import_rxjs13.map)((chunk) => chunk.response.trim()),
+          (0, import_rxjs13.toArray)()
         );
-        const result = await (0, import_rxjs12.lastValueFrom)(chunks$);
+        const result = await (0, import_rxjs13.lastValueFrom)(chunks$);
         const vetResult = result.join("").trim().toLowerCase();
         debugLogger.ragDebug("determineRelevantDocuments result", { vetResult });
         if (vetResult.includes("none") || !vetResult) {
@@ -6513,16 +6698,16 @@ var init_vectorDatabaseService = __esm({
     init_debugLogger();
     VectorDatabaseService = class {
       baseUrl;
-      s3ApiUrl;
+      fileStorageApiUrl;
       token = null;
       lastAvailabilityState;
       lastConfigState;
-      constructor(gatewayApiUrl, s3ApiUrl) {
+      constructor(gatewayApiUrl, fileStorageApiUrl) {
         this.baseUrl = gatewayApiUrl || "https://localhost:5001/api";
-        this.s3ApiUrl = s3ApiUrl || "https://localhost:5001/api";
+        this.fileStorageApiUrl = fileStorageApiUrl || "https://localhost:5001/api";
         debugLogger.info("Vector database service initialized", {
           baseUrl: this.baseUrl,
-          s3ApiUrl: this.s3ApiUrl,
+          fileStorageApiUrl: this.fileStorageApiUrl,
           hasToken: Boolean(this.token)
         });
       }
@@ -6548,11 +6733,11 @@ var init_vectorDatabaseService = __esm({
        * Check if vector database is available and configured
        */
       isAvailable() {
-        const available = !!(this.baseUrl && this.s3ApiUrl && this.token);
+        const available = !!(this.baseUrl && this.fileStorageApiUrl && this.token);
         if (this.lastAvailabilityState !== available) {
           debugLogger.debug("Vector service availability check", {
             baseUrl: this.baseUrl,
-            s3ApiUrl: this.s3ApiUrl,
+            fileStorageApiUrl: this.fileStorageApiUrl,
             hasToken: Boolean(this.token),
             available
           });
@@ -7052,7 +7237,7 @@ var init_vectorDatabaseService = __esm({
       }
       // ===== DOCUMENT OPERATIONS =====
       /**
-       * Upload file to S3 API and get file ID
+       * Upload file to file storage API and get file ID
        * 
        * @param file - The file to upload
        * @param shareWithTeam - Whether to share the file with team members.
@@ -7062,8 +7247,8 @@ var init_vectorDatabaseService = __esm({
        * @returns Promise<FileUploadResult> with success status and file ID
        */
       async uploadFile(file, shareWithTeam = true) {
-        if (!this.s3ApiUrl) {
-          throw new Error("S3 API URL not configured");
+        if (!this.fileStorageApiUrl) {
+          throw new Error("File storage API URL not configured");
         }
         if (!this.token) {
           throw new Error("Authentication token not available");
@@ -7072,14 +7257,14 @@ var init_vectorDatabaseService = __esm({
           const formData = new FormData();
           formData.append("file", file);
           formData.append("shareWithTeam", shareWithTeam.toString());
-          debugLogger.info("Uploading file to S3 API", {
+          debugLogger.info("Uploading file to file storage API", {
             filename: file.name,
             size: file.size,
             type: file.type,
             shareWithTeam,
-            s3ApiUrl: this.s3ApiUrl
+            fileStorageApiUrl: this.fileStorageApiUrl
           });
-          const response = await fetch(`${this.s3ApiUrl}/file/upload`, {
+          const response = await fetch(`${this.fileStorageApiUrl}/file/upload`, {
             method: "POST",
             headers: {
               "Authorization": `Bearer ${this.token}`
@@ -7088,13 +7273,13 @@ var init_vectorDatabaseService = __esm({
           });
           if (!response.ok) {
             const errorData = await response.json().catch(() => ({}));
-            throw new Error(errorData.message || `S3 upload failed: ${response.status}`);
+            throw new Error(errorData.message || `file storage upload failed: ${response.status}`);
           }
           const result = await response.json();
           const fileId = result.fileId || result.id;
-          debugLogger.debug("S3 upload response", result);
+          debugLogger.debug("File storage API upload response", result);
           debugLogger.debug("Extracted vector file id", { fileId });
-          debugLogger.info("File uploaded successfully to S3", {
+          debugLogger.info("File uploaded successfully to file storage", {
             fileId,
             filename: file.name,
             originalResponse: result
@@ -7105,8 +7290,8 @@ var init_vectorDatabaseService = __esm({
             message: result.message
           };
         } catch (error) {
-          debugLogger.error("Failed to upload file to S3", { error });
-          throw new Error(`S3 file upload failed: ${error instanceof Error ? error.message : String(error)}`);
+          debugLogger.error("Failed to upload file to file storage", { error });
+          throw new Error(`File storage upload failed: ${error instanceof Error ? error.message : String(error)}`);
         }
       }
       /**
@@ -7270,7 +7455,7 @@ var init_vectorDatabaseService = __esm({
         }
       }
       /**
-       * Get user's files - tries both Gateway API and S3 API
+       * Get user's files - tries both Gateway API and file storage API
        */
       async getUserFiles(skip = 0, limit = 50) {
         if (!this.isAvailable()) {
@@ -7283,10 +7468,10 @@ var init_vectorDatabaseService = __esm({
             headers: this.getHeaders()
           });
           if (!response.ok) {
-            debugLogger.warn("Gateway API files endpoint failed, falling back to S3 API", {
+            debugLogger.warn("Gateway API files endpoint failed, falling back to file storage API", {
               status: response.status
             });
-            return await this.getUserFilesFromS3(skip, limit);
+            return await this.getUserFilesFromFileStorage(skip, limit);
           }
           const result = await response.json();
           debugLogger.debug("Gateway API files response", result);
@@ -7298,17 +7483,17 @@ var init_vectorDatabaseService = __esm({
           }
           return [];
         } catch (error) {
-          debugLogger.error("Gateway API failed while fetching user files, trying S3 API", { error });
-          return await this.getUserFilesFromS3(skip, limit);
+          debugLogger.error("Gateway API failed while fetching user files, trying file storage API", { error });
+          return await this.getUserFilesFromFileStorage(skip, limit);
         }
       }
       /**
-       * Get user's files from S3 API as fallback
+       * Get user's files from file storage API as fallback
        */
-      async getUserFilesFromS3(skip = 0, limit = 50) {
+      async getUserFilesFromFileStorage(skip = 0, limit = 50) {
         try {
-          debugLogger.debug("Fetching user files from S3 API", { skip, limit });
-          const response = await fetch(`${this.s3ApiUrl}/file/files?skip=${skip}&limit=${limit}`, {
+          debugLogger.debug("Fetching user files from file storage API", { skip, limit });
+          const response = await fetch(`${this.fileStorageApiUrl}/file/files?skip=${skip}&limit=${limit}`, {
             method: "GET",
             headers: {
               "Authorization": `Bearer ${this.token}`,
@@ -7316,10 +7501,10 @@ var init_vectorDatabaseService = __esm({
             }
           });
           if (!response.ok) {
-            throw new Error(`S3 API failed: ${response.status}`);
+            throw new Error(`File storage API failed: ${response.status}`);
           }
           const result = await response.json();
-          debugLogger.debug("S3 API files response", result);
+          debugLogger.debug("File storage API files response", result);
           if (Array.isArray(result)) {
             return this.toRecordArray(result);
           }
@@ -7328,7 +7513,7 @@ var init_vectorDatabaseService = __esm({
           }
           return [];
         } catch (error) {
-          debugLogger.error("Failed to fetch user files from S3 API", { error });
+          debugLogger.error("Failed to fetch user files from file storage API", { error });
           return [];
         }
       }
@@ -7341,7 +7526,7 @@ var init_vectorDatabaseService = __esm({
         }
         try {
           debugLogger.debug("Downloading vector file", { fileId, filename });
-          const response = await fetch(`${this.s3ApiUrl}/file/download/${fileId}`, {
+          const response = await fetch(`${this.fileStorageApiUrl}/file/download/${fileId}`, {
             method: "GET",
             headers: {
               "Authorization": `Bearer ${this.token}`
@@ -7374,7 +7559,7 @@ var init_vectorDatabaseService = __esm({
         }
         try {
           debugLogger.debug("Fetching vector file blob", { fileId });
-          const response = await fetch(`${this.s3ApiUrl}/file/download/${fileId}`, {
+          const response = await fetch(`${this.fileStorageApiUrl}/file/download/${fileId}`, {
             method: "GET",
             headers: {
               "Authorization": `Bearer ${this.token}`
@@ -7486,16 +7671,16 @@ var init_vectorDatabaseService = __esm({
        * Configure the service with API URLs
        * This should be called by the main application with environment variables
        */
-      configure(gatewayApiUrl, s3ApiUrl) {
+      configure(gatewayApiUrl, fileStorageApiUrl) {
         this.baseUrl = gatewayApiUrl;
-        this.s3ApiUrl = s3ApiUrl;
-        if (this.lastConfigState !== `${gatewayApiUrl}|${s3ApiUrl}`) {
+        this.fileStorageApiUrl = fileStorageApiUrl;
+        if (this.lastConfigState !== `${gatewayApiUrl}|${fileStorageApiUrl}`) {
           debugLogger.info("Vector database service configured", {
             baseUrl: this.baseUrl,
-            s3ApiUrl: this.s3ApiUrl,
+            fileStorageApiUrl: this.fileStorageApiUrl,
             hasToken: Boolean(this.token)
           });
-          this.lastConfigState = `${gatewayApiUrl}|${s3ApiUrl}`;
+          this.lastConfigState = `${gatewayApiUrl}|${fileStorageApiUrl}`;
         }
       }
       /**
@@ -7506,7 +7691,7 @@ var init_vectorDatabaseService = __esm({
         debugLogger.info("Testing Gateway API connection");
         debugLogger.info("Vector service status snapshot", {
           baseUrl: this.baseUrl,
-          s3ApiUrl: this.s3ApiUrl,
+          fileStorageApiUrl: this.fileStorageApiUrl,
           hasToken: Boolean(this.token),
           tokenLength: this.token?.length || 0,
           tokenPreview: this.token ? `${this.token.substring(0, 30)}...` : void 0,
@@ -7533,15 +7718,15 @@ var init_vectorDatabaseService = __esm({
           debugLogger.error("Cannot reach Gateway API", { error });
         }
         try {
-          debugLogger.debug("Testing S3 API connectivity");
-          const files = await this.getUserFilesFromS3(0, 5);
-          debugLogger.info("S3 API files response", {
+          debugLogger.debug("Testing file storage API connectivity");
+          const files = await this.getUserFilesFromFileStorage(0, 5);
+          debugLogger.info("File storage API files response", {
             count: files.length,
             files: files.slice(0, 3)
             // Show first 3 files
           });
         } catch (error) {
-          debugLogger.error("S3 API test failed", { error });
+          debugLogger.error("File storage API test failed", { error });
         }
         try {
           debugLogger.debug("Testing embedding endpoint availability");
@@ -8627,8 +8812,8 @@ var init_useVectorStore = __esm({
             return;
           }
           const gatewayApiUrl = packageSettings.gatewayApiUrl;
-          const s3ApiUrl = packageSettings.s3ApiUrl || packageSettings.gatewayApiUrl;
-          vectorDatabaseService.configure(gatewayApiUrl, s3ApiUrl);
+          const fileStorageApiUrl = packageSettings.fileStorageApiUrl || packageSettings.gatewayApiUrl;
+          vectorDatabaseService.configure(gatewayApiUrl, fileStorageApiUrl);
           if (authStore.token) {
             vectorDatabaseService.setAuthToken(authStore.token);
           }
@@ -11439,11 +11624,11 @@ var init_ttsSanitizer = __esm({
 });
 
 // src/services/tts/tts-client.ts
-var import_rxjs13, getOrAppendAuthHeader;
+var import_rxjs14, getOrAppendAuthHeader;
 var init_tts_client = __esm({
   "src/services/tts/tts-client.ts"() {
     "use strict";
-    import_rxjs13 = require("rxjs");
+    import_rxjs14 = require("rxjs");
     init_authenticationService();
     init_voiceStore();
     init_ttsSanitizer();
@@ -11463,11 +11648,11 @@ var init_tts_client = __esm({
 });
 
 // src/services/tts/streaming-tts.ts
-var import_rxjs14, TTSState, StreamingTTSClient, getStreamingTTSClient, speakStream, stopTTS, pauseTTS, resumeTTS, getTTSState;
+var import_rxjs15, TTSState, StreamingTTSClient, getStreamingTTSClient, speakStream, stopTTS, pauseTTS, resumeTTS, getTTSState;
 var init_streaming_tts = __esm({
   "src/services/tts/streaming-tts.ts"() {
     "use strict";
-    import_rxjs14 = require("rxjs");
+    import_rxjs15 = require("rxjs");
     init_debugLogger();
     init_packageSettingsStore();
     init_tts_client();
@@ -11487,8 +11672,8 @@ var init_streaming_tts = __esm({
       // Store event handler references for proper cleanup
       audioHandlers = /* @__PURE__ */ new Map();
       // State management
-      stateSubject = new import_rxjs14.BehaviorSubject("IDLE" /* IDLE */);
-      progressSubject = new import_rxjs14.Subject();
+      stateSubject = new import_rxjs15.BehaviorSubject("IDLE" /* IDLE */);
+      progressSubject = new import_rxjs15.Subject();
       constructor() {
       }
       static getInstance() {
@@ -11519,7 +11704,7 @@ var init_streaming_tts = __esm({
        * Speak text with simple streaming
        */
       speakStream(text, voice, options = {}) {
-        return new import_rxjs14.Observable((subscriber) => {
+        return new import_rxjs15.Observable((subscriber) => {
           this.performSimpleStreaming(text, voice, options, subscriber);
         });
       }
@@ -14048,28 +14233,28 @@ var init_create_audio_blob = __esm({
 });
 
 // src/services/stt/sound-recorder.service.ts
-var import_rxjs15, SoundRecorderService;
+var import_rxjs16, SoundRecorderService;
 var init_sound_recorder_service = __esm({
   "src/services/stt/sound-recorder.service.ts"() {
     "use strict";
-    import_rxjs15 = require("rxjs");
+    import_rxjs16 = require("rxjs");
     init_create_audio_blob();
     SoundRecorderService = class {
       _mediaRecorder;
       start() {
-        const mediaStream = (0, import_rxjs15.from)(navigator.mediaDevices.getUserMedia({ audio: true }));
-        this._mediaRecorder = mediaStream.pipe((0, import_rxjs15.map)((stream) => {
+        const mediaStream = (0, import_rxjs16.from)(navigator.mediaDevices.getUserMedia({ audio: true }));
+        this._mediaRecorder = mediaStream.pipe((0, import_rxjs16.map)((stream) => {
           const rec = new MediaRecorder(stream);
           rec.start();
           return rec;
-        }), (0, import_rxjs15.shareReplay)(1));
+        }), (0, import_rxjs16.shareReplay)(1));
         const dataAvailableEvent = this._mediaRecorder.pipe(
-          (0, import_rxjs15.switchMap)((recorder) => (0, import_rxjs15.fromEvent)(recorder, "dataavailable"))
+          (0, import_rxjs16.switchMap)((recorder) => (0, import_rxjs16.fromEvent)(recorder, "dataavailable"))
         );
         const blob = dataAvailableEvent.pipe(
-          (0, import_rxjs15.first)(),
-          (0, import_rxjs15.map)((event) => createAudioBlob(event.data)),
-          (0, import_rxjs15.shareReplay)(1)
+          (0, import_rxjs16.first)(),
+          (0, import_rxjs16.map)((event) => createAudioBlob(event.data)),
+          (0, import_rxjs16.shareReplay)(1)
         );
         return blob;
       }
@@ -14077,7 +14262,7 @@ var init_sound_recorder_service = __esm({
         if (!this._mediaRecorder) {
           return;
         }
-        this._mediaRecorder.pipe((0, import_rxjs15.first)()).subscribe((recorder) => {
+        this._mediaRecorder.pipe((0, import_rxjs16.first)()).subscribe((recorder) => {
           recorder.stop();
         });
       }
@@ -14197,7 +14382,7 @@ var init_stt_client = __esm({
 });
 
 // src/services/stt/transcriber.tsx
-var import_react16, import_Mic, import_Check4, import_Close3, import_material10, import_rxjs16, import_jsx_runtime13, initialButtonStyles, Transcriber, transcriber_default;
+var import_react16, import_Mic, import_Check4, import_Close3, import_material10, import_rxjs17, import_jsx_runtime13, initialButtonStyles, Transcriber, transcriber_default;
 var init_transcriber = __esm({
   "src/services/stt/transcriber.tsx"() {
     "use strict";
@@ -14208,7 +14393,7 @@ var init_transcriber = __esm({
     init_sound_recorder_service();
     init_stt_client();
     import_material10 = require("@mui/material");
-    import_rxjs16 = require("rxjs");
+    import_rxjs17 = require("rxjs");
     init_debugLogger();
     import_jsx_runtime13 = require("react/jsx-runtime");
     initialButtonStyles = (badgeBackground, fileText, hoverBadgeBackground) => ({
@@ -14227,14 +14412,14 @@ var init_transcriber = __esm({
       const [status, setStatus] = (0, import_react16.useState)("IDLE");
       const recorderRef = (0, import_react16.useRef)(new SoundRecorderService());
       const [iconButtonStyles] = (0, import_react16.useState)(() => initialButtonStyles(badgeBackground, fileText, hoverBadgeBackground));
-      const [recordingSub, setRecordingSub] = (0, import_react16.useState)(() => new import_rxjs16.Subscription());
+      const [recordingSub, setRecordingSub] = (0, import_react16.useState)(() => new import_rxjs17.Subscription());
       const start = () => {
         recordingSub.unsubscribe();
         const recording = recorderRef.current.start();
         const text = recording.pipe(
-          (0, import_rxjs16.switchMap)((blob) => {
+          (0, import_rxjs17.switchMap)((blob) => {
             debugLogger.debug("Processing audio blob for transcription");
-            return (0, import_rxjs16.from)(STTClient.transcribe(blob));
+            return (0, import_rxjs17.from)(STTClient.transcribe(blob));
           })
         );
         const sub = text.subscribe({
@@ -17731,21 +17916,6 @@ ${sanitize(
                                 !isMobile && renderAttachmentButton("attach-inline"),
                                 !isMobile && renderMemoryButton("memory-inline"),
                                 !isMobile && renderSttButton("stt-inline"),
-                                !isMobile && isFeedbackEnabled && /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(import_material14.Tooltip, { title: "Send Feedback", children: /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
-                                  import_material14.IconButton,
-                                  {
-                                    onClick: () => setFeedbackModalOpen(true),
-                                    sx: {
-                                      bgcolor: badgeBackground,
-                                      color: fileText,
-                                      width: primaryIconSize,
-                                      height: primaryIconSize,
-                                      borderRadius: "50%",
-                                      "&:hover": { bgcolor: hoverBadgeBackground }
-                                    },
-                                    children: /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(import_Feedback.default, { fontSize: "small" })
-                                  }
-                                ) }),
                                 isMobile && hasSecondaryActions && /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
                                   import_material14.IconButton,
                                   {
@@ -17765,7 +17935,7 @@ ${sanitize(
                                         fontSize: "small",
                                         sx: {
                                           transition: "transform 0.2s ease",
-                                          transform: moreActionsOpen ? "rotate(180deg)" : "rotate(0deg)"
+                                          transform: moreActionsOpen ? "rotate(0deg)" : "rotate(180deg)"
                                         }
                                       }
                                     )
@@ -17861,11 +18031,11 @@ ${sanitize(
 });
 
 // src/chat/hooks/useMemoryEnhancer.tsx
-var import_rxjs17, MEMORY_LIMIT, MIN_MEMORY_WORDS, MERGE_THRESHOLD, REJECT_ECHO_THRESHOLD, REJECT_DUPLICATE_THRESHOLD, CONTEXTUAL_DIVERGENCE_THRESHOLD, normalizeText, isStructurallyDuplicate, isAboutBandit, hasEngagementValue, isMemoryTooShortOrGeneric, isPersonalText, mergeMemory, isVoiceShifted, sanitizeMemory, sanitizeMemoryText, shouldAcceptMemory, isContextuallyDivergent, useMemoryEnhancer;
+var import_rxjs18, MEMORY_LIMIT, MIN_MEMORY_WORDS, MERGE_THRESHOLD, REJECT_ECHO_THRESHOLD, REJECT_DUPLICATE_THRESHOLD, CONTEXTUAL_DIVERGENCE_THRESHOLD, normalizeText, isStructurallyDuplicate, isAboutBandit, hasEngagementValue, isMemoryTooShortOrGeneric, isPersonalText, mergeMemory, isVoiceShifted, sanitizeMemory, sanitizeMemoryText, shouldAcceptMemory, isContextuallyDivergent, useMemoryEnhancer;
 var init_useMemoryEnhancer = __esm({
   "src/chat/hooks/useMemoryEnhancer.tsx"() {
     "use strict";
-    import_rxjs17 = require("rxjs");
+    import_rxjs18 = require("rxjs");
     init_memoryStore();
     init_aiProviderStore();
     init_packageSettingsStore();
@@ -18257,8 +18427,8 @@ var init_useMemoryEnhancer = __esm({
               stream: false,
               options: { temperature: 0.1, num_predict: 150 }
             });
-            const suggestion = await (0, import_rxjs17.lastValueFrom)(
-              result$.pipe((0, import_rxjs17.map)((chunk) => chunk.response))
+            const suggestion = await (0, import_rxjs18.lastValueFrom)(
+              result$.pipe((0, import_rxjs18.map)((chunk) => chunk.response))
             );
             debugLogger.memoryDebug(`LLM memory suggestion received (${attempt})`, {
               suggestion: typeof suggestion === "string" ? suggestion.slice(0, 200) : suggestion,
@@ -23774,14 +23944,14 @@ var init_chat_app_bar = __esm({
 });
 
 // src/chat/hooks/useConversationNameGenerator.tsx
-var import_rxjs18, import_operators5, useConversationNameGenerator;
+var import_rxjs19, import_operators5, useConversationNameGenerator;
 var init_useConversationNameGenerator = __esm({
   "src/chat/hooks/useConversationNameGenerator.tsx"() {
     "use strict";
     init_aiProviderStore();
     init_packageSettingsStore();
     init_debugLogger();
-    import_rxjs18 = require("rxjs");
+    import_rxjs19 = require("rxjs");
     import_operators5 = require("rxjs/operators");
     init_conversationStore();
     useConversationNameGenerator = () => {
@@ -23817,7 +23987,7 @@ Respond with just the title and nothing else.
               num_predict: 20
             }
           });
-          const title = await (0, import_rxjs18.lastValueFrom)(
+          const title = await (0, import_rxjs19.lastValueFrom)(
             result$.pipe((0, import_operators5.map)((d) => d.response?.trim().replace(/["']/g, "")))
           );
           if (title && title.length > 0) {
@@ -23887,10 +24057,12 @@ var init_query_suggestion_picker = __esm({
           } else {
             setExamplePrompts([]);
             setVisiblePrompts([]);
+            hasGenerated.current = false;
           }
         }).catch((error) => {
           setExamplePrompts([]);
           setVisiblePrompts([]);
+          hasGenerated.current = false;
         });
       }, [getCurrentModel, isLoading]);
       (0, import_react31.useEffect)(() => {
@@ -27119,6 +27291,7 @@ var init_chat2 = __esm({
       const featureFlag = useFeatureFlag();
       const { isOSSMode } = featureFlag;
       const ossMode = isOSSMode() || !packageSettings?.featureFlags?.subscriptionType;
+      const playgroundBypassAccess = packageSettings?.playgroundBypassAuth || typeof window !== "undefined" && window.location.pathname.includes("/playground");
       const notificationService2 = useNotificationService();
       const [selectedTheme, setSelectedTheme] = (0, import_react35.useState)(null);
       const [themeLoading, setThemeLoading] = (0, import_react35.useState)(true);
@@ -27952,7 +28125,7 @@ var init_chat2 = __esm({
         }
       };
       if (!hydrated || brandingLoading || themeLoading) return null;
-      const userHasAccess = ossMode || claims?.roles?.includes("super-user") || claims?.roles?.includes("admin");
+      const userHasAccess = playgroundBypassAccess || ossMode || claims?.roles?.includes("super-user") || claims?.roles?.includes("admin");
       if (!userHasAccess) {
         return /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(import_material27.ThemeProvider, { theme: banditTheme, children: [
           /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(import_material27.CssBaseline, {}),
@@ -28155,13 +28328,19 @@ var init_chat2 = __esm({
       }
       const ossConfigured = !packageSettings.featureFlags?.subscriptionType;
       const allowUnauthenticated = isOSSMode() || ossConfigured;
+      const playgroundBypassAuth = packageSettings.playgroundBypassAuth;
+      const isPlaygroundRoute = typeof window !== "undefined" && window.location.pathname.includes("/playground");
+      const bypassAuth = playgroundBypassAuth || isPlaygroundRoute;
       debugLogger.info("Chat authentication gate", {
         ossConfigured,
         isOSSMode: isOSSMode(),
         tier: featureFlag.getEvaluation()?.tier,
-        hasToken: authenticationService.isAuthenticated()
+        hasToken: authenticationService.isAuthenticated(),
+        playgroundBypassAuth,
+        isPlaygroundRoute,
+        bypassAuth
       });
-      if (!allowUnauthenticated && !authenticationService.isAuthenticated()) {
+      if (!allowUnauthenticated && !bypassAuth && !authenticationService.isAuthenticated()) {
         debugLogger.debug("User is not authenticated, redirecting to login");
         return /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(import_react_router_dom3.Navigate, { to: "/login", replace: true });
       }
@@ -28541,10 +28720,16 @@ var ChatProvider = (props) => {
       useProjectStore.getState().hydrate();
       useAIQueryStore.getState().hydrate();
       useMemoryStore.getState().hydrate();
-      await usePreferencesStore.getState().loadPreferences();
-      await useKnowledgeStore.getState().loadDocs();
-      await useMCPToolsStore.getState().loadTools();
-      await useConversationSyncStore.getState().initialize();
+      const isPlaygroundRoute = typeof window !== "undefined" && window.location.pathname.includes("/playground");
+      const isPlaygroundMode = isPlaygroundRoute || props.packageSettings.playgroundMode === true;
+      if (isPlaygroundMode) {
+        debugLogger.info("ChatProvider: Playground mode detected \u2014 skipping remote preference and sync initialization");
+      } else {
+        await usePreferencesStore.getState().loadPreferences();
+        await useKnowledgeStore.getState().loadDocs();
+        await useMCPToolsStore.getState().loadTools();
+        await useConversationSyncStore.getState().initialize();
+      }
       debugLogger.info("ChatProvider about to call initModels - checking for existing branding first");
       const storeConfigs6 = [{ name: "config", keyPath: "id" }];
       let existingBranding = null;
@@ -28606,10 +28791,14 @@ var ChatProvider = (props) => {
           debugLogger.error("\u274C Failed to fetch or apply branding config:", { error: err });
         });
       }
-      loadDocuments();
-      embeddingService.backfillMissingEmbeddings().catch((err) => {
-        debugLogger.error("\u274C Failed to backfill memory embeddings:", { error: err });
-      });
+      if (!isPlaygroundMode) {
+        loadDocuments();
+        embeddingService.backfillMissingEmbeddings().catch((err) => {
+          debugLogger.error("\u274C Failed to backfill memory embeddings:", { error: err });
+        });
+      } else {
+        debugLogger.info("ChatProvider: Playground mode skipping knowledge backfill");
+      }
     };
     initializeAsync();
   }, [props.packageSettings, loadDocuments]);
@@ -29063,7 +29252,7 @@ init_modelStore();
 init_ai_response_text_field();
 init_memory_modal();
 init_streaming_tts();
-var import_rxjs19 = require("rxjs");
+var import_rxjs20 = require("rxjs");
 init_debugLogger();
 init_util();
 var import_jsx_runtime32 = require("react/jsx-runtime");
@@ -29092,7 +29281,7 @@ var AIQueriesDrawer = ({ drawerOpen, onClose, onClearComplete, onNavigateToMain
   const [memoryModalOpen, setMemoryModalOpen] = (0, import_react39.useState)(false);
   const [contextMode, setContextMode] = (0, import_react39.useState)("local");
   const [expandedSections, setExpandedSections] = (0, import_react39.useState)(/* @__PURE__ */ new Set(["history", "voice"]));
-  const [audioSub, setAudioSub] = (0, import_react39.useState)(new import_rxjs19.Subscription());
+  const [audioSub, setAudioSub] = (0, import_react39.useState)(new import_rxjs20.Subscription());
   const [isContextSwitching, setIsContextSwitching] = (0, import_react39.useState)(false);
   const [isDrawerLoading, setIsDrawerLoading] = (0, import_react39.useState)(false);
   (0, import_react39.useEffect)(() => {
@@ -30755,7 +30944,7 @@ init_debugLogger();
 init_banditTheme();
 init_themeMap();
 init_useTTS();
-var import_rxjs20 = require("rxjs");
+var import_rxjs21 = require("rxjs");
 var import_jsx_runtime34 = require("react/jsx-runtime");
 var FULL_SCREEN_THRESHOLD = 100;
 var CDN_BASE2 = "https://cdn.burtson.ai/";
@@ -30822,7 +31011,7 @@ var ChatModal = ({
   const [modalLogo, setModalLogo] = (0, import_react42.useState)("https://cdn.burtson.ai/logos/bandit-ai-logo.png");
   const [modelAnchorEl, setModelAnchorEl] = (0, import_react42.useState)(null);
   const [voiceAnchorEl, setVoiceAnchorEl] = (0, import_react42.useState)(null);
-  const [audioSub, setAudioSub] = (0, import_react42.useState)(new import_rxjs20.Subscription());
+  const [audioSub, setAudioSub] = (0, import_react42.useState)(new import_rxjs21.Subscription());
   const [selectedTheme, setSelectedTheme] = (0, import_react42.useState)(null);
   const [themeLoading, setThemeLoading] = (0, import_react42.useState)(true);
   const [autoFullscreenTriggered, setAutoFullscreenTriggered] = (0, import_react42.useState)(false);
@@ -33363,7 +33552,7 @@ init_conversationSyncStore();
 
 // src/hooks/useGatewayQueries.ts
 var import_react45 = require("react");
-var import_rxjs21 = require("rxjs");
+var import_rxjs22 = require("rxjs");
 var import_react_query2 = require("@tanstack/react-query");
 init_packageSettingsStore();
 init_gateway_service();
@@ -33394,7 +33583,7 @@ var useGatewayHealth = (options) => {
       if (!service) {
         throw new Error("Gateway service is not configured");
       }
-      return (0, import_rxjs21.lastValueFrom)(service.getHealth());
+      return (0, import_rxjs22.lastValueFrom)(service.getHealth());
     },
     enabled
   });
@@ -33409,7 +33598,7 @@ var useGatewayModels = (options) => {
       if (!service) {
         throw new Error("Gateway service is not configured");
       }
-      return (0, import_rxjs21.lastValueFrom)(service.listModels());
+      return (0, import_rxjs22.lastValueFrom)(service.listModels());
     },
     enabled
   });
@@ -33424,7 +33613,7 @@ var useGatewayMemory = (options) => {
       if (!service) {
         throw new Error("Gateway service is not configured");
       }
-      return (0, import_rxjs21.lastValueFrom)(service.getMemory());
+      return (0, import_rxjs22.lastValueFrom)(service.getMemory());
     },
     enabled
   });
@@ -35181,7 +35370,7 @@ var BrandingTab = ({
                     )) }),
                     /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_material39.Paper, { elevation: 3, sx: { px: 2, py: 1.5, borderRadius: 2, width: "100%", maxWidth: 500 }, children: /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_material39.Typography, { variant: "body1", sx: { color: "text.secondary" }, children: "What's on your mind?" }) }),
                     /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)(import_material39.Typography, { variant: "caption", sx: { textAlign: "center", color: "text.secondary", mt: 1 }, children: [
-                      brandingText ? `${brandingText} \u2022 ` : "",
+                      brandingText ? `${brandingText} \u2022 ` : "Bandit AI \u2022 ",
                       "may be wrong \u2014 double-check important info."
                     ] })
                   ] })
@@ -37167,7 +37356,10 @@ var import_CheckCircle3 = __toESM(require("@mui/icons-material/CheckCircle"));
 var import_Error3 = __toESM(require("@mui/icons-material/Error"));
 init_debugLogger();
 init_indexedDBService();
+init_conversationSyncStore();
 var import_jsx_runtime42 = require("react/jsx-runtime");
+var DEFAULT_DISPLAY_QUOTA_BYTES = 1024 * 1024 * 1024;
+var MAX_DISPLAY_QUOTA_BYTES = 5 * 1024 * 1024 * 1024;
 var formatBytes = (bytes) => {
   if (bytes === 0) return "0 B";
   const k = 1024;
@@ -37384,20 +37576,22 @@ var estimateStoreSize = async (dbName, storeName) => {
       const storeConfigs6 = [{ name: storeName, keyPath: "id" }];
       try {
         const items = await indexedDBService_default.getAll(dbName, 1, storeName, storeConfigs6);
-        debugLogger.info(`Retrieved ${items?.length || 0} items from ${dbName}.${storeName}`);
-        if (!items || items.length === 0) {
+        const rawItems = Array.isArray(items) ? items : [];
+        debugLogger.info(`Retrieved ${rawItems.length} items from ${dbName}.${storeName}`);
+        if (rawItems.length === 0) {
           debugLogger.info(`No items found in ${dbName}.${storeName}`);
           return { size: 0, count: 0 };
         }
-        const totalSize = items.reduce((acc, item) => {
+        const totalSize = rawItems.reduce((acc, item) => {
           try {
-            return acc + JSON.stringify(item).length * 2;
+            return acc + JSON.stringify(item ?? "").length * 2;
           } catch {
             return acc + 1e3;
           }
         }, 0);
-        debugLogger.info(`Estimated size for ${dbName}.${storeName}: ${totalSize} bytes, ${items.length} items`);
-        return { size: totalSize, count: items.length };
+        const itemCount = rawItems.length;
+        debugLogger.info(`Estimated size for ${dbName}.${storeName}: ${totalSize} bytes, ${itemCount} items`);
+        return { size: totalSize, count: itemCount };
       } catch (dbError) {
         debugLogger.info(`Database ${dbName} or store ${storeName} does not exist or is inaccessible`, { error: dbError });
         return { size: 0, count: 0 };
@@ -37421,14 +37615,18 @@ var clearStorageCategory = async (category) => {
       }
       const storeConfigs6 = [{ name: storeName, keyPath: "id" }];
       const items = await indexedDBService_default.getAll(dbName, 1, storeName, storeConfigs6);
-      if (items && items.length > 0) {
-        for (const item of items) {
-          const key = item.id || item.key || item.name;
-          if (key) {
-            await indexedDBService_default.delete(dbName, 1, storeName, key, storeConfigs6);
+      const records = Array.isArray(items) ? items : [];
+      if (records.length > 0) {
+        for (const rawItem of records) {
+          if (rawItem && typeof rawItem === "object") {
+            const record = rawItem;
+            const candidate = record["id"] ?? record["key"] ?? record["name"];
+            if (typeof candidate === "string" && candidate.length > 0) {
+              await indexedDBService_default.delete(dbName, 1, storeName, candidate, storeConfigs6);
+            }
           }
         }
-        debugLogger.info(`Cleared ${items.length} items from ${dbName}.${storeName}`);
+        debugLogger.info(`Cleared ${records.length} items from ${dbName}.${storeName}`);
       } else {
         debugLogger.info(`No items found in ${dbName}.${storeName}`);
       }
@@ -37456,7 +37654,12 @@ var clearEntireDatabase = async (dbName) => {
 };
 var StorageTab = ({ currentTheme }) => {
   const theme = (0, import_material42.useTheme)();
-  const [storageQuota, setStorageQuota] = (0, import_react52.useState)({ used: 0, quota: 0 });
+  const [storageQuota, setStorageQuota] = (0, import_react52.useState)({
+    used: 0,
+    quota: 0,
+    available: 0,
+    browserQuotaEstimate: 0
+  });
   const [storageCategories, setStorageCategories] = (0, import_react52.useState)([]);
   const [loading, setLoading] = (0, import_react52.useState)(true);
   const [clearAllDialogOpen, setClearAllDialogOpen] = (0, import_react52.useState)(false);
@@ -37465,16 +37668,31 @@ var StorageTab = ({ currentTheme }) => {
   const [snackbarMessage, setSnackbarMessage] = (0, import_react52.useState)("");
   const [showSnackbar, setShowSnackbar] = (0, import_react52.useState)(false);
   const [snackbarSeverity, setSnackbarSeverity] = (0, import_react52.useState)("success");
+  const { syncEnabled, isAdvancedVectorFeaturesEnabled } = useConversationSyncStore((state) => ({
+    syncEnabled: state.syncEnabled,
+    isAdvancedVectorFeaturesEnabled: state.isAdvancedVectorFeaturesEnabled
+  }));
+  const syncFeaturesActive = syncEnabled || isAdvancedVectorFeaturesEnabled;
+  const usageSummaryMessage = syncFeaturesActive ? "IndexedDB/local storage is shown below. Conversation sync or advanced vector storage may copy items to your configured gateway." : "IndexedDB/local storage lives entirely in this browser when sync features are disabled.";
+  const storageStatusPrimary = syncFeaturesActive ? "IndexedDB/local storage (sync features enabled)" : "IndexedDB/local storage only";
   const loadStorageData = async () => {
     setLoading(true);
     try {
       debugLogger.info("Loading storage data...");
-      const [quota, categories] = await Promise.all([
+      const [quotaEstimate, categories] = await Promise.all([
         getStorageQuota(),
         getIndexedDBSize()
       ]);
+      const calculatedUsed = categories.reduce((sum, cat) => sum + cat.size, 0);
+      const browserQuota = quotaEstimate.quota && quotaEstimate.quota > 0 ? quotaEstimate.quota : 0;
+      let normalizedQuota = browserQuota > 0 ? Math.min(Math.max(browserQuota, calculatedUsed || DEFAULT_DISPLAY_QUOTA_BYTES), MAX_DISPLAY_QUOTA_BYTES) : Math.max(DEFAULT_DISPLAY_QUOTA_BYTES, calculatedUsed);
+      const available = Math.max(normalizedQuota - calculatedUsed, 0);
       debugLogger.info("Storage data loaded successfully", {
-        quota: quota.used + "/" + quota.quota,
+        browserQuota,
+        browserUsageEstimate: quotaEstimate.used,
+        normalizedQuota,
+        calculatedUsed,
+        available,
         categoriesCount: categories.length,
         categories: categories.map((cat) => ({
           name: cat.name,
@@ -37483,7 +37701,12 @@ var StorageTab = ({ currentTheme }) => {
           canClear: cat.canClear
         }))
       });
-      setStorageQuota(quota);
+      setStorageQuota({
+        used: calculatedUsed,
+        quota: normalizedQuota,
+        available,
+        browserQuotaEstimate: browserQuota
+      });
       setStorageCategories(categories);
     } catch (error) {
       debugLogger.error("Failed to load storage data", { error });
@@ -37491,7 +37714,7 @@ var StorageTab = ({ currentTheme }) => {
       setSnackbarSeverity("error");
       setShowSnackbar(true);
       setStorageCategories([]);
-      setStorageQuota({ used: 0, quota: 0 });
+      setStorageQuota({ used: 0, quota: DEFAULT_DISPLAY_QUOTA_BYTES, available: DEFAULT_DISPLAY_QUOTA_BYTES, browserQuotaEstimate: 0 });
     } finally {
       setLoading(false);
     }
@@ -37504,7 +37727,7 @@ var StorageTab = ({ currentTheme }) => {
   }, [storageCategories]);
   const usagePercentage = (0, import_react52.useMemo)(() => {
     if (storageQuota.quota === 0) return 0;
-    const percentage = storageQuota.used / storageQuota.quota * 100;
+    const percentage = Math.min(storageQuota.used / storageQuota.quota * 100, 100);
     return percentage > 0 && percentage < 0.1 ? 0.1 : percentage;
   }, [storageQuota]);
   const clearableCategories = (0, import_react52.useMemo)(() => {
@@ -37704,7 +37927,7 @@ var StorageTab = ({ currentTheme }) => {
             /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(
               import_material42.Chip,
               {
-                label: `${formatBytes(storageQuota.quota - storageQuota.used)} Available`,
+                label: `${formatBytes(storageQuota.available)} Available`,
                 color: "success",
                 size: "small",
                 variant: "outlined"
@@ -37718,6 +37941,15 @@ var StorageTab = ({ currentTheme }) => {
                 size: "small",
                 variant: "outlined"
               }
+            ),
+            storageQuota.browserQuotaEstimate > 0 && storageQuota.quota > 0 && Math.abs(storageQuota.browserQuotaEstimate - storageQuota.quota) > storageQuota.quota * 0.05 && /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(
+              import_material42.Chip,
+              {
+                label: `\u2248${formatBytes(storageQuota.browserQuotaEstimate)} Browser Estimate`,
+                color: "default",
+                size: "small",
+                variant: "outlined"
+              }
             )
           ] }),
           /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(
@@ -37775,7 +38007,7 @@ var StorageTab = ({ currentTheme }) => {
             }
           )
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(import_material42.Typography, { variant: "body2", color: "text.secondary", sx: { mt: "auto" }, children: "Data is stored locally in your browser and never sent to external servers." })
+        /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(import_material42.Typography, { variant: "body2", color: "text.secondary", sx: { mt: "auto" }, children: usageSummaryMessage })
       ] }) })
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(import_material42.Typography, { variant: "h6", gutterBottom: true, sx: { mb: 2, fontWeight: 600, color: "text.primary" }, children: "Storage Categories" }),
@@ -37903,12 +38135,19 @@ var StorageTab = ({ currentTheme }) => {
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)(import_material42.List, { children: [
         /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)(import_material42.ListItem, { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(import_material42.ListItemIcon, { children: /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(import_CheckCircle3.default, { color: "success" }) }),
+          /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(import_material42.ListItemIcon, { children: /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(
+            import_CheckCircle3.default,
+            {
+              sx: {
+                color: syncFeaturesActive ? theme.palette.warning.main : theme.palette.success.main
+              }
+            }
+          ) }),
           /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(
             import_material42.ListItemText,
             {
-              primary: "All data is stored locally",
-              secondary: "Your data never leaves your browser and is not sent to external servers"
+              primary: storageStatusPrimary,
+              secondary: syncFeaturesActive ? "Some features (conversation sync or advanced vector storage) can sync items to your configured gateway storage." : "With conversation sync and advanced vector storage turned off, everything stays in this browser."
             }
           )
         ] }),
@@ -38203,6 +38442,11 @@ var ProviderTab = () => {
           provider: "openai"
         });
         break;
+      case "playground" /* PLAYGROUND */:
+        setProviderConfig({
+          ...baseConfig
+        });
+        break;
     }
   };
   const handleSaveProviderConfig = async () => {
@@ -38322,7 +38566,8 @@ var ProviderTab = () => {
                 /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(import_material43.MenuItem, { value: "ollama", children: "Ollama" }),
                 /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(import_material43.MenuItem, { value: "openai", children: "OpenAI" }),
                 /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(import_material43.MenuItem, { value: "azure-openai", children: "Azure OpenAI" }),
-                /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(import_material43.MenuItem, { value: "anthropic", children: "Anthropic" })
+                /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(import_material43.MenuItem, { value: "anthropic", children: "Anthropic" }),
+                /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(import_material43.MenuItem, { value: "playground", children: "Playground (Mock Demo)" })
               ]
             }
           ),