npcsh 1.1.9__tar.gz → 1.1.10__tar.gz

{npcsh-1.1.9 → npcsh-1.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.1.9
+Version: 1.1.10
 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

{npcsh-1.1.9 → npcsh-1.1.10}/npcsh/_state.py

@@ -111,6 +111,7 @@ except importlib.metadata.PackageNotFoundError:
     VERSION = "unknown"
 
 
+from litellm import RateLimitError
 
 
 NPCSH_CHAT_MODEL = os.environ.get("NPCSH_CHAT_MODEL", "gemma3:4b")
@@ -2263,7 +2264,7 @@ def process_pipeline_command(
                 images=state.attachments,
                 stream=stream_final,
                 context=info,
-                extra_globals=application_globals_for_jinx  # NOW PASS IT
+                extra_globals=application_globals_for_jinx  
             )
         if not review:
             if isinstance(llm_result, dict):
@@ -2513,7 +2514,23 @@ def execute_command(
                     f"  → Passing to stage {stage_num + 1}", 
                     "blue"
                 ))
-                
+            except RateLimitError:
+                print(colored('Rate Limit Exceeded'))
+                # wait 30 seconds then truncate messages/condense context with breathing mechanism
+                # for now just limit to first plus last 10
+                messages = current_state.messages[0:1] + current_state.messages[-2:]
+                current_state.messages = messages
+                #retry 
+                import time 
+                print('sleeping...')
+                print(current_state)
+                print(current_state.messages)
+                time.sleep(30)
+
+
+                return execute_command(command, current_state, review=review, router=router,)
+
+
             except Exception as pipeline_error:
                 import traceback
                 traceback.print_exc()
@@ -2665,10 +2682,12 @@ def setup_shell() -> Tuple[CommandHistory, Team, Optional[NPC]]:
                 if use_jinxs == "c":
                     global_jinxs_dir = os.path.expanduser("~/.npcsh/npc_team/jinxs")
                     if os.path.exists(global_jinxs_dir):
-                        shutil.copytree(global_jinxs_dir, team_dir, dirs_exist_ok=True)
+                        # Create the 'jinxs' subfolder within the new team's directory
+                        destination_jinxs_dir = os.path.join(team_dir, "jinxs")
+                        os.makedirs(destination_jinxs_dir, exist_ok=True)
+                        shutil.copytree(global_jinxs_dir, destination_jinxs_dir, dirs_exist_ok=True)
                 else:
                     team_ctx_data["use_global_jinxs"] = True
-
                 with open(ctx_path, "w") as f:
                     yaml.dump(team_ctx_data, f)
             else:

{npcsh-1.1.9 → npcsh-1.1.10}/npcsh/guac.py

@@ -1376,10 +1376,12 @@ def get_guac_prompt_char(command_count: int, guac_refresh_period = 100) -> str:
 def execute_guac_command(command: str, state: ShellState, locals_dict: Dict[str, Any], project_name: str, src_dir: Path, router) -> Tuple[ShellState, Any]:
     stripped_command = command.strip()
     output = None 
-    cmd_parts = shlex.split(stripped_command)
-    if cmd_parts and cmd_parts[0] in ["cd", "ls", "pwd"]:
-        return execute_command(stripped_command, state, review=False, router=router)
-
+    try:
+        cmd_parts = shlex.split(stripped_command)
+        if cmd_parts and cmd_parts[0] in ["cd", "ls", "pwd"]:
+            return execute_command(stripped_command, state, review=False, router=router)
+    except Exception as e:
+        pass
     npc_team_dir = Path(state.team.team_path) if state.team and hasattr(state.team, 'team_path') else Path.cwd() / "npc_team"
 
     if not stripped_command:

npcsh-1.1.10/npcsh/npc_team/jinxs/utils/compress.jinx

