react-voice-action-router 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +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
+SOFTWARE.

package/README.md

@@ -0,0 +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
+# Note: React 16.8+ is required for Hooks support.

package/dist/adapters/index.d.mts

@@ -0,0 +1 @@
+export { c as createOpenAIAdapter } from '../index-DyZ8YKh9.mjs';

package/dist/adapters/index.d.ts

@@ -0,0 +1 @@
+export { c as createOpenAIAdapter } from '../index-DyZ8YKh9.js';

package/dist/adapters/index.js

@@ -0,0 +1,65 @@
+'use strict';
+
+// 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.createOpenAIAdapter = createOpenAIAdapter;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +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';\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

@@ -0,0 +1,63 @@
+// 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 { createOpenAIAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/adapters/index.mjs.map

@@ -0,0 +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';\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-DyZ8YKh9.d.mts

@@ -0,0 +1,52 @@
+/**
+ * A voice command that can be registered by a component.
+ */
+interface VoiceCommand {
+    /** Unique identifier for the command (e.g., 'nav_home') */
+    id: string;
+    /** Natural language description for the LLM (e.g., 'Navigate to the home dashboard') */
+    description: string;
+    /** Optional: Exact phrase for 0-latency matching (e.g., 'Go Home') */
+    phrase?: string;
+    /** The function to execute when matched */
+    action: () => void;
+}
+/**
+ * The internal state of the voice engine.
+ */
+interface VoiceControlState {
+    isListening: boolean;
+    isProcessing: boolean;
+    lastTranscript: string | null;
+    /** Exposed primarily for debugging/visualization */
+    activeCommands: VoiceCommand[];
+}
+/**
+ * The Adapter Protocol ("The Universal Plug").
+ * Any AI provider (OpenAI, Anthropic, Local) must match this signature.
+ */
+type LLMAdapter = (transcript: string, commands: Omit<VoiceCommand, 'action'>[]) => Promise<{
+    commandId: string | null;
+}>;
+interface VoiceProviderProps {
+    children: React.ReactNode;
+    /** The AI Adapter function */
+    adapter: LLMAdapter;
+    /** Optional: Trigger word (e.g., "Jarvis") - not implemented in MVP */
+    wakeWord?: string;
+    /** Optional: Callback for debugging state changes */
+    onStateChange?: (state: VoiceControlState) => void;
+}
+
+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-DyZ8YKh9.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A voice command that can be registered by a component.
+ */
+interface VoiceCommand {
+    /** Unique identifier for the command (e.g., 'nav_home') */
+    id: string;
+    /** Natural language description for the LLM (e.g., 'Navigate to the home dashboard') */
+    description: string;
+    /** Optional: Exact phrase for 0-latency matching (e.g., 'Go Home') */
+    phrase?: string;
+    /** The function to execute when matched */
+    action: () => void;
+}
+/**
+ * The internal state of the voice engine.
+ */
+interface VoiceControlState {
+    isListening: boolean;
+    isProcessing: boolean;
+    lastTranscript: string | null;
+    /** Exposed primarily for debugging/visualization */
+    activeCommands: VoiceCommand[];
+}
+/**
+ * The Adapter Protocol ("The Universal Plug").
+ * Any AI provider (OpenAI, Anthropic, Local) must match this signature.
+ */
+type LLMAdapter = (transcript: string, commands: Omit<VoiceCommand, 'action'>[]) => Promise<{
+    commandId: string | null;
+}>;
+interface VoiceProviderProps {
+    children: React.ReactNode;
+    /** The AI Adapter function */
+    adapter: LLMAdapter;
+    /** Optional: Trigger word (e.g., "Jarvis") - not implemented in MVP */
+    wakeWord?: string;
+    /** Optional: Callback for debugging state changes */
+    onStateChange?: (state: VoiceControlState) => void;
+}
+
+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

