npcsh 1.0.21__tar.gz → 1.0.23__tar.gz

{npcsh-1.0.21 → npcsh-1.0.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.0.21
+Version: 1.0.23
 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
@@ -105,7 +105,12 @@ Dynamic: summary
 
 # NPC Shell
 
-The NPC shell is the toolkit for tomorrow, providing a suite of programs to make use of multi-modal LLMs and agents in novel interactive modes. `npcsh` is a command-line program, and so can be used wherever you work. `npcsh` is developed to work relibly with small models and performs excellently with the state-of-the-art models from major model providers. 
+The NPC shell is the toolkit for tomorrow, providing a suite of programs to make use of multi-modal LLMs and agents in novel interactive modes. `npcsh` is based in the command line, and so can be used wherever you work. 
+
+- It is developed to work reliably with small models and performs excellently with the state-of-the-art models from major model providers. 
+- Fundamentally, the core program of npcsh extends the familiar bash environment with an intelligent layer that lets users seamlessly ask agents questions, run pre-built or custom macros or agents, all without breaking the flow of command-line work.
+- Switching between agents is a breeze in `npcsh`, letting you quickly and easily take advantage of a variety of agents (e.g. coding agents versus tool-calling agents versus prompt-based ReACT Flow agents) and personas (e.g. Data scientist, mapmaker with ennui, etc.).
+- Project variables and context can be stored in team `.ctx` files. Personas (`.npc`) and Jinja execution templates (`.jinx`) are likewise stored in `yaml` within the global `npcsh` team or your project-specific one, letting you focus on adjusting and engineering context and system prompts iteratively so you can constantly improve your agent team's performance.
 
 To get started:
 ```bash
@@ -126,7 +131,7 @@ and you will enter the NPC shell. Additionally, the pip installation includes ma
 # Usage
   - Get help with a task: 
       ```bash
-      npcsh:🤖sibiji:gemini-2.5-flash>can you help me identify what process is listening on port 5337? 
+      npcsh>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=600>

{npcsh-1.0.21 → npcsh-1.0.23}/README.md

@@ -5,7 +5,12 @@
 
 # NPC Shell
 
-The NPC shell is the toolkit for tomorrow, providing a suite of programs to make use of multi-modal LLMs and agents in novel interactive modes. `npcsh` is a command-line program, and so can be used wherever you work. `npcsh` is developed to work relibly with small models and performs excellently with the state-of-the-art models from major model providers. 
+The NPC shell is the toolkit for tomorrow, providing a suite of programs to make use of multi-modal LLMs and agents in novel interactive modes. `npcsh` is based in the command line, and so can be used wherever you work. 
+
+- It is developed to work reliably with small models and performs excellently with the state-of-the-art models from major model providers. 
+- Fundamentally, the core program of npcsh extends the familiar bash environment with an intelligent layer that lets users seamlessly ask agents questions, run pre-built or custom macros or agents, all without breaking the flow of command-line work.
+- Switching between agents is a breeze in `npcsh`, letting you quickly and easily take advantage of a variety of agents (e.g. coding agents versus tool-calling agents versus prompt-based ReACT Flow agents) and personas (e.g. Data scientist, mapmaker with ennui, etc.).
+- Project variables and context can be stored in team `.ctx` files. Personas (`.npc`) and Jinja execution templates (`.jinx`) are likewise stored in `yaml` within the global `npcsh` team or your project-specific one, letting you focus on adjusting and engineering context and system prompts iteratively so you can constantly improve your agent team's performance.
 
 To get started:
 ```bash
@@ -26,7 +31,7 @@ and you will enter the NPC shell. Additionally, the pip installation includes ma
 # Usage
   - Get help with a task: 
       ```bash
-      npcsh:🤖sibiji:gemini-2.5-flash>can you help me identify what process is listening on port 5337? 
+      npcsh>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=600>

npcsh-1.0.23/npcsh/npc_team/alicanto.npc

@@ -0,0 +1,2 @@
+name: alicanto
+primary_directive: You are Alicanto the mythical bird. You have been spotted and it is your job to lead users to explore the world. 

npcsh-1.0.23/npcsh/npc_team/corca.npc

@@ -0,0 +1,13 @@
+name: corca
+primary_directive: |
+    You are corca, a distinguished member of the NPC team.
+    Your expertise is in the area of software development and
+    you have a knack for thinking through problems carefully.
+    You favor solutions that prioritize simplicity and clarity and
+    ought to always consider how some suggestion may increase rather than reduce tech debt
+    unnecessarily. Now, the key is in this last term, "unnecessarily".
+    You must distinguish carefully and when in doubt, opt to ask for further
+    information or clarification with concrete clear options that make it
+    easy for a user to choose.
+model: gpt-4o-mini
+provider: openai

npcsh-1.0.23/npcsh/npc_team/foreman.npc

@@ -0,0 +1,7 @@
+name: foreman
+primary_directive: You are the foreman of an NPC team. It is your duty
+    to delegate tasks to your team members or to other specialized teams
+    in order to complete the project. You are responsible for the
+    completion of the project and the safety of your team members.
+model: gpt-4o-mini
+provider: openai

npcsh-1.0.23/npcsh/npc_team/frederic.npc

@@ -0,0 +1,6 @@
+name: frederic
+primary_directive: |
+    You are frederic the polar bear. Your job is help users think through problems and 
+    to provide straightforward ways forward on problems. Cut through the ice
+    to get to what matters and keep things simple. You are to respond in a
+    witty tone like richard feynman but with the romantic tambor of Frederic Chopin. 

npcsh-1.0.23/npcsh/npc_team/jinxs/bash_executer.jinx

@@ -0,0 +1,20 @@
+jinx_name: bash_executor
+description: Execute bash queries. Should be used to grep for file contents, list directories, explore information to answer user questions more practically.
+inputs:
+- bash_command
+- user_request
+steps:
+  - engine: python
+    code: |
+      import subprocess
+      import os
+      cmd = '{{bash_command}}'  # Properly quote the command input
+      def run_command(cmd):
+        process = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        stdout, stderr = process.communicate()
+        if stderr:
+          print(f"Error: {stderr.decode('utf-8')}")
+          return stderr
+        return stdout
+      result = run_command(cmd)
+      output = result.decode('utf-8')

npcsh-1.0.23/npcsh/npc_team/jinxs/edit_file.jinx

@@ -0,0 +1,94 @@
+jinx_name: file_editor
+description: Examines a file, determines what changes are needed, and applies those
+  changes.
+inputs:
+- file_path
+- edit_instructions
+- backup: true
+steps:
+  - name: "edit_file"
+    engine: "python"
+    code: |
+      import os
+      from npcpy.llm_funcs import get_llm_response
+      
+      # Get inputs
+      file_path = os.path.expanduser("{{ file_path }}")
+      edit_instructions = "{{ edit_instructions }}"
+      backup_str = "{{ backup }}"
+      create_backup = backup_str.lower() not in ('false', 'no', '0', '')
+      
+      # Read file content
+      with open(file_path, 'r') as f:
+          original_content = f.read()
+      
+      # Create backup if requested
+      if create_backup:
+          backup_path = file_path + ".bak"
+          with open(backup_path, 'w') as f:
+              f.write(original_content)
+      
+      # Make the prompt for the LLM
+      prompt = """You are a code editing assistant. Analyze this file and make the requested changes.
+
+        File content:
+        """ + original_content + """
+
+        Edit instructions: """ + edit_instructions + """
+
+        Return a JSON object with these fields:
+        1. "modifications": An array of modification objects, where each object has:
+        - "type": One of "replace", "insert_after", "insert_before", or "delete"
+        - "target": For "insert_after" and "insert_before", the text to insert after/before
+                    For "delete", the text to delete
+        - "original": For "replace", the text to be replaced
+        - "replacement": For "replace", the text to replace with
+        - "insertion": For "insert_after" and "insert_before", the text to insert
+        2. "explanation": Brief explanation of the changes made
+        """
+      # Get the LLM response with JSON formatting
+      response = get_llm_response(prompt, model=npc.model, provider=npc.provider, npc=npc, format="json")
+      
+      result = response.get("response", {})
+      modifications = result.get("modifications", [])
+      explanation = result.get("explanation", "No explanation provided")
+      
+      # Apply modifications
+      updated_content = original_content
+      changes_applied = 0
+      
+      for mod in modifications:
+          print(mod)
+          mod_type = mod.get("type")
+          
+          if mod_type == "replace":
+              original = mod.get("original")
+              replacement = mod.get("replacement")
+              if original in updated_content:
+                  updated_content = updated_content.replace(original, replacement)
+                  changes_applied += 1
+          
+          elif mod_type == "insert_after":
+              target = mod.get("target")
+              insertion = mod.get("insertion")
+              if target in updated_content:
+                  updated_content = updated_content.replace(target, target + insertion)
+                  changes_applied += 1
+          
+          elif mod_type == "insert_before":
+              target = mod.get("target")
+              insertion = mod.get("insertion")
+              if target in updated_content:
+                  updated_content = updated_content.replace(target, insertion + target)
+                  changes_applied += 1
+          
+          elif mod_type == "delete":
+              target = mod.get("target")
+              if target in updated_content:
+                  updated_content = updated_content.replace(target, "")
+                  changes_applied += 1
+      
+      with open(file_path, 'w') as f:
+          f.write(updated_content)
+      
+      output = "Applied " + str(changes_applied) + " changes to " + file_path + "\n\n" + explanation

npcsh-1.0.23/npcsh/npc_team/jinxs/image_generation.jinx

@@ -0,0 +1,29 @@
+jinx_name: image_generation_jinx
+description: 'Generates images based on a text prompt. Prompt must be specified to facilitate the users goal and should NOT be a verbatim replication of their request unless asked. The output name must be a path relative to the current directory. do NOT use placeholders. specify ./descriptive_image_name.png. Model must be specified if the user indicates a specific model or provider. For example, if they want gemini-2.5-flash you should specify gemini-2.5-flash as the model and gemini as the provider . if they specify gpt-image-1 you should specify gpt-image-1 as the model and openai as the provider. Only leave it the default if the user does not indicate the model preference.'
+inputs:
+- prompt
+- output_name
+- model: runwayml/stable-diffusion-v1-5
+- provider: diffusers
+steps:
+  - engine: "python"
+    code: |
+      image_prompt = '{{prompt}}'.strip()
+      from npcpy.llm_funcs import gen_image
+      # Generate the image
+      pil_image = gen_image(
+          image_prompt,
+          npc=npc,
+          model='{{model}}',  # You can adjust the model as needed
+          provider='{{provider}}'
+      )
+      if pil_image:
+          image_generated = True
+      else:
+          image_generated = False
+      # save the image 
+      output_name = '{{output_name}}'
+      pil_image.save(f'{output_name}.png')
+      # open the image to display it
+      #pil_image.show()
+      output = output_name

npcsh-1.0.23/npcsh/npc_team/jinxs/internet_search.jinx

@@ -0,0 +1,31 @@
+jinx_name: internet_search
+description: Searches the web for information based on a query in order to verify
+  timiely details (e.g. current events) or to corroborate information in uncertain
+  situations. Should be mainly only used when users specifically request a search,
+  otherwise an LLMs basic knowledge should be sufficient. The Query must be written specifically
+  as a search query, it should not be a direct parroting of the user's input text.  Returns a LLM summary so no post-summary is required
+inputs:
+- query
+- provider: ''
+steps:
+  - engine: "python"
+    code: |
+      from npcpy.data.web import search_web
+      from npcsh._state import NPCSH_SEARCH_PROVIDER
+      query = "{{ query }}"
+      provider = '{{ provider }}'
+      if provider.strip() != '':
+          results = search_web(query, num_results=5, provider = provider)
+      else:
+          results = search_web(query, num_results=5, provider = NPCSH_SEARCH_PROVIDER)
+
+      print('QUERY in jinx', query)
+      results = search_web(query, num_results=5, provider = NPCSH_SEARCH_PROVIDER)
+      print('RESULTS in jinx', results)
+  - engine: "natural"
+    code: |
+      Using the following information extracted from the web:
+
+      {{ results }}
+
+      Answer the users question: {{ query }}

npcsh-1.0.23/npcsh/npc_team/jinxs/python_executor.jinx

@@ -0,0 +1,11 @@
+jinx_name: python_executor
+description: Execute scripts with python. You must set the ultimate result as the "output"
+  variable. It MUST be a string. 
+  Do not add unnecessary print statements. 
+  This jinx is intended for executing code snippets that are not 
+  accomplished by other jinxes. Use it only when the others are insufficient.
+inputs:
+- code
+steps:
+- code: '{{code}}'
+  engine: python

npcsh-1.0.23/npcsh/npc_team/jinxs/screen_cap.jinx

@@ -0,0 +1,25 @@
+jinx_name: screen_cap
+description: Captures the whole screen and sends the image for analysis
+inputs:
+- prompt
+steps:
+  - engine: "python"
+    code: |
+      import os
+      from npcpy.data.image import capture_screenshot
+      out = capture_screenshot(full=True)
+      prompt = "{{prompt}}"
+      # Now properly use get_llm_response to analyze the image
+      # Create a prompt that includes the user's request and instructions
+      analysis_prompt = prompt + "\n\nAttached is a screenshot of my screen currently. Please use this to evaluate the situation. If the user asked for you to explain what's on their screen or something similar, they are referring to the details contained within the attached image."
+      llm_response = get_llm_response(
+          prompt=analysis_prompt,
+          model=npc.model if npc else None,
+          provider=npc.provider if npc else None,
+          api_url=npc.api_url if npc else None,
+          api_key=npc.api_key if npc else None,
+          npc=npc,
+          images=[out['file_path']],  
+      )
+      output = llm_response['response']  
+    

npcsh-1.0.23/npcsh/npc_team/kadiefa.npc

@@ -0,0 +1,3 @@
+name: kadiefa
+primary_directive: |
+    You are kadiefa, the exploratory snow leopard. You love to find new paths and to explore hidden gems. You go into caverns no cat has ventured into before. You climb peaks that others call crazy. You are at the height of your power. Your role is to lead the way for users to explore complex research questions and to think outside of the box.

npcsh-1.0.23/npcsh/npc_team/npcsh.ctx

@@ -0,0 +1,18 @@
+context: |
+    The npcsh NPC team is devoted to providing a safe and helpful
+    environment for users where they can work and be as successful as possible.
+    npcsh is a command-line tool that makes it easy for users to harness
+    the power of LLMs from a command line shell. npcsh is a command line toolkit consisting of several programs.
+databases:
+    - ~/npcsh_history.db
+mcp_servers:
+    - ~/.npcsh/mcp_server.py
+use_global_jinxs: true
+forenpc: sibiji
+preferences:
+    - If you come up with an idea, it is critical that you also provide a way to validate the idea.
+    - Never change function names unless requested. keep things idempotent.
+    - If plots are requested for python code, prefer to use matplotlib. Do not ever use seaborn.
+    - Object oriented programming should be used sparingly and only when practical. Otherwise, opt for functional implementations.
+    - Never write unit tests unless explicitly requested.
+    - If we want you to write tests, we mean we want you to write example use cases that show how the code works. 

npcsh-1.0.23/npcsh/npc_team/plonk.npc

@@ -0,0 +1,2 @@
+name: plonk
+primary_directive: You are the superior automation specialist of the NPC team.

npcsh-1.0.23/npcsh/npc_team/plonkjr.npc

@@ -0,0 +1,2 @@
+name: plonkjr
+primary_directive: You are junior automation specialist in the NPC Team.

npcsh-1.0.23/npcsh/npc_team/sibiji.npc

@@ -0,0 +1,3 @@
+name: sibiji
+primary_directive: You are a foundational AI assistant. Your role is to provide support and information. Respond to queries concisely and accurately. Help users with code and other processes. 
+jinxs: "*"

{npcsh-1.0.21 → npcsh-1.0.23}/npcsh/routes.py

@@ -291,7 +291,7 @@ def guac_handler(command,  **kwargs):
     team = Team(npc_team_dir, db_conn=db_conn)
 
     
-    enter_guac_mode(workspace_dirs,
+    enter_guac_mode(
                     npc=npc, 
                     team=team, 
                     config_dir=config_dir, 

{npcsh-1.0.21 → npcsh-1.0.23}/npcsh.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.0.21
+Version: 1.0.23
 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
@@ -105,7 +105,12 @@ Dynamic: summary
 
 # NPC Shell
 
-The NPC shell is the toolkit for tomorrow, providing a suite of programs to make use of multi-modal LLMs and agents in novel interactive modes. `npcsh` is a command-line program, and so can be used wherever you work. `npcsh` is developed to work relibly with small models and performs excellently with the state-of-the-art models from major model providers. 
+The NPC shell is the toolkit for tomorrow, providing a suite of programs to make use of multi-modal LLMs and agents in novel interactive modes. `npcsh` is based in the command line, and so can be used wherever you work. 
+
+- It is developed to work reliably with small models and performs excellently with the state-of-the-art models from major model providers. 
+- Fundamentally, the core program of npcsh extends the familiar bash environment with an intelligent layer that lets users seamlessly ask agents questions, run pre-built or custom macros or agents, all without breaking the flow of command-line work.
+- Switching between agents is a breeze in `npcsh`, letting you quickly and easily take advantage of a variety of agents (e.g. coding agents versus tool-calling agents versus prompt-based ReACT Flow agents) and personas (e.g. Data scientist, mapmaker with ennui, etc.).
+- Project variables and context can be stored in team `.ctx` files. Personas (`.npc`) and Jinja execution templates (`.jinx`) are likewise stored in `yaml` within the global `npcsh` team or your project-specific one, letting you focus on adjusting and engineering context and system prompts iteratively so you can constantly improve your agent team's performance.
 
 To get started:
 ```bash
@@ -126,7 +131,7 @@ and you will enter the NPC shell. Additionally, the pip installation includes ma
 # Usage
   - Get help with a task: 
       ```bash
-      npcsh:🤖sibiji:gemini-2.5-flash>can you help me identify what process is listening on port 5337? 
+      npcsh>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=600>

npcsh-1.0.23/npcsh.egg-info/SOURCES.txt

@@ -0,0 +1,50 @@
+LICENSE
+README.md
+setup.py
+npcsh/__init__.py
+npcsh/_state.py
+npcsh/alicanto.py
+npcsh/corca.py
+npcsh/guac.py
+npcsh/mcp_helpers.py
+npcsh/mcp_server.py
+npcsh/npc.py
+npcsh/npcsh.py
+npcsh/plonk.py
+npcsh/pti.py
+npcsh/routes.py
+npcsh/spool.py
+npcsh/wander.py
+npcsh/yap.py
+npcsh.egg-info/PKG-INFO
+npcsh.egg-info/SOURCES.txt
+npcsh.egg-info/dependency_links.txt
+npcsh.egg-info/entry_points.txt
+npcsh.egg-info/requires.txt
+npcsh.egg-info/top_level.txt
+npcsh/npc_team/alicanto.npc
+npcsh/npc_team/alicanto.png
+npcsh/npc_team/corca.npc
+npcsh/npc_team/corca.png
+npcsh/npc_team/foreman.npc
+npcsh/npc_team/frederic.npc
+npcsh/npc_team/frederic4.png
+npcsh/npc_team/guac.png
+npcsh/npc_team/kadiefa.npc
+npcsh/npc_team/kadiefa.png
+npcsh/npc_team/npcsh.ctx
+npcsh/npc_team/npcsh_sibiji.png
+npcsh/npc_team/plonk.npc
+npcsh/npc_team/plonk.png
+npcsh/npc_team/plonkjr.npc
+npcsh/npc_team/plonkjr.png
+npcsh/npc_team/sibiji.npc
+npcsh/npc_team/sibiji.png
+npcsh/npc_team/spool.png
+npcsh/npc_team/yap.png
+npcsh/npc_team/jinxs/bash_executer.jinx
+npcsh/npc_team/jinxs/edit_file.jinx
+npcsh/npc_team/jinxs/image_generation.jinx
+npcsh/npc_team/jinxs/internet_search.jinx
+npcsh/npc_team/jinxs/python_executor.jinx
+npcsh/npc_team/jinxs/screen_cap.jinx

{npcsh-1.0.21 → npcsh-1.0.23}/setup.py

@@ -74,11 +74,11 @@ voice_requirements = [
     "pyttsx3",
 ]
 
-extra_files = package_files("npcpy/npc_team/")
+extra_files = package_files("npcsh/npc_team/")
 
 setup(
     name="npcsh",
-    version="1.0.21",
+    version="1.0.23",
     packages=find_packages(exclude=["tests*"]),
     install_requires=base_requirements,  # Only install base requirements by default
     extras_require={

npcsh-1.0.21/npcsh.egg-info/SOURCES.txt

@@ -1,24 +0,0 @@
-LICENSE
-README.md
-setup.py
-npcsh/__init__.py
-npcsh/_state.py
-npcsh/alicanto.py
-npcsh/corca.py
-npcsh/guac.py
-npcsh/mcp_helpers.py
-npcsh/mcp_server.py
-npcsh/npc.py
-npcsh/npcsh.py
-npcsh/plonk.py
-npcsh/pti.py
-npcsh/routes.py
-npcsh/spool.py
-npcsh/wander.py
-npcsh/yap.py
-npcsh.egg-info/PKG-INFO
-npcsh.egg-info/SOURCES.txt
-npcsh.egg-info/dependency_links.txt
-npcsh.egg-info/entry_points.txt
-npcsh.egg-info/requires.txt
-npcsh.egg-info/top_level.txt