npcsh 1.0.13__py3-none-any.whl → 1.0.14__py3-none-any.whl

npcsh/_state.py

@@ -1,45 +1,35 @@
 
 from colorama import Fore, Back, Style
-
-
-from datetime import datetime
-from dotenv import load_dotenv
-
-import re
+from dataclasses import dataclass, field
+import filecmp
 import os
-from termcolor import colored
-
-
-
-from typing import Dict, List, Any
-import subprocess
-import termios
-import tty
+import platform
 import pty
+import re
 import select
+import shutil
 import signal
-import time
-import os
-import re
 import sqlite3
-from datetime import datetime
+import subprocess
+import sys
+from termcolor import colored
+import termios
+import time
+from typing import Dict, List,  Any, Tuple, Union, Optional
+import tty
 import logging
 import textwrap
 from termcolor import colored
-import sys
-import platform
-
+from npcpy.memory.command_history import (
+    start_new_conversation,
+)
+from npcpy.npc_compiler import NPC, Team
 
 def get_npc_path(npc_name: str, db_path: str) -> str:
-    # First, check in project npc_team directory
     project_npc_team_dir = os.path.abspath("./npc_team")
     project_npc_path = os.path.join(project_npc_team_dir, f"{npc_name}.npc")
-
-    # Then, check in global npc_team directory
     user_npc_team_dir = os.path.expanduser("~/.npcsh/npc_team")
     global_npc_path = os.path.join(user_npc_team_dir, f"{npc_name}.npc")
-
-    # Check database for compiled NPCs
     try:
         with sqlite3.connect(db_path) as conn:
             cursor = conn.cursor()
@@ -105,9 +95,6 @@ def initialize_base_npcs_if_needed(db_path: str) -> None:
     package_dir = os.path.dirname(__file__)
     package_npc_team_dir = os.path.join(package_dir, "npc_team")
 
-    
-
-    # User's global npc_team directory
     user_npc_team_dir = os.path.expanduser("~/.npcsh/npc_team")
 
     user_jinxs_dir = os.path.join(user_npc_team_dir, "jinxs")
@@ -115,7 +102,7 @@ def initialize_base_npcs_if_needed(db_path: str) -> None:
     os.makedirs(user_npc_team_dir, exist_ok=True)
     os.makedirs(user_jinxs_dir, exist_ok=True)
     os.makedirs(user_templates_dir, exist_ok=True)
-    # Copy NPCs from package to user directory
+
     for filename in os.listdir(package_npc_team_dir):
         if filename.endswith(".npc"):
             source_path = os.path.join(package_npc_team_dir, filename)
@@ -243,11 +230,11 @@ def ensure_npcshrc_exists() -> str:
             npcshrc.write("# NPCSH Configuration File\n")
             npcshrc.write("export NPCSH_INITIALIZED=0\n")
             npcshrc.write("export NPCSH_DEFAULT_MODE='agent'\n")
+            npcshrc.write("export NPCSH_BUILD_KG=1")
             npcshrc.write("export NPCSH_CHAT_PROVIDER='ollama'\n")
-            npcshrc.write("export NPCSH_CHAT_MODEL='llama3.2'\n")
+            npcshrc.write("export NPCSH_CHAT_MODEL='gemma3:4b'\n")
             npcshrc.write("export NPCSH_REASONING_PROVIDER='ollama'\n")
             npcshrc.write("export NPCSH_REASONING_MODEL='deepseek-r1'\n")
-
             npcshrc.write("export NPCSH_EMBEDDING_PROVIDER='ollama'\n")
             npcshrc.write("export NPCSH_EMBEDDING_MODEL='nomic-embed-text'\n")
             npcshrc.write("export NPCSH_VISION_PROVIDER='ollama'\n")
@@ -1059,12 +1046,13 @@ NPCSH_REASONING_PROVIDER = os.environ.get("NPCSH_REASONING_PROVIDER", "ollama")
 NPCSH_STREAM_OUTPUT = eval(os.environ.get("NPCSH_STREAM_OUTPUT", "0")) == 1
 NPCSH_API_URL = os.environ.get("NPCSH_API_URL", None)
 NPCSH_SEARCH_PROVIDER = os.environ.get("NPCSH_SEARCH_PROVIDER", "duckduckgo")
