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

npcsh/npc_team/kadiefa.npc

@@ -18,4 +18,5 @@ primary_directive: |
   Use web search and browsing tools to discover new information.
 jinxs:
   - lib/core/python
-  - bin/wander
+  - lib/core/sh
+  - lib/core/search/web_search

npcsh/npc_team/sibiji.npc

@@ -17,8 +17,8 @@ primary_directive: |
   When delegating, match the task to the agent whose primary_directive best fits. Basic search inquiries can be handled by yourself. Do not delegate unnecessarily.
   You have access to the delegate tool to pass tasks to other agents.
 jinxs:
-  - lib/orchestration/delegate
-  - lib/orchestration/convene
+  - lib/core/delegate
+  - lib/core/convene
   - lib/core/sh
   - lib/core/python
-  - lib/core/search
+  - lib/core/search/web_search

{npcsh-1.1.21.data → npcsh-1.1.22.data}/data/npcsh/npc_team/alicanto.jinx

@@ -33,6 +33,8 @@ steps:
       from typing import List, Dict, Any, Tuple
       from pathlib import Path
 
+      import requests as _requests
+
       from npcpy.llm_funcs import get_llm_response
       from npcpy.npc_compiler import NPC
 
@@ -65,6 +67,7 @@ steps:
 
       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)
+      _alicanto_directive = (npc.primary_directive if npc and hasattr(npc, 'primary_directive') else "") or ""
 
       # ========== Utility ==========
       def get_size():
@@ -164,8 +167,26 @@ steps:
           except:
               return "Error listing directory."
 
-      def execute_shell_command(command: str) -> str:
-          """Execute a shell command and return stdout/stderr."""
+      def run_python(code: str) -> str:
+          """Execute Python code and return the output. This is your PRIMARY tool for data analysis, file processing, API calls, computations, and any programmatic work. Use this for: downloading data, parsing files, running analyses, making HTTP requests, processing CSVs/FITS/JSON, plotting, statistics, etc. The code runs in a fresh namespace with access to standard library and installed packages (numpy, pandas, astropy, requests, matplotlib, scipy, etc.)."""
+          import io as _io
+          _old_stdout = sys.stdout
+          _old_stderr = sys.stderr
+          _capture = _io.StringIO()
+          sys.stdout = _capture
+          sys.stderr = _capture
+          _ns = {'__builtins__': __builtins__}
+          try:
+              exec(code, _ns)
+          except Exception as _e:
+              print(f"Error: {type(_e).__name__}: {_e}")
+          finally:
+              sys.stdout = _old_stdout
+              sys.stderr = _old_stderr
+          return _capture.getvalue()[:5000] if _capture.getvalue().strip() else "(no output)"
+
+      def shell_command(command: str) -> str:
+          """Execute a shell command. ONLY use this for simple system tasks like installing packages (pip install), checking disk space, or listing system info. For ALL data work, analysis, file processing, HTTP requests, and computation, use run_python instead."""
           try:
               result = subprocess.run(command, shell=True, capture_output=True, text=True, timeout=60)
               out = ""
@@ -179,12 +200,14 @@ steps:
           except Exception as e:
               return f"Error: {e}"
 
+      _search_provider = os.environ.get('NPCSH_SEARCH_PROVIDER', 'perplexity')
+
       def _web_search_tool(query: str) -> str:
           """Search the web for information."""
           if not WEB_AVAILABLE:
               return "Web search not available."
           try:
-              results = search_web(query, num_results=5)
+              results = search_web(query, num_results=5, provider=_search_provider)
               if not results:
                   return "No results found."
               if isinstance(results, list):
@@ -199,6 +222,61 @@ steps:
           except Exception as e:
               return f"Search error: {e}"
 
