@myscheme/voice-navigation-sdk 0.1.0 → 0.1.2

package/dist/actions.d.ts

@@ -1,4 +1,7 @@
 import type { NavigationAction, ActionContext, ActionResult, AgentActionResponse } from "./types.js";
+import type { PageRegistry } from "./services/page-registry.js";
+export declare const setPageRegistry: (registry: PageRegistry) => void;
+export declare const getPageRegistry: () => PageRegistry | null;
 export declare const setZoomScale: (scale: number) => number;
 export declare const adjustZoom: (delta: number) => number;
 export declare const formatActionLabel: (action: string) => string;

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACpB,MAAM,YAAY,CAAC;AA0EpB,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAS5C,CAAC;AAKF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAM1C,CAAC;AAKF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAElD,CAAC;AAKF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,gBAAgB,EACxB,UAAS,aAAkB,KAC1B,YAoaF,CAAC;AAKF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,GAAG,KAAG,mBAAmB,GAAG,IAgCtE,CAAC;AAKF,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI,gBAE1D,CAAC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAsChE,eAAO,MAAM,eAAe,GAAI,UAAU,YAAY,KAAG,IAOxD,CAAC;AAKF,eAAO,MAAM,eAAe,QAAO,YAAY,GAAG,IAEjD,CAAC;AAkCF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAS5C,CAAC;AAKF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAM1C,CAAC;AAKF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAElD,CAAC;AAKF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,gBAAgB,EACxB,UAAS,aAAkB,KAC1B,YA4VF,CAAC;AAKF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,GAAG,KAAG,mBAAmB,GAAG,IAiCtE,CAAC;AAKF,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI,gBAY1D,CAAC"}

package/dist/actions.js