-
+NPCSH_BUILD_KG = os.environ.get("NPCSH_BUILD_KG") == "1" 
 READLINE_HISTORY_FILE = os.path.expanduser("~/.npcsh_history")
 
 
 
 def setup_readline() -> str:
+    import readline
     if readline is None:
         return None
     try:
@@ -1097,14 +1085,6 @@ def save_readline_history():
 
 
 
-
-from npcpy.memory.command_history import (
-    start_new_conversation,
-)
-from dataclasses import dataclass, field
-from typing import Optional, List, Dict, Any, Tuple, Union
-from npcpy.npc_compiler import NPC, Team
-import os
 @dataclass
 class ShellState:
     npc: Optional[Union[NPC, str]] = None
@@ -1126,6 +1106,7 @@ class ShellState:
     video_gen_model: str = NPCSH_VIDEO_GEN_MODEL
     video_gen_provider: str = NPCSH_VIDEO_GEN_PROVIDER
     current_mode: str = NPCSH_DEFAULT_MODE
+    build_kg: bool = NPCSH_BUILD_KG,
     api_key: Optional[str] = None
     api_url: Optional[str] = NPCSH_API_URL
     current_path: str = field(default_factory=os.getcwd)
@@ -1163,5 +1144,6 @@ initial_state = ShellState(
     image_gen_provider=NPCSH_IMAGE_GEN_PROVIDER,
     video_gen_model=NPCSH_VIDEO_GEN_MODEL,
     video_gen_provider=NPCSH_VIDEO_GEN_PROVIDER,
+    build_kg=NPCSH_BUILD_KG, 
     api_url=NPCSH_API_URL,
 )

npcsh/npcsh.py

