Route Functions

import { 
  resolveNavaiRoute, 
  getNavaiRoutePromptLines,
  type NavaiRoute 
} from '@navai/voice-frontend';

type NavaiRoute = {
  name: string;        // Route identifier (e.g., "profile", "settings")
  path: string;        // Actual URL path (e.g., "/profile", "/settings")
  description: string; // Human-readable description
  synonyms?: string[]; // Alternative names (e.g., ["perfil", "account"])
};

const route: NavaiRoute = {
  name: 'profile',
  path: '/user/profile',
  description: 'User profile page with account information',
  synonyms: ['perfil', 'account', 'my account', 'mi cuenta']
};

function resolveNavaiRoute(
  input: string,
  routes?: NavaiRoute[]
): string | null

const routes: NavaiRoute[] = [
  {
    name: 'home',
    path: '/',
    description: 'Home page'
  },
  {
    name: 'profile',
    path: '/user/profile',
    description: 'User profile',
    synonyms: ['perfil', 'account', 'mi cuenta']
  },
  {
    name: 'settings',
    path: '/settings',
    description: 'Application settings',
    synonyms: ['config', 'preferences', 'ajustes']
  }
];

// Exact path match
resolveNavaiRoute('/settings', routes);
// => '/settings'

// Exact name match
resolveNavaiRoute('profile', routes);
// => '/user/profile'

// Exact synonym match
resolveNavaiRoute('perfil', routes);
// => '/user/profile'

resolveNavaiRoute('ajustes', routes);
// => '/settings'

// Partial name match
resolveNavaiRoute('prof', routes);
// => '/user/profile'

resolveNavaiRoute('sett', routes);
// => '/settings'

// Partial synonym match
resolveNavaiRoute('cuenta', routes);  // matches 'mi cuenta'
// => '/user/profile'

// Case insensitive
resolveNavaiRoute('PROFILE', routes);
// => '/user/profile'

resolveNavaiRoute('Perfil', routes);
// => '/user/profile'

// Accent insensitive
resolveNavaiRoute('configuración', routes);  // synonym is 'config'
// Note: This won't match 'config', accents are removed from input
resolveNavaiRoute('ajustes', routes);
// => '/settings'

// No match
resolveNavaiRoute('dashboard', routes);
// => null

resolveNavaiRoute('unknown', routes);
// => null

function handleVoiceNavigation(userInput: string, routes: NavaiRoute[]) {
  const path = resolveNavaiRoute(userInput, routes);
  
  if (path) {
    router.push(path);
    return `Navigating to ${path}`;
  } else {
    return `Sorry, I couldn't find a route matching "${userInput}"`;
  }
}

// User says: "go to profile"
handleVoiceNavigation('profile', routes);
// Navigates to '/user/profile'

// User says: "abre ajustes" (Spanish)
handleVoiceNavigation('ajustes', routes);
// Navigates to '/settings'

function getNavaiRoutePromptLines(
  routes?: NavaiRoute[]
): string[]

const routes: NavaiRoute[] = [
  {
    name: 'home',
    path: '/',
    description: 'Home page'
  },
  {
    name: 'profile',
    path: '/user/profile',
    description: 'User profile',
    synonyms: ['perfil', 'account']
  },
  {
    name: 'settings',
    path: '/settings',
    description: 'Settings page',
    synonyms: ['config', 'preferences', 'ajustes']
  }
];

const lines = getNavaiRoutePromptLines(routes);

console.log(lines);
// [
//   "- home (/)",
//   "- profile (/user/profile), aliases: perfil, account",
//   "- settings (/settings), aliases: config, preferences, ajustes"
// ]

// Format as instructions
const instructions = [
  'Allowed routes:',
  ...lines
].join('\n');

console.log(instructions);
// Allowed routes:
// - home (/)
// - profile (/user/profile), aliases: perfil, account
// - settings (/settings), aliases: config, preferences, ajustes

