mini-code-cli 0.1.0.0__py3-none-any.whl → 0.1.0.1__py3-none-any.whl

mini_code_cli/agent_loop.py

@@ -581,6 +581,10 @@ class AgentSession:
         print_welcome(self.allowed_dir, self.server_url, self.args,
                       self.unique_id, self.cache_dir, self.model)
 
+        # Announce the session's unique id as an assistant-styled message so the
+        # user can see / copy the id this conversation is being saved under.
+        self._print_session_id()
+
         # Report the outcome of --load-last-session up front, so the user sees
         # whether we resumed an earlier conversation (under a brand-new id) or
         # started fresh because no previous session was found.
@@ -649,6 +653,20 @@ class AgentSession:
                 # Ctrl-C mid-loop just saves and re-prompts rather than crashing.
                 self._persist()
 
+    def _print_session_id(self):
+        """Print the session's unique id as an assistant-styled message.
+
+        A short, styled announcement (in the assistant accent) so the user can
+        see and copy the id the conversation is saved under -- the same id shown
+        in the welcome banner, but rendered as a transcript turn so it is easy
+        to spot and grep.
+        """
+        self.console.divider()
+        self.console.turn(
+            "Session id",
+            f"{self.unique_id}  (saved under {self.cache_dir})",
+            accent="green")
+
     # -- autonomous drive (used by sub-agents) ------------------------------
 
     def _drive_auto(self, initial_task, max_steps=None):
@@ -864,7 +882,7 @@ class AgentSession:
                        self.unique_id, self.cache_dir, self.model)
             return True
         if cmd in self.CLEAR_COMMANDS:
-            self.console.clear_screen()
+            self._clear_and_show_last()
             return True
         self.console.note(f"Unknown command {stripped!r}. Try /help.", "warn")
         return True
@@ -892,12 +910,42 @@ class AgentSession:
                 return
         self._reset_history(target["turn"], target)
 
+    def _clear_and_show_last(self):
+        """Handle /clear: wipe the screen and re-print the last turn.
+
+        The conversation itself is unchanged; we just redraw the most recent
+        exchange so the user re-orients after clearing the view. If there is no
+        assistant reply yet, the last user turn is shown instead.
+        """
+        self.console.clear_screen()
+        last_role = last_text = None
+        for m in reversed(self.messages):
+            role = m.get("role")
+            content = m.get("content")
+            if role == "assistant" and not m.get("tool_calls") and content:
+                last_role, last_text = "Assistant", content
+                break
+            if role == "user" and content:
+                last_role, last_text = "You", content
+                break
+        if last_role is not None:
+            self.console.divider()
+            accent = "green" if last_role == "Assistant" else "cyan"
+            self.console.turn(last_role, last_text, accent=accent)
+
     # -- tool execution ----------------------------------------------------
 
     def _run_tool_calls(self, tool_calls):
         _make_tool_call_note(self.console, len(tool_calls))
-        for call in tool_calls:
-            self._run_one_tool_call(call)
+        # Show a "… calling tool" spinner (in-place, non-scrolling) while the
+        # tool(s) execute, mirroring the thinking spinner that covers the LLM
+        # call. Always stopped (finally) so it can never leak into the next turn.
+        self.console.start_tool_call()
+        try:
+            for call in tool_calls:
+                self._run_one_tool_call(call)
+        finally:
+            self.console.stop_tool_call()
 
     def _run_one_tool_call(self, call):
         call_id = call.get("id", "")

mini_code_cli/ui.py

@@ -99,6 +99,12 @@ class Console:
         # "… thinking" spinner state (see start_thinking / stop_thinking).
         self._thinking_thread = None
         self._thinking_stop = None
+        # "… calling tool" spinner state (see start_tool_call / stop_tool_call).
+        # Mirrors the thinking spinner: a daemon thread that rewrites a single
+        # live line in place (via the transient region) so the tool-execution
+        # phase looks alive without scrolling the transcript.
+        self._tool_call_thread = None
+        self._tool_call_stop = None
         # Live "transient" region (non-verbose mode) renders the tool-call area
         # and the usage line without scrolling the screen. We keep a single
         # invariant: whenever ``_transient_lines`` is > 0 a block of that many
