@yuktishaalaa/yuktai 5.3.7 → 5.3.9

package/README.md

@@ -46,6 +46,77 @@ Six modules ship in a single npm package, for React/Next.js and, since v5.3, for
 
 ---
 
+## What's new in v5.3.9: `YuktAIWrapper` launcher, opt-in buttons, Rust Ask page
+
+Turn on only the buttons a site needs, put them behind one launcher, and let 💬 Ask page find answers with the Rust RAG first.
+
+```tsx
+"use client";
+import type { ReactNode } from "react";
+import { YuktAIWrapper } from "@yuktishaalaa/yuktai";
+
+export default function YuktaiClient({ children }: { children: ReactNode }) {
+  return (
+    <YuktAIWrapper position="left" launcher showAccessibility showRag showAgent showVibeCoder engine="rust">
+      {children}
+    </YuktAIWrapper>
+  );
+}
+```
+
+| Prop | Button |
+|---|---|
+| `launcher` | ✨ one button that shows/hides the others. Remembers the visitor's choice, closes with Esc, sets `<html data-yuktai-tools="open\|closed">` for styling |
+| `showAccessibility` | ♿ Accessibility preferences |
+| `showRag` | 💬 Ask page |
+| `showAgent` | 🤖 AI Agent |
+| `showVibeCoder` | ⚡ Vibe Coder (a developer tool; leave it off on public sites) |
+| `engine` | 💬 Ask page search: `"rust"`, `"auto"` or `"ts"` |
+
+- **Opt-in:** as soon as you set `launcher`, `showAccessibility` or `showVibeCoder`, only the buttons you turn on are shown, stacked with no gaps. Without those props the wrapper behaves exactly as before (♿ always; ⚡ with `showAgent`).
+- **💬 with `engine`:** the page RAG finds the best passages first (Rust: fast, offline, Telugu-aware) and shows them at once with "From this page" and the search time. If Gemini Nano or Transformers.js is available, the model then writes the answer from **only those passages**, instead of reading the whole page (Gemini) or embedding every chunk for each question (Transformers.js). It works even with no model at all. Without `engine`, 💬 works exactly as before.
+- **Fixes:** ⚡ Vibe Coder can now be turned off on its own (it used to follow `showAgent`); Esc now closes the Vibe Coder panel too.
+
+---
+
+## What's new in v5.3.8: Rust RAG for "Ask page" (optional)
+
+The page + data search behind **Ask page** (`createContextIndex`, used after `askAboutPage`) can now run in **Rust**. Same passages, same BM25 scores (bit for bit), same answers: only faster. Free, offline, and it works in PWAs: the engine (about 33 KB of WebAssembly) is embedded in the package.
+
+```tsx
+<AgenticPanel engine="rust" />                                  // React / Next.js: Ask page tab
+```
+
+```js
+yuktai.mountAgenticPanel("#tools", { engine: "rust" })            // plain HTML
+const index = yuktai.createContextIndex({ rows, columns, engine: "rust" })
+await index.ask("Which office handles leave requests?")
+```
+
+| `engine` | What runs |
+|---|---|
+| `"ts"` (default) | TypeScript, unchanged |
+| `"rust"` | Rust inverted index for every search |
+| `"auto"` | Rust from 1,000 passages |
+
+- **How it is faster:** TypeScript scans every word of every passage for each question. Rust builds an inverted index once and jumps straight to the passages that contain the question's words (and their longer/shorter forms, as before).
+- **Same results, tested:** TypeScript still tokenizes (Telugu-aware) and computes `idf` with `Math.log`; Rust does the counting and the BM25 arithmetic in the same order, so scores match bit for bit. Tests compare both engines on English and Telugu documents, grid rows and real page text (1,000+ searches).
+- **Measured** (Node 22, median, per question):
+
+| Content | TypeScript | Rust | Speed-up |
+|---|---|---|---|
+| Long page, 500 passages | 2.3 ms | 0.08 ms | 27× |
+| Help docs, 5,000 passages | 18.8 ms | 0.45 ms | 42× |
+| Grid, 1,00,000 rows | 46.2 ms | 3.4 ms | 14× |
+
+  Rust builds its index once per content change (240 ms for 1 lakh rows); every question after that is fast.
+- **Also faster for everyone (both engines):** asking again on an unchanged page no longer rebuilds the index (6 ms instead of 183 ms for 5,000 passages). The React Ask tab now reuses its index between questions, like the vanilla panel.
+- **PWA:** the demo's service worker cache is now `yuktai-vanilla-v5.3.8`, so installed apps pick up the new engine.
+
+Source: [`rust/rag-core`](./rust/rag-core) (no dependencies, `no_std` + `alloc`). Rust tests: `npm run test:rust`.
+
+---
+
 ## What's new in v5.3.5: Rust grid engine (optional)
 
 The grid's existing search and number/date sorting can now run in **Rust**, compiled to WebAssembly. Nothing else changes: same rows, same order, same API. The default is still TypeScript, so existing apps behave exactly as before.