import { buildNavaiAgent, getNavaiRoutePromptLines } from '@navai/voice-frontend';

const routes: NavaiRoute[] = [
  {
    name: 'dashboard',
    path: '/dashboard',
    description: 'Main dashboard',
    synonyms: ['home', 'inicio']
  },
  {
    name: 'analytics',
    path: '/analytics',
    description: 'Analytics and reports',
    synonyms: ['reports', 'stats', 'estadísticas']
  }
];

// The agent automatically uses getNavaiRoutePromptLines internally
const { agent } = await buildNavaiAgent({
  navigate: (path) => router.push(path),
  routes,
  functionModuleLoaders: {},
  baseInstructions: `
You are a helpful assistant.

Available routes:
${getNavaiRoutePromptLines(routes).join('\n')}
  `.trim()
});

import { 
  resolveNavaiRoute, 
  getNavaiRoutePromptLines,
  type NavaiRoute 
} from '@navai/voice-frontend';
import { useNavigate } from 'react-router-dom';

// Define routes with multilingual support
const routes: NavaiRoute[] = [
  {
    name: 'home',
    path: '/',
    description: 'Home page',
    synonyms: ['inicio', 'main', 'principal']
  },
  {
    name: 'profile',
    path: '/user/profile',
    description: 'User profile and account settings',
    synonyms: ['perfil', 'account', 'cuenta', 'my account', 'mi cuenta']
  },
  {
    name: 'messages',
    path: '/messages',
    description: 'Messages and chat',
    synonyms: ['chat', 'mensajes', 'inbox']
  },
  {
    name: 'settings',
    path: '/settings',
    description: 'Application settings and preferences',
    synonyms: ['config', 'configuration', 'ajustes', 'preferences', 'preferencias']
  },
  {
    name: 'help',
    path: '/help',
    description: 'Help and documentation',
    synonyms: ['ayuda', 'docs', 'documentation', 'support']
  }
];

function VoiceNavigationHandler() {
  const navigate = useNavigate();
  
  const handleVoiceCommand = (command: string) => {
    // Try to resolve the route
    const path = resolveNavaiRoute(command, routes);
    
    if (path) {
      console.log(`Navigating to ${path}`);
      navigate(path);
      return true;
    } else {
      console.warn(`No route found for: ${command}`);
      return false;
    }
  };
  
  // Test various commands
  handleVoiceCommand('profile');      // => '/user/profile'
  handleVoiceCommand('perfil');       // => '/user/profile'
  handleVoiceCommand('mi cuenta');    // => '/user/profile'
  handleVoiceCommand('settings');     // => '/settings'
  handleVoiceCommand('ajustes');      // => '/settings'
  handleVoiceCommand('help');         // => '/help'
  handleVoiceCommand('ayuda');        // => '/help'
  handleVoiceCommand('dashboard');    // => null (not found)
  
  return null;
}

// Generate instructions for agent
function generateAgentInstructions() {
  const routeLines = getNavaiRoutePromptLines(routes);
  
  return `
You are a voice assistant for a web application.

Available routes:
${routeLines.join('\n')}

When the user asks to navigate, use the navigate_to tool with one of these route names or paths.
  `.trim();
}

console.log(generateAgentInstructions());
// You are a voice assistant for a web application.
//
// Available routes:
// - home (/), aliases: inicio, main, principal
// - profile (/user/profile), aliases: perfil, account, cuenta, my account, mi cuenta
// - messages (/messages), aliases: chat, mensajes, inbox
// - settings (/settings), aliases: config, configuration, ajustes, preferences, preferencias
// - help (/help), aliases: ayuda, docs, documentation, support
//
// When the user asks to navigate, use the navigate_to tool with one of these route names or paths.

function normalize(value: string): string {
  return value
    .normalize("NFD")                    // Decompose accented characters
    .replace(/[\u0300-\u036f]/g, "")    // Remove accent marks
    .trim()                              // Remove whitespace
    .toLowerCase();                      // Convert to lowercase
}