@@ -0,0 +1,25 @@
+import React from 'react';
+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;
+    unregister: (id: string) => void;
+    processTranscript: (text: string) => Promise<void>;
+}
+declare const VoiceControlProvider: React.FC<VoiceProviderProps>;
+declare const useVoiceContext: () => VoiceContextValue;
+
+/**
+ * The Developer Hook
+ * Wraps the lifecycle logic so the developer doesn't have to.
+ * * Usage:
+ * useVoiceCommand({
+ * id: 'nav_home',
+ * description: 'Go to home',
+ * action: () => navigate('/')
+ * });
+ */
+declare const useVoiceCommand: (command: VoiceCommand) => void;
+
+export { VoiceCommand, VoiceControlProvider, VoiceControlState, useVoiceCommand, useVoiceContext };

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+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;
+    unregister: (id: string) => void;
+    processTranscript: (text: string) => Promise<void>;
+}
+declare const VoiceControlProvider: React.FC<VoiceProviderProps>;
+declare const useVoiceContext: () => VoiceContextValue;
+
+/**
+ * The Developer Hook
+ * Wraps the lifecycle logic so the developer doesn't have to.
+ * * Usage:
+ * useVoiceCommand({
+ * id: 'nav_home',
+ * description: 'Go to home',
+ * action: () => navigate('/')
+ * });
+ */
+declare const useVoiceCommand: (command: VoiceCommand) => void;
+
+export { VoiceCommand, VoiceControlProvider, VoiceControlState, useVoiceCommand, useVoiceContext };

package/dist/index.js

