@courseecho/ai-core-sdk 1.0.27 → 1.0.28

package/dist/communication-service.js

@@ -14,6 +14,33 @@ async function safeJson(res) {
         return null;
     }
 }
+// ─── Page-text capture helper ─────────────────────────────────────────────────
+/**
+ * Extracts visible rendered text from the current page, deduplicated and capped
+ * at `maxChars` characters.  Covers SPA content (course cards, mentor profiles,
+ * employee tables, etc.) that server-side crawlers cannot see.
+ *
+ * Priority: <main> → [role="main"] → <article> → document.body
+ * Safe to call in SSR/Node environments — returns '' when `document` is absent.
+ */
+function capturePageText(maxChars = 8000) {
+    try {
+        if (typeof document === 'undefined')
+            return '';
+        const candidates = [
+            document.querySelector('main'),
+            document.querySelector('[role="main"]'),
+            document.querySelector('article'),
+            document.body,
+        ];
+        const el = candidates.find((c) => c && (c.innerText?.trim().length ?? 0) > 50) ?? document.body;
+        const raw = (el?.innerText ?? '').replace(/\s{3,}/g, '\n\n').trim();
+        return raw.length > maxChars ? raw.slice(0, maxChars) : raw;
+    }
+    catch {
+        return '';
+    }
+}
 export class AiCommunicationService {
     constructor(apiEndpoint, apiKey, minRequestIntervalMs = 1500) {
         this.lastQuotaInfo = null;
@@ -123,11 +150,20 @@ export class AiCommunicationService {
         else if (this.apiKey) {
             headers['X-API-Key'] = this.apiKey;
         }
+        // Capture live rendered page text so the AI can answer from SPA content
+        // (mentor cards, course listings, employee tables, etc.) that server-side
+        // crawlers cannot see.  We prefer targeted semantic regions for cleaner data.
+        const enrichedRequest = {
+            ...request,
+            pageText: request.pageText ?? capturePageText(8000),
+            pageUrl: request.pageUrl ?? (typeof window !== 'undefined' ? window.location.href : undefined),
+            pageTitle: request.pageTitle ?? (typeof window !== 'undefined' ? document.title : undefined),
+        };
         try {
             const response = await fetch(`${this.apiEndpoint}/api/aiorchestrator/query`, {
                 method: 'POST',
                 headers,
-                body: JSON.stringify(request),
+                body: JSON.stringify(enrichedRequest),
             });
             if (!response.ok) {
                 const errorData = await safeJson(response);

package/dist/models.d.ts

@@ -159,12 +159,57 @@ export interface AiContextConfig {
          */
         minRequestIntervalMs?: number;
     };
+    /**
+     * Mobile responsiveness configuration.
+     * Controls how the widget behaves on mobile devices (< 768px).
+     */
+    mobileConfig?: {
+        /**
+         * Enable collapsible mobile view.
+         * On small screens, shows a small icon that expands when clicked.
+         * Default: true
+         */
+        enableCollapsible?: boolean;
+        /**
+         * Width breakpoint (in px) below which mobile view activates.
+         * Default: 768
+         */
+        breakpoint?: number;
+        /**
+         * Height of the collapsed preview badge (in px).
+         * Default: 60
+         */
+        collapsedHeight?: number;
+        /**
+         * Width of the collapsed preview badge (in px).
+         * Default: 60
+         */
+        collapsedWidth?: number;
+        /**
+         * Animation duration for expand/collapse (in ms).
+         * Default: 300
+         */
+        animationDuration?: number;
+        /**
+         * Show a pulsing indicator on the collapsed badge to attract attention.
+         * Default: true
+         */
+        showPulsingIndicator?: boolean;
+    };
 }
 export interface AiQueryRequest {
     userQuery: string;
     pageType: string;
     entityId?: string;
     contextData?: Record<string, any>;
+    pageUrl?: string;
+    pageTitle?: string;
+    /**
+     * Rendered page text captured from the user's browser (document.body.innerText).
+     * Provides live page content for SPAs where content is injected via API calls
+     * and is not available in the server-side crawl.
+     */
+    pageText?: string;
     [key: string]: any;
 }
 export interface AiQueryResponse {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@courseecho/ai-core-sdk",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "description": "Framework-agnostic core AI chat SDK. Shared logic for all framework wrappers.",
   "license": "MIT",
   "author": "CourseEcho",