react-voice-action-router 1.0.1 → 1.0.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Nouman Ejaz
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026 Nouman Ejaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -1,21 +1,21 @@
-# react-voice-action-router 🎙️
-
-> **Don't build a chatbot. Build a hands-free interface.**
-
-[![npm version](https://img.shields.io/npm/v/react-voice-action-router.svg?style=flat-square)](https://www.npmjs.com/package/react-voice-action-router)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-
-A headless, latency-first voice intent router for React applications. It bridges natural language speech to your existing React functions using an **LLM-Agnostic Adapter Pattern**.
-
-* **Headless & Zero UI:** We provide the logic hooks; you build the interface (or keep it invisible).
-* **Context-Aware:** The AI only knows about commands on the *current* screen, reducing costs and hallucinations.
-* **Universal Adapter:** Works with OpenAI, Anthropic, local Llama models (Ollama), or your own secure backend.
-* **Latency-First:** Supports instant execution for exact phrases, falling back to AI for fuzzy intents.
-
----
-
-## Installation
-
-```bash
-npm install react-voice-action-router
+# react-voice-action-router 🎙️
+
+> **Don't build a chatbot. Build a hands-free interface.**
+
+[![npm version](https://img.shields.io/npm/v/react-voice-action-router.svg?style=flat-square)](https://www.npmjs.com/package/react-voice-action-router)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+
+A headless, latency-first voice intent router for React applications. It bridges natural language speech to your existing React functions using an **LLM-Agnostic Adapter Pattern**.
+
+* **Headless & Zero UI:** We provide the logic hooks; you build the interface (or keep it invisible).
+* **Context-Aware:** The AI only knows about commands on the *current* screen, reducing costs and hallucinations.
+* **Universal Adapter:** Works with OpenAI, Anthropic, local Llama models (Ollama), or your own secure backend.
+* **Latency-First:** Supports instant execution for exact phrases, falling back to AI for fuzzy intents.
+
+---
+
+## Installation
+
+```bash
+npm install react-voice-action-router
 # Note: React 16.8+ is required for Hooks support.

package/dist/adapters/index.d.mts

@@ -1,14 +1 @@
-import { L as LLMAdapter } from '../index-B9ulrUXF.mjs';
-
-interface OpenAIConfig {
-    apiKey: string;
-    /** @default "gpt-4o-mini" */
-    model?: string;
-}
-/**
- * A Factory that creates an Adapter for OpenAI.
- * Users call this: createOpenAIAdapter({ apiKey: '...' })
- */
-declare const createOpenAIAdapter: (config: OpenAIConfig) => LLMAdapter;
-
-export { createOpenAIAdapter };
+export { c as createOpenAIAdapter } from '../index-DyZ8YKh9.mjs';

package/dist/adapters/index.d.ts

@@ -1,14 +1 @@
-import { L as LLMAdapter } from '../index-B9ulrUXF.js';
-
-interface OpenAIConfig {
-    apiKey: string;
-    /** @default "gpt-4o-mini" */
-    model?: string;
-}
-/**
- * A Factory that creates an Adapter for OpenAI.
- * Users call this: createOpenAIAdapter({ apiKey: '...' })
- */
-declare const createOpenAIAdapter: (config: OpenAIConfig) => LLMAdapter;
-
-export { createOpenAIAdapter };
+export { c as createOpenAIAdapter } from '../index-DyZ8YKh9.js';

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/prompt.ts","../../src/adapters/openai.ts"],"names":[],"mappings":";;;AAMO,IAAM,kBAAA,GAAqB,CAAC,QAAA,KAA6C;AAE5E,EAAA,MAAM,cAAc,QAAA,CAAS,GAAA;AAAA,IAAI,SAC7B,CAAA,OAAA,EAAU,GAAA,CAAI,EAAE,CAAA,kBAAA,EAAqB,IAAI,WAAW,CAAA,CAAA;AAAA,GACxD,CAAE,KAAK,IAAI,CAAA;AAEX,EAAA,OAAO;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,EAYT,WAAW;;AAAA;AAAA;AAAA,CAAA;AAKb,CAAA;;;AChBO,IAAM,mBAAA,GAAsB,CAAC,MAAA,KAAqC;AACrE,EAAA,OAAO,OAAO,YAAY,QAAA,KAAa;AAGnC,IAAA,MAAM,YAAA,GAAe,mBAAmB,QAAQ,CAAA;AAGhD,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,4CAAA,EAA8C;AAAA,MACvE,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACL,cAAA,EAAgB,kBAAA;AAAA,QAChB,eAAA,EAAiB,CAAA,OAAA,EAAU,MAAA,CAAO,MAAM,CAAA;AAAA,OAC5C;AAAA,MACA,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACjB,KAAA,EAAO,OAAO,KAAA,IAAS,aAAA;AAAA,QACvB,QAAA,EAAU;AAAA,UACN,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,YAAA,EAAa;AAAA,UACxC,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,UAAA;AAAW,SACxC;AAAA,QACA,WAAA,EAAa,CAAA;AAAA;AAAA,QACb,eAAA,EAAiB,EAAE,IAAA,EAAM,aAAA;AAAc;AAAA,OAC1C;AAAA,KACJ,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,uBAAA,EAA0B,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,IACnE;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAGjC,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAM,IAAA,CAAK,QAAQ,CAAC,CAAA,CAAE,QAAQ,OAAO,CAAA;AACzD,MAAA,OAAO,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU;AAAA,IACzC,SAAS,CAAA,EAAG;AACR,MAAA,OAAA,CAAQ,KAAA,CAAM,gCAAgC,CAAC,CAAA;AAC/C,MAAA,OAAO,EAAE,WAAW,IAAA,EAAK;AAAA,IAC7B;AAAA,EACJ,CAAA;AACJ","file":"index.js","sourcesContent":["import { VoiceCommand } from '../types';\r\n\r\n/**\r\n * Generates the System Prompt for the LLM.\r\n * This ensures consistent behavior across different AI providers.\r\n */\r\nexport const createSystemPrompt = (commands: Omit<VoiceCommand, 'action'>[]) => {\r\n    // Format the list of commands for the AI to read\r\n    const commandList = commands.map(cmd =>\r\n        `- ID: \"${cmd.id}\" | Description: \"${cmd.description}\"`\r\n    ).join('\\n');\r\n\r\n    return `\r\nYou are a precise Voice Command Router.\r\nYour goal is to map the user's spoken input to the correct Command ID from the list below.\r\n\r\nRULES:\r\n1. Analyze the user's input and find the intent.\r\n2. Match it to the command with the most relevant \"Description\".\r\n3. Use fuzzy matching (e.g., \"Dark mode\" matches \"Toggle Theme\").\r\n4. If NO command matches the intent, return null.\r\n5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.\r\n\r\nAVAILABLE COMMANDS:\r\n${commandList}\r\n\r\nRESPONSE FORMAT:\r\n{ \"commandId\": \"string_id_or_null\" }\r\n`;\r\n};\r\n\r\n/**\r\n * Standardizes how the user's voice transcript is presented to the AI.\r\n */\r\nexport const createUserPrompt = (transcript: string) => {\r\n    return `User Input: \"${transcript}\"`;\r\n};","import { LLMAdapter } from '../types';\r\nimport { createSystemPrompt } from '../core/prompt';\r\n\r\ninterface OpenAIConfig {\r\n    apiKey: string;\r\n    /** @default \"gpt-4o-mini\" */\r\n    model?: string;\r\n}\r\n\r\n/**\r\n * A Factory that creates an Adapter for OpenAI.\r\n * Users call this: createOpenAIAdapter({ apiKey: '...' })\r\n */\r\nexport const createOpenAIAdapter = (config: OpenAIConfig): LLMAdapter => {\r\n    return async (transcript, commands) => {\r\n\r\n        // 1. Generate the optimized system instructions\r\n        const systemPrompt = createSystemPrompt(commands);\r\n\r\n        // 2. Call the API\r\n        const response = await fetch('https://api.openai.com/v1/chat/completions', {\r\n            method: 'POST',\r\n            headers: {\r\n                'Content-Type': 'application/json',\r\n                'Authorization': `Bearer ${config.apiKey}`\r\n            },\r\n            body: JSON.stringify({\r\n                model: config.model || \"gpt-4o-mini\",\r\n                messages: [\r\n                    { role: \"system\", content: systemPrompt },\r\n                    { role: \"user\", content: transcript }\r\n                ],\r\n                temperature: 0, // Deterministic results\r\n                response_format: { type: \"json_object\" } // Force JSON mode\r\n            })\r\n        });\r\n\r\n        if (!response.ok) {\r\n            throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);\r\n        }\r\n\r\n        const data = await response.json();\r\n\r\n        // 3. Parse the result\r\n        try {\r\n            const parsed = JSON.parse(data.choices[0].message.content);\r\n            return { commandId: parsed.commandId };\r\n        } catch (e) {\r\n            console.error(\"Failed to parse LLM response\", e);\r\n            return { commandId: null };\r\n        }\r\n    };\r\n};"]}
+{"version":3,"sources":["../../src/core/prompt.ts","../../src/adapters/openai.ts"],"names":[],"mappings":";;;AAMO,IAAM,kBAAA,GAAqB,CAAC,QAAA,KAA6C;AAE5E,EAAA,MAAM,cAAc,QAAA,CAAS,GAAA;AAAA,IAAI,SAC7B,CAAA,OAAA,EAAU,GAAA,CAAI,EAAE,CAAA,kBAAA,EAAqB,IAAI,WAAW,CAAA,CAAA;AAAA,GACxD,CAAE,KAAK,IAAI,CAAA;AAEX,EAAA,OAAO;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,EAYT,WAAW;;AAAA;AAAA;AAAA,CAAA;AAKb,CAAA;;;AChBO,IAAM,mBAAA,GAAsB,CAAC,MAAA,KAAqC;AACrE,EAAA,OAAO,OAAO,YAAY,QAAA,KAAa;AAGnC,IAAA,MAAM,YAAA,GAAe,mBAAmB,QAAQ,CAAA;AAGhD,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,4CAAA,EAA8C;AAAA,MACvE,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACL,cAAA,EAAgB,kBAAA;AAAA,QAChB,eAAA,EAAiB,CAAA,OAAA,EAAU,MAAA,CAAO,MAAM,CAAA;AAAA,OAC5C;AAAA,MACA,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACjB,KAAA,EAAO,OAAO,KAAA,IAAS,aAAA;AAAA,QACvB,QAAA,EAAU;AAAA,UACN,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,YAAA,EAAa;AAAA,UACxC,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,UAAA;AAAW,SACxC;AAAA,QACA,WAAA,EAAa,CAAA;AAAA;AAAA,QACb,eAAA,EAAiB,EAAE,IAAA,EAAM,aAAA;AAAc;AAAA,OAC1C;AAAA,KACJ,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,uBAAA,EAA0B,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,IACnE;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAGjC,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAM,IAAA,CAAK,QAAQ,CAAC,CAAA,CAAE,QAAQ,OAAO,CAAA;AACzD,MAAA,OAAO,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU;AAAA,IACzC,SAAS,CAAA,EAAG;AACR,MAAA,OAAA,CAAQ,KAAA,CAAM,gCAAgC,CAAC,CAAA;AAC/C,MAAA,OAAO,EAAE,WAAW,IAAA,EAAK;AAAA,IAC7B;AAAA,EACJ,CAAA;AACJ","file":"index.js","sourcesContent":["import { VoiceCommand } from '../types';\n\n/**\n * Generates the System Prompt for the LLM.\n * This ensures consistent behavior across different AI providers.\n */\nexport const createSystemPrompt = (commands: Omit<VoiceCommand, 'action'>[]) => {\n    // Format the list of commands for the AI to read\n    const commandList = commands.map(cmd =>\n        `- ID: \"${cmd.id}\" | Description: \"${cmd.description}\"`\n    ).join('\\n');\n\n    return `\nYou are a precise Voice Command Router.\nYour goal is to map the user's spoken input to the correct Command ID from the list below.\n\nRULES:\n1. Analyze the user's input and find the intent.\n2. Match it to the command with the most relevant \"Description\".\n3. Use fuzzy matching (e.g., \"Dark mode\" matches \"Toggle Theme\").\n4. If NO command matches the intent, return null.\n5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.\n\nAVAILABLE COMMANDS:\n${commandList}\n\nRESPONSE FORMAT:\n{ \"commandId\": \"string_id_or_null\" }\n`;\n};\n\n/**\n * Standardizes how the user's voice transcript is presented to the AI.\n */\nexport const createUserPrompt = (transcript: string) => {\n    return `User Input: \"${transcript}\"`;\n};","import { LLMAdapter } from '../types';\nimport { createSystemPrompt } from '../core/prompt';\n\ninterface OpenAIConfig {\n    apiKey: string;\n    /** @default \"gpt-4o-mini\" */\n    model?: string;\n}\n\n/**\n * A Factory that creates an Adapter for OpenAI.\n * Users call this: createOpenAIAdapter({ apiKey: '...' })\n */\nexport const createOpenAIAdapter = (config: OpenAIConfig): LLMAdapter => {\n    return async (transcript, commands) => {\n\n        // 1. Generate the optimized system instructions\n        const systemPrompt = createSystemPrompt(commands);\n\n        // 2. Call the API\n        const response = await fetch('https://api.openai.com/v1/chat/completions', {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'Authorization': `Bearer ${config.apiKey}`\n            },\n            body: JSON.stringify({\n                model: config.model || \"gpt-4o-mini\",\n                messages: [\n                    { role: \"system\", content: systemPrompt },\n                    { role: \"user\", content: transcript }\n                ],\n                temperature: 0, // Deterministic results\n                response_format: { type: \"json_object\" } // Force JSON mode\n            })\n        });\n\n        if (!response.ok) {\n            throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);\n        }\n\n        const data = await response.json();\n\n        // 3. Parse the result\n        try {\n            const parsed = JSON.parse(data.choices[0].message.content);\n            return { commandId: parsed.commandId };\n        } catch (e) {\n            console.error(\"Failed to parse LLM response\", e);\n            return { commandId: null };\n        }\n    };\n};"]}

package/dist/adapters/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/prompt.ts","../../src/adapters/openai.ts"],"names":[],"mappings":";AAMO,IAAM,kBAAA,GAAqB,CAAC,QAAA,KAA6C;AAE5E,EAAA,MAAM,cAAc,QAAA,CAAS,GAAA;AAAA,IAAI,SAC7B,CAAA,OAAA,EAAU,GAAA,CAAI,EAAE,CAAA,kBAAA,EAAqB,IAAI,WAAW,CAAA,CAAA;AAAA,GACxD,CAAE,KAAK,IAAI,CAAA;AAEX,EAAA,OAAO;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,EAYT,WAAW;;AAAA;AAAA;AAAA,CAAA;AAKb,CAAA;;;AChBO,IAAM,mBAAA,GAAsB,CAAC,MAAA,KAAqC;AACrE,EAAA,OAAO,OAAO,YAAY,QAAA,KAAa;AAGnC,IAAA,MAAM,YAAA,GAAe,mBAAmB,QAAQ,CAAA;AAGhD,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,4CAAA,EAA8C;AAAA,MACvE,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACL,cAAA,EAAgB,kBAAA;AAAA,QAChB,eAAA,EAAiB,CAAA,OAAA,EAAU,MAAA,CAAO,MAAM,CAAA;AAAA,OAC5C;AAAA,MACA,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACjB,KAAA,EAAO,OAAO,KAAA,IAAS,aAAA;AAAA,QACvB,QAAA,EAAU;AAAA,UACN,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,YAAA,EAAa;AAAA,UACxC,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,UAAA;AAAW,SACxC;AAAA,QACA,WAAA,EAAa,CAAA;AAAA;AAAA,QACb,eAAA,EAAiB,EAAE,IAAA,EAAM,aAAA;AAAc;AAAA,OAC1C;AAAA,KACJ,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,uBAAA,EAA0B,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,IACnE;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAGjC,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAM,IAAA,CAAK,QAAQ,CAAC,CAAA,CAAE,QAAQ,OAAO,CAAA;AACzD,MAAA,OAAO,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU;AAAA,IACzC,SAAS,CAAA,EAAG;AACR,MAAA,OAAA,CAAQ,KAAA,CAAM,gCAAgC,CAAC,CAAA;AAC/C,MAAA,OAAO,EAAE,WAAW,IAAA,EAAK;AAAA,IAC7B;AAAA,EACJ,CAAA;AACJ","file":"index.mjs","sourcesContent":["import { VoiceCommand } from '../types';\r\n\r\n/**\r\n * Generates the System Prompt for the LLM.\r\n * This ensures consistent behavior across different AI providers.\r\n */\r\nexport const createSystemPrompt = (commands: Omit<VoiceCommand, 'action'>[]) => {\r\n    // Format the list of commands for the AI to read\r\n    const commandList = commands.map(cmd =>\r\n        `- ID: \"${cmd.id}\" | Description: \"${cmd.description}\"`\r\n    ).join('\\n');\r\n\r\n    return `\r\nYou are a precise Voice Command Router.\r\nYour goal is to map the user's spoken input to the correct Command ID from the list below.\r\n\r\nRULES:\r\n1. Analyze the user's input and find the intent.\r\n2. Match it to the command with the most relevant \"Description\".\r\n3. Use fuzzy matching (e.g., \"Dark mode\" matches \"Toggle Theme\").\r\n4. If NO command matches the intent, return null.\r\n5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.\r\n\r\nAVAILABLE COMMANDS:\r\n${commandList}\r\n\r\nRESPONSE FORMAT:\r\n{ \"commandId\": \"string_id_or_null\" }\r\n`;\r\n};\r\n\r\n/**\r\n * Standardizes how the user's voice transcript is presented to the AI.\r\n */\r\nexport const createUserPrompt = (transcript: string) => {\r\n    return `User Input: \"${transcript}\"`;\r\n};","import { LLMAdapter } from '../types';\r\nimport { createSystemPrompt } from '../core/prompt';\r\n\r\ninterface OpenAIConfig {\r\n    apiKey: string;\r\n    /** @default \"gpt-4o-mini\" */\r\n    model?: string;\r\n}\r\n\r\n/**\r\n * A Factory that creates an Adapter for OpenAI.\r\n * Users call this: createOpenAIAdapter({ apiKey: '...' })\r\n */\r\nexport const createOpenAIAdapter = (config: OpenAIConfig): LLMAdapter => {\r\n    return async (transcript, commands) => {\r\n\r\n        // 1. Generate the optimized system instructions\r\n        const systemPrompt = createSystemPrompt(commands);\r\n\r\n        // 2. Call the API\r\n        const response = await fetch('https://api.openai.com/v1/chat/completions', {\r\n            method: 'POST',\r\n            headers: {\r\n                'Content-Type': 'application/json',\r\n                'Authorization': `Bearer ${config.apiKey}`\r\n            },\r\n            body: JSON.stringify({\r\n                model: config.model || \"gpt-4o-mini\",\r\n                messages: [\r\n                    { role: \"system\", content: systemPrompt },\r\n                    { role: \"user\", content: transcript }\r\n                ],\r\n                temperature: 0, // Deterministic results\r\n                response_format: { type: \"json_object\" } // Force JSON mode\r\n            })\r\n        });\r\n\r\n        if (!response.ok) {\r\n            throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);\r\n        }\r\n\r\n        const data = await response.json();\r\n\r\n        // 3. Parse the result\r\n        try {\r\n            const parsed = JSON.parse(data.choices[0].message.content);\r\n            return { commandId: parsed.commandId };\r\n        } catch (e) {\r\n            console.error(\"Failed to parse LLM response\", e);\r\n            return { commandId: null };\r\n        }\r\n    };\r\n};"]}
+{"version":3,"sources":["../../src/core/prompt.ts","../../src/adapters/openai.ts"],"names":[],"mappings":";AAMO,IAAM,kBAAA,GAAqB,CAAC,QAAA,KAA6C;AAE5E,EAAA,MAAM,cAAc,QAAA,CAAS,GAAA;AAAA,IAAI,SAC7B,CAAA,OAAA,EAAU,GAAA,CAAI,EAAE,CAAA,kBAAA,EAAqB,IAAI,WAAW,CAAA,CAAA;AAAA,GACxD,CAAE,KAAK,IAAI,CAAA;AAEX,EAAA,OAAO;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,EAYT,WAAW;;AAAA;AAAA;AAAA,CAAA;AAKb,CAAA;;;AChBO,IAAM,mBAAA,GAAsB,CAAC,MAAA,KAAqC;AACrE,EAAA,OAAO,OAAO,YAAY,QAAA,KAAa;AAGnC,IAAA,MAAM,YAAA,GAAe,mBAAmB,QAAQ,CAAA;AAGhD,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,4CAAA,EAA8C;AAAA,MACvE,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACL,cAAA,EAAgB,kBAAA;AAAA,QAChB,eAAA,EAAiB,CAAA,OAAA,EAAU,MAAA,CAAO,MAAM,CAAA;AAAA,OAC5C;AAAA,MACA,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACjB,KAAA,EAAO,OAAO,KAAA,IAAS,aAAA;AAAA,QACvB,QAAA,EAAU;AAAA,UACN,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,YAAA,EAAa;AAAA,UACxC,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,UAAA;AAAW,SACxC;AAAA,QACA,WAAA,EAAa,CAAA;AAAA;AAAA,QACb,eAAA,EAAiB,EAAE,IAAA,EAAM,aAAA;AAAc;AAAA,OAC1C;AAAA,KACJ,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,uBAAA,EAA0B,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,IACnE;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAGjC,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAM,IAAA,CAAK,QAAQ,CAAC,CAAA,CAAE,QAAQ,OAAO,CAAA;AACzD,MAAA,OAAO,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU;AAAA,IACzC,SAAS,CAAA,EAAG;AACR,MAAA,OAAA,CAAQ,KAAA,CAAM,gCAAgC,CAAC,CAAA;AAC/C,MAAA,OAAO,EAAE,WAAW,IAAA,EAAK;AAAA,IAC7B;AAAA,EACJ,CAAA;AACJ","file":"index.mjs","sourcesContent":["import { VoiceCommand } from '../types';\n\n/**\n * Generates the System Prompt for the LLM.\n * This ensures consistent behavior across different AI providers.\n */\nexport const createSystemPrompt = (commands: Omit<VoiceCommand, 'action'>[]) => {\n    // Format the list of commands for the AI to read\n    const commandList = commands.map(cmd =>\n        `- ID: \"${cmd.id}\" | Description: \"${cmd.description}\"`\n    ).join('\\n');\n\n    return `\nYou are a precise Voice Command Router.\nYour goal is to map the user's spoken input to the correct Command ID from the list below.\n\nRULES:\n1. Analyze the user's input and find the intent.\n2. Match it to the command with the most relevant \"Description\".\n3. Use fuzzy matching (e.g., \"Dark mode\" matches \"Toggle Theme\").\n4. If NO command matches the intent, return null.\n5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.\n\nAVAILABLE COMMANDS:\n${commandList}\n\nRESPONSE FORMAT:\n{ \"commandId\": \"string_id_or_null\" }\n`;\n};\n\n/**\n * Standardizes how the user's voice transcript is presented to the AI.\n */\nexport const createUserPrompt = (transcript: string) => {\n    return `User Input: \"${transcript}\"`;\n};","import { LLMAdapter } from '../types';\nimport { createSystemPrompt } from '../core/prompt';\n\ninterface OpenAIConfig {\n    apiKey: string;\n    /** @default \"gpt-4o-mini\" */\n    model?: string;\n}\n\n/**\n * A Factory that creates an Adapter for OpenAI.\n * Users call this: createOpenAIAdapter({ apiKey: '...' })\n */\nexport const createOpenAIAdapter = (config: OpenAIConfig): LLMAdapter => {\n    return async (transcript, commands) => {\n\n        // 1. Generate the optimized system instructions\n        const systemPrompt = createSystemPrompt(commands);\n\n        // 2. Call the API\n        const response = await fetch('https://api.openai.com/v1/chat/completions', {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'Authorization': `Bearer ${config.apiKey}`\n            },\n            body: JSON.stringify({\n                model: config.model || \"gpt-4o-mini\",\n                messages: [\n                    { role: \"system\", content: systemPrompt },\n                    { role: \"user\", content: transcript }\n                ],\n                temperature: 0, // Deterministic results\n                response_format: { type: \"json_object\" } // Force JSON mode\n            })\n        });\n\n        if (!response.ok) {\n            throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);\n        }\n\n        const data = await response.json();\n\n        // 3. Parse the result\n        try {\n            const parsed = JSON.parse(data.choices[0].message.content);\n            return { commandId: parsed.commandId };\n        } catch (e) {\n            console.error(\"Failed to parse LLM response\", e);\n            return { commandId: null };\n        }\n    };\n};"]}

package/dist/{index-B9ulrUXF.d.mts → index-DyZ8YKh9.d.mts}

@@ -38,4 +38,15 @@ interface VoiceProviderProps {
     onStateChange?: (state: VoiceControlState) => void;
 }
 
-export type { LLMAdapter as L, VoiceProviderProps as V, VoiceControlState as a, VoiceCommand as b };
+interface OpenAIConfig {
+    apiKey: string;
+    /** @default "gpt-4o-mini" */
+    model?: string;
+}
+/**
+ * A Factory that creates an Adapter for OpenAI.
+ * Users call this: createOpenAIAdapter({ apiKey: '...' })
+ */
+declare const createOpenAIAdapter: (config: OpenAIConfig) => LLMAdapter;
+
+export { type LLMAdapter as L, type VoiceProviderProps as V, type VoiceControlState as a, type VoiceCommand as b, createOpenAIAdapter as c };

package/dist/{index-B9ulrUXF.d.ts → index-DyZ8YKh9.d.ts}

@@ -38,4 +38,15 @@ interface VoiceProviderProps {
     onStateChange?: (state: VoiceControlState) => void;
 }
 
-export type { LLMAdapter as L, VoiceProviderProps as V, VoiceControlState as a, VoiceCommand as b };
+interface OpenAIConfig {
+    apiKey: string;
+    /** @default "gpt-4o-mini" */
+    model?: string;
+}
+/**
+ * A Factory that creates an Adapter for OpenAI.
+ * Users call this: createOpenAIAdapter({ apiKey: '...' })
+ */
+declare const createOpenAIAdapter: (config: OpenAIConfig) => LLMAdapter;
+
+export { type LLMAdapter as L, type VoiceProviderProps as V, type VoiceControlState as a, type VoiceCommand as b, createOpenAIAdapter as c };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { V as VoiceProviderProps, a as VoiceControlState, b as VoiceCommand } from './index-B9ulrUXF.mjs';
-export { L as LLMAdapter } from './index-B9ulrUXF.mjs';
+import { V as VoiceProviderProps, a as VoiceControlState, b as VoiceCommand } from './index-DyZ8YKh9.mjs';
+export { L as LLMAdapter, c as createOpenAIAdapter } from './index-DyZ8YKh9.mjs';
 
 interface VoiceContextValue extends VoiceControlState {
     register: (cmd: VoiceCommand) => void;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { V as VoiceProviderProps, a as VoiceControlState, b as VoiceCommand } from './index-B9ulrUXF.js';
-export { L as LLMAdapter } from './index-B9ulrUXF.js';
+import { V as VoiceProviderProps, a as VoiceControlState, b as VoiceCommand } from './index-DyZ8YKh9.js';
+export { L as LLMAdapter, c as createOpenAIAdapter } from './index-DyZ8YKh9.js';
 
 interface VoiceContextValue extends VoiceControlState {
     register: (cmd: VoiceCommand) => void;

package/dist/index.js

@@ -79,7 +79,68 @@ var useVoiceCommand = (command) => {
   }, [register, unregister, command]);
 };
 
+// src/core/prompt.ts
+var createSystemPrompt = (commands) => {
+  const commandList = commands.map(
+    (cmd) => `- ID: "${cmd.id}" | Description: "${cmd.description}"`
+  ).join("\n");
+  return `
+You are a precise Voice Command Router.
+Your goal is to map the user's spoken input to the correct Command ID from the list below.
+
+RULES:
+1. Analyze the user's input and find the intent.
+2. Match it to the command with the most relevant "Description".
+3. Use fuzzy matching (e.g., "Dark mode" matches "Toggle Theme").
+4. If NO command matches the intent, return null.
+5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.
+
+AVAILABLE COMMANDS:
+${commandList}
+
+RESPONSE FORMAT:
+{ "commandId": "string_id_or_null" }
+`;
+};
+
+// src/adapters/openai.ts
+var createOpenAIAdapter = (config) => {
+  return async (transcript, commands) => {
+    const systemPrompt = createSystemPrompt(commands);
+    const response = await fetch("https://api.openai.com/v1/chat/completions", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({
+        model: config.model || "gpt-4o-mini",
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: transcript }
+        ],
+        temperature: 0,
+        // Deterministic results
+        response_format: { type: "json_object" }
+        // Force JSON mode
+      })
+    });
+    if (!response.ok) {
+      throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);
+    }
+    const data = await response.json();
+    try {
+      const parsed = JSON.parse(data.choices[0].message.content);
+      return { commandId: parsed.commandId };
+    } catch (e) {
+      console.error("Failed to parse LLM response", e);
+      return { commandId: null };
+    }
+  };
+};
+
 exports.VoiceControlProvider = VoiceControlProvider;