@@ -35,6 +35,7 @@ from npcsh._state import (
     ShellState,
     interactive_commands,
     BASH_COMMANDS,
+
     start_interactive_session,
     validate_bash_command, 
     normalize_and_expand_flags, 
@@ -892,9 +893,13 @@ def execute_command(
     active_provider = npc_provider or state.chat_provider
 
     if state.current_mode == 'agent':
+        print(len(commands), commands)
         for i, cmd_segment in enumerate(commands):
+
+            render_markdown(f'- executing command {i+1}/{len(commands)}')
             is_last_command = (i == len(commands) - 1)
-            stream_this_segment = is_last_command and state.stream_output # Use state's stream setting
+
+            stream_this_segment = state.stream_output and not is_last_command 
 
             try:
                 current_state, output = process_pipeline_command(
@@ -905,17 +910,18 @@ def execute_command(
                 )
 
                 if is_last_command:
-                    final_output = output # Capture the output of the last command
+                    return current_state, output
                 if isinstance(output, str):
                     stdin_for_next = output
                 elif not isinstance(output, str):
                     try:
-                        full_stream_output = print_and_process_stream_with_markdown(output, 
-                                                                                    state.npc.model, 
-                                                                                    state.npc.provider)
-                        stdin_for_next = full_stream_output
-                        if is_last_command: 
-                            final_output = full_stream_output
+                        if stream_this_segment:
+                            full_stream_output = print_and_process_stream_with_markdown(output, 
+                                                                                        state.npc.model, 
+                                                                                        state.npc.provider)
+                            stdin_for_next = full_stream_output
+                            if is_last_command: 
+                                final_output = full_stream_output
                     except:
                         if output is not None: # Try converting other types to string
                             try: 
@@ -1064,6 +1070,13 @@ def setup_shell() -> Tuple[CommandHistory, Team, Optional[NPC]]:
     command_history = CommandHistory(db_path)
 
 
+    if not is_npcsh_initialized():
+        print("Initializing NPCSH...")
+        initialize_base_npcs_if_needed(db_path)
+        print("NPCSH initialization complete. Restart or source ~/.npcshrc.")
+
+
+
     try:
         history_file = setup_readline()
         atexit.register(save_readline_history)
@@ -1260,39 +1273,42 @@ def process_result(
         )
 
         conversation_turn_text = f"User: {user_input}\nAssistant: {final_output_str}"
-        conn = command_history.conn
+        engine = command_history.engine
 
-        try:
-            if not should_skip_kg_processing(user_input, final_output_str):
-
-                npc_kg = load_kg_from_db(conn, team_name, npc_name, result_state.current_path)
-                evolved_npc_kg, _ = kg_evolve_incremental(
-                    existing_kg=npc_kg, 
-                    new_content_text=conversation_turn_text,
-                    model=active_npc.model, 
-                    provider=active_npc.provider, 
-                    get_concepts=True,
-                    link_concepts_facts = False, 
-                    link_concepts_concepts = False, 
-                    link_facts_facts = False, 
 
-                    
-                )
-                save_kg_to_db(conn,
-                              evolved_npc_kg, 
-                              team_name, 
-                              npc_name, 
-                              result_state.current_path)
-        except Exception as e:
-            print(colored(f"Error during real-time KG evolution: {e}", "red"))
+        if result_state.build_kg:
+            try:
+                if not should_skip_kg_processing(user_input, final_output_str):
+
+                    npc_kg = load_kg_from_db(engine, team_name, npc_name, result_state.current_path)
+                    evolved_npc_kg, _ = kg_evolve_incremental(
+                        existing_kg=npc_kg, 
+                        new_content_text=conversation_turn_text,
+                        model=active_npc.model, 
+                        provider=active_npc.provider, 
+                        get_concepts=True,
+                        link_concepts_facts = False, 
+                        link_concepts_concepts = False, 
+                        link_facts_facts = False, 
+
+                        
+                    )
+                    save_kg_to_db(engine,
+                                evolved_npc_kg, 
+                                team_name, 
+                                npc_name, 
+                                result_state.current_path)
+            except Exception as e:
+                print(colored(f"Error during real-time KG evolution: {e}", "red"))
 
         # --- Part 3: Periodic Team Context Suggestions ---
         result_state.turn_count += 1
+
         if result_state.turn_count > 0 and result_state.turn_count % 10 == 0:
             print(colored("\nChecking for potential team improvements...", "cyan"))
             try:
                 summary = breathe(messages=result_state.messages[-20:], 
-                                  npc=active_npc)
+                                npc=active_npc)
                 characterization = summary.get('output')
 
                 if characterization and result_state.team:
@@ -1300,7 +1316,7 @@ def process_result(
                     ctx_data = {}
                     if os.path.exists(team_ctx_path):
                         with open(team_ctx_path, 'r') as f:
-                           ctx_data = yaml.safe_load(f) or {}
+                            ctx_data = yaml.safe_load(f) or {}
                     current_context = ctx_data.get('context', '')
 
                     prompt = f"""Based on this characterization: {characterization},
@@ -1317,7 +1333,7 @@ def process_result(
 
                     if suggestion:
                         new_context = (current_context + " " + suggestion).strip()
-                        print(colored("AI suggests updating team context:", "yellow"))
+                        print(colored(f"{result_state.npc.name} suggests updating team context:", "yellow"))
                         print(f"  - OLD: {current_context}\n  + NEW: {new_context}")
                         if input("Apply? [y/N]: ").strip().lower() == 'y':
                             ctx_data['context'] = new_context
@@ -1360,7 +1376,7 @@ def run_repl(command_history: CommandHistory, initial_state: ShellState):
         print("\nGoodbye!")
         print(colored("Processing and archiving all session knowledge...", "cyan"))
         
-        conn = command_history.conn
+        engine = command_history.engine
         integrator_npc = NPC(name="integrator", model=current_state.chat_model, provider=current_state.chat_provider)
 
         # Process each unique scope that was active during the session
@@ -1384,7 +1400,7 @@ def run_repl(command_history: CommandHistory, initial_state: ShellState):
                     continue
 
                 # Load the existing KG for this specific, real scope
-                current_kg = load_kg_from_db(conn, team_name, npc_name, path)
+                current_kg = load_kg_from_db(engine, team_name, npc_name, path)
                 
                 # Evolve it with the full text from the session for this scope
                 evolved_kg, _ = kg_evolve_incremental(
@@ -1400,7 +1416,7 @@ def run_repl(command_history: CommandHistory, initial_state: ShellState):
                 )
                 
                 # Save the updated KG back to the database under the same exact scope
-                save_kg_to_db(conn, evolved_kg, team_name, npc_name, path)
+                save_kg_to_db(engine, evolved_kg, team_name, npc_name, path)
 
             except Exception as e:
                 import traceback
@@ -1488,6 +1504,7 @@ def main() -> None:
     initial_state.npc = default_npc 
     initial_state.team = team
 
+
     # add a -g global command to indicate if to use the global or project, otherwise go thru normal flow
     
     if args.command:

npcsh/routes.py

@@ -757,12 +757,12 @@ def sleep_handler(command: str, **kwargs):
     try:
         db_path = os.getenv("NPCSH_DB_PATH", os.path.expanduser("~/npcsh_history.db"))
         command_history = CommandHistory(db_path)
-        conn = command_history.conn
+        engine = command_history.engine
     except Exception as e:
         return {"output": f"Error connecting to history database for KG access: {e}", "messages": messages}
 
     try:
-        current_kg = load_kg_from_db(conn, team_name, npc_name, current_path)
+        current_kg = load_kg_from_db(engine, team_name, npc_name, current_path)
 
         # FIXED: Provide a detailed and helpful message when the KG is empty
         if not current_kg or not current_kg.get('facts'):
@@ -1031,16 +1031,10 @@ def wander_handler(command: str, **kwargs):
         return {"output": f"Error during wander mode: {e}", "messages": messages}
 
 @router.route("yap", "Enter voice chat (yap) mode")
-def whisper_handler(command: str, **kwargs):
+def yap_handler(command: str, **kwargs):
     try:
         return enter_yap_mode(
-            messages=safe_get(kwargs, 'messages'),
-            npc=safe_get(kwargs, 'npc'),
-            model=safe_get(kwargs, 'model', NPCSH_CHAT_MODEL),
-            provider=safe_get(kwargs, 'provider', NPCSH_CHAT_PROVIDER),
-            team=safe_get(kwargs, 'team'),
-            stream=safe_get(kwargs, 'stream', NPCSH_STREAM_OUTPUT),
-            conversation_id=safe_get(kwargs, 'conversation_id')
+            ** kwargs
             )
     except Exception as e:
         traceback.print_exc()

npcsh/yap.py

@@ -54,18 +54,20 @@ from npcpy.npc_compiler import (
 from npcpy.memory.command_history import CommandHistory, save_conversation_message,start_new_conversation
 from typing import Dict, Any, List
 def enter_yap_mode(
-    
-    model: str ,
-    provider: str ,
-    messages: list = None,
+    messages: list = None,        
+    model: str =  None,
+    provider: str = None ,
     npc = None,    
-    team=  None,
+    team =  None,
+    stream: bool = False, 
+    api_url: str = None,
+    api_key: str=None, 
+    conversation_id = None,
     tts_model="kokoro",
     voice="af_heart", 
     files: List[str] = None,
     rag_similarity_threshold: float = 0.3,
-    stream: bool = NPCSH_STREAM_OUTPUT, 
-    conversation_id = None,
+    **kwargs
 ) -> Dict[str, Any]:
     running = True
     is_recording = False
@@ -100,22 +102,20 @@ def enter_yap_mode(
     # Add conciseness instruction to the system message
     system_message = system_message + " " + concise_instruction
 
-    if messages is None:
+    if messages is None or len(messages) == 0:
         messages = [{"role": "system", "content": system_message}]
     elif messages is not None and messages[0]['role'] != 'system':
         messages.insert(0, {"role": "system", "content": system_message})
 
     kokoro_pipeline = None
     if tts_model == "kokoro":
-        try:
-            from kokoro import KPipeline
-            import soundfile as sf
+        from kokoro import KPipeline
+        import soundfile as sf
+
+        kokoro_pipeline = KPipeline(lang_code="a")
+        print("Kokoro TTS model initialized")
+
 
-            kokoro_pipeline = KPipeline(lang_code="a")
-            print("Kokoro TTS model initialized")
-        except ImportError:
-            print("Kokoro not installed, falling back to gTTS")
-            tts_model = "gtts"
 
     # Initialize PyAudio
     pyaudio_instance = pyaudio.PyAudio()
@@ -134,43 +134,45 @@ def enter_yap_mode(
         nonlocal running, audio_stream
 
         while running and speech_thread_active.is_set():
-            try:
-                # Get next speech item from queue
-                if not speech_queue.empty():
-                    text_to_speak = speech_queue.get(timeout=0.1)
-
-                    # Only process if there's text to speak
-                    if text_to_speak.strip():
-                        # IMPORTANT: Set is_speaking flag BEFORE starting audio output
-                        is_speaking.set()
-
-                        # Safely close the audio input stream before speaking
-                        current_audio_stream = audio_stream
-                        audio_stream = (
-                            None  # Set to None to prevent capture thread from using it
-                        )
-
-                        if current_audio_stream and current_audio_stream.is_active():
-                            current_audio_stream.stop_stream()
-                            current_audio_stream.close()
-
-                        print(f"Speaking full response...")
-
-                        # Generate and play speech
-                        generate_and_play_speech(text_to_speak)
-
-                        # Delay after speech to prevent echo
-                        time.sleep(0.005 * len(text_to_speak))
-                        print(len(text_to_speak))
-
-                        # Clear the speaking flag to allow listening again
-                        is_speaking.clear()
-                else:
-                    time.sleep(0.5)
-            except Exception as e:
-                print(f"Error in speech thread: {e}")
-                is_speaking.clear()  # Make sure to clear the flag if there's an error
-                time.sleep(0.1)
+            #try:
+            # Get next speech item from queue
+            print('.', end='', flush=True)
+            if not speech_queue.empty():
+                print('\n')
+                text_to_speak = speech_queue.get(timeout=0.1)
+
+                # Only process if there's text to speak
+                if text_to_speak.strip():
+                    # IMPORTANT: Set is_speaking flag BEFORE starting audio output
+                    is_speaking.set()
+
+                    # Safely close the audio input stream before speaking
+                    current_audio_stream = audio_stream
+                    audio_stream = (
+                        None  # Set to None to prevent capture thread from using it
+                    )
+
+                    if current_audio_stream and current_audio_stream.is_active():
+                        current_audio_stream.stop_stream()
+                        current_audio_stream.close()
+
+                    print(f"Speaking full response...")
+                    print(text_to_speak)
+                    # Generate and play speech
+                    generate_and_play_speech(text_to_speak)
+
+                    # Delay after speech to prevent echo
+                    time.sleep(0.005 * len(text_to_speak))
+                    print(len(text_to_speak))
+
+                    # Clear the speaking flag to allow listening again
+                    is_speaking.clear()
+            else:
+                time.sleep(0.5)
+            #except Exception as e:
+            #    print(f"Error in speech thread: {e}")
+            #    is_speaking.clear()  # Make sure to clear the flag if there's an error
+            #    time.sleep(0.1)
 
     def safely_close_audio_stream(stream):
         """Safely close an audio stream with error handling"""
@@ -315,10 +317,9 @@ def enter_yap_mode(
                     frames_per_buffer=CHUNK,
                 )
 
-            # Initialize or reset the recording variables
-            is_recording = False
-            recording_data = []
-            buffer_data = []
+            # Add timeout counter
+            timeout_counter = 0
+            max_timeout = 100  # About 10 seconds at 0.1s intervals
 
             print("\nListening for speech...")
 
@@ -327,49 +328,63 @@ def enter_yap_mode(
                 and audio_stream
                 and audio_stream.is_active()
                 and not is_speaking.is_set()
+                and timeout_counter < max_timeout
             ):
                 try:
+                    # Add non-blocking read with timeout
                     data = audio_stream.read(CHUNK, exception_on_overflow=False)
-                    if data:
-                        audio_array = np.frombuffer(data, dtype=np.int16)
-                        audio_float = audio_array.astype(np.float32) / 32768.0
-
-                        tensor = torch.from_numpy(audio_float).to(device)
-                        speech_prob = vad_model(tensor, RATE).item()
-                        current_time = time.time()
-
-                        if speech_prob > 0.5:  # VAD threshold
-                            last_speech_time = current_time
-                            if not is_recording:
-                                is_recording = True
-                                print("\nSpeech detected, listening...")
-                                recording_data.extend(buffer_data)
-                                buffer_data = []
-                            recording_data.append(data)
+                    
+                    if not data:
+                        timeout_counter += 1
+                        time.sleep(0.1)
+                        continue
+                        
+                    # Reset timeout on successful read
+                    timeout_counter = 0
+                    
+                    audio_array = np.frombuffer(data, dtype=np.int16)
+                    if len(audio_array) == 0:
+                        continue
+                        
+                    audio_float = audio_array.astype(np.float32) / 32768.0
+                    tensor = torch.from_numpy(audio_float).to(device)
+                    
+                    # Add timeout to VAD processing
+                    speech_prob = vad_model(tensor, RATE).item()
+                    current_time = time.time()
+
+                    if speech_prob > 0.5:  # VAD threshold
+                        last_speech_time = current_time
+                        if not is_recording:
+                            is_recording = True
+                            print("\nSpeech detected, listening...")
+                            recording_data.extend(buffer_data)
+                            buffer_data = []
+                        recording_data.append(data)
+                    else:
+                        if is_recording:
+                            if (
+                                current_time - last_speech_time > 1
+                            ):  # silence duration
+                                is_recording = False
+                                print("Speech ended, transcribing...")
+
+                                # Stop stream before transcribing
+                                safely_close_audio_stream(audio_stream)
+                                audio_stream = None
+
+                                # Transcribe in this thread to avoid race conditions
+                                transcription = transcribe_recording(recording_data)
+                                if transcription:
+                                    transcription_queue.put(transcription)
+                                recording_data = []
+                                return True  # Got speech
                         else:
-                            if is_recording:
-                                if (
-                                    current_time - last_speech_time > 1
-                                ):  # silence duration
-                                    is_recording = False
-                                    print("Speech ended, transcribing...")
-
-                                    # Stop stream before transcribing
-                                    safely_close_audio_stream(audio_stream)
-                                    audio_stream = None
-
-                                    # Transcribe in this thread to avoid race conditions
-                                    transcription = transcribe_recording(recording_data)
-                                    if transcription:
-                                        transcription_queue.put(transcription)
-                                    recording_data = []
-                                    return True  # Got speech
-                            else:
-                                buffer_data.append(data)
-                                if len(buffer_data) > int(
-                                    0.65 * RATE / CHUNK
-                                ):  # buffer duration
-                                    buffer_data.pop(0)
+                            buffer_data.append(data)
+                            if len(buffer_data) > int(
+                                0.65 * RATE / CHUNK
+                            ):  # buffer duration
+                                buffer_data.pop(0)
 
                     # Check frequently if we need to stop capturing
                     if is_speaking.is_set():
@@ -427,19 +442,14 @@ def enter_yap_mode(
 
 
         while running:
-
-            # First check for typed input (non-blocking)
             import select
             import sys
-
-            # Don't spam the console with prompts when speaking
             if not is_speaking.is_set():
                 print(
                     "🎤🎤🎤🎤\n Speak or type your message (or 'exit' to quit): ",
                     end="",
                     flush=True,
                 )
-
             rlist, _, _ = select.select([sys.stdin], [], [], 0.1)
             if rlist:
                 user_input = sys.stdin.readline().strip()
@@ -448,7 +458,7 @@ def enter_yap_mode(
                     break
                 if user_input:
                     print(f"\nYou (typed): {user_input}")
-                    # Handle RAG context
+
                     if loaded_content:
                         context_content = ""
                         for filename, content in loaded_content.items():
@@ -494,9 +504,8 @@ def enter_yap_mode(
 
 
                     continue  # Skip audio capture this cycle
-
-            # Then try to capture some audio (if no typed input)
             if not is_speaking.is_set():  # Only capture if not currently speaking
+                print('capturing audio')
                 got_speech = capture_audio()
 
                 # If we got speech, process it
@@ -560,9 +569,9 @@ def main():
         provider = sibiji.provider        
     # Enter spool mode
     enter_yap_mode(
-        model,
-        provider,
         messages=None,
+        model= model,
+        provider = provider,
         npc=sibiji,
         team = team,
         files=args.files,

{npcsh-1.0.13.dist-info → npcsh-1.0.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.0.13
+Version: 1.0.14
 Summary: npcsh is a command-line toolkit for using AI agents in novel ways.
 Home-page: https://github.com/NPC-Worldwide/npcsh
 Author: Christopher Agostino
@@ -16,6 +16,7 @@ Requires-Dist: litellm
 Requires-Dist: docx
 Requires-Dist: scipy
 Requires-Dist: numpy
+Requires-Dist: imagehash
 Requires-Dist: requests
 Requires-Dist: matplotlib
 Requires-Dist: markdown
@@ -121,14 +122,15 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
       npcsh:🤖sibiji:gemini-2.5-flash>can you help me identify what process is listening on port 5337? 
       ```
       <p align="center"> 
-        <img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/port5337.png" alt="example of running npcsh to check what processes are listening on port 5337", width=250>
+        <img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/port5337.png" alt="example of running npcsh to check what processes are listening on port 5337", width=600>
       </p>
     - Edit files
 
   - **Ask a Generic Question**
     ```bash
-    npc 'has there ever been a better pasta shape than bucatini?'
+    npcsh> has there ever been a better pasta shape than bucatini?
     ```
+    
     ```
     .Loaded .env file...                                                                                                                                               
     Initializing database schema...                                                                                                                                                            
@@ -147,7 +149,7 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
     /search "cal golden bears football schedule" -sp perplexity
     ```
     <p align="center">
-        <img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/search_example.png" alt="example of search results", width=250>
+        <img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/search_example.png" alt="example of search results", width=600>
     </p>
 
   - **Computer Use**
@@ -203,10 +205,10 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
     - `/serve` - Serve an NPC Team server.
     - `/set` - Set configuration values
     - `/sleep` - Evolve knowledge graph with options for dreaming. 
-    - `/spool` - Enter interactive chat (spool) mode
+    - `/spool` - Enter interactive chat (spool) mode with an npc with fresh context or files for rag
     - `/trigger` - Execute a trigger command
-    - `/vixynt` - Generate images from text descriptions
-    - `/wander` - Enter wander mode (experimental)
+    - `/vixynt` - Generate and edit images from text descriptions using local models, openai, gemini
+    - `/wander` - A method for LLMs to think on a problem by switching between states of high temperature and low temperature
     - `/yap` - Enter voice chat (yap) mode
     
     ## Common Command-Line Flags\n\nThe shortest unambiguous prefix works (e.g., `-t` for `--temperature`).

{npcsh-1.0.13.dist-info → npcsh-1.0.14.dist-info}/RECORD

@@ -1,21 +1,21 @@
 npcsh/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-npcsh/_state.py,sha256=UEI28eLEHS4xJZOlNynSfZWnxipZV086ynGzoAdQmUY,33601
+npcsh/_state.py,sha256=Xm2JoXLW4GNEbdME096XLzRCIIPfaNslh8VHc6JshHc,33436
 npcsh/alicanto.py,sha256=-muGqd0O2m8xcFBctEavSEizWbQmzuPSdcT-3YqYBhY,45043
 npcsh/guac.py,sha256=Ocmk_c4NUtGsC3JOtmkbgLvD6u-XtBPRFRYcckpgUJU,33099
 npcsh/mcp_helpers.py,sha256=Ktd2yXuBnLL2P7OMalgGLj84PXJSzaucjqmJVvWx6HA,12723
 npcsh/mcp_npcsh.py,sha256=SfmplH62GS9iI6q4vuQLVUS6tkrok6L7JxODx_iH7ps,36158
 npcsh/mcp_server.py,sha256=l2Ra0lpFrUu334pvp0Q9ajF2n73KvZswFi0FgbDhh9k,5884
 npcsh/npc.py,sha256=7ujKrMQFgkeGJ4sX5Kn_dB5tjrPN58xeC91PNt453aM,7827
-npcsh/npcsh.py,sha256=TB_xYN3IEFHB5Wj931ZOlgQ12cNBsVz1SoIrQsP4b4M,59088
+npcsh/npcsh.py,sha256=uxs_5k-zmuDjdvKMxoBZwdefdgKGESd-EIGCXYNgx0Y,59571
 npcsh/plonk.py,sha256=7w7J2bht5QXOyV2UK045nAPDmrSrTGLX-sh56KQ3-k0,14653
 npcsh/pti.py,sha256=jGHGE5SeIcDkV8WlOEHCKQCnYAL4IPS-kUBHrUz0oDA,10019
-npcsh/routes.py,sha256=hEnOwRrY9onHhUTeS7lPGEytEUEzd7KZYO5GTikS0KQ,44848
+npcsh/routes.py,sha256=gsKHhdbzcZnE91w86ydr3ABNTxL12Ta0Oa9z3qwEh54,44470
 npcsh/spool.py,sha256=QF1SuIhj_PWiOYNkAK31f1W_wS8yYxC5XvM2GU7VJMM,9495
 npcsh/wander.py,sha256=BiN6eYyFnEsFzo8MFLRkdZ8xS9sTKkQpjiCcy9chMcc,23225
-npcsh/yap.py,sha256=h5KNt9sNOrDPhGe_zfn_yFIeQhizX09zocjcPWH7m3k,20905
-npcsh-1.0.13.dist-info/licenses/LICENSE,sha256=IKBvAECHP-aCiJtE4cHGCE5Yl0tozYz02PomGeWS3y4,1070
-npcsh-1.0.13.dist-info/METADATA,sha256=xhEAZb5pELsUA-lQKspyS_nKfy6kxU2ayL4CfJxZQjg,30829
-npcsh-1.0.13.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-npcsh-1.0.13.dist-info/entry_points.txt,sha256=qxOYTm3ym3JWyWf2nv2Mk71uMcJIdUoNEJ8VYMkyHiY,214
-npcsh-1.0.13.dist-info/top_level.txt,sha256=kHSNgKMCkfjV95-DH0YSp1LLBi0HXdF3w57j7MQON3E,6
-npcsh-1.0.13.dist-info/RECORD,,
+npcsh/yap.py,sha256=ipkY3uMDw8gNrPSZ9qJFWVQ_fXtLmQ2oz_6_WZt2hew,21097
+npcsh-1.0.14.dist-info/licenses/LICENSE,sha256=IKBvAECHP-aCiJtE4cHGCE5Yl0tozYz02PomGeWS3y4,1070
+npcsh-1.0.14.dist-info/METADATA,sha256=W0GyU5aR_MP9qUrp7BHWV54p0cgNNrY6E7wzChyvU_4,31027
+npcsh-1.0.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+npcsh-1.0.14.dist-info/entry_points.txt,sha256=qxOYTm3ym3JWyWf2nv2Mk71uMcJIdUoNEJ8VYMkyHiY,214
+npcsh-1.0.14.dist-info/top_level.txt,sha256=kHSNgKMCkfjV95-DH0YSp1LLBi0HXdF3w57j7MQON3E,6
+npcsh-1.0.14.dist-info/RECORD,,