+      _s2_api_key = os.environ.get('S2_API_KEY', '')
+
+      def search_papers(query: str, limit: int = 10) -> str:
+          """Search Semantic Scholar for academic papers. Returns titles, authors, year, citation count, abstracts, and URLs."""
+          s2_url = "https://api.semanticscholar.org/graph/v1/paper/search"
+          params = {
+              "query": query,
+              "limit": min(limit, 20),
+              "fields": "title,abstract,authors,year,citationCount,url,tldr,venue"
+          }
+          try:
+              # Try with API key first if available
+              if _s2_api_key:
+                  resp = _requests.get(s2_url, headers={"x-api-key": _s2_api_key}, params=params, timeout=30)
+                  if resp.status_code == 403:
+                      # Key expired/revoked, fall back to unauthenticated
+                      resp = _requests.get(s2_url, params=params, timeout=30)
+              else:
+                  resp = _requests.get(s2_url, params=params, timeout=30)
+              if resp.status_code == 429:
+                  # Rate limited, wait and retry once
+                  time.sleep(1.5)
+                  resp = _requests.get(s2_url, params=params, timeout=30)
+              resp.raise_for_status()
+              papers = resp.json().get('data', [])
+              if not papers:
+                  return f"No papers found for: {query}"
+              out = []
+              for i, p in enumerate(papers, 1):
+                  title = p.get('title', 'No title')
+                  year = p.get('year', '?')
+                  cites = p.get('citationCount', 0)
+                  authors = ', '.join([a.get('name', '') for a in p.get('authors', [])[:3]])
+                  if len(p.get('authors', [])) > 3:
+                      authors += ' et al.'
+                  tldr = p.get('tldr', {}).get('text', '') if p.get('tldr') else ''
+                  abstract = (p.get('abstract') or '')[:200]
+                  paper_url = p.get('url', '')
+                  venue = p.get('venue', '')
+                  entry = f"{i}. {title} ({year}) [{cites} citations]"
+                  entry += f"\n   Authors: {authors}"
+                  if venue:
+                      entry += f"\n   Venue: {venue}"
+                  if tldr:
+                      entry += f"\n   TL;DR: {tldr}"
+                  elif abstract:
+                      entry += f"\n   Abstract: {abstract}..."
+                  entry += f"\n   URL: {paper_url}"
+                  out.append(entry)
+              return "\n\n".join(out)
+          except _requests.exceptions.RequestException as e:
+              return f"Semantic Scholar API error: {e}"
+          except Exception as e:
+              return f"Paper search error: {e}"
+
       # ========== File Provenance (matching original) ==========
       @dataclass
       class FileProvenance:
@@ -362,14 +440,14 @@ steps:
               except Exception as e:
                   return f"Wander failed: {e}"
 
-          tools = [create_file, append_to_file, replace_in_file, read_file,
-                   list_files, execute_shell_command, _web_search_tool, wander_wrapper]
+          tools = [run_python, create_file, append_to_file, replace_in_file, read_file,
+                   list_files, _web_search_tool, search_papers, shell_command, wander_wrapper]
 
           agent = NPC(
               name=agent_name.replace(' ', '_').lower(),
               model=_model,
               provider=_provider,
-              primary_directive=agent_persona,
+              primary_directive=_alicanto_directive + "\n\n" + agent_persona,
               tools=tools
           )
 
@@ -379,6 +457,7 @@ steps:
           created_files = set()
           summary = {}
           major_step = 0
+          stall_count = 0  # consecutive steps with no filesystem change
 
           while major_step < _max_steps:
               # Check for skip/quit
@@ -401,37 +480,11 @@ steps:
               history_str = "\n".join(summarized_history)
               next_step_text = f"This is the next step suggested by your advisor. : BEGIN NEXT_STEP: {summary.get('next_step')} END NEXT STEP" if summary else ""
 