+exports.createOpenAIAdapter = createOpenAIAdapter;
 exports.useVoiceCommand = useVoiceCommand;
 exports.useVoiceContext = useVoiceContext;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/VoiceContext.tsx","../src/hooks/useVoiceCommand.ts"],"names":["createContext","useRef","useState","useCallback","jsx","useContext","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import React, { createContext, useContext, useState, useCallback, useRef } from 'react';\r\nimport { VoiceCommand, VoiceControlState, VoiceProviderProps } from '../types';\r\n\r\ninterface VoiceContextValue extends VoiceControlState {\r\n  register: (cmd: VoiceCommand) => void;\r\n  unregister: (id: string) => void;\r\n  processTranscript: (text: string) => Promise<void>;\r\n}\r\n\r\nconst VoiceContext = createContext<VoiceContextValue | null>(null);\r\n\r\nexport const VoiceControlProvider: React.FC<VoiceProviderProps> = ({ \r\n  children, \r\n  adapter \r\n}) => {\r\n  // THE REGISTRY: A Map ensures O(1) lookups and prevents duplicate IDs\r\n  const commandsRef = useRef<Map<string, VoiceCommand>>(new Map());\r\n  \r\n  // UI STATE\r\n  const [state, setState] = useState<VoiceControlState>({\r\n    isListening: false,\r\n    isProcessing: false,\r\n    lastTranscript: null,\r\n    activeCommands: [],\r\n  });\r\n\r\n  // 1. REGISTRATION LOGIC\r\n  const register = useCallback((cmd: VoiceCommand) => {\r\n    commandsRef.current.set(cmd.id, cmd);\r\n    // Update generic state for debugging UI\r\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\r\n  }, []);\r\n\r\n  const unregister = useCallback((id: string) => {\r\n    commandsRef.current.delete(id);\r\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\r\n  }, []);\r\n\r\n  // 2. THE ROUTER LOGIC\r\n  const processTranscript = useCallback(async (transcript: string) => {\r\n    const cleanText = transcript.trim().toLowerCase();\r\n    setState(prev => ({ ...prev, isProcessing: true, lastTranscript: cleanText }));\r\n\r\n    const allCommands = Array.from(commandsRef.current.values());\r\n\r\n    // PHASE 1: EXACT MATCH (0ms Latency)\r\n    const exactMatch = allCommands.find(c => c.phrase?.toLowerCase() === cleanText);\r\n    \r\n    if (exactMatch) {\r\n      console.log(`⚡ Instant Match: \"${cleanText}\" -> ${exactMatch.id}`);\r\n      exactMatch.action();\r\n      setState(prev => ({ ...prev, isProcessing: false }));\r\n      return;\r\n    }\r\n\r\n    // PHASE 2: FUZZY MATCH (AI Adapter)\r\n    try {\r\n      console.log(`🤖 AI Routing: \"${cleanText}\"...`);\r\n      \r\n      // We strip the 'action' function before sending to the AI\r\n      const commandListForAI = allCommands.map(({ id, description, phrase }) => ({ \r\n        id, \r\n        description, \r\n        phrase \r\n      }));\r\n\r\n      const result = await adapter(cleanText, commandListForAI);\r\n\r\n      if (result.commandId) {\r\n        const cmd = commandsRef.current.get(result.commandId);\r\n        if (cmd) {\r\n          console.log(`✅ Matched: ${cmd.id}`);\r\n          cmd.action();\r\n        } else {\r\n          console.warn(`⚠️ Adapter returned unknown ID: ${result.commandId}`);\r\n        }\r\n      }\r\n    } catch (error) {\r\n      console.error(\"Adapter Error:\", error);\r\n    } finally {\r\n      setState(prev => ({ ...prev, isProcessing: false }));\r\n    }\r\n  }, [adapter]);\r\n\r\n  return (\r\n    <VoiceContext.Provider value={{ ...state, register, unregister, processTranscript }}>\r\n      {children}\r\n    </VoiceContext.Provider>\r\n  );\r\n};\r\n\r\nexport const useVoiceContext = () => {\r\n  const ctx = useContext(VoiceContext);\r\n  if (!ctx) throw new Error(\"useVoiceContext must be used within a VoiceControlProvider\");\r\n  return ctx;\r\n};","import { useEffect, useRef } from 'react';\r\nimport { useVoiceContext } from '../components/VoiceContext';\r\nimport { VoiceCommand } from '../types';\r\n\r\n/**\r\n * The Developer Hook\r\n * Wraps the lifecycle logic so the developer doesn't have to.\r\n * * Usage:\r\n * useVoiceCommand({\r\n * id: 'nav_home',\r\n * description: 'Go to home',\r\n * action: () => navigate('/')\r\n * });\r\n */\r\nexport const useVoiceCommand = (command: VoiceCommand) => {\r\n    const { register, unregister } = useVoiceContext();\r\n\r\n    // Use a ref to keep the ID stable across renders\r\n    const idRef = useRef(command.id);\r\n\r\n    useEffect(() => {\r\n        // 1. Mount: Register the tool\r\n        register(command);\r\n\r\n        // 2. Unmount: Remove the tool\r\n        return () => {\r\n            unregister(idRef.current);\r\n        };\r\n    }, [register, unregister, command]); // Re-register if command definition changes\r\n};"]}
+{"version":3,"sources":["../src/components/VoiceContext.tsx","../src/hooks/useVoiceCommand.ts","../src/core/prompt.ts","../src/adapters/openai.ts"],"names":["createContext","useRef","useState","useCallback","jsx","useContext","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import React, { createContext, useContext, useState, useCallback, useRef } from 'react';\nimport { VoiceCommand, VoiceControlState, VoiceProviderProps } from '../types';\n\ninterface VoiceContextValue extends VoiceControlState {\n  register: (cmd: VoiceCommand) => void;\n  unregister: (id: string) => void;\n  processTranscript: (text: string) => Promise<void>;\n}\n\nconst VoiceContext = createContext<VoiceContextValue | null>(null);\n\nexport const VoiceControlProvider: React.FC<VoiceProviderProps> = ({ \n  children, \n  adapter \n}) => {\n  // THE REGISTRY: A Map ensures O(1) lookups and prevents duplicate IDs\n  const commandsRef = useRef<Map<string, VoiceCommand>>(new Map());\n  \n  // UI STATE\n  const [state, setState] = useState<VoiceControlState>({\n    isListening: false,\n    isProcessing: false,\n    lastTranscript: null,\n    activeCommands: [],\n  });\n\n  // 1. REGISTRATION LOGIC\n  const register = useCallback((cmd: VoiceCommand) => {\n    commandsRef.current.set(cmd.id, cmd);\n    // Update generic state for debugging UI\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\n  }, []);\n\n  const unregister = useCallback((id: string) => {\n    commandsRef.current.delete(id);\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\n  }, []);\n\n  // 2. THE ROUTER LOGIC\n  const processTranscript = useCallback(async (transcript: string) => {\n    const cleanText = transcript.trim().toLowerCase();\n    setState(prev => ({ ...prev, isProcessing: true, lastTranscript: cleanText }));\n\n    const allCommands = Array.from(commandsRef.current.values());\n\n    // PHASE 1: EXACT MATCH (0ms Latency)\n    const exactMatch = allCommands.find(c => c.phrase?.toLowerCase() === cleanText);\n    \n    if (exactMatch) {\n      console.log(`⚡ Instant Match: \"${cleanText}\" -> ${exactMatch.id}`);\n      exactMatch.action();\n      setState(prev => ({ ...prev, isProcessing: false }));\n      return;\n    }\n\n    // PHASE 2: FUZZY MATCH (AI Adapter)\n    try {\n      console.log(`🤖 AI Routing: \"${cleanText}\"...`);\n      \n      // We strip the 'action' function before sending to the AI\n      const commandListForAI = allCommands.map(({ id, description, phrase }) => ({ \n        id, \n        description, \n        phrase \n      }));\n\n      const result = await adapter(cleanText, commandListForAI);\n\n      if (result.commandId) {\n        const cmd = commandsRef.current.get(result.commandId);\n        if (cmd) {\n          console.log(`✅ Matched: ${cmd.id}`);\n          cmd.action();\n        } else {\n          console.warn(`⚠️ Adapter returned unknown ID: ${result.commandId}`);\n        }\n      }\n    } catch (error) {\n      console.error(\"Adapter Error:\", error);\n    } finally {\n      setState(prev => ({ ...prev, isProcessing: false }));\n    }\n  }, [adapter]);\n\n  return (\n    <VoiceContext.Provider value={{ ...state, register, unregister, processTranscript }}>\n      {children}\n    </VoiceContext.Provider>\n  );\n};\n\nexport const useVoiceContext = () => {\n  const ctx = useContext(VoiceContext);\n  if (!ctx) throw new Error(\"useVoiceContext must be used within a VoiceControlProvider\");\n  return ctx;\n};","import { useEffect, useRef } from 'react';\nimport { useVoiceContext } from '../components/VoiceContext';\nimport { VoiceCommand } from '../types';\n\n/**\n * The Developer Hook\n * Wraps the lifecycle logic so the developer doesn't have to.\n * * Usage:\n * useVoiceCommand({\n * id: 'nav_home',\n * description: 'Go to home',\n * action: () => navigate('/')\n * });\n */\nexport const useVoiceCommand = (command: VoiceCommand) => {\n    const { register, unregister } = useVoiceContext();\n\n    // Use a ref to keep the ID stable across renders\n    const idRef = useRef(command.id);\n\n    useEffect(() => {\n        // 1. Mount: Register the tool\n        register(command);\n\n        // 2. Unmount: Remove the tool\n        return () => {\n            unregister(idRef.current);\n        };\n    }, [register, unregister, command]); // Re-register if command definition changes\n};","import { VoiceCommand } from '../types';\n\n/**\n * Generates the System Prompt for the LLM.\n * This ensures consistent behavior across different AI providers.\n */\nexport const createSystemPrompt = (commands: Omit<VoiceCommand, 'action'>[]) => {\n    // Format the list of commands for the AI to read\n    const commandList = commands.map(cmd =>\n        `- ID: \"${cmd.id}\" | Description: \"${cmd.description}\"`\n    ).join('\\n');\n\n    return `\nYou are a precise Voice Command Router.\nYour goal is to map the user's spoken input to the correct Command ID from the list below.\n\nRULES:\n1. Analyze the user's input and find the intent.\n2. Match it to the command with the most relevant \"Description\".\n3. Use fuzzy matching (e.g., \"Dark mode\" matches \"Toggle Theme\").\n4. If NO command matches the intent, return null.\n5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.\n\nAVAILABLE COMMANDS:\n${commandList}\n\nRESPONSE FORMAT:\n{ \"commandId\": \"string_id_or_null\" }\n`;\n};\n\n/**\n * Standardizes how the user's voice transcript is presented to the AI.\n */\nexport const createUserPrompt = (transcript: string) => {\n    return `User Input: \"${transcript}\"`;\n};","import { LLMAdapter } from '../types';\nimport { createSystemPrompt } from '../core/prompt';\n\ninterface OpenAIConfig {\n    apiKey: string;\n    /** @default \"gpt-4o-mini\" */\n    model?: string;\n}\n\n/**\n * A Factory that creates an Adapter for OpenAI.\n * Users call this: createOpenAIAdapter({ apiKey: '...' })\n */\nexport const createOpenAIAdapter = (config: OpenAIConfig): LLMAdapter => {\n    return async (transcript, commands) => {\n\n        // 1. Generate the optimized system instructions\n        const systemPrompt = createSystemPrompt(commands);\n\n        // 2. Call the API\n        const response = await fetch('https://api.openai.com/v1/chat/completions', {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'Authorization': `Bearer ${config.apiKey}`\n            },\n            body: JSON.stringify({\n                model: config.model || \"gpt-4o-mini\",\n                messages: [\n                    { role: \"system\", content: systemPrompt },\n                    { role: \"user\", content: transcript }\n                ],\n                temperature: 0, // Deterministic results\n                response_format: { type: \"json_object\" } // Force JSON mode\n            })\n        });\n\n        if (!response.ok) {\n            throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);\n        }\n\n        const data = await response.json();\n\n        // 3. Parse the result\n        try {\n            const parsed = JSON.parse(data.choices[0].message.content);\n            return { commandId: parsed.commandId };\n        } catch (e) {\n            console.error(\"Failed to parse LLM response\", e);\n            return { commandId: null };\n        }\n    };\n};"]}

package/dist/index.mjs

@@ -77,6 +77,66 @@ var useVoiceCommand = (command) => {
   }, [register, unregister, command]);
 };
 
