gemcode 0.3.16__tar.gz → 0.3.18__tar.gz

{gemcode-0.3.16/src/gemcode.egg-info → gemcode-0.3.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.16
+Version: 0.3.18
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License
@@ -179,6 +179,7 @@ Requires-Dist: google-adk>=1.0.0
 Requires-Dist: google-genai>=1.0.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"

{gemcode-0.3.16 → gemcode-0.3.18}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gemcode"
-version = "0.3.16"
+version = "0.3.18"
 description = "Local-first coding agent on Google Gemini + ADK"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -31,6 +31,7 @@ dependencies = [
   "google-genai>=1.0.0",
   "python-dotenv>=1.0.0",
   "rich>=13.0.0",
+  "prompt_toolkit>=3.0.0",
 ]
 
 [project.urls]

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode/agent.py

@@ -151,10 +151,24 @@ You have native deep thinking capability — use it actively:
   - `web_fetch("https://registry.npmjs.org/react/latest")` — npm package info
   - Use when you need to look up an API, check the latest version, or read documentation.
 
-### Planning
+### Reasoning and planning
+- **`think`** — private reasoning scratchpad. Write your analysis, plan, or hypothesis here before acting. Not shown to the user. Use before:
+  - A complex multi-file edit or refactor
+  - A debugging session where you need to trace logic before touching code
+  - Any destructive action (delete, force-push) — think first
+  - Choosing between approaches with real trade-offs
+
 - **`todo_write`** — track work items. Use for any task with 3+ steps.
   - Create at task start, mark completed as you finish, merge updates.
 
+- **`run_subtask`** — spawn an isolated sub-agent with its own fresh context window.
+  - The sub-agent has the same tools (bash, read_file, grep, etc.) but starts from scratch.
+  - Use when a task would bloat your context too much: e.g. "read all 40 test files and find patterns"
+  - Use to parallelize: issue multiple `run_subtask` calls in one turn for concurrent exploration
+  - Use for verification passes: "check all files I edited for consistency and syntax errors"
+  - Always give the sub-agent enough context to operate independently.
+  - End your task prompt with "Summarise your findings clearly." so the result is useful.
+
 ## Multi-step task execution
 One user message = many model↔tool rounds (up to 256 LLM calls by default). This is intentional — you are expected to do complete tasks autonomously.
 
@@ -174,8 +188,25 @@ Issue independent tool calls in the same turn when outputs don't depend on each
 - Reading multiple files simultaneously ✓
 - Grepping for different patterns at once ✓
 - `list_directory` + `glob_files` in parallel ✓
+- Multiple `run_subtask` calls in one turn for parallel sub-agent exploration ✓
 Sequential: when step B needs step A's result.
 
+## Sub-agent delegation (orchestrator-worker pattern)
+Use `run_subtask` when the work is better done in an isolated context:
+- **Context preservation**: offload reading/analysing large areas of the codebase so your own context stays clean and focused on the high-level task.
+- **Parallel exploration**: launch multiple sub-agents simultaneously to research different subsystems ("analyse auth module", "analyse payment module") then synthesise.
+- **Verification**: after completing work, spawn a sub-agent to review it independently — "verify the changes in src/ are syntactically correct and don't break imports."
+- **Deep research**: when you need to exhaustively search something (50+ files, long documentation pages) delegate it rather than polluting the main conversation.
+
+The sub-agent inherits your permission settings and returns its final text as `result`. Treat it as a trusted colleague returning a written summary.
+
+## Evaluator-optimizer loop
+For tasks where quality matters:
+1. Complete the task (execute tools, write code, run commands)
+2. Spawn a verification `run_subtask` or use `bash` to run tests/lint
+3. If verification fails, read the error, fix, re-verify
+4. Report done only when verified
+
 ## Error recovery
 - **Test/build failures**: read the full error, identify the exact line, fix, re-run.
 - **Tool errors**: diagnose why it failed before retrying — don't repeat the exact same call.
@@ -207,9 +238,25 @@ All file tools use paths **relative to the project root** (where GemCode was sta
   return base
 
 
-def build_root_agent(cfg: GemCodeConfig, extra_tools: list | None = None) -> LlmAgent:
-  """Create the root LlmAgent with tools and callbacks (no Runner)."""
-  tools = build_function_tools(cfg)
+def build_root_agent(
+  cfg: GemCodeConfig,
+  extra_tools: list | None = None,
+  *,
+  _tools: list | None = None,
+) -> LlmAgent:
+  """Create the root LlmAgent with tools and callbacks (no Runner).
+
+  Args:
+    cfg: Runtime configuration.
+    extra_tools: Additional tools to append (e.g. modality tools from session_runtime).
+    _tools: Override the entire tool list (used by run_subtask sub-agents to pass a
+            pre-built list that excludes run_subtask itself, preventing recursion).
+            When set, build_function_tools() is NOT called.
+  """
+  if _tools is not None:
+    tools = list(_tools)
+  else:
+    tools = build_function_tools(cfg)
   if getattr(cfg, "enable_memory", False):
     # ADK preload_memory injects retrieved memories into the next llm_request.
     from google.adk.tools import preload_memory

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode/tool_prompt_manifest.py

@@ -108,7 +108,10 @@ Permission policy:
 - session_sticky_hitl={sticky_hitl}: when true, after the user approves **one** tool in this session, further mutating/shell tools may run without re-prompting (set GEMCODE_HITL_STICKY_SESSION=0 to prompt every time).
 
 You may call tools as follows:
-- Session planning: {_fmt_list(planning)}. In-memory task list for this session (no disk writes). Use for non-trivial multi-step work; set merge=true to upsert by id.
+- Session planning / reasoning: {_fmt_list(planning)}.
+  - `todo_write`: in-memory task list (no disk writes). Use for non-trivial multi-step work; merge=true to upsert by id.
+  - `think`: private scratchpad — write reasoning/analysis before risky or complex actions. Not shown to user.
+  - `run_subtask(task, context)`: spawn an isolated sub-agent to handle context-heavy work in parallel or in sequence. Sub-agent inherits your permissions and returns its final text as `result`. Exclude run_subtask from sub-agent by design (no recursion).
 - Read-only tools: {_fmt_list(read_only)}.
   Use these proactively to locate files and code before asking the user for paths.
 - Mutating tools (WRITE/EDIT/DELETE): {_fmt_list(mutating)}.

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode/tool_registry.py

@@ -36,7 +36,9 @@ MUTATING_TOOLS: frozenset[str] = frozenset(
 SHELL_TOOLS: frozenset[str] = frozenset({"run_command", "bash"})
 
 # Session planning only (no disk / shell; no extra permission)
-PLANNING_TOOLS: frozenset[str] = frozenset({"todo_write"})
+# think — in-context reasoning scratchpad (no-op, no side effects)
+# run_subtask — spawns a sub-agent; inherits parent permission settings
+PLANNING_TOOLS: frozenset[str] = frozenset({"todo_write", "think", "run_subtask"})
 
 ToolConcurrency = Literal["parallel_safe", "serial_mutating", "shell"]
 

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode/tools/__init__.py

@@ -8,20 +8,25 @@ from gemcode.tools.edit import make_edit_tools
 from gemcode.tools.filesystem import make_filesystem_tools
 from gemcode.tools.search import make_grep_tool
 from gemcode.tools.shell import make_run_command
+from gemcode.tools.subtask import make_run_subtask_tool
+from gemcode.tools.think import make_think_tool
 from gemcode.tools.todo import make_todo_tool
 from gemcode.tools.web import make_web_fetch_tool
 
 
-def build_function_tools(cfg: GemCodeConfig) -> list:
+def build_function_tools(cfg: GemCodeConfig, *, include_subtask: bool = True) -> list:
   read_file, list_directory, glob_files, delete_file, move_file = make_filesystem_tools(cfg)
   grep_content = make_grep_tool(cfg)
   run_command = make_run_command(cfg)
   bash = make_bash_tool(cfg)
   write_file, search_replace = make_edit_tools(cfg)
   todo_write = make_todo_tool(cfg)
+  think = make_think_tool()
   web_fetch = make_web_fetch_tool()
-  return [
+
+  tools = [
     todo_write,
+    think,
     read_file,
     list_directory,
     glob_files,
@@ -34,3 +39,9 @@ def build_function_tools(cfg: GemCodeConfig) -> list:
     delete_file,
     web_fetch,
   ]
+
+  # run_subtask is excluded when building sub-agent tools (prevents recursion).
+  if include_subtask:
+    tools.append(make_run_subtask_tool(cfg))
+
+  return tools

gemcode-0.3.18/src/gemcode/tools/subtask.py

@@ -0,0 +1,137 @@
+"""
+Sub-agent tool — spawn an isolated focused agent for context-heavy tasks.
+
+Analogous to OpenClaude's AgentTool / AI SDK's ToolLoopAgent subagent pattern.
+
+Key insight (from AI SDK docs "Subagents"):
+  "Some tasks require exploring large amounts of information — reading files,
+   searching codebases, or researching topics. Running these in the main agent
+   consumes context quickly, making the agent less coherent over time.
+   With subagents, you can spin up a dedicated agent that uses hundreds of
+   thousands of tokens and have it return only a focused summary."
+
+The sub-agent:
+- Gets the same tools as the parent (read_file, bash, grep, etc.) EXCEPT
+  run_subtask itself (prevents infinite recursion).
+- Uses an in-memory session (no DB writes, fully isolated).
+- Respects the same permission settings (yes_to_all, permission_mode) as the parent.
+- Is depth-capped (max 48 LLM calls) to prevent runaway cost.
+"""
+
+from __future__ import annotations
+
+from gemcode.config import GemCodeConfig
+
+
+def make_run_subtask_tool(cfg: GemCodeConfig):
+    async def run_subtask(task: str, context: str = "") -> dict:
+        """
+        Spawn an isolated sub-agent to complete a focused, self-contained task.
+
+        The sub-agent starts with a fresh context window — it does NOT inherit this
+        conversation's history. It has access to all the same tools (read_file, bash,
+        grep_content, web_fetch, etc.) and returns its final response as `result`.
+
+        Use when:
+        - Exploring a large codebase section that would bloat your context
+          ("read all 40 test files and summarise what each group tests")
+        - Running deep analysis in parallel — issue multiple run_subtask calls
+          in the same turn for genuine parallel execution
+        - Delegating a focused research or investigation task while staying
+          high-level yourself
+        - Getting a verification or review pass on your own changes
+          ("check my edits in src/ for syntax errors and consistency")
+        - Any task that requires 10+ file reads or multiple bash commands but
+          whose output can be summarised in a paragraph
+
+        The sub-agent reasons and acts like a full Gemini coding agent.
+        Give it a clear, self-contained task — include all context it needs
+        since it cannot see this conversation.
+
+        Tip: end your task description with "Summarise your findings clearly
+        since your full output will be returned to the main agent."
+
+        Args:
+            task: Clear, self-contained description of what to do.
+            context: Extra context the sub-agent needs (file paths, relevant
+                     code snippets, constraints, acceptance criteria).
+        """
+        import uuid
+
+        try:
+            from google.adk.runners import Runner
+            from google.adk.sessions.in_memory_session_service import (
+                InMemorySessionService,
+            )
+        except ImportError:
+            try:
+                from google.adk.runners import Runner
+                from google.adk.sessions import InMemorySessionService
+            except ImportError:
+                return {"error": "google-adk not available for sub-agent"}
+
+        from gemcode.agent import build_root_agent
+        from gemcode.tools import build_function_tools
+        from gemcode.invoke import run_turn
+
+        # Build the sub-agent tool set WITHOUT run_subtask (no recursion).
+        sub_tools = build_function_tools(cfg, include_subtask=False)
+
+        # Build a standalone LlmAgent with the limited tool set.
+        sub_agent = build_root_agent(cfg, _tools=sub_tools)
+
+        # Isolated in-memory session — never writes to the parent SQLite DB.
+        sub_runner = Runner(
+            app_name="gemcode_sub",
+            agent=sub_agent,
+            session_service=InMemorySessionService(),
+        )
+        sub_session_id = str(uuid.uuid4())
+
+        # Compose the sub-agent prompt.
+        prompt = task.strip()
+        if context and context.strip():
+            prompt = f"{task.strip()}\n\nAdditional context:\n{context.strip()}"
+
+        # Cap sub-agent depth to avoid runaway API cost.
+        sub_max_calls = min(int(cfg.max_llm_calls or 48), 48)
+
+        try:
+            events = await run_turn(
+                sub_runner,
+                user_id="local",
+                session_id=sub_session_id,
+                prompt=prompt,
+                max_llm_calls=sub_max_calls,
+                cfg=cfg,
+            )
+        except Exception as e:
+            return {"error": f"Sub-agent error: {type(e).__name__}: {e}"}
+
+        # Extract only non-thinking text parts from the sub-agent's output.
+        parts: list[str] = []
+        for ev in events:
+            try:
+                if not ev.content or not ev.content.parts:
+                    continue
+                if getattr(ev, "author", None) == "user":
+                    continue
+                for part in ev.content.parts:
+                    t = getattr(part, "text", None)
+                    is_thought = getattr(part, "thought", None)
+                    if isinstance(t, str) and t.strip() and not is_thought:
+                        parts.append(t)
+            except Exception:
+                continue
+
+        result_text = "".join(parts).strip()
+        if not result_text:
+            result_text = (
+                "(Sub-agent completed the task but produced no text output. "
+                "It may have only called tools. Consider a more explicit task "
+                "that asks the sub-agent to summarise its findings.)"
+            )
+
+        return {"result": result_text}
+
+    return run_subtask

gemcode-0.3.18/src/gemcode/tools/think.py

@@ -0,0 +1,41 @@
+"""
+Think tool — structured reasoning scratchpad before acting.
+
+Inspired by Anthropic's documented "think" tool pattern:
+https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking
+
+Even though Gemini 2.5 has native dynamic thinking, an explicit think() call
+improves quality on hard tasks because:
+1. It forces a structured reasoning checkpoint before irreversible actions.
+2. The written thought persists in the conversation history so later tool calls
+   can reference it.
+3. It creates a visible chain-of-reasoning the model can revise.
+"""
+
+from __future__ import annotations
+
+
+def make_think_tool():
+    def think(thought: str) -> dict:
+        """
+        Write out your reasoning, plan, or analysis before taking action.
+
+        This is a private scratchpad — the content is NOT shown to the user.
+        Use it when you need to think clearly before executing tools:
+
+        - Planning a multi-step edit: map out what files to touch and in what order
+        - Debugging an error: trace the execution path before deciding on a fix
+        - Weighing approaches: compare trade-offs before committing to one
+        - Verifying understanding: articulate your model of the code before editing
+        - Decomposing a complex task: break it into concrete sub-steps
+        - After reading multiple files: synthesise before writing
+
+        Call think() BEFORE a sequence of tool calls, especially before destructive
+        or irreversible actions (deletes, overwrites, force-pushes).
+
+        The return value is intentionally empty — the value is in the reasoning
+        itself being part of the conversation context.
+        """
+        return {"ok": True}
+
+    return think

gemcode-0.3.18/src/gemcode/tui/input_handler.py

@@ -0,0 +1,182 @@
+"""
+Interactive input handler for the GemCode REPL.
+
+Provides (when prompt_toolkit is available):
+- Slash command autocomplete — type / and see all commands with descriptions;
+  use ↑ / ↓ arrows to navigate the list, Tab or Enter to accept, Esc to dismiss.
+- Conversation history — ↑ / ↓ arrows cycle through previous messages (when
+  the completion popup is not open).
+- Status bar — shows the active model and session ID while typing.
+- Styled ❯ prompt in GemCode blue.
+
+Falls back gracefully to plain input() when prompt_toolkit is unavailable or
+stdout is not a TTY (e.g. piped input, CI).
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Callable
+
+# ---------------------------------------------------------------------------
+# Availability guard — import everything inside try so we never hard-crash
+# ---------------------------------------------------------------------------
+_PT_AVAILABLE = False
+try:
+    from prompt_toolkit import PromptSession
+    from prompt_toolkit.completion import Completer, Completion
+    from prompt_toolkit.document import Document  # noqa: F401 (type hint only)
+    from prompt_toolkit.formatted_text import HTML
+    from prompt_toolkit.history import InMemoryHistory
+    from prompt_toolkit.key_binding import KeyBindings
+    from prompt_toolkit.styles import Style
+
+    _PT_AVAILABLE = True
+except ImportError:
+    pass
+
+# ---------------------------------------------------------------------------
+# Slash command registry
+# (name without /, description shown in the autocomplete popup)
+# ---------------------------------------------------------------------------
+SLASH_COMMANDS: list[tuple[str, str]] = [
+    ("help",        "List all available commands"),
+    ("clear",       "Start a fresh session — clears conversation history"),
+    ("model",       "View or switch model  ·  /model use <id>  ·  /model list"),
+    ("status",      "Show session ID, model, and current settings"),
+    ("context",     "Show context window usage and token counts"),
+    ("tools",       "List all tools and their permission categories"),
+    ("compact",     "Summarise conversation history to reclaim context space"),
+    ("config",      "Show active configuration and environment variables"),
+    ("permissions", "Show current permission mode (default / strict / yes)"),
+    ("audit",       "Show recent audit log  ·  /audit [N lines]"),
+    ("memory",      "Show memory / storage settings"),
+    ("doctor",      "Run diagnostics and validate the environment"),
+    ("hooks",       "Show hooks configuration"),
+    ("version",     "Show installed GemCode version"),
+    ("exit",        "Exit GemCode"),
+]
+
+
+# ---------------------------------------------------------------------------
+# Completer
+# ---------------------------------------------------------------------------
+if _PT_AVAILABLE:
+    class _SlashCommandCompleter(Completer):
+        """
+        Activates when the input starts with '/'.
+        Supports prefix matching and substring matching so typing '/mo' shows
+        /model, '/compact', etc.
+        """
+
+        def get_completions(self, document, complete_event):
+            text = document.text_before_cursor
+            if not text.startswith("/"):
+                return
+            query = text[1:].lower()
+            for name, desc in SLASH_COMMANDS:
+                if not query or name.startswith(query) or query in name:
+                    yield Completion(
+                        "/" + name,
+                        start_position=-len(text),
+                        display=HTML(f"<ansiblue>/<b>{name}</b></ansiblue>"),
+                        display_meta=desc,
+                    )
+
+
+# ---------------------------------------------------------------------------
+# Public class
+# ---------------------------------------------------------------------------
+class GemCodeInputHandler:
+    """
+    Wraps prompt_toolkit PromptSession with GemCode-specific styling and slash
+    command autocomplete.  Use ``await handler.prompt_async()`` in the async
+    REPL loop.
+
+    When prompt_toolkit is not installed (or stdout is not a TTY) every call
+    transparently delegates to ``input()``.
+    """
+
+    def __init__(
+        self,
+        *,
+        ansi_enabled: bool = True,
+        get_model: Callable[[], str] | None = None,
+        get_session_id: Callable[[], str] | None = None,
+    ) -> None:
+        self._ansi = ansi_enabled
+        self._get_model = get_model or (lambda: "gemini")
+        self._get_session_id = get_session_id or (lambda: "")
+        self._session: "PromptSession | None" = None
+
+        if _PT_AVAILABLE and sys.stdin.isatty() and sys.stdout.isatty():
+            self._build_session()
+
+    def _build_session(self) -> None:
+        style = Style.from_dict(
+            {
+                # The ❯ prompt glyph
+                "prompt":                               "#5fafd7 bold",
+                # Completion popup rows
+                "completion-menu.completion":           "bg:#0d2035 fg:#87cefa",
+                "completion-menu.completion.current":   "bg:#0087d7 fg:#ffffff bold",
+                # Meta (description) column
+                "completion-menu.meta.completion":      "bg:#0d2035 fg:#5a7a9a",
+                "completion-menu.meta.completion.current": "bg:#0065a0 fg:#cce8ff",
+                "completion-menu.border":               "#0087d7",
+                # Bottom toolbar
+                "bottom-toolbar":                       "bg:#0d1f2d fg:#4a7a9a",
+            }
+        )
+
+        get_model = self._get_model
+        get_session_id = self._get_session_id
+
+        def bottom_toolbar() -> HTML:
+            model = get_model() or "gemini"
+            sid = get_session_id()
+            sid_short = sid[:8] if len(sid) >= 8 else sid
+            return HTML(
+                f'<style bg="#0d1f2d" fg="#5fafd7"><b> ◆ {model}</b></style>'
+                f'<style bg="#0d1f2d" fg="#3d6080">  ·  session {sid_short}'
+                f'  ·  / for commands</style>'
+            )
+
+        kb = KeyBindings()
+
+        @kb.add("c-c")
+        def _ctrl_c(event):
+            """Ctrl+C clears current line (like a real shell)."""
+            event.app.current_buffer.reset()
+
+        self._session = PromptSession(
+            history=InMemoryHistory(),
+            completer=_SlashCommandCompleter(),
+            complete_while_typing=True,
+            style=style,
+            bottom_toolbar=bottom_toolbar,
+            key_bindings=kb,
+            mouse_support=False,
+            complete_in_thread=True,
+            reserve_space_for_menu=10,
+            # Show completion descriptions to the right (like VS Code)
+            complete_style="COLUMN",
+        )
+
+    def is_interactive(self) -> bool:
+        return self._session is not None
+
+    async def prompt_async(self) -> str:
+        """
+        Async prompt — returns stripped user input.
+        Raises EOFError on Ctrl+D (caller should handle gracefully).
+        """
+        if self._session is not None:
+            from prompt_toolkit.formatted_text import HTML as _HTML
+
+            result = await self._session.prompt_async(
+                _HTML('<style fg="#5fafd7"><b>❯</b></style> '),
+            )
+            return (result or "").strip()
+        else:
+            return input("❯ ").strip()

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode/tui/scrollback.py

@@ -14,6 +14,7 @@ from gemcode.capability_routing import apply_capability_routing
 from gemcode.config import load_cli_environment
 from gemcode.model_routing import pick_effective_model
 from gemcode.repl_slash import process_repl_slash
+from gemcode.tui.input_handler import GemCodeInputHandler
 from gemcode.tui.welcome_rich import print_shortcuts_hint, print_welcome_dashboard
 
 _ADK_REQUEST_CONFIRMATION = "adk_request_confirmation"
@@ -185,6 +186,17 @@ async def run_gemcode_scrollback_tui(
 
   char_delay_ms = int(os.environ.get("GEMCODE_TUI_CHAR_DELAY_MS", "0") or "0")
 
+  # Build the interactive input handler (prompt_toolkit when available, plain
+  # input() otherwise).  Callables let the handler always read the *current*
+  # model and session id even after /model or /clear commands.
+  _current_session_id_holder = [session_id]
+
+  input_handler = GemCodeInputHandler(
+      ansi_enabled=ansi.enabled,
+      get_model=lambda: getattr(cfg, "model", "gemini") or "gemini",
+      get_session_id=lambda: _current_session_id_holder[0],
+  )
+
   async def typewrite(text: str) -> None:
     if not text:
       return
@@ -252,7 +264,7 @@ async def run_gemcode_scrollback_tui(
 
   while True:
     try:
-      prompt = input(f"{ansi.bold}❯{ansi.reset} ").strip()
+      prompt = await input_handler.prompt_async()
     except EOFError:
       print("")
       return
@@ -276,6 +288,7 @@ async def run_gemcode_scrollback_tui(
         return
       if slash.new_session_id is not None:
         current_session_id = slash.new_session_id
+        _current_session_id_holder[0] = current_session_id
       if slash.skip_model_turn:
         # Runner binds the model at creation time (LlmAgent(model=...)),
         # so rebuild it when the user overrides the model mid-session.
@@ -400,9 +413,12 @@ async def run_gemcode_scrollback_tui(
             print(
               f"  ⎿  {ansi.blue}{ansi.bold}Permission needed{ansi.reset} for {ansi.bold}{tool_name}{ansi.reset}."
             )
-          ans = input(
-            f"  ⎿  Allow? ({ansi.blue_ok}y{ansi.reset}/{ansi.dim}N{ansi.reset}) "
-          ).strip().lower()
+          try:
+            ans = input(
+              f"  ⎿  Allow? ({ansi.blue_ok}y{ansi.reset}/{ansi.dim}N{ansi.reset}) "
+            ).strip().lower()
+          except EOFError:
+            ans = ""
           ok = ans in ("y", "yes")
 
         parts.append(

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode/tui/welcome_rich.py

@@ -132,4 +132,9 @@ def print_welcome_dashboard(cfg, *, console: Console) -> None:
 def print_shortcuts_hint(*, console: Console) -> None:
   from rich.text import Text
 
-  console.print(Text("  ? for shortcuts", style=f"dim {_LABEL_GREY}"))
+  console.print(
+    Text(
+      "  Type a message to begin  ·  / for commands  ·  ↑↓ history",
+      style=f"dim {_LABEL_GREY}",
+    )
+  )

{gemcode-0.3.16 → gemcode-0.3.18/src/gemcode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.16
+Version: 0.3.18
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License
@@ -179,6 +179,7 @@ Requires-Dist: google-adk>=1.0.0
 Requires-Dist: google-genai>=1.0.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode.egg-info/SOURCES.txt

@@ -69,8 +69,11 @@ src/gemcode/tools/filesystem.py
 src/gemcode/tools/search.py
 src/gemcode/tools/shell.py
 src/gemcode/tools/shell_gate.py
+src/gemcode/tools/subtask.py
+src/gemcode/tools/think.py
 src/gemcode/tools/todo.py
 src/gemcode/tools/web.py
+src/gemcode/tui/input_handler.py
 src/gemcode/tui/scrollback.py
 src/gemcode/tui/spinner.py
 src/gemcode/tui/welcome_banner.py

{gemcode-0.3.16 → gemcode-0.3.18}/src/gemcode.egg-info/requires.txt

@@ -2,6 +2,7 @@ google-adk>=1.0.0
 google-genai>=1.0.0
 python-dotenv>=1.0.0
 rich>=13.0.0
+prompt_toolkit>=3.0.0
 
 [dev]
 pytest>=8.0.0