flowjet 2.2.0__tar.gz → 2.2.2__tar.gz

{flowjet-2.2.0 → flowjet-2.2.2}/CHANGELOG.md

@@ -10,6 +10,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.2] — 2026-11-13
+
+### Changed
+
+- **Dashboard snapshot is now disabled by default.** The live progress panel is erased when the run finishes, leaving only the final answer. Set `FJ_SNAPSHOT=1` (or `true`/`yes`) to keep the DONE / FAILED / PAUSED snapshot visible above the answer, as in previous versions.
+
+- **`✓ Done` status footer is now suppressed by default.** The run ends with just the final answer. Pass `-v` (or set `FJ_LOG_LEVEL=debug`) to surface the `✓ Done · <duration> · <tokens> · <thread_id>` summary footer.
+
+## [2.2.1] — 2026-11-11
+
+### Changed
+
+- **`soothe` floor bumped to `>=1.3.1`** (`uv.lock` refreshed). Picks up the latest soothe 1.3.1 runtime — Proactive Coverage Evaluation (PCE) and the TUI stream-cancel fix; no flowjet-facing API changes.
+
 ## [2.2.0] — 2026-11-10
 
 ### Changed

{flowjet-2.2.0 → flowjet-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: flowjet
-Version: 2.2.0
+Version: 2.2.2
 Summary: FlowJet — a fast, open agent runtime for CLI and HTTP, powered by Soothe
 Project-URL: Homepage, https://github.com/caesar0301/flowjet
 Project-URL: Repository, https://github.com/caesar0301/flowjet
@@ -23,7 +23,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.11
 Requires-Dist: rich>=13.0
-Requires-Dist: soothe<2.0.0,>=1.3.0
+Requires-Dist: soothe<2.0.0,>=1.3.1
 Provides-Extra: dev
 Requires-Dist: httpx>=0.27.0; extra == 'dev'
 Requires-Dist: mypy>=1.0.0; extra == 'dev'
@@ -104,7 +104,7 @@ fj -l                        # list recent threads
 
 `-f` is scoped to your current project, so work in other checkouts never hijacks your thread.
 
-On an interactive terminal, `fj` shows a live dashboard: a status badge, a one-line strip (step X/N, elapsed, tokens, last updated), the current action, an activity history (tool calls plus the agent's intermediate reasoning between them) and an answer preview. Piped or redirected output stays plain text with no progress content. Display is tunable via `NO_COLOR`, `FJ_FORCE_COLOR` and `FJ_PROGRESS_WIDTH`.
+On an interactive terminal, `fj` shows a live dashboard: a status badge, a one-line strip (step X/N, elapsed, tokens, last updated), the current action, an activity history (tool calls plus the agent's intermediate reasoning between them) and an answer preview. Piped or redirected output stays plain text with no progress content. Display is tunable via `NO_COLOR`, `FJ_FORCE_COLOR`, `FJ_PROGRESS_WIDTH` and `FJ_SNAPSHOT`.
 
 Shell completion predicts full queries, not just flags:
 

{flowjet-2.2.0 → flowjet-2.2.2}/README.md

@@ -59,7 +59,7 @@ fj -l                        # list recent threads
 
 `-f` is scoped to your current project, so work in other checkouts never hijacks your thread.
 
-On an interactive terminal, `fj` shows a live dashboard: a status badge, a one-line strip (step X/N, elapsed, tokens, last updated), the current action, an activity history (tool calls plus the agent's intermediate reasoning between them) and an answer preview. Piped or redirected output stays plain text with no progress content. Display is tunable via `NO_COLOR`, `FJ_FORCE_COLOR` and `FJ_PROGRESS_WIDTH`.
+On an interactive terminal, `fj` shows a live dashboard: a status badge, a one-line strip (step X/N, elapsed, tokens, last updated), the current action, an activity history (tool calls plus the agent's intermediate reasoning between them) and an answer preview. Piped or redirected output stays plain text with no progress content. Display is tunable via `NO_COLOR`, `FJ_FORCE_COLOR`, `FJ_PROGRESS_WIDTH` and `FJ_SNAPSHOT`.
 
 Shell completion predicts full queries, not just flags:
 

{flowjet-2.2.0 → flowjet-2.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "flowjet"
-version = "2.2.0"
+version = "2.2.2"
 description = "FlowJet — a fast, open agent runtime for CLI and HTTP, powered by Soothe"
 readme = "README.md"
 license = { text = "MIT" }
@@ -27,7 +27,7 @@ classifiers = [
 ]
 # Single-dependency CLI wheel; HTTP service deps live in the `server` extra.
 dependencies = [
-    "soothe>=1.3.0,<2.0.0",
+    "soothe>=1.3.1,<2.0.0",
     # TTY rendering for answers/tables; imported lazily, unused when piped.
     "rich>=13.0",
 ]

{flowjet-2.2.0 → flowjet-2.2.2}/src/flowjet/cli/dashboard.py

@@ -9,14 +9,16 @@ The terminal renderer is split in two:
   gate, interleaved output and the final snapshot.
 
 ``Live`` itself is the only refresh source (its ``auto_refresh`` thread replaces
-the old hand-rolled 0.08s asyncio spinner). ``transient=False`` leaves the last
-frame on screen, which is what makes the DONE / FAILED / PAUSED snapshot visible
-above the final answer.
+the old hand-rolled 0.08s asyncio spinner). By default ``transient=True`` so the
+live panel is erased when the run finishes, leaving only the final answer.
+Set ``FJ_SNAPSHOT=1`` (or ``true``/``yes``) to keep the last frame on screen as
+a DONE / FAILED / PAUSED snapshot visible above the final answer.
 """
 
 from __future__ import annotations
 
 import logging
+import os
 import sys
 import time
 from collections.abc import Callable
@@ -40,6 +42,16 @@ _TAIL_MAX = 6
 _CHROME_ROWS = 14
 # Ceiling for a reasoning stretch before it is truncated into one panel row.
 _REASONING_MAX_CHARS = 2000
+# Env var that keeps the final DONE/FAILED/PAUSED panel on screen after the run
+# finishes. Disabled by default so only the answer text remains on the terminal;
+# set ``FJ_SNAPSHOT=1`` (or ``true``/``yes``) to leave the snapshot visible.
+_SNAPSHOT_ENV = "FJ_SNAPSHOT"
+
+
+def _snapshot_enabled() -> bool:
+    """Whether the final dashboard snapshot stays on screen after completion."""
+    return os.environ.get(_SNAPSHOT_ENV, "").strip().lower() in {"1", "true", "yes"}
+
 
 _STATUS_BADGES: dict[str, tuple[str, str]] = {
     "LIVE": ("● LIVE", "cyan"),
@@ -272,7 +284,7 @@ def _default_live(
         console=console,
         auto_refresh=True,
         refresh_per_second=refresh_per_second,
-        transient=False,
+        transient=not _snapshot_enabled(),
         redirect_stdout=True,
         redirect_stderr=True,
         vertical_overflow="visible",
@@ -622,11 +634,13 @@ class ProgressDashboard:
         duration_s: float | None = None,
         tokens: int | None = None,
     ) -> None:
-        """Freeze the panel as a visible snapshot (idempotent).
+        """Freeze the panel as a snapshot, or erase it (idempotent).
 
-        ``transient=False`` means ``Live.stop()`` leaves the last frame on
-        screen; no erase bytes are emitted, so a PAUSED snapshot and the
-        questions printed after it are both visible.
+        When ``FJ_SNAPSHOT`` is set, ``transient=False`` means ``Live.stop()``
+        leaves the last frame on screen — no erase bytes are emitted, so a
+        PAUSED snapshot and the questions printed after it are both visible.
+        By default (snapshot disabled) ``transient=True`` erases the panel so
+        only the final answer remains.
         """
         if self._finalized:
             return

{flowjet-2.2.0 → flowjet-2.2.2}/src/flowjet/cli/stream.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import asyncio
 import contextlib
 import logging
+import os
 import re
 import sys
 import time
@@ -84,6 +85,19 @@ def _format_tokens(count: int) -> str:
     return str(count)
 
 
+def _verbose_mode_active(show_tool_calls: bool) -> bool:
+    """True when verbose mode is on (``-v`` flag or ``FJ_LOG_LEVEL=debug``).
+
+    The ``✓ Done`` summary footer is shown **only** in verbose mode — by
+    default the run ends with just the final answer. In verbose mode the
+    footer complements the mirrored tool calls / DEBUG log records, which
+    surface duration, tokens, and thread id.
+    """
+    if show_tool_calls:
+        return True
+    return os.environ.get("FJ_LOG_LEVEL", "").strip().lower() == "debug"
+
+
 # Western + CJK sentence boundaries for status preview.
 _STATUS_SENTENCE_SEPS = (
     ". ",
@@ -538,6 +552,10 @@ async def stream_query(
     it, and :data:`INTERRUPTED` is returned — the run is not complete and must
     be resumed with ``fjf -t <thread> <answer>``.
 
+    The ``✓ Done`` summary footer (duration, tokens, thread id) is shown only
+    in verbose mode (``show_tool_calls=True`` or ``FJ_LOG_LEVEL=debug``); by
+    default the run ends with just the final answer.
+
     ``timeout_s`` cancels the whole run after that many seconds and raises
     :class:`AgentRunError` naming the last visible activity.
     """
@@ -747,6 +765,10 @@ async def stream_query(
         # A silent "✓ Done" teaches nothing — make the empty outcome and any
         # failed tool calls visible instead.
         _write_no_output_warning(stderr, failed_tool_calls, last_tool_error, thread_id)
+    if not _verbose_mode_active(show_tool_calls):
+        # Default mode: the ``✓ Done`` summary footer is suppressed — the
+        # run ends with just the final answer. Only verbose mode surfaces it.
+        return answer_text
     duration = _format_duration(time.monotonic() - started_at)
     token_part = f" · {_format_tokens(total_tokens)} tokens" if total_tokens else ""
     stdout.write(f"\n✓ Done · {duration}{token_part} · {thread_id}\n")