-export { VoiceControlProvider, useVoiceCommand, useVoiceContext };
+// src/core/prompt.ts
+var createSystemPrompt = (commands) => {
+  const commandList = commands.map(
+    (cmd) => `- ID: "${cmd.id}" | Description: "${cmd.description}"`
+  ).join("\n");
+  return `
+You are a precise Voice Command Router.
+Your goal is to map the user's spoken input to the correct Command ID from the list below.
+
+RULES:
+1. Analyze the user's input and find the intent.
+2. Match it to the command with the most relevant "Description".
+3. Use fuzzy matching (e.g., "Dark mode" matches "Toggle Theme").
+4. If NO command matches the intent, return null.
+5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.
+
+AVAILABLE COMMANDS:
+${commandList}
+
+RESPONSE FORMAT:
+{ "commandId": "string_id_or_null" }
+`;
+};
+
+// src/adapters/openai.ts
+var createOpenAIAdapter = (config) => {
+  return async (transcript, commands) => {
+    const systemPrompt = createSystemPrompt(commands);
+    const response = await fetch("https://api.openai.com/v1/chat/completions", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({
+        model: config.model || "gpt-4o-mini",
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: transcript }
+        ],
+        temperature: 0,
+        // Deterministic results
+        response_format: { type: "json_object" }
+        // Force JSON mode
+      })
+    });
+    if (!response.ok) {
+      throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);
+    }
+    const data = await response.json();
+    try {
+      const parsed = JSON.parse(data.choices[0].message.content);
+      return { commandId: parsed.commandId };
+    } catch (e) {
+      console.error("Failed to parse LLM response", e);
+      return { commandId: null };
+    }
+  };
+};
+
+export { VoiceControlProvider, createOpenAIAdapter, useVoiceCommand, useVoiceContext };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/VoiceContext.tsx","../src/hooks/useVoiceCommand.ts"],"names":["useRef"],"mappings":"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","file":"index.mjs","sourcesContent":["import React, { createContext, useContext, useState, useCallback, useRef } from 'react';\r\nimport { VoiceCommand, VoiceControlState, VoiceProviderProps } from '../types';\r\n\r\ninterface VoiceContextValue extends VoiceControlState {\r\n  register: (cmd: VoiceCommand) => void;\r\n  unregister: (id: string) => void;\r\n  processTranscript: (text: string) => Promise<void>;\r\n}\r\n\r\nconst VoiceContext = createContext<VoiceContextValue | null>(null);\r\n\r\nexport const VoiceControlProvider: React.FC<VoiceProviderProps> = ({ \r\n  children, \r\n  adapter \r\n}) => {\r\n  // THE REGISTRY: A Map ensures O(1) lookups and prevents duplicate IDs\r\n  const commandsRef = useRef<Map<string, VoiceCommand>>(new Map());\r\n  \r\n  // UI STATE\r\n  const [state, setState] = useState<VoiceControlState>({\r\n    isListening: false,\r\n    isProcessing: false,\r\n    lastTranscript: null,\r\n    activeCommands: [],\r\n  });\r\n\r\n  // 1. REGISTRATION LOGIC\r\n  const register = useCallback((cmd: VoiceCommand) => {\r\n    commandsRef.current.set(cmd.id, cmd);\r\n    // Update generic state for debugging UI\r\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\r\n  }, []);\r\n\r\n  const unregister = useCallback((id: string) => {\r\n    commandsRef.current.delete(id);\r\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\r\n  }, []);\r\n\r\n  // 2. THE ROUTER LOGIC\r\n  const processTranscript = useCallback(async (transcript: string) => {\r\n    const cleanText = transcript.trim().toLowerCase();\r\n    setState(prev => ({ ...prev, isProcessing: true, lastTranscript: cleanText }));\r\n\r\n    const allCommands = Array.from(commandsRef.current.values());\r\n\r\n    // PHASE 1: EXACT MATCH (0ms Latency)\r\n    const exactMatch = allCommands.find(c => c.phrase?.toLowerCase() === cleanText);\r\n    \r\n    if (exactMatch) {\r\n      console.log(`⚡ Instant Match: \"${cleanText}\" -> ${exactMatch.id}`);\r\n      exactMatch.action();\r\n      setState(prev => ({ ...prev, isProcessing: false }));\r\n      return;\r\n    }\r\n\r\n    // PHASE 2: FUZZY MATCH (AI Adapter)\r\n    try {\r\n      console.log(`🤖 AI Routing: \"${cleanText}\"...`);\r\n      \r\n      // We strip the 'action' function before sending to the AI\r\n      const commandListForAI = allCommands.map(({ id, description, phrase }) => ({ \r\n        id, \r\n        description, \r\n        phrase \r\n      }));\r\n\r\n      const result = await adapter(cleanText, commandListForAI);\r\n\r\n      if (result.commandId) {\r\n        const cmd = commandsRef.current.get(result.commandId);\r\n        if (cmd) {\r\n          console.log(`✅ Matched: ${cmd.id}`);\r\n          cmd.action();\r\n        } else {\r\n          console.warn(`⚠️ Adapter returned unknown ID: ${result.commandId}`);\r\n        }\r\n      }\r\n    } catch (error) {\r\n      console.error(\"Adapter Error:\", error);\r\n    } finally {\r\n      setState(prev => ({ ...prev, isProcessing: false }));\r\n    }\r\n  }, [adapter]);\r\n\r\n  return (\r\n    <VoiceContext.Provider value={{ ...state, register, unregister, processTranscript }}>\r\n      {children}\r\n    </VoiceContext.Provider>\r\n  );\r\n};\r\n\r\nexport const useVoiceContext = () => {\r\n  const ctx = useContext(VoiceContext);\r\n  if (!ctx) throw new Error(\"useVoiceContext must be used within a VoiceControlProvider\");\r\n  return ctx;\r\n};","import { useEffect, useRef } from 'react';\r\nimport { useVoiceContext } from '../components/VoiceContext';\r\nimport { VoiceCommand } from '../types';\r\n\r\n/**\r\n * The Developer Hook\r\n * Wraps the lifecycle logic so the developer doesn't have to.\r\n * * Usage:\r\n * useVoiceCommand({\r\n * id: 'nav_home',\r\n * description: 'Go to home',\r\n * action: () => navigate('/')\r\n * });\r\n */\r\nexport const useVoiceCommand = (command: VoiceCommand) => {\r\n    const { register, unregister } = useVoiceContext();\r\n\r\n    // Use a ref to keep the ID stable across renders\r\n    const idRef = useRef(command.id);\r\n\r\n    useEffect(() => {\r\n        // 1. Mount: Register the tool\r\n        register(command);\r\n\r\n        // 2. Unmount: Remove the tool\r\n        return () => {\r\n            unregister(idRef.current);\r\n        };\r\n    }, [register, unregister, command]); // Re-register if command definition changes\r\n};"]}
+{"version":3,"sources":["../src/components/VoiceContext.tsx","../src/hooks/useVoiceCommand.ts","../src/core/prompt.ts","../src/adapters/openai.ts"],"names":["useRef"],"mappings":"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","file":"index.mjs","sourcesContent":["import React, { createContext, useContext, useState, useCallback, useRef } from 'react';\nimport { VoiceCommand, VoiceControlState, VoiceProviderProps } from '../types';\n\ninterface VoiceContextValue extends VoiceControlState {\n  register: (cmd: VoiceCommand) => void;\n  unregister: (id: string) => void;\n  processTranscript: (text: string) => Promise<void>;\n}\n\nconst VoiceContext = createContext<VoiceContextValue | null>(null);\n\nexport const VoiceControlProvider: React.FC<VoiceProviderProps> = ({ \n  children, \n  adapter \n}) => {\n  // THE REGISTRY: A Map ensures O(1) lookups and prevents duplicate IDs\n  const commandsRef = useRef<Map<string, VoiceCommand>>(new Map());\n  \n  // UI STATE\n  const [state, setState] = useState<VoiceControlState>({\n    isListening: false,\n    isProcessing: false,\n    lastTranscript: null,\n    activeCommands: [],\n  });\n\n  // 1. REGISTRATION LOGIC\n  const register = useCallback((cmd: VoiceCommand) => {\n    commandsRef.current.set(cmd.id, cmd);\n    // Update generic state for debugging UI\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\n  }, []);\n\n  const unregister = useCallback((id: string) => {\n    commandsRef.current.delete(id);\n    setState(prev => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));\n  }, []);\n\n  // 2. THE ROUTER LOGIC\n  const processTranscript = useCallback(async (transcript: string) => {\n    const cleanText = transcript.trim().toLowerCase();\n    setState(prev => ({ ...prev, isProcessing: true, lastTranscript: cleanText }));\n\n    const allCommands = Array.from(commandsRef.current.values());\n\n    // PHASE 1: EXACT MATCH (0ms Latency)\n    const exactMatch = allCommands.find(c => c.phrase?.toLowerCase() === cleanText);\n    \n    if (exactMatch) {\n      console.log(`⚡ Instant Match: \"${cleanText}\" -> ${exactMatch.id}`);\n      exactMatch.action();\n      setState(prev => ({ ...prev, isProcessing: false }));\n      return;\n    }\n\n    // PHASE 2: FUZZY MATCH (AI Adapter)\n    try {\n      console.log(`🤖 AI Routing: \"${cleanText}\"...`);\n      \n      // We strip the 'action' function before sending to the AI\n      const commandListForAI = allCommands.map(({ id, description, phrase }) => ({ \n        id, \n        description, \n        phrase \n      }));\n\n      const result = await adapter(cleanText, commandListForAI);\n\n      if (result.commandId) {\n        const cmd = commandsRef.current.get(result.commandId);\n        if (cmd) {\n          console.log(`✅ Matched: ${cmd.id}`);\n          cmd.action();\n        } else {\n          console.warn(`⚠️ Adapter returned unknown ID: ${result.commandId}`);\n        }\n      }\n    } catch (error) {\n      console.error(\"Adapter Error:\", error);\n    } finally {\n      setState(prev => ({ ...prev, isProcessing: false }));\n    }\n  }, [adapter]);\n\n  return (\n    <VoiceContext.Provider value={{ ...state, register, unregister, processTranscript }}>\n      {children}\n    </VoiceContext.Provider>\n  );\n};\n\nexport const useVoiceContext = () => {\n  const ctx = useContext(VoiceContext);\n  if (!ctx) throw new Error(\"useVoiceContext must be used within a VoiceControlProvider\");\n  return ctx;\n};","import { useEffect, useRef } from 'react';\nimport { useVoiceContext } from '../components/VoiceContext';\nimport { VoiceCommand } from '../types';\n\n/**\n * The Developer Hook\n * Wraps the lifecycle logic so the developer doesn't have to.\n * * Usage:\n * useVoiceCommand({\n * id: 'nav_home',\n * description: 'Go to home',\n * action: () => navigate('/')\n * });\n */\nexport const useVoiceCommand = (command: VoiceCommand) => {\n    const { register, unregister } = useVoiceContext();\n\n    // Use a ref to keep the ID stable across renders\n    const idRef = useRef(command.id);\n\n    useEffect(() => {\n        // 1. Mount: Register the tool\n        register(command);\n\n        // 2. Unmount: Remove the tool\n        return () => {\n            unregister(idRef.current);\n        };\n    }, [register, unregister, command]); // Re-register if command definition changes\n};","import { VoiceCommand } from '../types';\n\n/**\n * Generates the System Prompt for the LLM.\n * This ensures consistent behavior across different AI providers.\n */\nexport const createSystemPrompt = (commands: Omit<VoiceCommand, 'action'>[]) => {\n    // Format the list of commands for the AI to read\n    const commandList = commands.map(cmd =>\n        `- ID: \"${cmd.id}\" | Description: \"${cmd.description}\"`\n    ).join('\\n');\n\n    return `\nYou are a precise Voice Command Router.\nYour goal is to map the user's spoken input to the correct Command ID from the list below.\n\nRULES:\n1. Analyze the user's input and find the intent.\n2. Match it to the command with the most relevant \"Description\".\n3. Use fuzzy matching (e.g., \"Dark mode\" matches \"Toggle Theme\").\n4. If NO command matches the intent, return null.\n5. IMPORTANT: Output ONLY valid JSON. Do not include markdown formatting.\n\nAVAILABLE COMMANDS:\n${commandList}\n\nRESPONSE FORMAT:\n{ \"commandId\": \"string_id_or_null\" }\n`;\n};\n\n/**\n * Standardizes how the user's voice transcript is presented to the AI.\n */\nexport const createUserPrompt = (transcript: string) => {\n    return `User Input: \"${transcript}\"`;\n};","import { LLMAdapter } from '../types';\nimport { createSystemPrompt } from '../core/prompt';\n\ninterface OpenAIConfig {\n    apiKey: string;\n    /** @default \"gpt-4o-mini\" */\n    model?: string;\n}\n\n/**\n * A Factory that creates an Adapter for OpenAI.\n * Users call this: createOpenAIAdapter({ apiKey: '...' })\n */\nexport const createOpenAIAdapter = (config: OpenAIConfig): LLMAdapter => {\n    return async (transcript, commands) => {\n\n        // 1. Generate the optimized system instructions\n        const systemPrompt = createSystemPrompt(commands);\n\n        // 2. Call the API\n        const response = await fetch('https://api.openai.com/v1/chat/completions', {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'Authorization': `Bearer ${config.apiKey}`\n            },\n            body: JSON.stringify({\n                model: config.model || \"gpt-4o-mini\",\n                messages: [\n                    { role: \"system\", content: systemPrompt },\n                    { role: \"user\", content: transcript }\n                ],\n                temperature: 0, // Deterministic results\n                response_format: { type: \"json_object\" } // Force JSON mode\n            })\n        });\n\n        if (!response.ok) {\n            throw new Error(`OpenAI Adapter Failed: ${response.statusText}`);\n        }\n\n        const data = await response.json();\n\n        // 3. Parse the result\n        try {\n            const parsed = JSON.parse(data.choices[0].message.content);\n            return { commandId: parsed.commandId };\n        } catch (e) {\n            console.error(\"Failed to parse LLM response\", e);\n            return { commandId: null };\n        }\n    };\n};"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-voice-action-router",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A headless voice action router for React",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -46,4 +46,4 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   }
-}
+}