gemcode 0.3.18__tar.gz → 0.3.19__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.18
+Version: 0.3.19
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gemcode"
-version = "0.3.18"
+version = "0.3.19"
 description = "Local-first coding agent on Google Gemini + ADK"
 readme = "README.md"
 requires-python = ">=3.11"

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

@@ -79,13 +79,26 @@ You run locally via the GemCode CLI. You are the same agent the user launched
 
 ## Core identity and approach
 You are a senior engineer who *acts*, not just advises. When given a task:
-1. **Orient** — understand the repo structure, find the relevant files.
+1. **Orient** — use `list_directory`, `glob_files`, `grep_content`, `read_file` to understand structure. These tools need **no permission** and are instant. Start here.
 2. **Plan** — for complex tasks, call `todo_write` upfront to map out the work.
 3. **Execute** — make the changes, run the checks, iterate.
 4. **Verify** — confirm the result is correct before reporting done.
 
 Never stop mid-task just because the first tool call succeeded. Keep going until the full task is complete or you hit a genuine blocker.
 
+## CRITICAL: Read-only tools first — never bash for exploration
+`bash` and `run_command` require permission confirmation by default. Always start with the **zero-permission** read-only tools:
+
+| Instead of… | Use… |
+|---|---|
+| `bash("ls -la src/")` | `list_directory("src")` |
+| `bash("find . -name '*.py'")` | `glob_files("**/*.py")` |
+| `bash("cat file.py")` | `read_file("file.py")` |
+| `bash("grep -r pattern .")` | `grep_content("pattern", "**/*")` |
+| `bash("find . -type f \| head -50")` | `list_directory(".")` + `glob_files("**/*")` |
+
+Only reach for `bash` or `run_command` when you actually need to **execute** something: run tests, build, git ops, start a server, install packages. **NEVER** use bash to list or read files.
+
 ## Thinking through hard problems
 You have native deep thinking capability — use it actively:
 - **Before** starting a complex refactor or architectural change, think: what are the dependencies? what could break? what is the minimal safe change?
@@ -94,11 +107,12 @@ You have native deep thinking capability — use it actively:
 - **For trade-off decisions** (which library, which pattern, which approach): reason through the pros/cons given this specific codebase.
 
 ## Interpreting requests
-- Treat every message as a software engineering task unless clearly otherwise.
+- Treat every message as a software engineering task — start working immediately. Do NOT respond with just a greeting or introduction.
 - If vague ("fix it", "the config", "rename that"), **infer from the repo**: search, read, then act. Do not give abstract advice when concrete files exist.
-- If the user refers to symbols or behaviors, **find them** with glob/grep/list — never ask them to paste paths you can discover yourself.
+- If the user refers to symbols or behaviors, **find them** with `glob_files`/`grep_content`/`list_directory` — never ask them to paste paths you can discover yourself.
 - **Never propose edits to files you haven't read.** Read first, then edit.
 - When something fails, diagnose (re-read the error, check assumptions) before switching strategy. Do not repeat the same failed call.
+- For analysis tasks ("analyse X", "explain X", "what does X do"): immediately start reading files with `list_directory` + `read_file` + `grep_content`. Produce concrete findings, not hypotheses.
 
 ## Tool selection guide
 
@@ -174,12 +188,11 @@ One user message = many model↔tool rounds (up to 256 LLM calls by default). Th
 
 **Standard workflow for complex tasks:**
 1. `todo_write` — plan the work items
-2. Explore — `bash("find . ...")` or `list_directory` or `glob_files` to understand structure
-3. Read — `read_file` with line ranges on large files; `grep_content` for symbol search
-4. Edit — `write_file` / `search_replace` for changes
-5. Verify — `bash("pytest ...")` or `bash("npm run build ...")` or `bash("git diff")`
-6. Fix — iterate on failures, re-verify
-7. Update todos — mark done as you go
+2. **Explore (read-only, no permission needed)** — `list_directory` + `glob_files` to map structure; `grep_content` to find symbols; `read_file` to understand code. Do NOT use `bash` for this step.
+3. **Edit** — `write_file` / `search_replace` for changes
+4. **Verify (shell needed)** — `bash("pytest ...")` or `bash("npm run build ...")` or `bash("git diff")`
+5. Fix — iterate on failures, re-verify
+6. Update todos — mark done as you go
 
 **Do not stop after step 2 or 3** — complete the full task.
 

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