-              search_provider = os.environ.get('NPCSH_SEARCH_PROVIDER', 'duckduckgo')
-              initial_prompt = f"""Test the following hypothesis: '{hypothesis}' as related to the user query: '{user_query}'.
-      Only focus on your specific hypothesis, other agents are being tasked with other aspects of the problem.
-
-      Use bash commands to carry out research through the execute_shell_command.
-      Adjust files with `replace_in_file` and use `read_file` and `list_files` to verify file states and file creation.
-      Create files with create_file()
-
-      Test with execute_shell_command when needed
-      Get unstuck with wander_wrapper
-
-      When you have a definitive result, say RESEARCH_COMPLETE.
-
-      FILE PROVENANCE HISTORY:
-      {chr(10).join(provenance_summary)}
-
-      CURRENT FILES: {list(fs_before.keys())}
-
-      COMPLETE ACTION HISTORY:
-      BEGIN HISTORY
+              initial_prompt = f"""Hypothesis: '{hypothesis}'
+      Query: '{user_query}'
+      Files: {list(fs_before.keys())}
       {history_str}
-      END HISTORY
-
-      What specific action will you take next to test your hypothesis?
-      AVAILABLE TOOLS: create_file, append_to_file, replace_in_file, read_file, list_files, execute_shell_command, wander_wrapper, _web_search_tool.
-
-      Do not repeat actions. Use `_web_search_tool` with provider of {search_provider} to look up items if you are struggling.
-
-      {next_step_text}
-
-      Your goal is to research. To set up experiments, create figures, and produce data outputs in csvs for verification and reproducibility."""
+      {next_step_text}"""
 
               ui_state['log'].append(f"\033[90m  Major step {major_step + 1}\033[0m")
 
@@ -495,8 +548,16 @@ steps:
 
               fs_after = get_filesystem_state()
               new_files = set(fs_after.keys()) - set(fs_before.keys())
+              changed_files = {f for f in fs_after if fs_before.get(f) != fs_after.get(f)}
               if new_files:
                   ui_state['log'].append(f"  \033[32mNew files: {list(new_files)}\033[0m")
+                  stall_count = 0
+              elif changed_files:
+                  stall_count = 0
+              else:
+                  stall_count += 1
+                  if stall_count >= 3:
+                      ui_state['log'].append(f"  \033[33mStalled for {stall_count} steps, forcing wrap-up\033[0m")
 
               combined_thought = " ".join(all_thoughts)
               combined_action = " | ".join(filter(None, all_actions))
@@ -619,7 +680,7 @@ steps:
 
       Focus ONLY on the {next_section} section. Write 2-4 paragraphs of substantial academic content.
 
-      Available tools: replace_in_file, read_file, _web_search_tool"""
+      Available tools: replace_in_file, read_file, _web_search_tool, search_papers"""
 
               for micro in range(5):
                   if micro == 0:
@@ -743,7 +804,7 @@ steps:
       Use replace_in_file to make targeted improvements to paper.tex.
       Use read_file to check current state.
 
-      Available tools: replace_in_file, read_file, append_to_file, _web_search_tool"""
+      Available tools: replace_in_file, read_file, append_to_file, _web_search_tool, search_papers"""
 
           coord_messages = []
           for micro in range(8):
@@ -965,13 +1026,13 @@ steps:
               except Exception as e:
                   return f"Wander failed: {e}"
 
-          coord_tools = [create_file, append_to_file, replace_in_file, read_file,
-                         list_files, execute_shell_command, _web_search_tool, wander_wrapper_coord]
+          coord_tools = [run_python, create_file, append_to_file, replace_in_file, read_file,
+                         list_files, _web_search_tool, search_papers, shell_command, wander_wrapper_coord]
 
           coordinator = NPC(
               name="Alicanto",
               model=model, provider=provider,
-              primary_directive="You are Alicanto the mythical bird. You research topics iteratively by writing to LaTeX files and searching for more information.",
+              primary_directive=_alicanto_directive,
               tools=coord_tools
           )
 

{npcsh-1.1.21.data → npcsh-1.1.22.data}/data/npcsh/npc_team/alicanto.npc

@@ -11,13 +11,19 @@ colors:
   top: "255,215,0"
   bottom: "218,165,32"
 primary_directive: |
