npcsh 1.1.16__tar.gz → 1.1.18__tar.gz

{npcsh-1.1.16/npcsh.egg-info → npcsh-1.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.1.16
+Version: 1.1.18
 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
@@ -66,6 +66,9 @@ Requires-Dist: playsound==1.2.2; extra == "yap"
 Requires-Dist: pygame; extra == "yap"
 Requires-Dist: faster_whisper; extra == "yap"
 Requires-Dist: pyttsx3; extra == "yap"
+Provides-Extra: bench
+Requires-Dist: harbor; extra == "bench"
+Requires-Dist: terminal-bench; extra == "bench"
 Provides-Extra: all
 Requires-Dist: anthropic; extra == "all"
 Requires-Dist: openai; extra == "all"
@@ -593,6 +596,9 @@ npc vixynt "a sunset over mountains"
 | `/teamviz` | Visualize team structure. Usage: `/teamviz save=output.png` |
 | `/ots` | Screenshot analysis. Usage: `/ots` then select area |
 | `/sleep` | Evolve knowledge graph. Usage: `/sleep --ops link_facts,deepen` |
+| `/kg_search` | Search knowledge graph with multiple modes. Usage: `/kg_search query mode=hybrid depth=2` |
+| `/mem_search` | Search approved memories. Usage: `/mem_search query status=approved top_k=10` |
+| `/mem_review` | Review pending memories interactively. Usage: `/mem_review limit=50` |
 
 ### System & Config
 | Command | Description |
@@ -604,7 +610,7 @@ npc vixynt "a sunset over mountains"
 | `/set` | Set config values. Usage: `/set model gemma3:4b`, `/set provider ollama` |
 | `/help` | Show help. Usage: `/help` |
 | `/jinxs` | List available jinxs. Usage: `/jinxs` |
-| `/npc-studio` | Launch NPC Studio GUI. Usage: `/npc-studio` |
+| `/incognide` | Launch Incognide GUI. Usage: `/incognide` |
 | `/trigger` | Set up system triggers. Usage: `/trigger 'description' -m gemma3:27b` |
     
     ## Common Command-Line Flags:
@@ -623,6 +629,92 @@ npc vixynt "a sunset over mountains"
     --format          (-f)         | --num_frames      (-num_f)     | --sprovider       (-s)         |                               
     ```
 
+## Memory & Knowledge Graph
+
+`npcsh` maintains a memory lifecycle system that allows agents to learn and grow from past interactions. Memories progress through stages and can be incorporated into a knowledge graph for advanced retrieval.
+
+### Memory Lifecycle
+
+Memories are extracted from conversations and follow this lifecycle:
+
+1. **pending_approval** - New memories awaiting review
+2. **human-approved** - Approved and ready for KG integration
+3. **human-rejected** - Rejected (used as negative examples)
+4. **human-edited** - Modified by user before approval
+5. **skipped** - Deferred for later review
+
+### Memory Commands
+
+```bash
+# Search through approved memories
+/mem_search python                      # Keyword search
+/mem_search python status=approved      # Filter by status
+/mem_search python top_k=20             # Limit results
+
+# Review pending memories interactively
+/mem_review                             # Review with default limit
+/mem_review limit=50                    # Review more at once
+```
+
+### Knowledge Graph
+
+The knowledge graph stores facts and concepts extracted from approved memories, enabling semantic search and reasoning. Facts are linked to concepts, allowing traversal-based discovery.
+
+```bash
+# Keyword search
+/kg_search python                       # Simple keyword match
+
+# Semantic similarity search
+/kg_search python mode=embedding        # Find semantically similar facts
+
+# Graph traversal search
+/kg_search python mode=link depth=3     # Traverse graph links
+
+# Hybrid search (combines methods)
+/kg_search python mode=all              # All methods combined
+
+# Explore concepts
+/kg_search type=concepts                # List all concepts
+/kg_search concept="Machine Learning"   # Explore a specific concept
+```
+
+### Knowledge Graph Evolution
+
+The `/sleep` command evolves the knowledge graph through consolidation, abstraction, and creative synthesis:
+
+```bash
+# Basic sleep (consolidation)
+/sleep
+
+# Import approved memories first, then evolve
+/sleep backfill=true
+
+# Dream mode - creative synthesis across domains
+/sleep dream=true
+
+# Combined backfill and dream
+/sleep backfill=true dream=true
+
+# Specific operations
+/sleep ops=prune,deepen,abstract
+```
+
+**Operations:**
+- **prune** - Remove redundant or low-value facts
+- **deepen** - Add detail to existing facts
+- **abstract** - Create higher-level generalizations
+- **link** - Connect related facts and concepts
+
+### Environment Variables
+
+```bash
+# Enable/disable automatic KG building (default: enabled)
+export NPCSH_BUILD_KG=1
+
+# Database path
+export NPCSH_DB_PATH=~/npcsh_history.db
+```
+
 ## Read the Docs
 To see more about how to use the jinxs and modes in the NPC Shell, read the docs at [npc-shell.readthedocs.io](https://npc-shell.readthedocs.io/en/latest/)
 
@@ -630,16 +722,16 @@ To see more about how to use the jinxs and modes in the NPC Shell, read the docs
 ## Inference Capabilities
 - `npcsh` works with local and enterprise LLM providers through its LiteLLM integration, allowing users to run inference from Ollama, LMStudio, vLLM, MLX, OpenAI, Anthropic, Gemini, and Deepseek, making it a versatile tool for both simple commands and sophisticated AI-driven tasks. 
 
-## NPC Studio
-There is a graphical user interface that makes use of the NPC Toolkit through the NPC Studio. See the source code for NPC Studio [here](https://github.com/npc-worldwide/npc-studio). Download the executables at [our website](https://enpisi.com/downloads). For the most up to date development version, you can use NPC Studio by invoking it in npcsh 
+## Incognide
+Incognide is a desktop workspace environment for integrating LLMs into your workflows in an organized and seamless manner. See the source code for Incognide [here](https://github.com/npc-worldwide/incognide). Download the executables at [our website](https://enpisi.com/downloads). For the most up to date development version, you can use Incognide by invoking it in npcsh 
 
 ```
-/npc-studio
+/incognide
 ```
-which will download and set up and serve the NPC Studio application within your `~/.npcsh` folder. It requires `npm` and `node` to work, and of course npcpy !
+which will download and set up and serve the Incognide application within your `~/.npcsh` folder. It requires `npm` and `node` to work, and of course npcpy !
 
 ## Mailing List and Community
-Interested to stay in the loop and to hear the latest and greatest about `npcpy`, `npcsh`, and NPC Studio? Be sure to sign up for the [newsletter](https://forms.gle/n1NzQmwjsV4xv1B2A)!
+Interested to stay in the loop and to hear the latest and greatest about `npcpy`, `npcsh`, and Incognide? Be sure to sign up for the [newsletter](https://forms.gle/n1NzQmwjsV4xv1B2A)!
 
 [Join the discord to discuss ideas for npc tools](https://discord.gg/VvYVT5YC)
 ## Support

{npcsh-1.1.16 → npcsh-1.1.18}/README.md

@@ -493,6 +493,9 @@ npc vixynt "a sunset over mountains"
 | `/teamviz` | Visualize team structure. Usage: `/teamviz save=output.png` |
 | `/ots` | Screenshot analysis. Usage: `/ots` then select area |
 | `/sleep` | Evolve knowledge graph. Usage: `/sleep --ops link_facts,deepen` |
+| `/kg_search` | Search knowledge graph with multiple modes. Usage: `/kg_search query mode=hybrid depth=2` |
+| `/mem_search` | Search approved memories. Usage: `/mem_search query status=approved top_k=10` |
+| `/mem_review` | Review pending memories interactively. Usage: `/mem_review limit=50` |
 
 ### System & Config
 | Command | Description |
@@ -504,7 +507,7 @@ npc vixynt "a sunset over mountains"
 | `/set` | Set config values. Usage: `/set model gemma3:4b`, `/set provider ollama` |
 | `/help` | Show help. Usage: `/help` |
 | `/jinxs` | List available jinxs. Usage: `/jinxs` |
-| `/npc-studio` | Launch NPC Studio GUI. Usage: `/npc-studio` |
+| `/incognide` | Launch Incognide GUI. Usage: `/incognide` |
 | `/trigger` | Set up system triggers. Usage: `/trigger 'description' -m gemma3:27b` |
     
     ## Common Command-Line Flags:
@@ -523,6 +526,92 @@ npc vixynt "a sunset over mountains"
     --format          (-f)         | --num_frames      (-num_f)     | --sprovider       (-s)         |                               
     ```
 
+## Memory & Knowledge Graph
+
+`npcsh` maintains a memory lifecycle system that allows agents to learn and grow from past interactions. Memories progress through stages and can be incorporated into a knowledge graph for advanced retrieval.
+
+### Memory Lifecycle
+
+Memories are extracted from conversations and follow this lifecycle:
+
+1. **pending_approval** - New memories awaiting review
+2. **human-approved** - Approved and ready for KG integration
+3. **human-rejected** - Rejected (used as negative examples)
+4. **human-edited** - Modified by user before approval
+5. **skipped** - Deferred for later review
+
+### Memory Commands
+
+```bash
+# Search through approved memories
+/mem_search python                      # Keyword search
+/mem_search python status=approved      # Filter by status
+/mem_search python top_k=20             # Limit results
+
+# Review pending memories interactively
+/mem_review                             # Review with default limit
+/mem_review limit=50                    # Review more at once
+```
+
+### Knowledge Graph
+
+The knowledge graph stores facts and concepts extracted from approved memories, enabling semantic search and reasoning. Facts are linked to concepts, allowing traversal-based discovery.
+
+```bash
+# Keyword search
+/kg_search python                       # Simple keyword match
+
+# Semantic similarity search
+/kg_search python mode=embedding        # Find semantically similar facts
+
+# Graph traversal search
+/kg_search python mode=link depth=3     # Traverse graph links
+
+# Hybrid search (combines methods)
+/kg_search python mode=all              # All methods combined
+
+# Explore concepts
+/kg_search type=concepts                # List all concepts
+/kg_search concept="Machine Learning"   # Explore a specific concept
+```
+
+### Knowledge Graph Evolution
+
+The `/sleep` command evolves the knowledge graph through consolidation, abstraction, and creative synthesis:
+
+```bash
+# Basic sleep (consolidation)
+/sleep
+
+# Import approved memories first, then evolve
+/sleep backfill=true
+
+# Dream mode - creative synthesis across domains
+/sleep dream=true
+
+# Combined backfill and dream
+/sleep backfill=true dream=true
+
+# Specific operations
+/sleep ops=prune,deepen,abstract
+```
+
+**Operations:**
+- **prune** - Remove redundant or low-value facts
+- **deepen** - Add detail to existing facts
+- **abstract** - Create higher-level generalizations
+- **link** - Connect related facts and concepts
+
+### Environment Variables
+
+```bash
+# Enable/disable automatic KG building (default: enabled)
+export NPCSH_BUILD_KG=1
+
+# Database path
+export NPCSH_DB_PATH=~/npcsh_history.db
+```
+
 ## Read the Docs
 To see more about how to use the jinxs and modes in the NPC Shell, read the docs at [npc-shell.readthedocs.io](https://npc-shell.readthedocs.io/en/latest/)
 
@@ -530,16 +619,16 @@ To see more about how to use the jinxs and modes in the NPC Shell, read the docs
 ## Inference Capabilities
 - `npcsh` works with local and enterprise LLM providers through its LiteLLM integration, allowing users to run inference from Ollama, LMStudio, vLLM, MLX, OpenAI, Anthropic, Gemini, and Deepseek, making it a versatile tool for both simple commands and sophisticated AI-driven tasks. 
 
-## NPC Studio
-There is a graphical user interface that makes use of the NPC Toolkit through the NPC Studio. See the source code for NPC Studio [here](https://github.com/npc-worldwide/npc-studio). Download the executables at [our website](https://enpisi.com/downloads). For the most up to date development version, you can use NPC Studio by invoking it in npcsh 
+## Incognide
+Incognide is a desktop workspace environment for integrating LLMs into your workflows in an organized and seamless manner. See the source code for Incognide [here](https://github.com/npc-worldwide/incognide). Download the executables at [our website](https://enpisi.com/downloads). For the most up to date development version, you can use Incognide by invoking it in npcsh 
 
 ```
-/npc-studio
+/incognide
 ```
-which will download and set up and serve the NPC Studio application within your `~/.npcsh` folder. It requires `npm` and `node` to work, and of course npcpy !
+which will download and set up and serve the Incognide application within your `~/.npcsh` folder. It requires `npm` and `node` to work, and of course npcpy !
 
 ## Mailing List and Community
-Interested to stay in the loop and to hear the latest and greatest about `npcpy`, `npcsh`, and NPC Studio? Be sure to sign up for the [newsletter](https://forms.gle/n1NzQmwjsV4xv1B2A)!
+Interested to stay in the loop and to hear the latest and greatest about `npcpy`, `npcsh`, and Incognide? Be sure to sign up for the [newsletter](https://forms.gle/n1NzQmwjsV4xv1B2A)!
 
 [Join the discord to discuss ideas for npc tools](https://discord.gg/VvYVT5YC)
 ## Support