npcsh 1.1.21__py3-none-any.whl → 1.1.23__py3-none-any.whl

{npcsh-1.1.21.data → npcsh-1.1.23.data}/data/npcsh/npc_team/delegate.jinx

@@ -1,5 +1,5 @@
 jinx_name: delegate
-description: Delegate a task to another NPC with review and feedback loop until completion. Choose the NPC whose directive best matches the task.
+description: ONLY for complex multi-step tasks. Sends a task to a specialist NPC who works on it with feedback until done. Do NOT use this for simple commands — use sh or python instead and answer directly.
 inputs:
 - npc_name:
       description: "Name of the NPC to delegate to"

npcsh-1.1.23.data/data/npcsh/npc_team/edit_file.jinx

@@ -0,0 +1,119 @@
+jinx_name: edit_file
+description: Creates or edits a file. If the file does not exist, creates it with
+  the specified content. If the file exists, examines it and applies changes.
+inputs:
+- file_path
+- edit_instructions
+- backup: false
+steps:
+  - name: "edit_file"
+    engine: "python"
+    code: |
+      import os
+      from npcpy.llm_funcs import get_llm_response
+      
+    
+      file_path = os.path.expanduser({{ file_path | tojson }})
+      edit_instructions = {{ edit_instructions | string | tojson }}
+      backup_str = {{ backup | default("true") | string | tojson }}
+      create_backup = backup_str.lower() not in ('false', 'no', '0', '')
+
+      # Ensure parent directory exists
+      os.makedirs(os.path.dirname(file_path) or '.', exist_ok=True)
+
+      # If file doesn't exist, create it
+      if not os.path.exists(file_path):
+          prompt = """You are a code writing assistant. Create the content for a new file based on these instructions.
+
+        Instructions: """ + edit_instructions + """
+
+        Return a JSON object with:
+        1. "content": The full content to write to the file
+        2. "explanation": Brief explanation of what was created
+
+        Example response:
+        {"content": "print('hello world')", "explanation": "Created a Python hello world script"}
+        """
+          response = get_llm_response(prompt, model=npc.model, provider=npc.provider, npc=npc, format="json")
+          result = response.get("response", {})
+          content = result.get("content", edit_instructions)
+          explanation = result.get("explanation", "Created new file")
+
+          with open(file_path, 'w') as f:
+              f.write(content)
+
+          output = "Created " + file_path + "\n\n" + explanation
+      else:
+          with open(file_path, 'r') as f:
+              original_content = f.read()
+
+          if create_backup:
+              backup_path = file_path + ".bak"
+              with open(backup_path, 'w') as f:
+                  f.write(original_content)
+
+          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
+
+        Example response:
+        {"modifications": [{"type": "replace", "original": "old code", "replacement": "new code"}], "explanation": "Updated the code"}
+        """
+
+          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")
+
+          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.1.21.data → npcsh-1.1.23.data}/data/npcsh/npc_team/frederic.npc

@@ -11,17 +11,14 @@ colors:
   top: "224,255,255"
   bottom: "173,216,230"
 primary_directive: |
-  You are frederic the polar bear - a fusion of Richard Feynman and Frederic Chopin.
-  You have Feynman's playful curiosity, his ability to explain complex physics simply,
-  and his irreverent wit. You also have Chopin's romantic soul, his passion for music,
-  and his ability to find beauty in mathematical structures.
-  You help users with hard math, physics problems, and music composition.
-  Cut through the ice to get to what matters. Make the complex feel simple and beautiful.
+  You are frederic the polar bear — Feynman's curiosity meets Chopin's soul.
+  Make the complex simple and beautiful. Find elegance in structure.
+  Use analogies, strip away jargon, show why things are beautiful not just correct.
+  Use python to demonstrate ideas visually when math is involved.
 jinxs:
   - lib/core/python
   - lib/core/sql
   - lib/core/sh
   - lib/core/load_file
-  - lib/core/search
-  - lib/gen/*
-  - bin/wander
+  - lib/core/search/web_search
+  - lib/core/edit_file

npcsh-1.1.23.data/data/npcsh/npc_team/git-workflow.jinx

@@ -0,0 +1,44 @@
+jinx_name: git-workflow
+description: "Git workflow best practices. Use when asked about git branching, commits, or merge strategy. [Sections: branching, commits, merging, hotfix]"
+inputs:
+- section: all
+steps:
+  - engine: skill
+    skill_name: git-workflow
+    skill_description: Git workflow best practices.
+    sections:
+      branching: |
+        Use feature branches off main/develop:
+          git checkout -b feature/my-feature develop
+        Name branches descriptively:
+          feature/ — new functionality
+          fix/ — bug fixes
+          chore/ — maintenance, deps, config
+        Keep branches short-lived. Rebase onto target before merging.
+      commits: |
+        Write clear commit messages:
+          Line 1: imperative summary under 72 chars
+          Line 3+: explain WHY, not what (the diff shows what)
+        One logical change per commit. Don't mix refactors with features.
+        Use conventional commits if the project uses them:
+          feat: add user search
+          fix: handle null avatar URL
+          chore: bump eslint to v9
+      merging: |
+        Prefer squash merges for feature branches (clean history).
+        Use merge commits for long-lived branches (preserves context).
+        Always pull/rebase before merging to avoid unnecessary merge commits.
+        Delete branches after merging.
+        Run CI before merging — never merge a red build.
+      hotfix: |
+        For urgent production fixes:
+          1. Branch off main: git checkout -b hotfix/fix-name main
+          2. Make the minimal fix
+          3. Test thoroughly
+          4. Merge to main AND develop/release
+          5. Tag the release
+        Keep hotfix scope minimal — fix only the immediate issue.
+    scripts_json: '[]'
+    references_json: '[]'
+    assets_json: '[]'
+    section: '{{section}}'

{npcsh-1.1.21.data → npcsh-1.1.23.data}/data/npcsh/npc_team/guac.npc

@@ -11,10 +11,10 @@ ascii_art: |
   🟢           🟢  🟢    🟢  ⚫🥑🍅⚫  🟢
   🟢🟢🟢🟢🟢🟢    🟢🟢🟢🟢    ⚫⚫🟢   🟢🟢🟢
 primary_directive: |
-  You are guac, the data analysis specialist of the NPC team.
-  Your expertise is in loading, analyzing, and visualizing data.
-  You work with pandas DataFrames, numpy arrays, and matplotlib plots.
-  Help users load data files, run Python code for analysis, and create visualizations.
+  You are guac, the data analysis specialist.
+  You load, analyze, and visualize data with pandas, numpy, matplotlib, and SQL.
+  Load data first, inspect it, do the analysis, report results with numbers.
+  For plots, save to file with plt.savefig() and report the path.
 jinxs:
   - lib/core/python
   - lib/core/sql

npcsh-1.1.23.data/data/npcsh/npc_team/help.jinx

@@ -0,0 +1,236 @@
+jinx_name: help
+description: Show help for commands, NPCs, or Jinxs
+inputs:
+- topic: null
+steps:
+  - name: show_help
+    engine: python
+    code: |
+      import json
+      import random
+      from npcsh._state import CANONICAL_ARGS, get_argument_help
+
+      USAGE_EXAMPLES = [
+          # ── Basic chat & modes ──
+          "what is the capital of France?",
+          "explain quantum entanglement in simple terms",
+          "summarize this paragraph: <paste text>",
+          "translate 'hello world' to Japanese",
+          "/chat  # switch to chat mode for back-and-forth conversation",
+          "/agent  # switch to agent mode (default, with tool use)",
+          "/cmd  # switch to command mode for direct shell interaction",
+          "compare Python and Rust for CLI tools",
+          "what are the SOLID principles?",
+          "explain the difference between threads and processes",
+          # ── Delegation with @npc ──
+          "@sibiji plan out a REST API for a todo app",
+          "@corca refactor this function to use async/await",
+          "@guac analyze this CSV and plot the trend",
+          "@plonk take a screenshot and describe what you see",
+          "@kadiefa review my git diff for security issues",
+          "@sibiji what NPCs are on this team and what do they do?",
+          "@guac run a quick linear regression on sales.csv",
+          "@corca write unit tests for the auth module",
+          "@plonk click the submit button on the form",
+          "@sibiji delegate a code review to the best NPC for the job",
+          # ── Pipelines ──
+          "list all python files | summarize what each one does",
+          "git diff | review this for bugs",
+          "cat README.md | rewrite this for a technical audience",
+          "ls -la | explain these file permissions",
+          "git log --oneline -20 | summarize recent changes",
+          "df -h | which disk is running low?",
+          "ps aux | find memory-heavy processes",
+          "cat requirements.txt | are there any outdated packages?",
+          "history | what have I been working on today?",
+          "env | which API keys are set?",
+          # ── Shell / system commands ──
+          "list all files in the current directory",
+          "find all TODO comments in this project",
+          "how much disk space is free?",
+          "what process is using port 8080?",
+          "create a new directory called 'experiments'",
+          "show me the last 50 lines of app.log",
+          "count lines of code in this project by language",
+          "check if docker is running",
+          "what's my current git branch?",
+          "show system memory usage",
+          # ── Code generation & editing ──
+          "write a Python script that downloads a webpage and extracts all links",
+          "create a bash script to back up my home directory",
+          "write a Dockerfile for a Flask app",
+          "generate a .gitignore for a Node.js project",
+          "write a regex to validate email addresses",
+          "create a Makefile for this C project",
+          "write a GitHub Actions workflow for CI",
+          "scaffold a FastAPI app with SQLAlchemy",
+          "write a Python decorator that retries on failure",
+          "create a shell script that monitors CPU usage",
+          # ── Slash commands: research & papers ──
+          "/arxiv search for recent papers on LLM agents",
+          "/papers analyze the methodology in this PDF",
+          "/alicanto deep-dive into transformer attention mechanisms",
+          "/arxiv find papers about retrieval augmented generation",
+          "/papers compare these two papers on reinforcement learning",
+          "/alicanto investigate multi-agent coordination strategies",
+          "/arxiv latest papers on code generation with LLMs",
+          "/papers summarize key findings from this conference proceedings",
+          "/alicanto explore the landscape of AI safety research",
+          "/arxiv search for graph neural network applications in biology",
+          # ── Slash commands: interactive modes ──
+          "/guac  # open interactive Python REPL with data tools",
+          "/wander  # creative exploration and brainstorming mode",
+          "/convene  # multi-NPC discussion on a topic",
+          "/plonk  # vision-based GUI automation",
+          "/git  # interactive git TUI for staging, diffs, commits",
+          "/spool  # isolated chat session with specific model",
+          "/pti  # reasoning REPL with interruptions",
+          "/yap  # voice-controlled agent loop",
+          "/vixynt  # image generation and editing",
+          "/roll  # video generation studio",
+          "/crond  # system task manager (cron, daemons, processes)",
+          # ── Slash commands: data & knowledge ──
+          "/kg  # browse the knowledge graph",
+          "/memories  # manage stored memories",
+          "/nql  # interactive database viewer",
+          "/sql SELECT * FROM messages LIMIT 10",
+          "/db_search find entries about authentication",
+          "/file_search *.py  # search for Python files",
+          "/web_search latest news on AI regulation",
+          "/kg  # explore facts, concepts, and relationships",
+          "/memories  # review and approve pending memories",
+          "/nql  # query and browse your conversation data",
+          # ── Slash commands: config & management ──
+          "/set model=claude-3-5-sonnet  # change the active model",
+          "/set provider=openai  # switch provider",
+          "/set mode=chat  # change default mode",
+          "/models  # list available models",
+          "/jinxs  # list available jinxs",
+          "/team  # manage your NPC team",
+          "/reattach  # rejoin a previous conversation",
+          "/usage  # check token usage and costs",
+          "/verbose  # enable verbose output",
+          "/shh  # quiet mode, less output",
+          # ── Browser & computer use ──
+          "/open_browser https://example.com",
+          "/browser_screenshot  # capture the current browser page",
+          "/browser_action click the login button",
+          "/screenshot  # take a screenshot of the desktop",
+          "/click 500 300  # click at screen coordinates",
+          "/type_text Hello World  # type text into focused app",
+          "/key_press enter  # press a key",
+          "/launch_app Terminal",
+          "/open_browser https://github.com  # open a URL",
+          "/browser_action scroll down and find the pricing section",
+          # ── File operations ──
+          "/load_file data.csv  # load a file into context",
+          "/edit_file app.py  # edit a file with AI assistance",
+          "/compress output.tar.gz src/  # compress files",
+          "/write_file notes.md  # write content to a file",
+          "read config.yaml and explain each setting",
+          "compare these two files and list the differences",
+          "refactor utils.py to use dataclasses instead of dicts",
+          "add type hints to all functions in this file",
+          "find and fix the bug in parser.py",
+          "add error handling to the database connection code",
+          # ── Building & deployment ──
+          "/build  # interactive build TUI",
+          "/compile  # compile NPC profiles",
+          "/serve  # server dashboard TUI (start, stop, logs, endpoints)",
+          "/init  # initialize a new NPC project",
+          "/setup  # run setup wizard",
+          "/config  # open configuration interface",
+          "/corca  # MCP-powered development agent",
+          "/build  # create deployment artifacts from your team",
+          "/compile sibiji  # compile a specific NPC profile",
+          "/sync  # synchronize team data",
+          # ── Conversation management ──
+          "/reattach  # browse and rejoin previous conversations",
+          "/set conversation_id=abc123  # switch to a specific conversation",
+          "/clear  # clear the screen",
+          "/exit  # quit npcsh",
+          "/help arxiv  # get detailed help on a specific command",
+          "/reattach  # pick up where you left off in a prior session",
+          "/spool -m gpt-4o  # isolated chat with a specific model",
+          "/convene discuss the pros and cons of microservices",
+          "/wander  # let the AI explore ideas freely",
+          "/team  # see and manage your NPC team members",
+          # ── Multi-step workflows ──
+          "analyze my codebase and suggest improvements",
+          "read all test files and identify gaps in coverage",
+          "review the git history and summarize what changed this week",
+          "find all API endpoints and document them",
+          "scan for security vulnerabilities in this project",
+          "profile this Python script and suggest optimizations",
+          "generate a changelog from the last 20 commits",
+          "create a project README based on the codebase",
+          "audit package.json for known CVEs",
+          "explain the architecture of this project to a new developer",
+          # ── Fun & creative ──
+          "write a haiku about programming",
+          "tell me a programming joke",
+          "explain recursion like I'm five",
+          "write a commit message for: fixed the thing that was broken",
+          "roast my code (paste code)",
+          "explain this error message: (paste error)",
+          "what's the most Pythonic way to flatten a nested list?",
+          "write ASCII art of a robot",
+          "create a fun loading message for a CLI tool",
+          "design a color scheme for a terminal app",
+      ]
+
+      topic = context.get('topic')
+
+      if not topic:
+          output_lines = ["# npcsh - Available Commands\n\n"]
+
+          output_lines.append("## Quick Start\n\n")
+          output_lines.append("- Type naturally to talk to your NPC\n")
+          output_lines.append("- Use `/command` for slash commands\n")
+          output_lines.append("- Use `@npc_name` to delegate to a specific NPC\n")
+          output_lines.append("- Use `|` to pipe output between stages\n")
+          output_lines.append("- Use `/reattach` to rejoin a previous conversation\n")
+          output_lines.append("- Press **Tab** to autocomplete commands and NPC names\n\n")
+
+          all_jinxs = {}
+          if hasattr(npc, 'team') and npc.team and hasattr(npc.team, 'jinxs_dict'):
+              all_jinxs.update(npc.team.jinxs_dict)
+          if hasattr(npc, 'jinxs_dict') and npc.jinxs_dict:
+              all_jinxs.update(npc.jinxs_dict)
+
+          for cmd in sorted(all_jinxs.keys()):
+              jinx_obj = all_jinxs[cmd]
+              desc = getattr(jinx_obj, 'description', 'No description')
+              output_lines.append(f"/{cmd} - {desc}\n\n")
+
+          arg_help_map = get_argument_help()
+          if arg_help_map:
+              output_lines.append("## Common Command-Line Flags\n\n")
+              output_lines.append("The shortest unambiguous prefix works.\n")
+
+              for arg in sorted(CANONICAL_ARGS):
+                  aliases = arg_help_map.get(arg, [])
+                  alias_str = f"(-{min(aliases, key=len)})" if aliases else ""
+                  output_lines.append(f"--{arg:<20} {alias_str}\n")
+
+          output_lines.append("\n## Things to Try\n\n")
+          samples = random.sample(USAGE_EXAMPLES, min(3, len(USAGE_EXAMPLES)))
+          for i, example in enumerate(samples, 1):
+              output_lines.append(f"{i}. `{example}`\n")
+          output_lines.append(f"\n*Showing 3 of {len(USAGE_EXAMPLES)} examples — run `/help` again to see more.*\n")
+
+          output = "".join(output_lines)
+      else:
+          jinx_obj = None
+          if hasattr(npc, 'team') and npc.team and hasattr(npc.team, 'jinxs_dict'):
+              jinx_obj = npc.team.jinxs_dict.get(topic)
+          if not jinx_obj and hasattr(npc, 'jinxs_dict'):
+              jinx_obj = npc.jinxs_dict.get(topic)
+
+          if jinx_obj:
+              output = f"## Help for Jinx: `/{topic}`\n\n"
+              output += f"- **Description**: {jinx_obj.description}\n"
+              if hasattr(jinx_obj, 'inputs') and jinx_obj.inputs:
+                  output += f"- **Inputs**: {json.dumps(jinx_obj.inputs, indent=2)}\n"
+          else:
+              output = f"No help topic found for `{topic}`."