npcsh 1.1.19__tar.gz → 1.1.21__tar.gz

{npcsh-1.1.19/npcsh.egg-info → npcsh-1.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.1.19
+Version: 1.1.21
 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
@@ -108,7 +108,7 @@ Dynamic: summary
 
 # npcsh
 
-The NPC shell (`npcsh`) makes the most of multi-modal LLMs and agents through a powerful set of simple slash  commands and novel interactive modes, all from the comfort of the command line. Build teams of agents and schedule them on jobs, engineer context, and design custom interaction modes and Jinja Execution templates (Jinxs for you and your agents to invoke, all managed scalably for organizations of any size through the NPC data layer.
+The NPC shell (`npcsh`) makes the most of multi-modal LLMs and agents through a powerful set of simple slash  commands and novel interactive modes, all from the comfort of the command line. Build teams of agents and schedule them on jobs, engineer context, and design custom interaction modes and Jinja Execution templates (Jinxs for you and your agents to invoke, all managed scalably for organizations of any size through the NPC  data layer.
 
 To get started:
 For users who want to mainly use models through APIs (`ollama`, `gemini`, `kimi`, `grok`, `deepseek`, `anthropic`, `openai`, `mistral`, or any others provided by litellm )

{npcsh-1.1.19 → npcsh-1.1.21}/README.md

@@ -5,7 +5,7 @@
 
 # npcsh
 
-The NPC shell (`npcsh`) makes the most of multi-modal LLMs and agents through a powerful set of simple slash  commands and novel interactive modes, all from the comfort of the command line. Build teams of agents and schedule them on jobs, engineer context, and design custom interaction modes and Jinja Execution templates (Jinxs for you and your agents to invoke, all managed scalably for organizations of any size through the NPC data layer.
+The NPC shell (`npcsh`) makes the most of multi-modal LLMs and agents through a powerful set of simple slash  commands and novel interactive modes, all from the comfort of the command line. Build teams of agents and schedule them on jobs, engineer context, and design custom interaction modes and Jinja Execution templates (Jinxs for you and your agents to invoke, all managed scalably for organizations of any size through the NPC  data layer.
 
 To get started:
 For users who want to mainly use models through APIs (`ollama`, `gemini`, `kimi`, `grok`, `deepseek`, `anthropic`, `openai`, `mistral`, or any others provided by litellm )

{npcsh-1.1.19 → npcsh-1.1.21}/npcsh/_state.py

@@ -2760,15 +2760,19 @@ def process_pipeline_command(
     if cmd_to_process.startswith("/"):
         command_name = cmd_to_process.split()[0].lstrip('/')
         
-        # Check if this is an interactive mode by looking for the jinx file in modes/
+        # Check if this is an interactive mode
         is_interactive_mode = False
-        
-        # Check global modes
-        global_modes_jinx = os.path.expanduser(f'~/.npcsh/npc_team/jinxs/modes/{command_name}.jinx')
-        if os.path.exists(global_modes_jinx):
+
+        # Check if the jinx declares interactive: true
+        if router.is_interactive(command_name):
             is_interactive_mode = True
-        
-        # Check team modes
+
+        # Also check modes/ directory (legacy)
+        if not is_interactive_mode:
+            global_modes_jinx = os.path.expanduser(f'~/.npcsh/npc_team/jinxs/modes/{command_name}.jinx')
+            if os.path.exists(global_modes_jinx):
+                is_interactive_mode = True
+
         if not is_interactive_mode and state.team and state.team.team_path:
             team_modes_jinx = os.path.join(state.team.team_path, 'jinxs', 'modes', f'{command_name}.jinx')
             if os.path.exists(team_modes_jinx):
@@ -3440,9 +3444,9 @@ def setup_shell() -> Tuple[CommandHistory, Team, Optional[NPC]]:
     command_history = CommandHistory(db_path)
 
     if not is_npcsh_initialized():
-        print("Initializing NPCSH...")
+        print("Setting up npcsh for first use...")
         initialize_base_npcs_if_needed(db_path)
-        print("NPCSH initialization complete. Restart or source ~/.npcshrc.")
+        print("Setup complete.")
 
     try:
         setup_readline()
@@ -3454,80 +3458,17 @@ def setup_shell() -> Tuple[CommandHistory, Team, Optional[NPC]]:
     project_team_path = os.path.abspath(PROJECT_NPC_TEAM_PATH)
     global_team_path = os.path.expanduser(DEFAULT_NPC_TEAM_PATH)
 
-    team_dir = None
-    default_forenpc_name = None
-    global_team_path = os.path.expanduser(DEFAULT_NPC_TEAM_PATH)
     if not os.path.exists(global_team_path):
-        print("Global NPC team directory doesn't exist. Initializing...")
         initialize_base_npcs_if_needed(db_path)
     if os.path.exists(project_team_path):
         team_dir = project_team_path
         default_forenpc_name = "forenpc"
     else:
-        if not os.path.exists('.npcsh_global'):
-            try:
-                resp = input(f"No npc_team found in {os.getcwd()}. Create a new team here? [Y/n]: ").strip().lower()
-            except (KeyboardInterrupt, EOFError):
-                print("\nAborted.")
-                sys.exit(0)
-            if resp in ("", "y", "yes"):
-                team_dir = project_team_path
-                os.makedirs(team_dir, exist_ok=True)
-                default_forenpc_name = "forenpc"
-                try:
-                    forenpc_directive = input(
-                        f"Enter a primary directive for {default_forenpc_name} (default: 'You are the forenpc of the team...'): "
-                    ).strip() or "You are the forenpc of the team, coordinating activities between NPCs on the team, verifying that results from NPCs are high quality and can help to adequately answer user requests."
-                    forenpc_model = input("Enter a model for your forenpc (default: llama3.2): ").strip() or "llama3.2"
-                    forenpc_provider = input("Enter a provider for your forenpc (default: ollama): ").strip() or "ollama"
-                except (KeyboardInterrupt, EOFError):
-                    print("\nAborted.")
-                    sys.exit(0)
-
-                with open(os.path.join(team_dir, f"{default_forenpc_name}.npc"), "w") as f:
-                    yaml.dump({
-                        "name": default_forenpc_name, "primary_directive": forenpc_directive,
-                        "model": forenpc_model, "provider": forenpc_provider
-                    }, f)
-
-                ctx_path = os.path.join(team_dir, "team.ctx")
-                try:
-                    folder_context = input("Enter a short description for this project/team (optional): ").strip()
-                    team_ctx_data = {
-                        "forenpc": default_forenpc_name,
-                        "model": forenpc_model,
-                        "provider": forenpc_provider,
-                        "context": folder_context if folder_context else None
-                    }
-                    use_jinxs = input("Use global jinxs folder (g) or copy to this project (c)? [g/c, default: g]: ").strip().lower()
-                except (KeyboardInterrupt, EOFError):
-                    print("\nAborted.")
-                    sys.exit(0)
-                if use_jinxs == "c":
-                    global_jinxs_dir = os.path.expanduser("~/.npcsh/npc_team/jinxs")
-                    if os.path.exists(global_jinxs_dir):
-                        # Create the 'jinxs' subfolder within the new team's directory
-                        destination_jinxs_dir = os.path.join(team_dir, "jinxs")
-                        os.makedirs(destination_jinxs_dir, exist_ok=True)
-                        shutil.copytree(global_jinxs_dir, destination_jinxs_dir, dirs_exist_ok=True)
-                else:
-                    team_ctx_data["use_global_jinxs"] = True
-                with open(ctx_path, "w") as f:
-                    yaml.dump(team_ctx_data, f)
-            else:
-                render_markdown('From now on, npcsh will assume you will use the global team when activating from this folder. \n If you change your mind and want to initialize a team, use /init from within npcsh, `npc init` or `rm .npcsh_global` from the current working directory.')
-                with open(".npcsh_global", "w") as f:
-                    pass
-                team_dir = global_team_path
-                default_forenpc_name = "sibiji"
-        else:
-            team_dir = global_team_path
-            default_forenpc_name = "sibiji"
-    
-    if team_dir is None:
+        # No project team in this directory - use global team.
+        # To create a project team, use /init from within npcsh or `npc init`.
         team_dir = global_team_path
         default_forenpc_name = "sibiji"
-    
+
     if not os.path.exists(team_dir):
         print(f"Creating team directory: {team_dir}")
         os.makedirs(team_dir, exist_ok=True)
@@ -3544,11 +3485,8 @@ def setup_shell() -> Tuple[CommandHistory, Team, Optional[NPC]]:
     forenpc_name = team_ctx.get("forenpc", default_forenpc_name)
     if forenpc_name is None:
         forenpc_name = "sibiji"
-  
-    print('forenpc_name:', forenpc_name)
 
     forenpc_path = os.path.join(team_dir, f"{forenpc_name}.npc")
-    print('forenpc_path:', forenpc_path)
 
     team = Team(team_path=team_dir, db_conn=command_history.engine)
     

{npcsh-1.1.19 → npcsh-1.1.21}/npcsh/diff_viewer.py

@@ -6,7 +6,7 @@ import os
 import sys
 import difflib
 from dataclasses import dataclass, field
-from typing import List, Dict, Optional, Tuple
+from typing import List, Dict, Tuple
 from enum import Enum
 
 # Platform-specific imports
@@ -324,8 +324,8 @@ class DiffViewer:
                 start = hunk.start_original - 1 + offset
 
                 # Count removals and additions in this hunk
-                removals = [l[1:] for l in hunk.lines if l.startswith('-')]
-                additions = [l[1:] for l in hunk.lines if l.startswith('+')]
+                removals = [ln[1:] for ln in hunk.lines if ln.startswith('-')]
+                additions = [ln[1:] for ln in hunk.lines if ln.startswith('+')]
 
                 # Remove old lines
                 del result_lines[start:start + len(removals)]

npcsh-1.1.21/npcsh/npc_team/jinxs/lib/core/compress.jinx

@@ -0,0 +1,428 @@
+jinx_name: "compress"
+description: "Manages conversation and knowledge context - compress, flush, sleep, dream"
+interactive: true
+inputs:
+- flush: ""
+- sleep: False
+- dream: False
+- ops: ""
+- model: ""
+- provider: ""
+steps:
+  - name: "manage_context_and_memory"
+    engine: "python"
+    code: |
+      import os
+      import sys
+      import traceback
+      from npcpy.llm_funcs import breathe
+      from npcpy.memory.command_history import CommandHistory, load_kg_from_db, save_kg_to_db
+      from npcpy.memory.knowledge_graph import kg_sleep_process, kg_dream_process
+
+      # --- Get all inputs from context ---
+      flush_n_str = context.get('flush')
+      is_sleeping = context.get('sleep')
+      is_dreaming = context.get('dream')
+      operations_str = context.get('ops')
+      llm_model = context.get('model')
+      llm_provider = context.get('provider')
+      output_messages = context.get('messages', [])
+
+      # --- Detect if called with explicit flags ---
+      is_flushing = flush_n_str is not None and str(flush_n_str).strip() != ''
+      has_explicit_args = is_flushing or is_sleeping or is_dreaming
+
+      # ========== Execution Functions ==========
+      def do_compress():
+          """Compact conversation context via breathe()"""
+          try:
+              result = breathe(**context)
+              if isinstance(result, dict):
+                  return result.get('output', 'Context compressed.')
+              return "Context compression process initiated."
+          except Exception as e:
+              traceback.print_exc()
+              return "Error during context compression: " + str(e)
+
+      def do_flush(n):
+          """Remove last N messages from context"""
+          messages_list = list(output_messages)
+          original_len = len(messages_list)
+          if messages_list and messages_list[0].get("role") == "system":
+              system_message = messages_list.pop(0)
+              num_to_remove = min(n, len(messages_list))
+              final_messages = [system_message] + messages_list[:-num_to_remove] if num_to_remove < len(messages_list) else [system_message]
+          else:
+              num_to_remove = min(n, original_len)
+              final_messages = messages_list[:-num_to_remove] if num_to_remove < original_len else []
+          removed_count = original_len - len(final_messages)
+          context['messages'] = final_messages
+          return "Flushed " + str(removed_count) + " message(s). Context is now " + str(len(final_messages)) + " messages."
+
+      def do_sleep(model, provider, ops_str, dream=False):
+          """Evolve knowledge graph via sleep/dream"""
+          current_npc = context.get('npc')
+          current_team = context.get('team')
+          operations_config = [op.strip() for op in ops_str.split(',')] if ops_str else None
+          if not model and current_npc: model = current_npc.model
+          if not provider and current_npc: provider = current_npc.provider
+          if not model: model = state.chat_model if state else "llama3.2"
+          if not provider: provider = state.chat_provider if state else "ollama"
+          team_name = current_team.name if current_team else "__none__"
+          npc_name = current_npc.name if current_npc else "__none__"
+          current_path = os.getcwd()
+          scope_str = "Team: '" + team_name + "', NPC: '" + npc_name + "', Path: '" + current_path + "'"
+          command_history = None
+          try:
+              db_path = os.getenv("NPCSH_DB_PATH", os.path.expanduser("~/npcsh_history.db"))
+              command_history = CommandHistory(db_path)
+              engine = command_history.engine
+              current_kg = load_kg_from_db(engine, team_name, npc_name, current_path)
+              if not current_kg or not current_kg.get('facts'):
+                  return "Knowledge graph for the current scope is empty. Nothing to process.\n- Scope: " + scope_str
+              original_facts = len(current_kg.get('facts', []))
+              original_concepts = len(current_kg.get('concepts', []))
+              evolved_kg, _ = kg_sleep_process(existing_kg=current_kg, model=model, provider=provider, npc=current_npc, operations_config=operations_config)
+              process_type = "Sleep"
+              if dream:
+                  evolved_kg, _ = kg_dream_process(existing_kg=evolved_kg, model=model, provider=provider, npc=current_npc)
+                  process_type += " & Dream"
+              save_kg_to_db(engine, evolved_kg, team_name, npc_name, current_path)
+              new_facts = len(evolved_kg.get('facts', []))
+              new_concepts = len(evolved_kg.get('concepts', []))
+              return (process_type + " process complete.\n"
+                      "- Facts: " + str(original_facts) + " -> " + str(new_facts) + " (" + str(new_facts - original_facts) + ")\n"
+                      "- Concepts: " + str(original_concepts) + " -> " + str(new_concepts) + " (" + str(new_concepts - original_concepts) + ")")
+          except Exception as e:
+              traceback.print_exc()
+              return "Error during KG evolution: " + str(e)
+          finally:
+              if command_history: command_history.close()
+
+      # ========== Direct execution (flags provided) ==========
+      if has_explicit_args:
+          if is_sleeping and is_flushing:
+              context['output'] = "Error: --sleep and --flush are mutually exclusive."
+              context['messages'] = output_messages
+          elif is_sleeping:
+              context['output'] = do_sleep(llm_model, llm_provider, operations_str, dream=bool(is_dreaming))
+              context['messages'] = output_messages
+          elif is_flushing:
+              try:
+                  n = int(flush_n_str)
+                  if n <= 0:
+                      context['output'] = "Error: Number of messages to flush must be positive."
+                  else:
+                      context['output'] = do_flush(n)
+              except ValueError:
+                  context['output'] = "Error: Invalid number '" + str(flush_n_str) + "'."
+
+      # ========== Interactive TUI (no flags) ==========
+      elif sys.stdin.isatty():
+          import tty
+          import termios
+          import select as _sel
+
+          class CompressState:
+              def __init__(self):
+                  self.actions = [
+                      {'name': 'Compress', 'desc': 'Compact conversation context (breathe)', 'key': 'compress'},
+                      {'name': 'Flush', 'desc': 'Remove last N messages from context', 'key': 'flush'},
+                      {'name': 'Sleep', 'desc': 'Evolve knowledge graph', 'key': 'sleep'},
+                      {'name': 'Sleep + Dream', 'desc': 'Evolve KG with creative synthesis', 'key': 'dream'},
+                  ]
+                  self.sel = 0
+                  self.mode = 'menu'  # menu, params, editing, running
+                  # Params for each action
+                  self.flush_n = "5"
+                  self.sleep_model = ""
+                  self.sleep_provider = ""
+                  self.sleep_ops = ""
+                  self.status = "Select an action"
+                  self.msg_count = len(output_messages)
+                  # Param editing
+                  self.param_sel = 0
+                  self.edit_buf = ""
+                  self.edit_cursor = 0
+
+              def get_params(self):
+                  """Return list of (label, value) for current action"""
+                  key = self.actions[self.sel]['key']
+                  if key == 'compress':
+                      return [('Messages in context', str(self.msg_count), False)]
+                  elif key == 'flush':
+                      return [
+                          ('Messages to flush', self.flush_n, True),
+                          ('Messages in context', str(self.msg_count), False),
+                      ]
+                  elif key == 'sleep':
+                      return [
+                          ('Model', self.sleep_model or '(default)', True),
+                          ('Provider', self.sleep_provider or '(default)', True),
+                          ('Operations', self.sleep_ops or '(all)', True),
+                      ]
+                  elif key == 'dream':
+                      return [
+                          ('Model', self.sleep_model or '(default)', True),
+                          ('Provider', self.sleep_provider or '(default)', True),
+                          ('Operations', self.sleep_ops or '(all)', True),
+                      ]
+                  return []
+
+              def set_param(self, idx, val):
+                  key = self.actions[self.sel]['key']
+                  if key == 'flush':
+                      if idx == 0: self.flush_n = val
+                  elif key in ('sleep', 'dream'):
+                      if idx == 0: self.sleep_model = val
+                      elif idx == 1: self.sleep_provider = val
+                      elif idx == 2: self.sleep_ops = val
+
+          st = CompressState()
+
+          def get_size():
+              try:
+                  s = os.get_terminal_size()
+                  return s.columns, s.lines
+              except:
+                  return 80, 24
+
+          def render():
+              width, height = get_size()
+              out = []
+              out.append("\033[H")
+
+              # Header
+              header = " COMPRESS - Context & Memory Manager "
+              out.append("\033[1;1H\033[7;1m" + header.ljust(width) + "\033[0m")
+
+              if st.mode == 'menu':
+                  out.append("\033[3;1H\033[36;1m Actions \033[90m" + ("-" * (width - 11)) + "\033[0m")
+                  for i, act in enumerate(st.actions):
+                      row = 4 + i
+                      out.append("\033[" + str(row) + ";1H\033[K")
+                      line = "  " + act['name'].ljust(18) + "\033[90m" + act['desc'][:width-24] + "\033[0m"
+                      if i == st.sel:
+                          out.append("\033[7m>" + line + "\033[0m")
+                      else:
+                          out.append(" " + line)
+
+                  # Show params preview below
+                  params = st.get_params()
+                  param_start = 4 + len(st.actions) + 1
+                  out.append("\033[" + str(param_start) + ";1H\033[33;1m Parameters \033[90m" + ("-" * (width - 14)) + "\033[0m")
+                  for j, (label, val, editable) in enumerate(params):
+                      row = param_start + 1 + j
+                      out.append("\033[" + str(row) + ";1H\033[K")
+                      marker = "[e]" if editable else "   "
+                      out.append("  " + label.ljust(22) + val[:width-30] + "  \033[90m" + marker + "\033[0m")
+
+                  # Clear remaining lines
+                  clear_start = param_start + 1 + len(params)
+                  for r in range(clear_start, height - 2):
+                      out.append("\033[" + str(r) + ";1H\033[K")
+
+              elif st.mode == 'params':
+                  params = st.get_params()
+                  act = st.actions[st.sel]
+                  out.append("\033[3;1H\033[36;1m " + act['name'] + " Parameters \033[90m" + ("-" * (width - len(act['name']) - 16)) + "\033[0m")
+                  for j, (label, val, editable) in enumerate(params):
+                      row = 4 + j
+                      out.append("\033[" + str(row) + ";1H\033[K")
+                      if st.mode == 'editing' and j == st.param_sel:
+                          line = "  " + label.ljust(22) + "\033[7m " + st.edit_buf + " \033[0m"
+                      else:
+                          marker = " [e]" if editable else ""
+                          line = "  " + label.ljust(22) + val[:width-30] + "\033[90m" + marker + "\033[0m"
+                      if j == st.param_sel:
+                          out.append("\033[7m>" + line + "\033[0m")
+                      else:
+                          out.append(" " + line)
+
+                  clear_start = 4 + len(params)
+                  for r in range(clear_start, height - 2):
+                      out.append("\033[" + str(r) + ";1H\033[K")
+
+              elif st.mode == 'editing':
+                  # Same as params but with edit field
+                  params = st.get_params()
+                  act = st.actions[st.sel]
+                  out.append("\033[3;1H\033[36;1m " + act['name'] + " Parameters \033[90m" + ("-" * (width - len(act['name']) - 16)) + "\033[0m")
+                  for j, (label, val, editable) in enumerate(params):
+                      row = 4 + j
+                      out.append("\033[" + str(row) + ";1H\033[K")
+                      if j == st.param_sel:
+                          line = "  " + label.ljust(22) + "\033[7m " + st.edit_buf + " \033[0m"
+                          out.append(">" + line)
+                      else:
+                          marker = " [e]" if editable else ""
+                          line = "  " + label.ljust(22) + val[:width-30] + "\033[90m" + marker + "\033[0m"
+                          out.append(" " + line)
+
+                  clear_start = 4 + len(params)
+                  for r in range(clear_start, height - 2):
+                      out.append("\033[" + str(r) + ";1H\033[K")
+
+              elif st.mode == 'running':
+                  out.append("\033[3;1H\033[K")
+                  out.append("\033[4;1H\033[K  Running " + st.actions[st.sel]['name'] + "...")
+                  for r in range(5, height - 2):
+                      out.append("\033[" + str(r) + ";1H\033[K")
+
+              # Status + footer
+              out.append("\033[" + str(height-2) + ";1H\033[K\033[90m" + ("-" * width) + "\033[0m")
+              out.append("\033[" + str(height-1) + ";1H\033[K " + st.status[:width-2])
+
+              if st.mode == 'menu':
+                  footer = " j/k:Nav  Enter:Configure  G:Run Now  q:Quit "
+              elif st.mode == 'params':
+                  footer = " j/k:Nav  e:Edit  Enter:Execute  b:Back  q:Quit "
+              elif st.mode == 'editing':
+                  footer = " Type value  Enter:Confirm  Esc:Cancel "
+              else:
+                  footer = " Running... "
+              out.append("\033[" + str(height) + ";1H\033[K\033[7m" + footer.ljust(width) + "\033[0m")
+
+              sys.stdout.write(''.join(out))
+              sys.stdout.flush()
+
+          def execute_action():
+              """Run the selected action and return result text"""
+              key = st.actions[st.sel]['key']
+              st.mode = 'running'
+              render()
+
+              if key == 'compress':
+                  return do_compress()
+              elif key == 'flush':
+                  try:
+                      n = int(st.flush_n)
+                      if n <= 0:
+                          return "Error: Number must be positive."
+                      return do_flush(n)
+                  except ValueError:
+                      return "Error: Invalid number '" + st.flush_n + "'."
+              elif key == 'sleep':
+                  return do_sleep(st.sleep_model or None, st.sleep_provider or None, st.sleep_ops or None, dream=False)
+              elif key == 'dream':
+                  return do_sleep(st.sleep_model or None, st.sleep_provider or None, st.sleep_ops or None, dream=True)
+              return "Unknown action."
+
+          fd = sys.stdin.fileno()
+          old_settings = termios.tcgetattr(fd)
+          result_text = None
+
+          try:
+              tty.setcbreak(fd)
+              sys.stdout.write('\033[?25l')
+              sys.stdout.write('\033[2J')
+              render()
+
+              running = True
+              while running:
+                  c = os.read(fd, 1).decode('latin-1')
+
+                  if st.mode == 'editing':
+                      if c == '\x1b':
+                          if _sel.select([fd], [], [], 0.05)[0]:
+                              os.read(fd, 2)
+                          st.mode = 'params'
+                      elif c in ('\r', '\n'):
+                          st.set_param(st.param_sel, st.edit_buf)
+                          st.mode = 'params'
+                          st.status = "Parameter updated."
+                      elif c == '\x7f' or c == '\x08':
+                          if st.edit_cursor > 0:
+                              st.edit_buf = st.edit_buf[:st.edit_cursor-1] + st.edit_buf[st.edit_cursor:]
+                              st.edit_cursor -= 1
+                      elif c >= ' ' and c <= '~':
+                          st.edit_buf = st.edit_buf[:st.edit_cursor] + c + st.edit_buf[st.edit_cursor:]
+                          st.edit_cursor += 1
+                      render()
+                      continue
+
+                  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':  # Up
+                                  if st.mode == 'menu':
+                                      st.sel = max(0, st.sel - 1)
+                                  elif st.mode == 'params':
+                                      st.param_sel = max(0, st.param_sel - 1)
+                              elif c3 == 'B':  # Down
+                                  if st.mode == 'menu':
+                                      st.sel = min(len(st.actions) - 1, st.sel + 1)
+                                  elif st.mode == 'params':
+                                      params = st.get_params()
+                                      st.param_sel = min(len(params) - 1, st.param_sel + 1)
+                      else:
+                          if st.mode == 'params':
+                              st.mode = 'menu'
+                              st.status = "Select an action"
+                          else:
+                              result_text = "Cancelled."
+                              running = False
+                      render()
+                      continue
+
+                  if c == 'q' or c == '\x03':
+                      result_text = "Cancelled."
+                      running = False
+                  elif st.mode == 'menu':
+                      if c == 'j':
+                          st.sel = min(len(st.actions) - 1, st.sel + 1)
+                      elif c == 'k':
+                          st.sel = max(0, st.sel - 1)
+                      elif c in ('\r', '\n'):
+                          params = st.get_params()
+                          editable = [p for p in params if p[2]]
+                          if editable:
+                              st.mode = 'params'
+                              st.param_sel = 0
+                              st.status = "Configure parameters, then Enter to execute"
+                          else:
+                              result_text = execute_action()
+                              running = False
+                      elif c == 'G':
+                          result_text = execute_action()
+                          running = False
+                  elif st.mode == 'params':
+                      if c == 'j':
+                          params = st.get_params()
+                          st.param_sel = min(len(params) - 1, st.param_sel + 1)
+                      elif c == 'k':
+                          st.param_sel = max(0, st.param_sel - 1)
+                      elif c == 'e':
+                          params = st.get_params()
+                          if st.param_sel < len(params) and params[st.param_sel][2]:
+                              st.mode = 'editing'
+                              val = params[st.param_sel][1]
+                              st.edit_buf = "" if val.startswith('(') else val
+                              st.edit_cursor = len(st.edit_buf)
+                      elif c == 'b':
+                          st.mode = 'menu'
+                          st.status = "Select an action"
+                      elif c in ('\r', '\n'):
+                          result_text = execute_action()
+                          running = False
+
+                  render()
+
+          finally:
+              termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
+              sys.stdout.write('\033[?25h')
+              sys.stdout.write('\033[2J\033[H')
+              sys.stdout.flush()
+
+          context['output'] = result_text or "Cancelled."
+          if 'messages' not in context:
+              context['messages'] = output_messages
+
+      # ========== Non-interactive fallback ==========
+      else:
+          result = do_compress()
+          context['output'] = result
+          if 'messages' not in context:
+              context['messages'] = output_messages