@@ -0,0 +1,140 @@
+jinx_name: "compress"
+description: "Manages conversation and knowledge context. Defaults to compacting context. Use flags for other operations."
+inputs:
+  - flush: ""       # The number of recent messages to flush.
+  - sleep: False    # If true, evolves the knowledge graph.
+  - dream: False    # Used with --sleep. Runs creative synthesis.
+  - ops: ""         # Used with --sleep. Comma-separated list of KG operations.
+  - model: ""       # Used with --sleep. LLM model for KG evolution.
+  - provider: ""    # Used with --sleep. LLM provider for KG evolution.
+steps:
+  - name: "manage_context_and_memory"
+    engine: "python"
+    code: |
+      import os
+      import traceback
+      from npcpy.llm_funcs import breathe
+      from npcpy.memory.command_history import CommandHistory, load_kg_from_db, save_kg_to_db
+      from npcpy.memory.knowledge_graph import kg_sleep_process, kg_dream_process
+
+      # --- Get all inputs from context ---
+      flush_n_str = context.get('flush')
+      is_sleeping = context.get('sleep')
+      is_dreaming = context.get('dream')
+      operations_str = context.get('ops')
+      llm_model = context.get('model')
+      llm_provider = context.get('provider')
+      output_messages = context.get('messages', [])
+      
+      USAGE = """Usage:
+        /compress                       (Compacts conversation context)
+        /compress --flush <number>        (Removes the last N messages)
+        /compress --sleep [...]         (Evolves the knowledge graph)
+          --dream                       (With --sleep: enables creative synthesis)
+          --ops "op1,op2"               (With --sleep: specifies KG operations)
+          --model <name>                (With --sleep: specifies LLM model)
+          --provider <name>             (With --sleep: specifies LLM provider)"""
+
+      # --- Argument Validation: Ensure mutual exclusivity ---
+      is_flushing = flush_n_str is not None and flush_n_str.strip() != ''
+      if is_sleeping and is_flushing:
+          context['output'] = f"Error: --sleep and --flush are mutually exclusive.\n{USAGE}"
+          context['messages'] = output_messages
+          exit()
+
+      # --- Dispatcher: Route to the correct functionality ---
+
+      # 1. SLEEP: Evolve the Knowledge Graph
+      if is_sleeping:
+          current_npc = context.get('npc')
+          current_team = context.get('team')
+          
+          # Parameter setup for KG process
+          operations_config = [op.strip() for op in operations_str.split(',')] if operations_str else None
+          if not llm_model and current_npc: llm_model = current_npc.model
+          if not llm_provider and current_npc: llm_provider = current_npc.provider
+          if not llm_model: llm_model = "gemini-1.5-pro"
+          if not llm_provider: llm_provider = "gemini"
+
+          team_name = current_team.name if current_team else "__none__"
+          npc_name = current_npc.name if current_npc else "__none__"
+          current_path = os.getcwd()
+          scope_str = f"Team: '{team_name}', NPC: '{npc_name}', Path: '{current_path}'"
+          
+          command_history = None
+          try:
+              db_path = os.getenv("NPCSH_DB_PATH", os.path.expanduser("~/npcsh_history.db"))
+              command_history = CommandHistory(db_path)
+              engine = command_history.engine
+              current_kg = load_kg_from_db(engine, team_name, npc_name, current_path)
+
+              if not current_kg or not current_kg.get('facts'):
+                  context['output'] = f"Knowledge graph for the current scope is empty. Nothing to process.\n- Scope: {scope_str}"
+                  exit()
+
+              original_facts = len(current_kg.get('facts', []))
+              original_concepts = len(current_kg.get('concepts', []))
+              
+              evolved_kg, _ = kg_sleep_process(existing_kg=current_kg, model=llm_model, provider=llm_provider, npc=current_npc, operations_config=operations_config)
+              process_type = "Sleep"
+
+              if is_dreaming:
+                  evolved_kg, _ = kg_dream_process(existing_kg=evolved_kg, model=llm_model, provider=llm_provider, npc=current_npc)
+                  process_type += " & Dream"
+
+              save_kg_to_db(engine, evolved_kg, team_name, npc_name, current_path)
+              
+              new_facts = len(evolved_kg.get('facts', []))
+              new_concepts = len(evolved_kg.get('concepts', []))
+              
+              context['output'] = (f"{process_type} process complete.\n"
+                                   f"- Facts: {original_facts} -> {new_facts} ({new_facts - original_facts:+})\n"
+                                   f"- Concepts: {original_concepts} -> {new_concepts} ({new_concepts - original_concepts:+})")
+          except Exception as e:
+              traceback.print_exc()
+              context['output'] = f"Error during KG evolution: {e}"
+          finally:
+              if command_history: command_history.close()
+              context['messages'] = output_messages
+
+      # 2. FLUSH: Remove messages from context
+      elif is_flushing:
+          try:
+              n = int(flush_n_str)
+              if n <= 0:
+                  context['output'] = "Error: Number of messages to flush must be positive."
+                  exit()
+          except ValueError:
+              context['output'] = f"Error: Invalid number '{flush_n_str}'. {USAGE}"
+              exit()
+
+          messages_list = list(output_messages)
+          original_len = len(messages_list)
+          final_messages = []
+          
+          if messages_list and messages_list[0].get("role") == "system":
+              system_message = messages_list.pop(0)
+              num_to_remove = min(n, len(messages_list))
+              final_messages = [system_message] + messages_list[:-num_to_remove]
+          else:
+              num_to_remove = min(n, original_len)
+              final_messages = messages_list[:-num_to_remove]
+          
+          removed_count = original_len - len(final_messages)
+          context['output'] = f"Flushed {removed_count} message(s). Context is now {len(final_messages)} messages."
+          context['messages'] = final_messages
+
+      # 3. DEFAULT: Compact conversation context
+      else:
+          try:
+              result = breathe(**context)
+              if isinstance(result, dict):
+                  context['output'] = result.get('output', 'Context compressed.')
+                  context['messages'] = result.get('messages', output_messages)
+              else:
+                  context['output'] = "Context compression process initiated."
+                  context['messages'] = output_messages
+          except Exception as e:
+              traceback.print_exc()
+              context['output'] = f"Error during context compression: {e}"
+              context['messages'] = output_messages