@@ -236,7 +236,76 @@ async def run_gemcode_scrollback_tui(
       pass
     return tool_name, hint
 
+  # ── Live status indicator ─────────────────────────────────────────────────
+  # spinner_active[0] = True while "⟳ Working..." is on the current line.
+  # _clear_spinner() uses \r + ANSI erase to overwrite it before real output.
+  spinner_active = [False]
+
+  def _clear_spinner() -> None:
+    if spinner_active[0]:
+      sys.stdout.write("\r\033[K")
+      sys.stdout.flush()
+      spinner_active[0] = False
+
+  def _fmt_tool_result(resp: object) -> str:
+    """One-line summary of a tool execution result."""
+    try:
+      d = resp if isinstance(resp, dict) else {}
+      # ADK may wrap the return value; try both the raw dict and a nested "result" key.
+      inner = d.get("result", d)
+      if not isinstance(inner, dict):
+        inner = d
+      err = inner.get("error") or d.get("error")
+      if err:
+        return f"\u2717 {str(err)[:80]}"
+      exit_code = inner.get("exit_code")
+      if exit_code is not None:
+        icon = "\u2713" if exit_code == 0 else f"\u2717 exit {exit_code}"
+        out = str(inner.get("stdout", "") or "").strip()
+        first = out.split("\n")[0][:80] if out else ""
+        if not first:
+          first = str(inner.get("stderr", "") or "").strip().split("\n")[0][:80]
+        return f"{icon}  {first}" if first else icon
+      if inner.get("content") is not None:
+        lines = str(inner["content"]).count("\n") + 1
+        return f"\u2713 {lines} lines"
+      if inner.get("files") is not None:
+        return f"\u2713 {len(inner['files'])} files"
+      if inner.get("matches") is not None:
+        return f"\u2713 {len(inner['matches'])} matches"
+      if inner.get("ok") or d.get("ok"):
+        return "\u2713"
+      return ""
+    except Exception:
+      return ""
+
+  def _render_tool_results(ev) -> None:
+    """Print a brief one-line summary when a tool finishes executing."""
+    try:
+      frs: list = []
+      try:
+        frs = ev.get_function_responses() or []
+      except Exception:
+        pass
+      if not frs and ev.content and ev.content.parts:
+        for part in ev.content.parts:
+          fr = getattr(part, "function_response", None)
+          if fr is not None:
+            frs.append(fr)
+      for fr in frs:
+        name = getattr(fr, "name", "") or ""
+        if name == _ADK_REQUEST_CONFIRMATION:
+          continue
+        _clear_spinner()
+        resp = getattr(fr, "response", {}) or {}
+        summary = _fmt_tool_result(resp)
+        if summary:
+          print(f"  ⎿    {ansi.dim}\u21b3 {summary}{ansi.reset}")
+    except Exception:
+      pass
+
   def _render_tool_calls(ev) -> None:
+    _clear_spinner()
     try:
       fcs = ev.get_function_calls() or []
     except Exception:
@@ -331,9 +400,18 @@ async def run_gemcode_scrollback_tui(
         kwargs["run_config"] = run_config
       # (We don't handle token budget reset here; full-screen TUI does.)
 
+      # Show a live "Working…" indicator so the user never wonders if the
+      # agent froze.  _clear_spinner() overwrites it with \r+ANSI-erase
+      # before the first real output (tool call, tool result, or response).
+      if ansi.enabled:
+        spinner_active[0] = True
+        sys.stdout.write(f"  {ansi.dim}\u27f3  Working\u2026{ansi.reset}")
+        sys.stdout.flush()
+
       async for ev in runner.run_async(**kwargs):
         events.append(ev)
         _render_tool_calls(ev)
+        _render_tool_results(ev)
         try:
           if not ev.content or not ev.content.parts:
             continue
@@ -351,6 +429,8 @@ async def run_gemcode_scrollback_tui(
         except Exception:
           continue
 
+      _clear_spinner()  # ensure "Working…" is gone before any response line
+
       if not assistant_wrote_text and _events_had_non_confirmation_tools(events):
         await typewrite(
             f"{ansi.dim}(Tools ran without a text reply in this step; "
@@ -377,15 +457,6 @@ async def run_gemcode_scrollback_tui(
             await typewrite(thought_text)
             sys.stdout.write("\n")
             sys.stdout.flush()
-        else:
-          # Keep thinking visible even if the model produced no separate
-          # "thought" channel output.
-          print(
-            f"  ⎿  {ansi.dim}{ansi.bold}\u2234 Thinking{ansi.reset}: "
-            "(no thinking output)"
-          )
-          print("")
-
         if buffered_final:
           sys.stdout.write(f"  ⎿  {ansi.bold}GemCode{ansi.reset}: ")
           sys.stdout.flush()

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.18
+Version: 0.3.19
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License