npcsh 1.1.17__py3-none-any.whl → 1.1.18__py3-none-any.whl

npcsh-1.1.18.data/data/npcsh/npc_team/web_search.jinx

@@ -0,0 +1,283 @@
+jinx_name: web_search
+description: Search the web with interactive TUI
+inputs:
+- query: ""
+- provider: ""
+- num_results: "10"
+- text: "false"
+
+steps:
+  - name: search_web
+    engine: python
+    code: |
+      import os
+      import sys
+      import tty
+      import termios
+      import webbrowser
+      import subprocess
+      from npcpy.data.web import search_web
+
+      query = context.get('query', '').strip()
+      text_mode = context.get('text', '').lower() in ('true', '1', 'yes')
+
+      if not query:
+          lines = [
+              "Usage: /web_search <query>",
+              "",
+              "Options:",
+              "  provider    - Search provider (default uses state.search_provider)",
+              "  num_results - Number of results (default 10)",
+              "  text        - Text-only output, no TUI (true/false)",
+              "",
+              "TUI Controls:",
+              "  j/k or arrows - Navigate",
+              "  p             - Preview page content",
+              "  o             - Open in browser",
+              "  i             - Open in incognide",
+              "  c             - Copy URL to clipboard",
+              "  q/ESC         - Quit",
+              "",
+              "Examples:",
+              "  /web_search python asyncio tutorial",
+              "  /web_search react hooks num_results=20",
+          ]
+          context['output'] = "\n".join(lines)
+      else:
+          provider = context.get('provider') or None
+          try:
+              provider = provider or (state.search_provider if 'state' in dir() and state else None)
+          except:
+              pass
+          num_results = int(context.get('num_results') or 10)
+
+          try:
+              raw_results = search_web(query, provider=provider, num_results=num_results)
+
+              # Normalize results
+              results = []
+              if raw_results:
+                  for res in raw_results:
+                      if isinstance(res, dict):
+                          results.append({
+                              'title': res.get('title', 'No title'),
+                              'url': res.get('url', res.get('link', '')),
+                              'snippet': res.get('snippet', res.get('description', ''))
+                          })
+                      else:
+                          results.append({'title': str(res)[:50], 'url': str(res), 'snippet': ''})
+
+              if not results:
+                  context['output'] = "No web results found."
+              elif text_mode:
+                  # Text-only output
+                  lines = []
+                  for res in results:
+                      lines.append(f"- {res['title']}")
+                      lines.append(f"  {res['url']}")
+                      if res.get('snippet'):
+                          lines.append(f"  {res['snippet'][:100]}...")
+                      lines.append("")
+                  context['output'] = "\n".join(lines)
+              else:
+                  # Interactive TUI mode
+                  def get_terminal_size():
+                      try:
+                          size = os.get_terminal_size()
+                          return size.columns, size.lines
+                      except:
+                          return 80, 24
+
+                  def get_domain(url):
+                      try:
+                          from urllib.parse import urlparse
+                          return urlparse(url).netloc[:25]
+                      except:
+                          return url[:25]
+
+                  width, height = get_terminal_size()
+                  selected = 0
+                  scroll = 0
+                  list_height = height - 5
+                  mode = 'list'
+                  preview_scroll = 0
+                  preview_content = []
+
+                  fd = sys.stdin.fileno()
+                  old_settings = termios.tcgetattr(fd)
+
+                  try:
+                      tty.setcbreak(fd)
+                      sys.stdout.write('\033[?25l')
+                      sys.stdout.write('\033[2J\033[H')
+
+                      while True:
+                          width, height = get_terminal_size()
+                          list_height = height - 5
+
+                          if mode == 'list':
+                              if selected < scroll:
+                                  scroll = selected
+                              elif selected >= scroll + list_height:
+                                  scroll = selected - list_height + 1
+
+                          sys.stdout.write('\033[H')
+
+                          # Header
+                          if mode == 'list':
+                              header = f" WEB SEARCH ({len(results)} results): '{query}' "
+                          else:
+                              header = f" PREVIEW: {results[selected]['title'][:width-12]} "
+                          sys.stdout.write(f'\033[44;37;1m{header.ljust(width)}\033[0m\n')
+
+                          # Column headers
+                          if mode == 'list':
+                              col_header = f' {"#":<3} {"DOMAIN":<25} {"TITLE":<50}'
+                              sys.stdout.write(f'\033[90m{col_header[:width]}\033[0m\n')
+                          else:
+                              sys.stdout.write(f'\033[90m{"─" * width}\033[0m\n')
+
+                          if mode == 'list':
+                              for i in range(list_height):
+                                  idx = scroll + i
+                                  sys.stdout.write(f'\033[{3+i};1H\033[K')
+                                  if idx >= len(results):
+                                      continue
+
+                                  r = results[idx]
+                                  num = str(idx + 1)
+                                  domain = get_domain(r['url'])
+                                  title = r['title'][:55].replace('\n', ' ')
+
+                                  line = f" {num:<3} {domain:<25} {title}"
+                                  line = line[:width-1]
+
+                                  if idx == selected:
+                                      sys.stdout.write(f'\033[47;30;1m>{line}\033[0m')
+                                  else:
+                                      sys.stdout.write(f' {line}')
+
+                              # Status bar
+                              sys.stdout.write(f'\033[{height-2};1H\033[K\033[90m{"─" * width}\033[0m')
+                              sel = results[selected] if results else {}
+                              snippet = (sel.get('snippet') or '')[:width-2]
+                              sys.stdout.write(f'\033[{height-1};1H\033[K {snippet}'.ljust(width))
+                              sys.stdout.write(f'\033[{height};1H\033[K\033[44;37m j/k:Nav p:Preview o:Open i:Incog c:Copy q:Quit [{selected+1}/{len(results)}] \033[0m')
+
+                          else:  # preview mode
+                              for i in range(list_height):
+                                  idx = preview_scroll + i
+                                  sys.stdout.write(f'\033[{3+i};1H\033[K')
+                                  if idx < len(preview_content):
+                                      sys.stdout.write(preview_content[idx][:width-1])
+
+                              sys.stdout.write(f'\033[{height-2};1H\033[K\033[90m{"─" * width}\033[0m')
+                              sys.stdout.write(f'\033[{height-1};1H\033[K [{preview_scroll+1}/{len(preview_content)} lines]')
+                              sys.stdout.write(f'\033[{height};1H\033[K\033[44;37m j/k:Scroll b:Back o:Open c:Copy q:Quit \033[0m')
+
+                          sys.stdout.flush()
+
+                          c = sys.stdin.read(1)
+
+                          if c == '\x1b':
+                              c2 = sys.stdin.read(1)
+                              if c2 == '[':
+                                  c3 = sys.stdin.read(1)
+                                  if c3 == 'A':
+                                      if mode == 'list' and selected > 0:
+                                          selected -= 1
+                                      elif mode == 'preview' and preview_scroll > 0:
+                                          preview_scroll -= 1
+                                  elif c3 == 'B':
+                                      if mode == 'list' and selected < len(results) - 1:
+                                          selected += 1
+                                      elif mode == 'preview' and preview_scroll < max(0, len(preview_content) - list_height):
+                                          preview_scroll += 1
+                              else:
+                                  if mode == 'preview':
+                                      mode = 'list'
+                                      sys.stdout.write('\033[2J\033[H')
+                                  else:
+                                      context['output'] = "Cancelled."
+                                      break
+                              continue
+
+                          if c == 'q' or c == '\x03':
+                              context['output'] = "Cancelled."
+                              break
+                          elif c == 'k':
+                              if mode == 'list' and selected > 0:
+                                  selected -= 1
+                              elif mode == 'preview' and preview_scroll > 0:
+                                  preview_scroll -= 1
+                          elif c == 'j':
+                              if mode == 'list' and selected < len(results) - 1:
+                                  selected += 1
+                              elif mode == 'preview' and preview_scroll < max(0, len(preview_content) - list_height):
+                                  preview_scroll += 1
+                          elif c == 'p' and mode == 'list' and results:
+                              # Build preview from available info
+                              sel = results[selected]
+                              preview_content = [
+                                  f"Title: {sel['title']}",
+                                  "",
+                                  f"URL: {sel['url']}",
+                                  f"Domain: {get_domain(sel['url'])}",
+                                  "",
+                              ]
+                              if sel.get('snippet'):
+                                  preview_content.append("Snippet:")
+                                  # Word wrap snippet
+                                  words = sel['snippet'].split()
+                                  line = ""
+                                  for w in words:
+                                      if len(line) + len(w) + 1 > width - 4:
+                                          preview_content.append(f"  {line}")
+                                          line = w
+                                      else:
+                                          line = f"{line} {w}" if line else w
+                                  if line:
+                                      preview_content.append(f"  {line}")
+
+                              mode = 'preview'
+                              preview_scroll = 0
+                              sys.stdout.write('\033[2J\033[H')
+                          elif c == 'b' and mode == 'preview':
+                              mode = 'list'
+                              sys.stdout.write('\033[2J\033[H')
+                          elif c == 'o' and results:
+                              url = results[selected].get('url', '')
+                              if url:
+                                  webbrowser.open(url)
+                          elif c == 'i' and results:
+                              url = results[selected].get('url', '')
+                              if url:
+                                  try:
+                                      subprocess.run(['npcsh', '-c', f'/navigate url={url}'], check=False, capture_output=True)
+                                  except:
+                                      webbrowser.open(url)
+                          elif c == 'c' and results:
+                              url = results[selected].get('url', '')
+                              if url:
+                                  try:
+                                      # Try xclip or xsel
+                                      subprocess.run(['xclip', '-selection', 'clipboard'], input=url.encode(), check=True)
+                                  except:
+                                      try:
+                                          subprocess.run(['xsel', '--clipboard', '--input'], input=url.encode(), check=True)
+                                      except:
+                                          pass
+                          elif c in ('\r', '\n') and results:
+                              sel = results[selected]
+                              context['output'] = f"Selected: {sel['title']}\nURL: {sel['url']}"
+                              break
+
+                  finally:
+                      termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
+                      sys.stdout.write('\033[?25h')
+                      sys.stdout.write('\033[2J\033[H')
+                      sys.stdout.flush()
+
+          except Exception as e:
+              import traceback
+              context['output'] = "Web search error: " + str(e) + "\n" + traceback.format_exc()