npcsh-1.1.10/npcsh/npc_team/jinxs/utils/load_file.jinx

@@ -0,0 +1,35 @@
+jinx_name: load_file
+description: Loads and returns the contents of a file using npcpy's file loaders
+inputs:
+- file_path
+steps:
+  - name: "load_file"
+    engine: "python"
+    code: |
+      import os
+      from npcpy.data.load import load_file_contents
+      
+      # Expand user path and get absolute path
+      file_path = os.path.expanduser("{{ file_path }}")
+      
+      # Check if file exists
+      if not os.path.exists(file_path):
+          output = f"Error: File not found at {file_path}"
+      else:
+          try:
+              # Load file contents using npcpy's loader
+              # Returns chunks by default with chunk_size=250
+              chunks = load_file_contents(file_path)
+              
+              # Join chunks back together for full content
+              if isinstance(chunks, list):
+                  if chunks and chunks[0].startswith("Error"):
+                      output = chunks[0]
+                  else:
+                      file_content = "\n".join(chunks)
+                      output = f"File: {file_path}\n\n{file_content}"
+              else:
+                  output = f"File: {file_path}\n\n{chunks}"
+                  
+          except Exception as e:
+              output = f"Error reading file {file_path}: {str(e)}"

{npcsh-1.1.9 → npcsh-1.1.10}/npcsh/npc_team/jinxs/utils/serve.jinx

@@ -17,9 +17,6 @@ steps:
       if cors_str and cors_str.strip():
           cors_origins = [origin.strip() for origin in cors_str.split(",")]
 