@@ -1,4 +1,4 @@
-const ALLOWED_ACTIONS = new Set([
+const CORE_ACTIONS = new Set([
     "zoom_in",
     "zoom_out",
     "scroll_up",
@@ -23,20 +23,20 @@ const ALLOWED_ACTIONS = new Set([
     "pause_media",
     "mute_media",
     "unmute_media",
-    "navigate_home",
     "search_content",
-    "navigate_search",
-    "navigate_faqs",
-    "navigate_help",
-    "navigate_contact",
-    "navigate_about",
-    "navigate_screen_reader",
-    "navigate_accessibility",
-    "navigate_disclaimer",
-    "navigate_terms_conditions",
     "stop",
     "unknown",
 ]);
+let globalPageRegistry = null;
+export const setPageRegistry = (registry) => {
+    globalPageRegistry = registry;
+    if (typeof window !== "undefined") {
+        window.__navigatePageRegistry = registry;
+    }
+};
+export const getPageRegistry = () => {
+    return globalPageRegistry;
+};
 const ZOOM_STEP = 0.1;
 const MIN_ZOOM = 0.5;
 const MAX_ZOOM = 2.0;
@@ -337,92 +337,12 @@ export const performAgentAction = (action, context = {}) => {
             }
             break;
         }
-        case "navigate_home": {
-            notifyNavigationIntent(context, "/");
-            window.location.href = "/";
-            console.log("Navigating to home");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
         case "search_content": {
             console.log("Vector search action delegated to controller");
             info.searchPending = true;
             performed = false;
             break;
         }
-        case "navigate_search": {
-            notifyNavigationIntent(context, "/search");
-            window.location.href = "/search";
-            console.log("Navigating to search");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_faqs": {
-            notifyNavigationIntent(context, "/faqs");
-            window.location.href = "/faqs";
-            console.log("Navigating to FAQs");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_help": {
-            notifyNavigationIntent(context, "/help");
-            window.location.href = "/help";
-            console.log("Navigating to help");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_contact": {
-            notifyNavigationIntent(context, "/contact");
-            window.location.href = "/contact";
-            console.log("Navigating to contact");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_about": {
-            notifyNavigationIntent(context, "/about");
-            window.location.href = "/about";
-            console.log("Navigating to about");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_screen_reader": {
-            notifyNavigationIntent(context, "/screen-reader-access");
-            window.location.href = "/screen-reader-access";
-            console.log("Navigating to screen reader");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_accessibility": {
-            notifyNavigationIntent(context, "/accessibility");
-            window.location.href = "/accessibility";
-            console.log("Navigating to accessibility");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_disclaimer": {
-            notifyNavigationIntent(context, "/disclaimer");
-            window.location.href = "/disclaimer";
-            console.log("Navigating to disclaimer");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
-        case "navigate_terms_conditions": {
-            notifyNavigationIntent(context, "/terms-and-conditions");
-            window.location.href = "/terms-and-conditions";
-            console.log("Navigating to terms and conditions");
-            info.navigated = true;
-            performed = true;
-            break;
-        }
         case "stop": {
             console.log("Stop command received");
             if (onStop) {
@@ -432,6 +352,22 @@ export const performAgentAction = (action, context = {}) => {
             break;
         }
         default: {
+            if (action.startsWith("navigate_") && globalPageRegistry) {
+                const pageId = globalPageRegistry.getPageIdFromAction(action);
+                if (pageId) {
+                    const page = globalPageRegistry.getPageById(pageId);
+                    if (page) {
+                        notifyNavigationIntent(context, page.path);
+                        window.location.href = page.path;
+                        console.log(`Navigating to ${page.name} (${page.path})`);
+                        info.navigated = true;
+                        info.pageName = page.name;
+                        info.pagePath = page.path;
+                        performed = true;
+                        break;
+                    }
+                }
+            }
             console.log(`Unknown action: ${action}`);
             performed = false;
             break;
@@ -446,8 +382,10 @@ export const extractAgentAction = (result) => {
     if (!result) {
         return null;
     }
+    if (typeof result === "object" && !Array.isArray(result) && result.action) {
+        return result;
+    }
     let raw = "";
-    console.log("Extracting action from result:", result, typeof result);
     if (typeof result === "string") {
         raw = result;
     }
@@ -457,10 +395,6 @@ export const extractAgentAction = (result) => {
     else if (result.text) {
         raw = result.text;
     }
-    else if (typeof result === "object" && result?.action) {
-        raw = result?.action;
-    }
-    console.log("raw reslt", raw, result);
     if (!raw) {
         return null;
     }
@@ -474,5 +408,11 @@ export const extractAgentAction = (result) => {
     }
 };
 export const isAllowedAction = (action) => {
-    return ALLOWED_ACTIONS.has(action);
+    if (CORE_ACTIONS.has(action)) {
+        return true;
+    }
+    if (action.startsWith("navigate_") && globalPageRegistry) {
+        return globalPageRegistry.isPageNavigationAction(action);
+    }
+    return false;
 };

package/dist/index.d.ts

@@ -2,6 +2,10 @@ export { VoiceNavigationController } from "./navigation-controller.js";
 export { MicrophoneHandler } from "./microphone-handler.js";
 export { AzureSpeechService } from "./services/azure-speech.js";
 export { BedrockService } from "./services/bedrock.js";
+export { PageRegistry } from "./services/page-registry.js";
+export type { NavigablePage } from "./services/page-registry.js";
+export { parseNavigationXML, fetchNavigationXML, loadNavigationPages, } from "./services/xml-parser.js";
+export type { PageXMLConfig } from "./services/xml-parser.js";
 export * from "./types.js";
 export * from "./actions.js";
 export * from "./ui.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2JnD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,GACvB,yBAAyB,CA0E3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA8JnD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,GACvB,yBAAyB,CAuE3B"}

package/dist/index.js

@@ -2,6 +2,8 @@ export { VoiceNavigationController } from "./navigation-controller.js";
 export { MicrophoneHandler } from "./microphone-handler.js";
 export { AzureSpeechService } from "./services/azure-speech.js";
 export { BedrockService } from "./services/bedrock.js";
+export { PageRegistry } from "./services/page-registry.js";
+export { parseNavigationXML, fetchNavigationXML, loadNavigationPages, } from "./services/xml-parser.js";
 export * from "./types.js";
 export * from "./actions.js";
 export * from "./ui.js";
@@ -32,6 +34,7 @@ const buildPersistableConfig = (config) => {
         opensearch: normalizedConfig.opensearch
             ? { ...normalizedConfig.opensearch }
             : undefined,
+        pages: normalizedConfig.pages ? { ...normalizedConfig.pages } : undefined,
         language: normalizedConfig.language,
         autoStart: normalizedConfig.autoStart,
     };
@@ -109,7 +112,8 @@ export function initNavigationOnMicrophone(config) {
         const currentOpenSearchConfig = resolveOpenSearchConfig(normalizedConfig);
         const hadVectorSearch = Boolean(previousOpenSearchConfig);
         const wantsVectorSearch = Boolean(currentOpenSearchConfig);
-        const existingHasVectorSearch = Boolean(existingController?.vectorSearchService);
+        const existingHasVectorSearch = Boolean(existingController
+            ?.vectorSearchService);
         const vectorConfigChanged = hadVectorSearch &&
             wantsVectorSearch &&
             describeOpenSearchConfig(previousOpenSearchConfig) !==

package/dist/navigation-controller.d.ts

@@ -4,6 +4,7 @@ export declare class VoiceNavigationController {
     private microphoneHandler;
     private azureSpeechService;
     private bedrockService;
+    private pageRegistry;
     private ui;
     private lastTranscript;
     private isProcessing;
@@ -12,12 +13,14 @@ export declare class VoiceNavigationController {
     private autoStartPendingUserInteraction;
     private removeAutoStartListeners;
     private vectorSearchService;
+    private pagesInitialized;
     constructor(config: NavigationConfig);
     private shouldAutoStart;
     setAutoStart(enabled: boolean): void;
     prepareForNavigation(options?: {
         target?: string;
     }): void;
+    private initializePages;
     private setupEventHandlers;
     private toggleRecording;
     start(options?: {

package/dist/navigation-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-controller.d.ts","sourceRoot":"","sources":["../src/navigation-controller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AAuDpB,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,qBAAqB,CAAkB;IAC/C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,+BAA+B,CAAkB;IACzD,OAAO,CAAC,wBAAwB,CAA6B;IAC7D,OAAO,CAAC,mBAAmB,CAAoC;gBAEnD,MAAM,EAAE,gBAAgB;IA0EpC,OAAO,CAAC,eAAe;IAoBhB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAepC,oBAAoB,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAOpE,OAAO,CAAC,kBAAkB;YASZ,eAAe;IAkBhB,KAAK,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEhE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BlC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;YAWP,aAAa;YAOb,wBAAwB;IAuCtC,OAAO,CAAC,WAAW;YAiBL,iBAAiB;YAwBjB,iBAAiB;IA0HxB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;YAI5B,yBAAyB;IAgMvC,OAAO,CAAC,oBAAoB;IAqD5B,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,4BAA4B;IAiB7B,OAAO,IAAI,IAAI;IAgBtB,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,kBAAkB;IAwD1B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,uBAAuB;IAoD/B,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,wBAAwB;CAgBjC"}
+{"version":3,"file":"navigation-controller.d.ts","sourceRoot":"","sources":["../src/navigation-controller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AA0DpB,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,qBAAqB,CAAkB;IAC/C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,+BAA+B,CAAkB;IACzD,OAAO,CAAC,wBAAwB,CAA6B;IAC7D,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,MAAM,EAAE,gBAAgB;IAgFpC,OAAO,CAAC,eAAe;IAoBhB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAepC,oBAAoB,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;YAOtD,eAAe;IAmE7B,OAAO,CAAC,kBAAkB;YASZ,eAAe;IAkBhB,KAAK,CAChB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,GACzC,OAAO,CAAC,IAAI,CAAC;IA0EH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BlC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;YAWP,aAAa;YAOb,wBAAwB;IAuCtC,OAAO,CAAC,WAAW;YAoBL,iBAAiB;YAwBjB,iBAAiB;IA0HxB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;YAI5B,yBAAyB;IAgMvC,OAAO,CAAC,oBAAoB;IAqD5B,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,4BAA4B;IAiB7B,OAAO,IAAI,IAAI;IAgBtB,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,CAAC,kBAAkB;IAwD1B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,uBAAuB;IAkD/B,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,wBAAwB;CAmBjC"}

package/dist/navigation-controller.js

@@ -1,8 +1,10 @@
 import { MicrophoneHandler } from "./microphone-handler.js";
 import { AzureSpeechService } from "./services/azure-speech.js";
 import { BedrockService } from "./services/bedrock.js";
+import { PageRegistry } from "./services/page-registry.js";
+import { loadNavigationPages } from "./services/xml-parser.js";
 import { VectorSearchService, } from "./services/vector-search.js";
-import { performAgentAction, formatActionLabel, extractAgentAction, } from "./actions.js";
+import { performAgentAction, formatActionLabel, extractAgentAction, setPageRegistry, } from "./actions.js";
 import { createFloatingControl, setState, updateStatus, updateTranscript, updateActionIndicator, showError, emitEvent, } from "./ui.js";
 const AUTO_START_STORAGE_KEY = "__navigate_auto_start";
 const RESUME_STATE_STORAGE_KEY = "__navigate_resume_state";
@@ -61,6 +63,8 @@ export class VoiceNavigationController {
                 ? undefined
                 : this.config.aws.embeddingModelId,
         });
+        this.pageRegistry = new PageRegistry([]);
+        this.pagesInitialized = this.initializePages();
         this.microphoneHandler = new MicrophoneHandler({
             azureSpeechService: this.azureSpeechService,
             bedrockService: this.bedrockService,
@@ -114,6 +118,46 @@ export class VoiceNavigationController {
     prepareForNavigation(options = {}) {
         this.persistResumeState(options.target);
     }
+    async initializePages() {
+        try {
+            const pagesConfig = this.config.pages;
+            if (!pagesConfig) {
+                flowLog("No pages configuration provided, using empty page registry");
+                setPageRegistry(this.pageRegistry);
+                this.bedrockService.setPageRegistry(this.pageRegistry);
+                return;
+            }
+            if (pagesConfig.pages && Array.isArray(pagesConfig.pages)) {
+                flowLog(`Loading ${pagesConfig.pages.length} pages from configuration`);
+                this.pageRegistry.loadPages(pagesConfig.pages);
+            }
+            else if (pagesConfig.xml) {
+                const xmlType = pagesConfig.xmlType || "url";
+                flowLog(`Loading pages from XML (${xmlType}): ${clipText(pagesConfig.xml, 60)}`);
+                const pages = await loadNavigationPages({
+                    source: pagesConfig.xml,
+                    type: xmlType,
+                });
+                flowLog(`✓ Loaded ${pages.length} pages from XML`);
+                this.pageRegistry.loadPages(pages);
+            }
+            setPageRegistry(this.pageRegistry);
+            this.bedrockService.setPageRegistry(this.pageRegistry);
+            flowLog(`✓ Page registry initialized with ${this.pageRegistry.size} pages`);
+            if (this.pageRegistry.size > 0) {
+                const actions = this.pageRegistry.getNavigationActions();
+                flowLog(`✓ Available page navigation actions: ${actions
+                    .slice(0, 5)
+                    .join(", ")}${actions.length > 5 ? `, ... (${actions.length} total)` : ""}`);
+            }
+        }
+        catch (error) {
+            console.error("Failed to load navigation pages:", error);
+            flowLog("⚠ Continuing without dynamic page navigation");
+            setPageRegistry(this.pageRegistry);
+            this.bedrockService.setPageRegistry(this.pageRegistry);
+        }
+    }
     setupEventHandlers() {
         this.ui.button.addEventListener("click", () => {
             this.toggleRecording();
@@ -133,6 +177,12 @@ export class VoiceNavigationController {
     async start(options = {}) {
         const reason = options.reason ?? "user";
         this.lastStartReason = reason;
+        try {
+            await this.pagesInitialized;
+        }
+        catch (error) {
+            console.error("Failed to initialize pages:", error);
+        }
         if (this.ui.root.dataset.state === "listening") {
             return;
         }
@@ -258,7 +308,8 @@ export class VoiceNavigationController {
     }
     handleError(error) {
         console.error("Microphone error:", error);
-        if (this.lastStartReason === "auto" && this.isPermissionRelatedError(error)) {
+        if (this.lastStartReason === "auto" &&
+            this.isPermissionRelatedError(error)) {
             setState(this.ui, "idle");
             this.handleAutoStartFallback("auto");
             updateStatus(this.ui, "Tap to start voice control");
@@ -670,8 +721,7 @@ export class VoiceNavigationController {
             };
             sessionStorage.setItem(RESUME_STATE_STORAGE_KEY, JSON.stringify(payload));
         }
-        catch (error) {
-        }
+        catch (error) { }
     }
     consumeResumeState() {
         if (typeof window === "undefined") {
@@ -737,9 +787,7 @@ export class VoiceNavigationController {
         setState(this.ui, "idle");
         const resume = () => {
             this.clearAutoStartFallback();
-            void this.microphoneHandler
-                .unlockAudioContext(true)
-                .finally(() => {
+            void this.microphoneHandler.unlockAudioContext(true).finally(() => {
                 void this.start({ reason: "user" });
             });
         };
@@ -774,7 +822,8 @@ export class VoiceNavigationController {
         if (message.includes("audiocontext") && message.includes("not allowed")) {
             return true;
         }
-        if (message.includes("must be resumed") && message.includes("user gesture")) {
+        if (message.includes("must be resumed") &&
+            message.includes("user gesture")) {
             return true;
         }
         return false;

package/dist/services/bedrock.d.ts

@@ -1,4 +1,5 @@
 import type { AgentActionResponse } from "../types.js";
+import type { PageRegistry } from "./page-registry.js";
 export interface BedrockConfig {
     region: string;
     accessKeyId: string;
@@ -10,7 +11,10 @@ export declare class BedrockService {
     private client;
     private actionModelId;
     private embeddingModelId;
+    private pageRegistry;
     constructor(config: BedrockConfig);
+    setPageRegistry(registry: PageRegistry): void;
+    private buildSystemPrompt;
     extractAction(userInput: string): Promise<AgentActionResponse>;
     static create(config: BedrockConfig): BedrockService;
     embedText(text: string): Promise<number[]>;

package/dist/services/bedrock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bedrock.d.ts","sourceRoot":"","sources":["../../src/services/bedrock.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAmBD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,MAAM,EAAE,aAAa;IAuB3B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiEpE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc;IAO9C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAyDjD"}
+{"version":3,"file":"bedrock.d.ts","sourceRoot":"","sources":["../../src/services/bedrock.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAiCD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,aAAa;IAwBjC,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAO7C,OAAO,CAAC,iBAAiB;IA+BnB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmEpE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc;IAO9C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAwDjD"}

package/dist/services/bedrock.js

@@ -1,21 +1,35 @@
 import { BedrockRuntimeClient, InvokeModelCommand, } from "@aws-sdk/client-bedrock-runtime";
-const SYSTEM_PROMPT = `You are an action extraction assistant.
+const CORE_ACTIONS_LIST = `"zoom_in", "zoom_out", "scroll_up", "scroll_down", "scroll_left", "scroll_right", "page_up", "page_down", "scroll_top", "scroll_bottom", "go_back", "go_forward", "reload_page", "print_page", "copy_url", "open_menu", "close_menu", "focus_search", "toggle_fullscreen", "exit_fullscreen", "play_media", "pause_media", "mute_media", "unmute_media", "search_content", "stop"`;
+const BASE_SYSTEM_PROMPT = `You are an action extraction assistant.
 
-VERY IMPORTANT INSTRUCTIONS:
-- RESPOND ONLY IN THE SPECIFIED JSON FORMAT.
-- ALWAYS RETURN A SINGLE JSON OBJECT.
-- IF THE USER INPUT DOES NOT CLEARLY INDICATE AN ACTION, RESPOND WITH {"action": "unknown"}.
-- DO NOT RESPOND WITH ANYTHING OTHER THAN THE JSON OBJECT.
-- CHOOSE THE MOST SPECIFIC ACTION FROM THE ALLOWED LIST. IF MULTIPLE ACTIONS APPLY, CHOOSE THE ONE THAT BEST MATCHES THE USER REQUEST.
-- DO NOT INVENT YOUR OWN ACTION. IT MUST BE ONE OF THE GIVEN ACTIONS OR "unknown".
-- WHEN THE USER CLEARLY EXPRESSES A DESIRE TO SEARCH OR FIND INFORMATION, RESPOND WITH {"action": "search_content", "query": "concise keywords"}.
-- WHEN YOU RETURN THE "search_content" ACTION, THE "query" FIELD MUST BE A SHORT PHRASE CAPTURING THE USER'S INTENT WITHOUT FILLER WORDS.
+CRITICAL RULES:
+1. RESPOND ONLY WITH A SINGLE JSON OBJECT
+2. THE JSON MUST HAVE AN "action" FIELD
+3. THE ACTION MUST BE EXACTLY ONE OF THE ACTIONS LISTED BELOW
+4. DO NOT CREATE NEW ACTION NAMES - USE ONLY THE EXACT ACTION NAMES PROVIDED
+5. DO NOT USE GENERIC ACTIONS LIKE "go_to_page" OR "navigate_to_page"
+6. FOR PAGE NAVIGATION, USE THE EXACT "navigate_<id>" ACTION PROVIDED FOR THAT PAGE
+7. IF UNCERTAIN, RESPOND WITH {"action": "unknown"}
 
-The only possible actions are:
-"zoom_in", "zoom_out", "scroll_up", "scroll_down", "scroll_left", "scroll_right", "page_up", "page_down", "scroll_top", "scroll_bottom", "go_back", "go_forward", "reload_page", "print_page", "copy_url", "open_menu", "close_menu", "focus_search", "toggle_fullscreen", "exit_fullscreen", "play_media", "pause_media", "mute_media", "unmute_media", "navigate_home", "search_content", "navigate_search", "navigate_faqs", "navigate_help", "navigate_contact", "navigate_about", "navigate_screen_reader", "navigate_accessibility", "navigate_disclaimer", "navigate_terms_conditions", "stop".`;
+RESPONSE FORMAT:
+- Core actions: {"action": "action_name"}
+- Search: {"action": "search_content", "query": "keywords"}
+- Page navigation: {"action": "navigate_<page_id>"}
+
+EXAMPLES:
+- User says "go to dashboard" → {"action": "navigate_dashboard"}
+- User says "show me the team page" → {"action": "navigate_team"}
+- User says "scroll down" → {"action": "scroll_down"}
+- User says "find schemes" → {"action": "search_content", "query": "schemes"}
+
+MATCHING RULES FOR PAGE NAVIGATION:
+- Match user's words to page names and keywords
+- Choose the navigate_ action that best matches
+- If user says "go to X" or "open X" or "show me X", find the page with that name or keyword`;
 const DEFAULT_EMBEDDING_MODEL_ID = "cohere.embed-multilingual-v3";
 export class BedrockService {
     constructor(config) {
+        this.pageRegistry = null;
         this.client = new BedrockRuntimeClient({
             region: config.region,
             credentials: {
@@ -29,17 +43,39 @@ export class BedrockService {
         }
         else if (typeof config.embeddingModelId === "string") {
             const trimmed = config.embeddingModelId.trim();
-            this.embeddingModelId = trimmed.length > 0 ? trimmed : DEFAULT_EMBEDDING_MODEL_ID;
+            this.embeddingModelId =
+                trimmed.length > 0 ? trimmed : DEFAULT_EMBEDDING_MODEL_ID;
         }
         else {
             this.embeddingModelId = DEFAULT_EMBEDDING_MODEL_ID;
         }
     }
+    setPageRegistry(registry) {
+        this.pageRegistry = registry;
+    }
+    buildSystemPrompt() {
+        let prompt = BASE_SYSTEM_PROMPT;
+        prompt += `\n\n=== CORE ACTIONS ===\n${CORE_ACTIONS_LIST}`;
+        if (this.pageRegistry && this.pageRegistry.size > 0) {
+            const pages = this.pageRegistry.getAllPages();
+            const pageActions = pages.map((page) => {
+                const keywords = page.keywords?.length
+                    ? ` [matches: ${page.keywords.join(", ")}]`
+                    : "";
+                return `"navigate_${page.id}" for "${page.name}"${keywords}`;
+            });
+            prompt += `\n\n=== PAGE NAVIGATION ACTIONS ===\n${pageActions.join("\n")}`;
+            prompt += `\n\nWhen user wants to navigate to a page, use the EXACT "navigate_<id>" action shown above.`;
+        }
+        prompt += `\n\n=== FINAL REMINDER ===\nYou MUST use one of the actions listed above. DO NOT create new action names. DO NOT use "go_to_page" or similar generic actions.`;
+        return prompt;
+    }
     async extractAction(userInput) {
+        const systemPrompt = this.buildSystemPrompt();
         const body = {
             anthropic_version: "bedrock-2023-05-31",
             max_tokens: 70,
-            system: SYSTEM_PROMPT,
+            system: systemPrompt,
             messages: [
                 {
                     role: "user",
@@ -118,7 +154,8 @@ export class BedrockService {
                 (Array.isArray(decoded.embeddings)
                     ? decoded.embeddings
                     : decoded.embeddings?.values) ||
-                decoded.results?.find((item) => Array.isArray(item.embedding))?.embedding;
+                decoded.results?.find((item) => Array.isArray(item.embedding))
+                    ?.embedding;
             if (!Array.isArray(embedding)) {
                 throw new Error("Unexpected embedding response structure");
             }

package/dist/services/page-registry.d.ts

@@ -0,0 +1,25 @@
+export interface NavigablePage {
+    id: string;
+    name: string;
+    path: string;
+    keywords?: string[];
+    description?: string;
+}
+export declare class PageRegistry {
+    private pages;
+    private pathToId;
+    private keywordIndex;
+    constructor(pages?: NavigablePage[]);
+    loadPages(pages: NavigablePage[]): void;
+    addPage(page: NavigablePage): void;
+    getPageById(id: string): NavigablePage | undefined;
+    getPageByPath(path: string): NavigablePage | undefined;
+    findPageByKeyword(keyword: string): NavigablePage | undefined;
+    getAllPages(): NavigablePage[];
+    getNavigationActions(): string[];
+    isPageNavigationAction(action: string): boolean;
+    getPageIdFromAction(action: string): string | null;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=page-registry.d.ts.map

package/dist/services/page-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-registry.d.ts","sourceRoot":"","sources":["../../src/services/page-registry.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,YAAY,CAAuC;gBAE/C,KAAK,GAAE,aAAa,EAAO;IAOvC,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAavC,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAuBlC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAOlD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAQtD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAwB7D,WAAW,IAAI,aAAa,EAAE;IAO9B,oBAAoB,IAAI,MAAM,EAAE;IAOhC,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAW/C,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAWlD,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/services/page-registry.js

@@ -0,0 +1,82 @@
+export class PageRegistry {
+    constructor(pages = []) {
+        this.pages = new Map();
+        this.pathToId = new Map();
+        this.keywordIndex = new Map();
+        this.loadPages(pages);
+    }
+    loadPages(pages) {
+        this.pages.clear();
+        this.pathToId.clear();
+        this.keywordIndex.clear();
+        for (const page of pages) {
+            this.addPage(page);
+        }
+    }
+    addPage(page) {
+        this.pages.set(page.id, page);
+        this.pathToId.set(page.path, page.id);
+        const keywords = page.keywords || [];
+        const allKeywords = [
+            page.name.toLowerCase(),
+            page.id.toLowerCase(),
+            ...keywords.map((k) => k.toLowerCase()),
+        ];
+        for (const keyword of allKeywords) {
+            if (!this.keywordIndex.has(keyword)) {
+                this.keywordIndex.set(keyword, new Set());
+            }
+            this.keywordIndex.get(keyword).add(page.id);
+        }
+    }
+    getPageById(id) {
+        return this.pages.get(id);
+    }
+    getPageByPath(path) {
+        const id = this.pathToId.get(path);
+        return id ? this.pages.get(id) : undefined;
+    }
+    findPageByKeyword(keyword) {
+        const normalized = keyword.toLowerCase().trim();
+        const pageIds = this.keywordIndex.get(normalized);
+        if (pageIds && pageIds.size > 0) {
+            const firstId = Array.from(pageIds)[0];
+            return this.pages.get(firstId);
+        }
+        for (const [key, ids] of this.keywordIndex.entries()) {
+            if (key.includes(normalized) || normalized.includes(key)) {
+                const firstId = Array.from(ids)[0];
+                return this.pages.get(firstId);
+            }
+        }
+        return undefined;
+    }
+    getAllPages() {
+        return Array.from(this.pages.values());
+    }
+    getNavigationActions() {
+        return Array.from(this.pages.keys()).map((id) => `navigate_${id}`);
+    }
+    isPageNavigationAction(action) {
+        if (!action.startsWith("navigate_")) {
+            return false;
+        }
+        const pageId = action.replace(/^navigate_/, "");
+        return this.pages.has(pageId);
+    }
+    getPageIdFromAction(action) {
+        if (!action.startsWith("navigate_")) {
+            return null;
+        }
+        const pageId = action.replace(/^navigate_/, "");
+        return this.pages.has(pageId) ? pageId : null;
+    }
+    clear() {
+        this.pages.clear();
+        this.pathToId.clear();
+        this.keywordIndex.clear();
+    }
+    get size() {
+        return this.pages.size;
+    }
+}

package/dist/services/xml-parser.d.ts

@@ -0,0 +1,9 @@
+import type { NavigablePage } from "./page-registry.js";
+export interface PageXMLConfig {
+    source: string | URL;
+    type: "url" | "string";
+}
+export declare function parseNavigationXML(xmlString: string): NavigablePage[];
+export declare function fetchNavigationXML(url: string): Promise<NavigablePage[]>;
+export declare function loadNavigationPages(config: PageXMLConfig): Promise<NavigablePage[]>;
+//# sourceMappingURL=xml-parser.d.ts.map

package/dist/services/xml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-parser.d.ts","sourceRoot":"","sources":["../../src/services/xml-parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;IACrB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;CACxB;AAKD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAsDrE;AAKD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,EAAE,CAAC,CAgB1B;AAKD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1B"}