{npcsh-1.1.17.data → npcsh-1.1.18.data}/data/npcsh/npc_team/yap.jinx

@@ -1,11 +1,11 @@
 jinx_name: yap
 description: Voice chat mode - speech-to-text input, text-to-speech output
 inputs:
-- model: null
-- provider: null
-- tts_model: kokoro
-- voice: af_heart
-- files: null
+  - model: null
+  - provider: null
+  - tts_model: kokoro
+  - voice: af_heart
+  - files: null
 
 steps:
   - name: yap_repl
@@ -49,8 +49,14 @@ steps:
       tts_model = context.get('tts_model', 'kokoro')
       voice = context.get('voice', 'af_heart')
 
-      model = context.get('model') or (npc.model if npc else None)
-      provider = context.get('provider') or (npc.provider if npc else None)
+      # Resolve npc if it's a string (npc name) rather than NPC object
+      if isinstance(npc, str) and team:
+          npc = team.get(npc) if hasattr(team, 'get') else None
+      elif isinstance(npc, str):
+          npc = None
+
+      model = context.get('model') or (npc.model if npc and hasattr(npc, 'model') else None)
+      provider = context.get('provider') or (npc.provider if npc and hasattr(npc, 'provider') else None)
 
       print("""
       ██╗   ██╗ █████╗ ██████╗

{npcsh-1.1.17.dist-info → npcsh-1.1.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.1.17
+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
@@ -596,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 |
@@ -626,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/)