-      # start_flask_server blocks, so this will hold the Jinx until the server is stopped.
-      # In a real-world scenario, you might want to run this in a separate process
-      # or have a non-blocking server start.
       start_flask_server(
           port=int(port), # Ensure port is an integer
           cors_origins=cors_origins,

npcsh-1.1.10/npcsh/npc_team/jinxs/utils/trigger.jinx

@@ -0,0 +1,61 @@
+jinx_name: "trigger"
+description: "Creates a persistent listener (--listen) or a scheduled task (--cron)."
+inputs:
+  - listen: "" # The description for a persistent, event-driven listener.
+  - cron: ""   # The description for a scheduled, time-based task.
+steps:
+  - name: "execute_command"
+    engine: "python"
+    code: |
+      import traceback
+      from npcpy.work.trigger import execute_trigger_command # For --listen
+      from npcpy.work.plan import execute_plan_command      # For --cron
+      
+      listen_description = context.get('listen')
+      cron_description = context.get('cron')
+      output_messages = context.get('messages', [])
+      
+      USAGE = 'Usage: /trigger --listen "<description>" OR /trigger --cron "<description>"'
+      
+      # Determine which command was used and set the appropriate variables
+      subcommand = None
+      description = None
+      executor_func = None
+      
+      # --- Argument Validation ---
+      # Ensure mutual exclusivity
+      if listen_description and cron_description:
+          context['output'] = f"Error: --listen and --cron are mutually exclusive. {USAGE}"
+          context['messages'] = output_messages
+          exit()
+          
+      # --- Command Dispatch ---
+      if listen_description:
+          subcommand = 'listen'
+          description = listen_description
+          executor_func = execute_trigger_command
+      elif cron_description:
+          subcommand = 'cron'
+          description = cron_description
+          executor_func = execute_plan_command
+      else:
+          # Handle case where no arguments were provided
+          context['output'] = f"Error: You must provide either --listen or --cron. {USAGE}"
+          context['messages'] = output_messages
+          exit()
+      
+      # --- Execution ---
+      try:
+          result = executor_func(command=description, **context)
+          
+          if isinstance(result, dict):
+              output_key = 'Listener' if subcommand == 'listen' else 'Cron job'
+              context['output'] = result.get('output', f'{output_key} created successfully.')
+              context['messages'] = result.get('messages', output_messages)
+          else:
+              context['output'] = str(result)
+              context['messages'] = output_messages
+      except Exception as e:
+          traceback.print_exc()
+          context['output'] = f"Error creating {subcommand}: {e}"
+          context['messages'] = output_messages

{npcsh-1.1.9 → npcsh-1.1.10}/npcsh/npcsh.py

@@ -78,7 +78,8 @@ def run_repl(command_history: CommandHistory, initial_state: ShellState, router)
     render_markdown(f'- Using {state.current_mode} mode. Use /agent, /cmd, or /chat to switch to other modes')
     render_markdown(f'- To switch to a different NPC, type /npc <npc_name> or /n <npc_name> to switch to that NPC.')
     render_markdown('\n- Here are the current NPCs available in your team: ' + ', '.join([npc_name for npc_name in state.team.npcs.keys()]))
-
+    render_markdown('\n- Here are the currently available Jinxs: ' + ', '.join([jinx_name for jinx_name in state.team.jinxs_dict.keys()]))
+    
     is_windows = platform.system().lower().startswith("win")
     try:
         completer = make_completer(state, router)

{npcsh-1.1.9 → npcsh-1.1.10}/npcsh/routes.py

@@ -90,7 +90,6 @@ class CommandRouter:
             
             jinx_output = jinx.execute(
                 input_values=input_values,
-                jinxs_dict=kwargs.get('jinxs_dict', {}),
                 npc=npc,
                 messages=messages,
                 extra_globals=application_globals_for_jinx

{npcsh-1.1.9 → npcsh-1.1.10}/npcsh.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.1.9
+Version: 1.1.10
 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

{npcsh-1.1.9 → npcsh-1.1.10}/npcsh.egg-info/SOURCES.txt

@@ -55,12 +55,11 @@ npcsh/npc_team/jinxs/modes/pti.jinx
 npcsh/npc_team/jinxs/modes/spool.jinx
 npcsh/npc_team/jinxs/modes/wander.jinx
 npcsh/npc_team/jinxs/modes/yap.jinx
-npcsh/npc_team/jinxs/utils/breathe.jinx
+npcsh/npc_team/jinxs/npc_studio/npc-studio.jinx
+npcsh/npc_team/jinxs/utils/compress.jinx
 npcsh/npc_team/jinxs/utils/edit_file.jinx
-npcsh/npc_team/jinxs/utils/flush.jinx
-npcsh/npc_team/jinxs/utils/npc-studio.jinx
+npcsh/npc_team/jinxs/utils/load_file.jinx
 npcsh/npc_team/jinxs/utils/ots.jinx
-npcsh/npc_team/jinxs/utils/plan.jinx
 npcsh/npc_team/jinxs/utils/roll.jinx
 npcsh/npc_team/jinxs/utils/sample.jinx
 npcsh/npc_team/jinxs/utils/search.jinx

{npcsh-1.1.9 → npcsh-1.1.10}/setup.py

@@ -78,7 +78,7 @@ extra_files = package_files("npcsh/npc_team/")
 
 setup(
     name="npcsh",
-    version="1.1.9",
+    version="1.1.10",
     packages=find_packages(exclude=["tests*"]),
     install_requires=base_requirements,  # Only install base requirements by default
     extras_require={

npcsh-1.1.9/npcsh/npc_team/jinxs/utils/breathe.jinx

@@ -1,20 +0,0 @@
-jinx_name: "breathe"
-description: "Condense context on a regular cadence"
-inputs: [] # The breathe command takes all relevant context from the NPC's environment
-steps:
-  - name: "condense_context"
-    engine: "python"
-    code: |
-      from npcpy.llm_funcs import breathe
-      
-      output_messages = context.get('messages', [])
-
-      # Pass all current context as kwargs to breathe
-      result = breathe(**context) 
-      
-      if isinstance(result, dict):
-          context['output'] = result.get('output', 'Context condensed.')
-          context['messages'] = result.get('messages', output_messages)
-      else:
-          context['output'] = "Context condensation process initiated."
-          context['messages'] = output_messages

npcsh-1.1.9/npcsh/npc_team/jinxs/utils/flush.jinx

@@ -1,39 +0,0 @@
-jinx_name: "flush"
-description: "Flush the last N messages from the conversation history."
-inputs:
-  - n: 1 # The number of messages to flush (default to 1).
-steps:
-  - name: "flush_messages"
-    engine: "python"
-    code: |
-      n = int(context.get('n', 1))
-      output_messages = context.get('messages', [])
-      
-      if n <= 0:
-          context['output'] = "Error: Number of messages must be positive."
-          context['messages'] = output_messages
-          exit()
-
-      new_messages = list(output_messages)
-      original_len = len(new_messages)
-      removed_count = 0
-
-      if new_messages and new_messages[0].get("role") == "system":
-          system_message = new_messages[0]
-          working_messages = new_messages[1:]
-          num_to_remove = min(n, len(working_messages))
-          if num_to_remove > 0:
-              final_messages = [system_message] + working_messages[:-num_to_remove]
-              removed_count = num_to_remove
-          else:
-              final_messages = [system_message]
-      else:
-          num_to_remove = min(n, original_len)
-          if num_to_remove > 0:
-              final_messages = new_messages[:-num_to_remove]
-              removed_count = num_to_remove
-          else:
-              final_messages = []
-
-      context['output'] = f"Flushed {removed_count} message(s). Context is now {len(final_messages)} messages."
-      context['messages'] = final_messages

npcsh-1.1.9/npcsh/npc_team/jinxs/utils/plan.jinx

@@ -1,33 +0,0 @@
-jinx_name: "plan"
-description: "Execute a plan command"
-inputs:
-  - plan_description: "" # Description of the plan to execute.
-steps:
-  - name: "execute_plan"
-    engine: "python"
-    code: |
-      import traceback
-      from npcpy.work.plan import execute_plan_command
-      
-      plan_description = context.get('plan_description')
-      output_messages = context.get('messages', [])
-      
-      if not plan_description or not plan_description.strip():
-          context['output'] = "Usage: /plan <description_of_plan>"
-          context['messages'] = output_messages
-          exit()
-      
-      try:
-          # Pass all current context as kwargs to execute_plan_command
-          result = execute_plan_command(command=plan_description, **context)
-          
-          if isinstance(result, dict):
-              context['output'] = result.get('output', 'Plan executed.')
-              context['messages'] = result.get('messages', output_messages)
-          else:
-              context['output'] = str(result)
-              context['messages'] = output_messages
-      except Exception as e:
-          traceback.print_exc()
-          context['output'] = f"Error executing plan: {e}"
-          context['messages'] = output_messages

npcsh-1.1.9/npcsh/npc_team/jinxs/utils/trigger.jinx

@@ -1,36 +0,0 @@
-jinx_name: "trigger"
-description: "Execute a trigger command"
-inputs:
-  - trigger_description: "" # Required description of the trigger to execute.
-steps:
-  - name: "execute_trigger"
-    engine: "python"
-    code: |
-      import traceback
-      from npcpy.work.trigger import execute_trigger_command
-      
-      trigger_description = context.get('trigger_description')
-      output_messages = context.get('messages', [])
-      
-      if not trigger_description or not trigger_description.strip():
-          context['output'] = "Usage: /trigger <trigger_description>"
-          context['messages'] = output_messages
-          exit()
-      
-      try:
-          # Pass all current context as kwargs to execute_trigger_command
-          result = execute_trigger_command(command=trigger_description, **context)
-          
-          if isinstance(result, dict):
-              context['output'] = result.get('output', 'Trigger executed.')
-              context['messages'] = result.get('messages', output_messages)
-          else:
-              context['output'] = str(result)
-              context['messages'] = output_messages
-      except NameError:
-          context['output'] = "Trigger function (execute_trigger_command) not available."
-          context['messages'] = output_messages
-      except Exception as e:
-          traceback.print_exc()
-          context['output'] = f"Error executing trigger: {e}"
-          context['messages'] = output_messages