@@ -432,6 +438,55 @@ class Console:
         if thread is not None and thread.is_alive():
             thread.join(timeout=1.0)
 
+    def start_tool_call(self, message="Calling tool"):
+        """Start a background "… calling tool" spinner (non-scrolling).
+
+        Shown while the agent executes a tool call, mirroring
+        :meth:`start_thinking` which covers the LLM request. Runs a short
+        animation in a daemon thread that rewrites a single live line in place
+        via the transient region, so the wait looks alive without scrolling the
+        transcript. On a real colour/utf-8 TTY it animates in place; on piped /
+        ASCII output it simply prints one static line and starts no thread.
+        Stop it with :meth:`stop_tool_call` before drawing the next turn.
+        """
+        self.stop_tool_call()  # be defensive: never leak more than one spinner
+        if not self._can_clear_cursor():
+            self.emit(self.style(f"\u2026 {message}", fg="magenta", dim=True))
+            return
+        self._tool_call_stop = threading.Event()
+        self._tool_call_thread = threading.Thread(
+            target=self._spin_tool_call, args=(message,), daemon=True)
+        self._tool_call_thread.start()
+
+    def _spin_tool_call(self, message):
+        """Animation loop for the tool-call spinner (mirror of :meth:`_spin`)."""
+        stop = self._tool_call_stop
+        i = 0
+        while not stop.is_set():
+            dots = "\u2026 " * min((i % 3) + 1, 3)
+            i += 1
+            self.emit_transient(self.style(f"{dots}{message}", fg="magenta", dim=True))
+            stop.wait(0.3)
+        # Replace the spinner line with a blank so the following real output
+        # lands cleanly; the blank stays tracked as the transient block and is
+        # cleared by the next :meth:`emit` (e.g. the next assistant turn).
+        self.emit_transient(None)
+
+    def stop_tool_call(self):
+        """Stop the "… calling tool" spinner started by :meth:`start_tool_call`.
+
+        Signals the animation thread to finish its current frame and exit, then
+        joins it, so no writes race with the main thread's subsequent output.
+        Safe to call when no spinner is running (a no-op)."""
+        stop = self._tool_call_stop
+        thread = self._tool_call_thread
+        self._tool_call_stop = None
+        self._tool_call_thread = None
+        if stop is not None:
+            stop.set()
+        if thread is not None and thread.is_alive():
+            thread.join(timeout=1.0)
+
     def tool_group(self, name, params=None, result=None, status="ran"):
         """Render one attempted tool call: its name, parameters and result."""
         self.emit(self.style(f"{self.glyph('gear')} {name}", fg="magenta", bold=True))