@@ -0,0 +1,147 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/components/VoiceContext.tsx
+var VoiceContext = react.createContext(null);
+var VoiceControlProvider = ({
+  children,
+  adapter
+}) => {
+  const commandsRef = react.useRef(/* @__PURE__ */ new Map());
+  const [state, setState] = react.useState({
+    isListening: false,
+    isProcessing: false,
+    lastTranscript: null,
+    activeCommands: []
+  });
+  const register = react.useCallback((cmd) => {
+    commandsRef.current.set(cmd.id, cmd);
+    setState((prev) => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));
+  }, []);
+  const unregister = react.useCallback((id) => {
+    commandsRef.current.delete(id);
+    setState((prev) => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));
+  }, []);
+  const processTranscript = react.useCallback(async (transcript) => {
+    const cleanText = transcript.trim().toLowerCase();
+    setState((prev) => ({ ...prev, isProcessing: true, lastTranscript: cleanText }));
+    const allCommands = Array.from(commandsRef.current.values());
+    const exactMatch = allCommands.find((c) => {
+      var _a;
+      return ((_a = c.phrase) == null ? void 0 : _a.toLowerCase()) === cleanText;
+    });
+    if (exactMatch) {
+      console.log(`\u26A1 Instant Match: "${cleanText}" -> ${exactMatch.id}`);
+      exactMatch.action();
+      setState((prev) => ({ ...prev, isProcessing: false }));
+      return;
+    }
+    try {
+      console.log(`\u{1F916} AI Routing: "${cleanText}"...`);
+      const commandListForAI = allCommands.map(({ id, description, phrase }) => ({
+        id,
+        description,
+        phrase
+      }));
+      const result = await adapter(cleanText, commandListForAI);
+      if (result.commandId) {
+        const cmd = commandsRef.current.get(result.commandId);
+        if (cmd) {
+          console.log(`\u2705 Matched: ${cmd.id}`);
+          cmd.action();
+        } else {
+          console.warn(`\u26A0\uFE0F Adapter returned unknown ID: ${result.commandId}`);
+        }
+      }
+    } catch (error) {
+      console.error("Adapter Error:", error);
+    } finally {
+      setState((prev) => ({ ...prev, isProcessing: false }));
+    }
+  }, [adapter]);
+  return /* @__PURE__ */ jsxRuntime.jsx(VoiceContext.Provider, { value: { ...state, register, unregister, processTranscript }, children });
+};
+var useVoiceContext = () => {
+  const ctx = react.useContext(VoiceContext);
+  if (!ctx) throw new Error("useVoiceContext must be used within a VoiceControlProvider");
+  return ctx;
+};
+var useVoiceCommand = (command) => {
+  const { register, unregister } = useVoiceContext();
+  const idRef = react.useRef(command.id);
+  react.useEffect(() => {
+    register(command);
+    return () => {
+      unregister(idRef.current);
+    };
+  }, [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
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,142 @@
+import { createContext, useRef, useState, useCallback, useContext, useEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/components/VoiceContext.tsx
+var VoiceContext = createContext(null);
+var VoiceControlProvider = ({
+  children,
+  adapter
+}) => {
+  const commandsRef = useRef(/* @__PURE__ */ new Map());
+  const [state, setState] = useState({
+    isListening: false,
+    isProcessing: false,
+    lastTranscript: null,
+    activeCommands: []
+  });
+  const register = useCallback((cmd) => {
+    commandsRef.current.set(cmd.id, cmd);
+    setState((prev) => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));
+  }, []);
+  const unregister = useCallback((id) => {
+    commandsRef.current.delete(id);
+    setState((prev) => ({ ...prev, activeCommands: Array.from(commandsRef.current.values()) }));
+  }, []);
+  const processTranscript = useCallback(async (transcript) => {
+    const cleanText = transcript.trim().toLowerCase();
+    setState((prev) => ({ ...prev, isProcessing: true, lastTranscript: cleanText }));
+    const allCommands = Array.from(commandsRef.current.values());
+    const exactMatch = allCommands.find((c) => {
+      var _a;
+      return ((_a = c.phrase) == null ? void 0 : _a.toLowerCase()) === cleanText;
+    });
+    if (exactMatch) {
+      console.log(`\u26A1 Instant Match: "${cleanText}" -> ${exactMatch.id}`);
+      exactMatch.action();
+      setState((prev) => ({ ...prev, isProcessing: false }));
+      return;
+    }
+    try {
+      console.log(`\u{1F916} AI Routing: "${cleanText}"...`);
+      const commandListForAI = allCommands.map(({ id, description, phrase }) => ({
+        id,
+        description,
+        phrase
+      }));
+      const result = await adapter(cleanText, commandListForAI);
+      if (result.commandId) {
+        const cmd = commandsRef.current.get(result.commandId);
+        if (cmd) {
+          console.log(`\u2705 Matched: ${cmd.id}`);
+          cmd.action();
+        } else {
+          console.warn(`\u26A0\uFE0F Adapter returned unknown ID: ${result.commandId}`);
+        }
+      }
+    } catch (error) {
+      console.error("Adapter Error:", error);
+    } finally {
+      setState((prev) => ({ ...prev, isProcessing: false }));
+    }
+  }, [adapter]);
+  return /* @__PURE__ */ jsx(VoiceContext.Provider, { value: { ...state, register, unregister, processTranscript }, children });
+};
+var useVoiceContext = () => {
+  const ctx = useContext(VoiceContext);
+  if (!ctx) throw new Error("useVoiceContext must be used within a VoiceControlProvider");
+  return ctx;
+};
+var useVoiceCommand = (command) => {
+  const { register, unregister } = useVoiceContext();
+  const idRef = useRef(command.id);
+  useEffect(() => {
+    register(command);
+    return () => {
+      unregister(idRef.current);
+    };
+  }, [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 };
+    }
+  };
+};
+
+export { VoiceControlProvider, createOpenAIAdapter, useVoiceCommand, useVoiceContext };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"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,11 +1,33 @@
 {
   "name": "react-voice-action-router",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A headless voice action router for React",
-  "main": "index.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "require": "./dist/adapters/index.js",
+      "import": "./dist/adapters/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "license": "MIT",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -17,5 +39,11 @@
   "bugs": {
     "url": "https://github.com/Nouman64-cat/react-voice-action-router/issues"
   },
-  "homepage": "https://github.com/Nouman64-cat/react-voice-action-router#readme"
+  "homepage": "https://github.com/Nouman64-cat/react-voice-action-router#readme",
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
 }

package/index.js

@@ -1,3 +0,0 @@
-// index.js
-console.log("react-voice-action-router: Coming soon!");
-module.exports = {};