package/dist/{agent-JGLAYQMX.mjs → agent-G67IA7MY.mjs}

@@ -10,7 +10,7 @@ The page has form fields the user may need to fill.`:""}
 
 User task: ${a}
 
-Action plan:`,i=await c.prompt(r);return c.destroy(),i?.trim()||""}async function H(n,a){let{askPageWithTransformers:t}=await import("./transformers-rag-HW4QKA5T.mjs");return(await t(`How do I: ${a}`)).answer||"I could not create a plan for this task."}async function S(n,a,t){if(!n.trim())return{success:!1,steps:[],error:"Please tell me what you want to do."};if(!a)return{success:!1,steps:[],error:"No AI engine available on this device."};let o=[],l=(c,e="info")=>{let r={text:c,type:e};o.push(r),t(r)};try{l("\u{1F4D6} Reading page content...","info");let c=T(),e=x(),r=e.length>0;c.length<50&&l("\u26A0\uFE0F Page content is very limited. This may be a static image page.","error"),l(r?`\u{1F4CB} Found ${e.length} form field${e.length!==1?"s":""} on this page`:"\u{1F4C4} No form fields found \u2014 this appears to be a content page","info"),l("\u{1F916} Creating action plan...","info");let i="";try{a==="gemini"?i=await M(c,n,r):i=await H(c,n)}catch{i=r?`1. Locate the form on this page
+Action plan:`,i=await c.prompt(r);return c.destroy(),i?.trim()||""}async function H(n,a){let{askPageWithTransformers:t}=await import("./transformers-rag-MQZRMFTG.mjs");return(await t(`How do I: ${a}`)).answer||"I could not create a plan for this task."}async function S(n,a,t){if(!n.trim())return{success:!1,steps:[],error:"Please tell me what you want to do."};if(!a)return{success:!1,steps:[],error:"No AI engine available on this device."};let o=[],l=(c,e="info")=>{let r={text:c,type:e};o.push(r),t(r)};try{l("\u{1F4D6} Reading page content...","info");let c=T(),e=x(),r=e.length>0;c.length<50&&l("\u26A0\uFE0F Page content is very limited. This may be a static image page.","error"),l(r?`\u{1F4CB} Found ${e.length} form field${e.length!==1?"s":""} on this page`:"\u{1F4C4} No form fields found \u2014 this appears to be a content page","info"),l("\u{1F916} Creating action plan...","info");let i="";try{a==="gemini"?i=await M(c,n,r):i=await H(c,n)}catch{i=r?`1. Locate the form on this page
 2. Fill each required field
 3. Review your answers
 4. Submit the form`:`1. Read the page carefully

package/dist/chunk-P2PBML6K.mjs

@@ -0,0 +1,11 @@
+function i(){return new Promise(t=>{let r=setTimeout(t,1500),e=new MutationObserver(()=>{clearTimeout(r),r=setTimeout(()=>{e.disconnect(),t()},500)});e.observe(document.body,{childList:!0,subtree:!0})})}function c(){let t=[],r=document.querySelectorAll("*");for(let e of r){if(e.closest("[data-yuktai-panel]"))continue;let s=e.innerText?.trim();s&&s.length>30&&t.push(s);let n=e.getAttribute("aria-label");if(n&&n.length>10&&t.push(n),(e instanceof HTMLInputElement||e instanceof HTMLTextAreaElement)&&(e.placeholder&&t.push(e.placeholder),e.value&&t.push(e.value)),e instanceof HTMLButtonElement){let a=e.innerText||e.getAttribute("aria-label");a&&t.push(a)}}return t.join(" ").slice(0,3500)}async function l(t){if(!t.trim())return{success:!1,answer:"",error:"Please type a question."};try{let r=window,e=r.LanguageModel||r.ai?.languageModel;if(!e)return{success:!1,answer:"",error:"Gemini Nano not available."};await i();let s=c();if(!s||s.length<100)return{success:!1,answer:"",error:"Page content not readable."};let n;try{n=await e.create({systemPrompt:`Answer ONLY using page content.
+Keep answer short (2\u20133 sentences).
+If not found say: "I could not find that on this page."`,outputLanguage:"en"})}catch{n=await e.create()}let a=`Page:
+${s}
+
+Q: ${t}`,o=await n.prompt(a);return n?.destroy&&n.destroy(),{success:!0,answer:o?.trim()||"No answer found."}}catch(r){return{success:!1,answer:"",error:r instanceof Error?r.message:"Error occurred"}}}async function f(t,r){if(!t.trim()||!r.trim())return{success:!1,answer:"",error:"Nothing to answer from."};try{let e=window,s=e.LanguageModel||e.ai?.languageModel;if(!s)return{success:!1,answer:"",error:"Gemini Nano not available."};let n;try{n=await s.create({systemPrompt:`Answer ONLY using page content.
+Keep answer short (2\u20133 sentences).
+If not found say: "I could not find that on this page."`,outputLanguage:"en"})}catch{n=await s.create()}let a=await n.prompt(`Page:
+${r.slice(0,3500)}
+
+Q: ${t}`);return n?.destroy&&n.destroy(),{success:!0,answer:a?.trim()||"No answer found."}}catch(e){return{success:!1,answer:"",error:e instanceof Error?e.message:"Error occurred"}}}export{l as a,f as b};

package/dist/chunk-UO7IGXCC.mjs

@@ -0,0 +1,13 @@
+var g=null,m=null,l=!1,f=!1;function h(){return typeof navigator>"u"?!1:/Android|iPhone|iPad|iPod|Mobile|Tablet/i.test(navigator.userAgent)}function p(){if(h())return"wasm";try{if(typeof navigator<"u"&&"gpu"in navigator&&navigator.gpu!==void 0)return"webgpu"}catch{}return"wasm"}async function w(){if(!f){if(l){for(;l;)await new Promise(e=>setTimeout(e,200));return}l=!0;try{let{pipeline:e,env:t}=await import("@huggingface/transformers");t.allowRemoteModels=!0,t.allowLocalModels=!1,typeof window<"u"&&typeof caches<"u"&&(t.useWasmCache=!0);let n=p(),s=h();console.log(`yuktai: Transformers.js \u2014 device: ${n}, mobile: ${s}`),g=await e("feature-extraction","Xenova/all-MiniLM-L6-v2",{device:n,dtype:s?"q4":"fp32"}),m=await e("text2text-generation","Xenova/flan-t5-small",{device:n,dtype:s?"q4":"fp32"}),f=!0,l=!1,console.log("yuktai: Transformers.js models loaded \u2705")}catch(e){throw l=!1,console.error("yuktai: Transformers.js model load failed",e),e}}}function y(){return new Promise(e=>{let t=setTimeout(e,1500),n=new MutationObserver(()=>{clearTimeout(t),t=setTimeout(()=>{n.disconnect(),e()},500)});n.observe(document.body,{childList:!0,subtree:!0})})}function b(){let e=[],t=new Set,n=document.querySelectorAll("p, h1, h2, h3, h4, h5, h6, li, td, th, label, figcaption, blockquote, span, a, button, div");for(let i of n){if(i.closest("[data-yuktai-panel]")||i.querySelector("p, h1, h2, h3, h4, li, td, div"))continue;let a=i.innerText?.trim();if(!a||a.length<15||t.has(a))continue;t.add(a),e.push(a);let c=i.getAttribute("aria-label")?.trim();c&&c.length>8&&!t.has(c)&&(t.add(c),e.push(c))}let s=document.title?.trim();s&&!t.has(s)&&e.unshift(s);let r=document.querySelector('meta[name="description"]')?.getAttribute("content")?.trim();return r&&!t.has(r)&&e.unshift(r),e.join(" ").slice(0,8e3)}function v(e,t=150,n=30){if(typeof e!="string")try{e=String(e??"")}catch{return[]}let s=e.trim();if(!s)return[];let o=Math.min(n,Math.floor(t/2)),r=s.split(/\s+/),i=[],u=t-o;for(let a=0;a<r.length;a+=u){let c=r.slice(a,a+t).join(" ");c.trim().length>20&&i.push(c)}return i}function k(e,t){let n=0,s=0,o=0;for(let r=0;r<e.length;r++)n+=e[r]*t[r],s+=e[r]*e[r],o+=t[r]*t[r];return n/(Math.sqrt(s)*Math.sqrt(o)+1e-8)}async function d(e){let t=await g(e,{pooling:"mean",normalize:!0}),n=t?.data??t;return Array.from(n)}async function x(e,t,n=3){let s=await d(e),o=await Promise.all(t.map(async r=>{let i=await d(r),u=k(s,i);return{chunk:r,score:u}}));return o.sort((r,i)=>i.score-r.score),o.slice(0,n).map(r=>r.chunk)}async function M(e){if(!e.trim())return{success:!1,answer:"",error:"Please type a question."};try{await w(),await y();let t=b();if(!t||t.length<50)return{success:!1,answer:"",error:"Not enough content on this page."};let n=v(t);if(n.length===0)return{success:!1,answer:"",error:"Could not process page content."};let r=`Answer the question based on the context. Give a complete answer in 2-3 sentences.
+
+Context: ${(await x(e,n,3)).join(" ").slice(0,1200)}
+
+Question: ${e}
+
+Answer:`,u=(await m(r,{max_new_tokens:120,min_new_tokens:10}))?.[0]?.generated_text?.trim()||"";return u?{success:!0,answer:u}:{success:!0,answer:"I could not find a specific answer on this page."}}catch(t){console.error("yuktai: Transformers RAG error",t);let n=t instanceof Error?t.message:"";return n.includes("Out of memory")||n.includes("memory")?{success:!1,answer:"",error:"Not enough device memory. Try on a device with more RAM or use desktop Chrome with Gemini Nano."}:{success:!1,answer:"",error:n||"Transformers.js error."}}}async function P(e,t){if(!e.trim()||!t.trim())return{success:!1,answer:"",error:"Nothing to answer from."};try{await w();let n=`Answer the question based on the context. Give a complete answer in 2-3 sentences.
+
+Context: ${t.slice(0,1200)}
+
+Question: ${e}
+
+Answer:`,o=(await m(n,{max_new_tokens:120,min_new_tokens:10}))?.[0]?.generated_text?.trim()||"";return o?{success:!0,answer:o}:{success:!1,answer:"",error:"No answer generated."}}catch(n){return{success:!1,answer:"",error:n instanceof Error?n.message:"Transformers.js error."}}}function A(){try{return typeof WebAssembly<"u"&&typeof Worker<"u"}catch{return!1}}function C(){return f?"ready":l?"loading":"idle"}export{M as a,P as b,A as c,C as d};

package/dist/index.d.mts

@@ -93,25 +93,6 @@ declare const wcagPlugin: {
     }[];
 };
 
-interface YuktAIWrapperProps {
-    position?: "left" | "right";
-    children: ReactNode;
-    config?: Partial<A11yConfig>;
-    showRag?: boolean;
-    showAgent?: boolean;
-}
-declare function YuktAIWrapper({ position, children, config: configOverrides, showRag, showAgent, }: YuktAIWrapperProps): react__default.JSX.Element;
-
-declare const aiPlugin: {
-    name: string;
-    execute(input: string): Promise<string>;
-};
-
-declare const voicePlugin: {
-    name: string;
-    execute(input: string): Promise<string>;
-};
-
 /** Which engine sorts and searches the grid. */
 type GridEngine = "ts" | "rust" | "auto";
 /** `engine: "auto"` switches to Rust from this many rows. */
@@ -158,6 +139,38 @@ declare class GridCore {
     sortByKeys(keys: Float64Array, desc: boolean): Uint32Array | null;
 }
 
+interface YuktAIWrapperProps {
+    position?: "left" | "right";
+    children: ReactNode;
+    config?: Partial<A11yConfig>;
+    showRag?: boolean;
+    showAgent?: boolean;
+    /** v5.3.9 — show ♿ Accessibility. Setting this (or showVibeCoder/launcher) switches every button to opt-in. */
+    showAccessibility?: boolean;
+    /** v5.3.9 — show ⚡ Vibe Coder (a developer tool; in legacy mode it follows showAgent). */
+    showVibeCoder?: boolean;
+    /** v5.3.9 — one ✨ button that shows/hides the others; remembers the choice; Esc closes. */
+    launcher?: boolean;
+    /**
+     * v5.3.9 — 💬 Ask page finds passages first with the page RAG ("rust",
+     * "auto" or "ts"), shows them at once, then lets Gemini Nano /
+     * Transformers.js write the answer from only those passages.
+     * Not set: 💬 works exactly as before.
+     */
+    engine?: GridEngine;
+}
+declare function YuktAIWrapper({ position, children, config: configOverrides, showRag, showAgent, showAccessibility, showVibeCoder, launcher, engine, }: YuktAIWrapperProps): react__default.JSX.Element;
+
+declare const aiPlugin: {
+    name: string;
+    execute(input: string): Promise<string>;
+};
+
+declare const voicePlugin: {
+    name: string;
+    execute(input: string): Promise<string>;
+};
+
 /** One search/sort run: what was searched, how long it took, which engine answered. */
 interface GridSearchTime {
     /** The search text ("" when only sorting) */
@@ -1094,6 +1107,12 @@ interface ContextIndexOptions<T = Record<string, unknown>> {
         id: string;
         text: string;
     }>;
+    /**
+     * Search engine: "ts" (default), "rust" (always) or "auto" (Rust from 1,000
+     * passages). Same passages, same scores, same order; Rust is faster on long
+     * pages and big grids. Works offline (the engine is embedded).
+     */
+    engine?: GridEngine;
 }
 declare function createContextIndex<T>(options?: ContextIndexOptions<T>): {
     search: (question: string, k?: number) => ContextHit[];
@@ -1105,6 +1124,10 @@ declare function createContextIndex<T>(options?: ContextIndexOptions<T>): {
     rebuild: () => void;
     update(next: Partial<ContextIndexOptions<T>>): void;
     size: () => number;
+    /** "rust" when the Rust engine answers searches for this index, else "ts". */
+    readonly engine: "rust" | "ts";
+    /** Resolves "rust" or "ts" once the engine is loaded (or not wanted). */
+    whenEngineReady: () => Promise<"ts" | "rust">;
 };
 
 type TaskAction = "filter" | "highlight" | "sort" | "clear" | "count" | "summarize" | "anomalies" | "open" | "select";
@@ -1271,9 +1294,11 @@ interface AgenticPanelProps {
     voiceLang?: string;
     /** Optional model hook for Ask page, e.g. Gemini Nano or your own API. */
     generate?: (question: string, context: string) => Promise<string>;
+    /** Ask page search engine: "ts" (default), "rust" or "auto". Same answers; Rust is faster on long pages. */
+    engine?: GridEngine;
     style?: CSSProperties;
 }
-declare function AgenticPanel({ defaultTab, voiceLang, generate, style }: AgenticPanelProps): react.JSX.Element;
+declare function AgenticPanel({ defaultTab, voiceLang, generate, engine, style }: AgenticPanelProps): react.JSX.Element;
 
 declare global {
     var __yuktai_runtime__: Runtime | undefined;

package/dist/index.d.ts

@@ -93,25 +93,6 @@ declare const wcagPlugin: {
     }[];
 };
 
-interface YuktAIWrapperProps {
-    position?: "left" | "right";
-    children: ReactNode;
-    config?: Partial<A11yConfig>;
-    showRag?: boolean;
-    showAgent?: boolean;
-}
-declare function YuktAIWrapper({ position, children, config: configOverrides, showRag, showAgent, }: YuktAIWrapperProps): react__default.JSX.Element;
-
-declare const aiPlugin: {
-    name: string;
-    execute(input: string): Promise<string>;
-};
-
-declare const voicePlugin: {
-    name: string;
-    execute(input: string): Promise<string>;
-};
-
 /** Which engine sorts and searches the grid. */
 type GridEngine = "ts" | "rust" | "auto";
 /** `engine: "auto"` switches to Rust from this many rows. */
@@ -158,6 +139,38 @@ declare class GridCore {
     sortByKeys(keys: Float64Array, desc: boolean): Uint32Array | null;
 }
 
+interface YuktAIWrapperProps {
+    position?: "left" | "right";
+    children: ReactNode;
+    config?: Partial<A11yConfig>;
+    showRag?: boolean;
+    showAgent?: boolean;
+    /** v5.3.9 — show ♿ Accessibility. Setting this (or showVibeCoder/launcher) switches every button to opt-in. */
+    showAccessibility?: boolean;
+    /** v5.3.9 — show ⚡ Vibe Coder (a developer tool; in legacy mode it follows showAgent). */
+    showVibeCoder?: boolean;
+    /** v5.3.9 — one ✨ button that shows/hides the others; remembers the choice; Esc closes. */
+    launcher?: boolean;
+    /**
+     * v5.3.9 — 💬 Ask page finds passages first with the page RAG ("rust",
+     * "auto" or "ts"), shows them at once, then lets Gemini Nano /
+     * Transformers.js write the answer from only those passages.
+     * Not set: 💬 works exactly as before.
+     */
+    engine?: GridEngine;
+}
+declare function YuktAIWrapper({ position, children, config: configOverrides, showRag, showAgent, showAccessibility, showVibeCoder, launcher, engine, }: YuktAIWrapperProps): react__default.JSX.Element;
+
+declare const aiPlugin: {
+    name: string;
+    execute(input: string): Promise<string>;
+};
+
+declare const voicePlugin: {
+    name: string;
+    execute(input: string): Promise<string>;
+};
+
 /** One search/sort run: what was searched, how long it took, which engine answered. */
 interface GridSearchTime {
     /** The search text ("" when only sorting) */
@@ -1094,6 +1107,12 @@ interface ContextIndexOptions<T = Record<string, unknown>> {
         id: string;
         text: string;
     }>;
+    /**
+     * Search engine: "ts" (default), "rust" (always) or "auto" (Rust from 1,000
+     * passages). Same passages, same scores, same order; Rust is faster on long
+     * pages and big grids. Works offline (the engine is embedded).
+     */
+    engine?: GridEngine;
 }
 declare function createContextIndex<T>(options?: ContextIndexOptions<T>): {
     search: (question: string, k?: number) => ContextHit[];
@@ -1105,6 +1124,10 @@ declare function createContextIndex<T>(options?: ContextIndexOptions<T>): {
     rebuild: () => void;
     update(next: Partial<ContextIndexOptions<T>>): void;
     size: () => number;
+    /** "rust" when the Rust engine answers searches for this index, else "ts". */
+    readonly engine: "rust" | "ts";
+    /** Resolves "rust" or "ts" once the engine is loaded (or not wanted). */
+    whenEngineReady: () => Promise<"ts" | "rust">;
 };
 
 type TaskAction = "filter" | "highlight" | "sort" | "clear" | "count" | "summarize" | "anomalies" | "open" | "select";
@@ -1271,9 +1294,11 @@ interface AgenticPanelProps {
     voiceLang?: string;
     /** Optional model hook for Ask page, e.g. Gemini Nano or your own API. */
     generate?: (question: string, context: string) => Promise<string>;
+    /** Ask page search engine: "ts" (default), "rust" or "auto". Same answers; Rust is faster on long pages. */
+    engine?: GridEngine;
     style?: CSSProperties;
 }
-declare function AgenticPanel({ defaultTab, voiceLang, generate, style }: AgenticPanelProps): react.JSX.Element;
+declare function AgenticPanel({ defaultTab, voiceLang, generate, engine, style }: AgenticPanelProps): react.JSX.Element;
 
 declare global {
     var __yuktai_runtime__: Runtime | undefined;