{mini_code_cli-0.1.0.0.dist-info → mini_code_cli-0.1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-code-cli
-Version: 0.1.0.0
+Version: 0.1.0.1
 Summary: Mini Coding Agent. Allows you to easily experiment with a small coding agent.
 Author-email: Nikolai Rozanov <nikolai.rozanov@gmail.com>
 License:                     GNU AFFERO GENERAL PUBLIC LICENSE
@@ -871,4 +871,19 @@ vllm serve ornith-ai/Ornith-1.5-397B-FP8 \
     --trust-remote-code
 ```
 
+## Citation
+
+If you use `mini-code-cli` in your research or writing, please cite it using the BibTeX entry below:
+
+```bibtex
+@misc{mini-code-cli,
+  author       = {Rozanov, Nikolai},
+  title        = {mini-code-cli: A minimal, dependency-light coding agent},
+  year         = {2026},
+  version      = {0.1.0.0},
+  howpublished = {\url{https://github.com/ai-nikolai/mini-code-cli}},
+  note         = {A no-bloat, dependency-free agent CLI for experimenting.}
+}
+```
+
 ## (C) Nikolai Rozanov, 2026 - Present

{mini_code_cli-0.1.0.0.dist-info → mini_code_cli-0.1.0.1.dist-info}/RECORD

@@ -1,5 +1,5 @@
 mini_code_cli/__init__.py,sha256=iNgHmKSHOuH99obGjnUMoS2JP4Gw4AOrIfu68EYaZQM,77
-mini_code_cli/agent_loop.py,sha256=DnoHKv9hsB7a9ibdvbt3HxfsdASpw8N1Gw2dTLZFI9g,55999
+mini_code_cli/agent_loop.py,sha256=jQEzWknHid0rKA8-vzES1RONg4tVJ8l4ImBleBC_RDE,58124
 mini_code_cli/config.py,sha256=AvzDZAKynQbuj5lcTtL-DcUwhyLa99QmNrLK6fYpdOA,814
 mini_code_cli/permissions.py,sha256=uQpQlUtQyVICpjUqdh9QQ_mgl51hZrGLHJzQR9vG124,2017
 mini_code_cli/persistence.py,sha256=L47NhXs6R54KETd8R17oGGxCXNEf7bjmvlwAJqtspLI,9944
@@ -10,14 +10,14 @@ mini_code_cli/sandbox.py,sha256=t7xS_AIpE8fbo5kj9zbUFbfEaAnq6iUE7plQcn6-uAk,2128
 mini_code_cli/shell_safety_utils.py,sha256=5E126vGnG7iIuTZe_R5JrxB_zxZpMKGe_pilz_Z2r4w,5551
 mini_code_cli/skills.py,sha256=baaz0RkPQ-OgWWwH5sHsKBmJdR430yT4HK3VLX0_88Y,13704
 mini_code_cli/tools.py,sha256=bW1zYyIj6OFp5TIcg5DCwheN-4xI1LQmDOQaHIfRV7M,10998
-mini_code_cli/ui.py,sha256=AUwn0OFt3yFx397-V8kYuidseCBxFHgO1KWDKrlLCOU,29371
+mini_code_cli/ui.py,sha256=sNfjwxLWtRF3C3VpSBP9L0uncVgFhZmGquw8u9O956U,32127
 mini_code_cli/utils.py,sha256=ffUAIisO8_h7VvlwAOLhdoNSAIdssGdtQHXm-i8bcLE,4620
 mini_code_cli/subagents/__init__.py,sha256=3fgcwY0pNq5iW29OxLPtSA3H5IKXhl2LUhwbBjLUDuU,1884
 mini_code_cli/subagents/base.py,sha256=bhZEENoTVjebfqaEKS7uPWeU0SwQWFN3BD40EtziPbg,12660
 mini_code_cli/subagents/builtin.py,sha256=ENzuooXIylzfZZ8uYkZmdxgCrCQ4pdbfrOONkBdGSPg,7598
-mini_code_cli-0.1.0.0.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-mini_code_cli-0.1.0.0.dist-info/METADATA,sha256=iUqH7NzuQqmIetQQjA5Re6-sADvq7JD_iGQDKehWqpQ,52292
-mini_code_cli-0.1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-mini_code_cli-0.1.0.0.dist-info/entry_points.txt,sha256=MwDp5UbXpI7wodSmOSYL8_nKutnBiyp96ZDDtaX7x14,60
-mini_code_cli-0.1.0.0.dist-info/top_level.txt,sha256=3Hb6PpNkJYXvzDKXuuFJRvzCdsTRh0TuRWz-ScJ6qV0,14
-mini_code_cli-0.1.0.0.dist-info/RECORD,,
+mini_code_cli-0.1.0.1.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+mini_code_cli-0.1.0.1.dist-info/METADATA,sha256=Er_McRLgRQ41CpufVZSHZeN1ZjBTGpf_s-odKMijoCE,52757
+mini_code_cli-0.1.0.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+mini_code_cli-0.1.0.1.dist-info/entry_points.txt,sha256=MwDp5UbXpI7wodSmOSYL8_nKutnBiyp96ZDDtaX7x14,60
+mini_code_cli-0.1.0.1.dist-info/top_level.txt,sha256=3Hb6PpNkJYXvzDKXuuFJRvzCdsTRh0TuRWz-ScJ6qV0,14
+mini_code_cli-0.1.0.1.dist-info/RECORD,,