-  You are alicanto, the research and exploration specialist of the NPC team.
-  Like the mythical bird, you lead users to discover valuable information.
-  Your role is web research, searching, and helping users explore topics.
-  Use search tools to find information and present findings clearly.
+  You are alicanto, a research agent. You investigate hypotheses through experimentation and evidence gathering.
+  Search academic papers to ground your work in existing literature.
+  Search the web for data, documentation, and recent findings.
+  Write and execute Python code to analyze data, compute statistics, and generate results.
+  Use shell commands for data processing and system tasks.
+  Create files to record your findings, analyses, and evidence.
+  When exploring a hypothesis, gather evidence from multiple sources, analyze it quantitatively where possible, and document what you find.
+  Say RESEARCH_COMPLETE when you have sufficient evidence to evaluate your hypothesis.
 jinxs:
-  - lib/core/search
+  - lib/core/search/web_search
+  - lib/core/search/file_search
+  - lib/core/search/db_search
   - lib/core/sh
   - lib/core/python
   - lib/core/load_file
-  - lib/research/*
+  - lib/core/edit_file

npcsh-1.1.22.data/data/npcsh/npc_team/build.jinx

@@ -0,0 +1,378 @@
+jinx_name: build
+description: Interactive TUI for building deployment artifacts from an NPC team
+interactive: true
+inputs:
+  - target: ""
+  - outdir: "./build"
+  - team: "./npc_team"
+  - port: 5337
+  - cors: ""
+steps:
+  - name: build
+    engine: python
+    code: |
+      import os
+      import sys
+      import tty
+      import termios
+      import select as _sel
+
+      def _resolve_team_path(raw_team):
+          """Resolve team path: try given path first, then local ./npc_team, then global ~/.npcsh/npc_team."""
+          candidates = []
+          if raw_team:
+              candidates.append(os.path.abspath(os.path.expanduser(raw_team)))
+          local = os.path.abspath('./npc_team')
+          global_ = os.path.expanduser('~/.npcsh/npc_team')
+          if local not in candidates:
+              candidates.append(local)
+          if global_ not in candidates:
+              candidates.append(global_)
+          for p in candidates:
+              if os.path.isdir(p):
+                  if p != candidates[0] and candidates[0] != p:
+                      print(f"\033[33m⚠ Local team not found at {candidates[0]}, using {p}\033[0m")
+                  return p
+          raise FileNotFoundError(
+              f"No npc_team directory found. Searched:\n"
+              + "\n".join(f"  - {c}" for c in candidates)
+              + "\n\nCreate a local npc_team/ or ensure ~/.npcsh/npc_team exists."
+          )
+
+      _direct_target = (context.get('target') or '').strip().lower()
+      _direct = bool(_direct_target) or not sys.stdin.isatty()
+
+      if _direct:
+          # Direct build: target passed explicitly or non-interactive
+          try:
+              from npcpy.build_funcs import (
+                  build_flask_server as _bf,
+                  build_docker_compose as _bd,
+                  build_cli_executable as _bc,
+                  build_static_site as _bs,
+              )
+              _target = _direct_target or 'flask'
+              _builders = {'flask': _bf, 'docker': _bd, 'cli': _bc, 'static': _bs}
+              if _target not in _builders:
+                  context['output'] = f"Unknown target: {_target}. Available: {list(_builders.keys())}"
+              else:
+                  _cfg = {
+                      'team_path': _resolve_team_path(context.get('team')),
+                      'output_dir': os.path.abspath(os.path.expanduser(context.get('outdir') or './build')),
+                      'target': _target,
+                      'port': int(context.get('port') or 5337),
+                      'cors_origins': [c.strip() for c in (context.get('cors') or '').split(',') if c.strip()] or None,
+                  }
+                  _r = _builders[_target](_cfg)
+                  context['output'] = _r.get('output', 'Build complete.')
+          except ImportError:
+              context['output'] = "Build functions not available. Install npcpy with build support."
+          except Exception as _e:
+              context['output'] = f"Build failed: {_e}"
+          context['messages'] = context.get('messages', [])
+          exit()
+
+      try:
+          from npcpy.build_funcs import (
+              build_flask_server,
+              build_docker_compose,
+              build_cli_executable,
+              build_static_site,
+          )
+          BUILD_AVAILABLE = True
+      except ImportError:
+          BUILD_AVAILABLE = False
+
+      if not BUILD_AVAILABLE:
+          context['output'] = "Build functions not available. Install npcpy with build support."
+          exit()
+
+      # ========== State ==========
+      class BuildState:
+          def __init__(self):
+              self.phase = 0  # 0=select target, 1=configure, 2=building, 3=result
+              self.sel = 0
+              self.targets = [
+                  {'key': 'flask',  'name': 'Flask Server',  'desc': 'Standalone Python web server with NPC API endpoints'},
+                  {'key': 'docker', 'name': 'Docker',        'desc': 'Containerized deployment with Dockerfile and docker-compose'},
+                  {'key': 'cli',    'name': 'CLI Scripts',   'desc': 'Per-NPC executable scripts for direct CLI usage'},
+                  {'key': 'static', 'name': 'Static Site',   'desc': 'HTML documentation page listing team NPCs'},
+              ]
+              try:
+                  _resolved_team = _resolve_team_path(context.get('team'))
+              except FileNotFoundError:
+                  _resolved_team = os.path.expanduser(context.get('team') or './npc_team')
+              self.config = {
+                  'outdir': os.path.expanduser(context.get('outdir') or './build'),
+                  'team': _resolved_team,
+                  'port': str(context.get('port') or 5337),
+                  'cors': context.get('cors') or '',
+              }
+              self.config_keys = ['outdir', 'team', 'port', 'cors']
+              self.config_labels = {'outdir': 'Output Dir', 'team': 'Team Path', 'port': 'Port', 'cors': 'CORS Origins'}
+              self.config_sel = 0
+              self.editing = False
+              self.edit_buf = ""
+              self.edit_key = ""
+              self.result = ""
+              self.error = ""
+              self.files_created = []
+
+      ui = BuildState()
+
+      # TUI mode: no target was passed, user picks interactively
+
+      # ========== Helpers ==========
+      def get_size():
+          try:
+              s = os.get_terminal_size()
+              return s.columns, s.lines
+          except:
+              return 80, 24
+
+      # ========== Rendering ==========
+      def render():
+          width, height = get_size()
+          out = []
+          out.append('\033[2J\033[H')
+
+          phase_names = ['Select Target', 'Configure', 'Building...', 'Complete']
+          header = f' NPC BUILD - {phase_names[ui.phase]} '
+          out.append(f'\033[1;1H\033[7;1m{header.ljust(width)}\033[0m')
+
+          if ui.phase == 0:
+              render_targets(out, width, height)
+          elif ui.phase == 1:
+              render_config(out, width, height)
+          elif ui.phase == 2:
+              render_building(out, width, height)
+          elif ui.phase == 3:
+              render_result(out, width, height)
+
+          if ui.error:
+              out.append(f'\033[{height-1};1H\033[K \033[31m{ui.error[:width-3]}\033[0m')
+
+          sys.stdout.write(''.join(out))
+          sys.stdout.flush()
+
+      def render_targets(out, width, height):
+          banner = [
+              '\033[33m ██████╗ ██╗   ██╗██╗██╗     ██████╗ \033[0m',
+              '\033[33m██╔══██╗██║   ██║██║██║     ██╔══██╗\033[0m',
+              '\033[33m██████╔╝██║   ██║██║██║     ██║  ██║\033[0m',
+              '\033[33m██╔══██╗██║   ██║██║██║     ██║  ██║\033[0m',
+              '\033[33m██████╔╝╚██████╔╝██║███████╗██████╔╝\033[0m',
+              '\033[33m╚═════╝  ╚═════╝ ╚═╝╚══════╝╚═════╝ \033[0m',
+          ]
+          for i, line in enumerate(banner):
+              out.append(f'\033[{3+i};3H{line}')
+
+          y = 3 + len(banner) + 1
+          out.append(f'\033[{y};3H\033[1mSelect a build target:\033[0m')
+          y += 2
+
+          for i, target in enumerate(ui.targets):
+              selected = (i == ui.sel)
+              if selected:
+                  out.append(f'\033[{y};2H\033[7;1m > {target["name"]:<20}\033[0m \033[7m{target["desc"][:width-28]}\033[0m')
+              else:
+                  out.append(f'\033[{y};2H   \033[1m{target["name"]:<20}\033[0m \033[90m{target["desc"][:width-28]}\033[0m')
+              y += 2
+
+          out.append(f'\033[{height};1H\033[K\033[7m j/k:Navigate  Enter:Select  q:Quit \033[0m'.ljust(width))
+
+      def render_config(out, width, height):
+          target = ui.targets[ui.sel]
+          out.append(f'\033[3;3H\033[1mTarget: \033[36m{target["name"]}\033[0m')
+          out.append(f'\033[4;3H\033[90m{target["desc"]}\033[0m')
+
+          out.append(f'\033[6;3H\033[1mConfiguration:\033[0m')
+
+          y = 8
+          for i, key in enumerate(ui.config_keys):
+              label = ui.config_labels[key]
+              val = ui.config[key]
+              selected = (i == ui.config_sel)
+
+              if ui.editing and key == ui.edit_key:
+                  out.append(f'\033[{y};3H\033[33m{label}:\033[0m \033[7m {ui.edit_buf}_ \033[0m')
+              elif selected:
+                  out.append(f'\033[{y};3H\033[7m {label}: {val} \033[0m')
+              else:
+                  out.append(f'\033[{y};3H \033[1m{label}:\033[0m {val}')
+              y += 2
+
+          # Show which configs are relevant for this target
+          y += 1
+          relevant = {'flask': ['outdir', 'team', 'port', 'cors'],
+                      'docker': ['outdir', 'team', 'port', 'cors'],
+                      'cli': ['outdir', 'team'],
+                      'static': ['outdir', 'team']}
+          rel = relevant.get(target['key'], ui.config_keys)
+          out.append(f'\033[{y};3H\033[90mRelevant for {target["name"]}: {", ".join(rel)}\033[0m')
+
+          if ui.editing:
+              out.append(f'\033[{height};1H\033[K\033[7m Enter:Save  Esc:Cancel \033[0m'.ljust(width))
+          else:
+              out.append(f'\033[{height};1H\033[K\033[7m j/k:Navigate  e:Edit  Enter:Build  Backspace:Back  q:Quit \033[0m'.ljust(width))
+
+      def render_building(out, width, height):
+          target = ui.targets[ui.sel]
+          mid = height // 2
+          out.append(f'\033[{mid};{width//2-10}H\033[33;1mBuilding {target["name"]}...\033[0m')
+
+      def render_result(out, width, height):
+          target = ui.targets[ui.sel]
+          y = 3
+          if ui.error:
+              out.append(f'\033[{y};3H\033[31;1mBuild Failed\033[0m')
+              y += 2
+              out.append(f'\033[{y};3H\033[31m{ui.error[:width-6]}\033[0m')
+          else:
+              out.append(f'\033[{y};3H\033[32;1mBuild Complete: {target["name"]}\033[0m')
+              y += 2
+              for line in ui.result.split('\n'):
+                  if y >= height - 3:
+                      break
+                  out.append(f'\033[{y};3H{line[:width-6]}')
+                  y += 1
+
+          out.append(f'\033[{height};1H\033[K\033[7m Enter:New Build  o:Open output dir  q:Quit \033[0m'.ljust(width))
+
+      # ========== Build Execution ==========
+      def do_build():
+          target = ui.targets[ui.sel]
+          config = {
+              'team_path': _resolve_team_path(ui.config['team']),
+              'output_dir': os.path.abspath(os.path.expanduser(ui.config['outdir'])),
+              'target': target['key'],
+              'port': int(ui.config['port']),
+              'cors_origins': [c.strip() for c in ui.config['cors'].split(',') if c.strip()] or None,
+          }
+
+          builders = {
+              'flask': build_flask_server,
+              'docker': build_docker_compose,
+              'cli': build_cli_executable,
+              'static': build_static_site,
+          }
+
+          try:
+              result = builders[target['key']](config)
+              ui.result = result.get('output', 'Build complete.')
+              ui.error = ""
+          except Exception as e:
+              ui.error = str(e)
+              ui.result = ""
+
+          ui.phase = 3
+
+      # ========== Input ==========
+      def handle_input(c, fd):
+          if ui.editing:
+              return handle_edit(c, fd)
+
+          if c == '\x1b':
+              if _sel.select([fd], [], [], 0.05)[0]:
+                  c2 = os.read(fd, 1).decode('latin-1')
+                  if c2 == '[':
+                      c3 = os.read(fd, 1).decode('latin-1')
+                      if c3 == 'A': move_up()
+                      elif c3 == 'B': move_down()
+              return True
+
+          if c == 'q' or c == '\x03':
+              return False
+
+          if ui.phase == 0:
+              if c == 'j': move_down()
+              elif c == 'k': move_up()
+              elif c in ('\r', '\n'):
+                  ui.phase = 1
+                  ui.config_sel = 0
+          elif ui.phase == 1:
+              if c == 'j': move_down()
+              elif c == 'k': move_up()
+              elif c == 'e':
+                  key = ui.config_keys[ui.config_sel]
+                  ui.editing = True
+                  ui.edit_key = key
+                  ui.edit_buf = ui.config[key]
+              elif c == '\x7f' or c == '\x08':
+                  ui.phase = 0
+                  ui.config_sel = 0
+              elif c in ('\r', '\n'):
+                  ui.phase = 2
+                  render()
+                  do_build()
+          elif ui.phase == 3:
+              if c in ('\r', '\n'):
+                  ui.phase = 0
+                  ui.sel = 0
+                  ui.error = ""
+                  ui.result = ""
+              elif c == 'o':
+                  outdir = os.path.abspath(os.path.expanduser(ui.config['outdir']))
+                  if os.path.isdir(outdir):
+                      import subprocess
+                      try:
+                          subprocess.Popen(['xdg-open', outdir], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                      except:
+                          pass
+          return True
+
+      def handle_edit(c, fd):
+          if c == '\x1b':
+              if _sel.select([fd], [], [], 0.05)[0]:
+                  os.read(fd, 2)
+              ui.editing = False
+              ui.edit_buf = ""
+              return True
+          if c in ('\r', '\n'):
+              ui.config[ui.edit_key] = ui.edit_buf
+              ui.editing = False
+              return True
+          if c == '\x7f' or c == '\x08':
+              ui.edit_buf = ui.edit_buf[:-1]
+              return True
+          if c >= ' ' and c <= '~':
+              ui.edit_buf += c
+          return True
+
+      def move_up():
+          if ui.phase == 0:
+              ui.sel = max(0, ui.sel - 1)
+          elif ui.phase == 1:
+              ui.config_sel = max(0, ui.config_sel - 1)
+
+      def move_down():
+          if ui.phase == 0:
+              ui.sel = min(len(ui.targets) - 1, ui.sel + 1)
+          elif ui.phase == 1:
+              ui.config_sel = min(len(ui.config_keys) - 1, ui.config_sel + 1)
+
+      # ========== Main Loop ==========
+      fd = sys.stdin.fileno()
+      old_settings = termios.tcgetattr(fd)
+
+      try:
+          tty.setcbreak(fd)
+          sys.stdout.write('\033[?25l')
+          render()
+
+          running = True
+          while running:
+              if _sel.select([fd], [], [], 0.5)[0]:
+                  c = os.read(fd, 1).decode('latin-1')
+                  running = handle_input(c, fd)
+              render()
+      finally:
+          termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
+          sys.stdout.write('\033[?25h\033[2J\033[H')
+          sys.stdout.flush()
+
+      if ui.result:
+          print(ui.result)
+
+      context['output'] = ui.result or 'Build cancelled.'
+      context['messages'] = context.get('messages', [])