flowjet 2.1.6__tar.gz → 2.1.8__tar.gz

{flowjet-2.1.6 → flowjet-2.1.8}/CHANGELOG.md

@@ -10,6 +10,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.8] — 2026-10-26
+
+### Fixed
+
+- **PostgreSQL checkpointer is now wired for the server surface.**
+  `Checkpointers.open()` (the `/v1/responses` + ACP server path) used to warn
+  “Checkpointer backend 'postgresql' is not wired for the flowjet server surface
+  yet” and yield `None`, so thread state never survived a turn — a deployment
+  whose `persistence.default_backend` is `postgresql` silently ran every turn as
+  a fresh conversation. It now builds an `AsyncPostgresSaver` on nano's shared
+  checkpoints pool (`resolve_checkpointer()` → `(None, pool)`), opens the pool,
+  and runs `setup()` once per process under nano's advisory lock
+  (`SharedCheckpointerPool.setup_checkpointer`), so concurrent workers cannot
+  race LangGraph's DDL. The shared pool is deliberately **not** closed on exit
+  (it is process-wide). Failure still degrades to “no persistence” with a
+  warning instead of failing startup; unknown backends keep the old behavior.
+
+## [2.1.7] — 2026-10-25
+
+### Added
+
+- **Configurable workspace watched subdirectories.** A new
+  `workspace_watched_subdirs` setting (env `FLOWJET_WORKSPACE_WATCHED_SUBDIRS`,
+  comma-separated) flows from Settings →
+  `SyncAwareWorkspaceResolver(watched_subdirs=...)` → `WorkspaceManager`, which
+  pre-creates the configured subtrees at workspace open and wires them into the
+  DirtyTracker. `None`/empty keeps the engine defaults (`input`/`working`/`output`)
+  — behavior unchanged — and unsafe entries fail loud at workspace open rather
+  than silently dropping sync coverage.
+
+### Changed
+
+- **Default identity no longer carries a personal creator byline.**
+  `FLOWJET_CREATOR` is now empty (the soothe identity renderer omits
+  "invented by {creator}" when the creator is blank) and
+  `FLOWJET_IDENTITY_FRAGMENT` drops the byline lines, so identity answers name
+  only (`{assistant_name}`). The vendor denylist (incl. Soothe/soothe-nano) is
+  unchanged. Explicit `agent.assistant_identity` in deployment config still wins
+  (e.g. MiraCloud branding).
+- **Soothe dependency pin raised to `>=1.2.3,<2.0.0`** to match the coordinated
+  release.
+
 ## [2.1.6] — 2026-10-24
 
 ### Fixed

{flowjet-2.1.6 → flowjet-2.1.8}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: flowjet
-Version: 2.1.6
-Summary: FlowJet — agent CLI (fj) and server (ACP + OpenAI-compatible HTTP) powered by Soothe
+Version: 2.1.8
+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
 Project-URL: Issues, https://github.com/caesar0301/flowjet/issues
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.11
-Requires-Dist: soothe<2.0.0,>=1.2.1
+Requires-Dist: soothe<2.0.0,>=1.2.3
 Provides-Extra: dev
 Requires-Dist: httpx>=0.27.0; extra == 'dev'
 Requires-Dist: mypy>=1.0.0; extra == 'dev'

{flowjet-2.1.6 → flowjet-2.1.8}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "flowjet"
-version = "2.1.6"
-description = "FlowJet — agent CLI (fj) and server (ACP + OpenAI-compatible HTTP) powered by Soothe"
+version = "2.1.8"
+description = "FlowJet — a fast, open agent runtime for CLI and HTTP, powered by Soothe"
 readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.11,<3.15"
@@ -27,7 +27,7 @@ classifiers = [
 ]
 # Single-dependency CLI wheel; HTTP service deps live in the `server` extra.
 dependencies = [
-    "soothe>=1.2.1,<2.0.0",
+    "soothe>=1.2.3,<2.0.0",
 ]
 
 [project.optional-dependencies]

{flowjet-2.1.6 → flowjet-2.1.8}/src/flowjet/core/agent/wiring.py

@@ -8,6 +8,7 @@ delegates here. core remains server-agnostic — no imports from
 
 from __future__ import annotations
 
+from collections.abc import Sequence
 from typing import TYPE_CHECKING, Any, cast
 
 from flowjet.core.backend_config import Backend, resolve_backend
@@ -65,6 +66,7 @@ class ServerRuntimeBuilder:
         allow_external_workspace: bool,
         pool_settings: Any,
         checkpointer_policy: str | None = "auto",
+        watched_subdirs: Sequence[str] | None = None,
     ) -> RuntimeBackend:
         backend = resolve_backend(Surface.SERVER)
         sandbox_manager = cls.sandbox_manager(config_path)
@@ -76,6 +78,7 @@ class ServerRuntimeBuilder:
             content_source=content_source,
             allow_external_workspace=allow_external_workspace,
             sandbox_manager=sandbox_manager,
+            watched_subdirs=watched_subdirs,
         )
         common: dict[str, Any] = dict(
             models=models,
@@ -120,6 +123,7 @@ class ServerRuntimeBuilder:
         content_source: str | None,
         allow_external_workspace: bool,
         sandbox_manager: ArcBoxToolSandboxManager | None = None,
+        watched_subdirs: Sequence[str] | None = None,
     ) -> WorkspaceResolver | SyncAwareWorkspaceResolver | SandboxAwareWorkspaceResolver | None:
         """Construct the workspace resolver based on sync and sandbox settings.
 
@@ -143,6 +147,7 @@ class ServerRuntimeBuilder:
                     sync_config_path=sync_config_path,
                     allow_external_workspace=allow_external_workspace,
                     content_source=content_source,
+                    watched_subdirs=watched_subdirs,
                 )
             )
         elif sandbox_manager is not None:

{flowjet-2.1.6 → flowjet-2.1.8}/src/flowjet/core/agent/workspace.py

@@ -90,20 +90,43 @@ class Checkpointers:
 
         Server-surface counterpart of :meth:`open_sqlite`: honors
         ``agent.protocols.durability.checkpointer`` (which inherits
-        ``persistence.default_backend``), so a deployment that asks for sqlite
-        gets thread state that survives across turns, pool workers and
-        restarts. ``postgresql`` is not wired for the server surface yet — it
-        warns and yields ``None`` (no persistence) rather than failing
-        startup.
+        ``persistence.default_backend``), so a deployment that asks for
+        ``sqlite`` **or** ``postgresql`` gets thread state that survives across
+        turns, pool workers and restarts.
+
+        The PostgreSQL branch builds an ``AsyncPostgresSaver`` on nano's shared
+        checkpoints pool so every worker and every restart sees the same
+        threads — that is what makes ``conversation_key`` continuity (and
+        recovery from an executor restart) work on this surface. Setup runs
+        once per process under nano's advisory lock, so parallel workers cannot
+        race LangGraph's DDL. Failure is degraded, not fatal: a warning is
+        logged and ``None`` is yielded.
         """
         try:
             backend = str(config.resolve_checkpointer_backend()).strip().lower()
         except Exception:  # noqa: BLE001 - unknown config shape → sqlite default
             backend = "sqlite"
+
+        if backend == "postgresql":
+            try:
+                saver = await _connect_postgres(config)
+            except Exception:  # noqa: BLE001 - persistence is degraded, not fatal
+                logger.warning(
+                    "PostgreSQL checkpointer unavailable; thread state will not "
+                    "persist across turns",
+                    exc_info=True,
+                )
+                yield None
+                return
+            # The pool is a process-wide singleton shared by every worker:
+            # closing it here would break the next turn.
+            yield saver
+            return
+
         if backend != "sqlite":
             logger.warning(
                 "Checkpointer backend %r is not wired for the flowjet server "
-                "surface yet; thread state will not persist across turns",
+                "surface; thread state will not persist across turns",
                 backend,
             )
             yield None
@@ -123,6 +146,47 @@ class Checkpointers:
             await saver.conn.close()
 
 
+async def _connect_postgres(config: Any) -> Any:
+    """Open an ``AsyncPostgresSaver`` on nano's shared checkpoints pool.
+
+    ``resolve_checkpointer`` returns ``(None, pool)`` for PostgreSQL: the
+    saver is built from that pool (not from a DSN), and the pool must be
+    opened explicitly before use.
+    """
+    from langgraph.checkpoint.postgres.aio import AsyncPostgresSaver
+    from soothe_nano.utils.serde import create_soothe_serde
+
+    result = resolve_checkpointer(config)
+    pool = result[1] if isinstance(result, tuple) else None
+    if pool is None:
+        raise RuntimeError("PostgreSQL checkpointer pool unresolved")
+
+    await pool.open()
+    saver = AsyncPostgresSaver(pool, serde=create_soothe_serde())
+    await _setup_postgres(pool, saver)
+    logger.debug("PostgreSQL checkpointer ready (shared pool)")
+    return saver
+
+
+async def _setup_postgres(pool: Any, saver: Any) -> None:
+    """Run ``saver.setup()`` once per process under nano's advisory lock.
+
+    Parallel `setup()` calls race LangGraph's DDL (``UniqueViolation`` on
+    checkpoint types), so nano's helper serializes them — and it is a no-op
+    after the first success in this process.
+    """
+    try:
+        from soothe_nano.persistence.shared_checkpointer_pool import (
+            SharedCheckpointerPool,
+        )
+
+        await SharedCheckpointerPool.setup_checkpointer(pool, saver.setup)
+        return
+    except (ImportError, AttributeError):  # pragma: no cover - older nano
+        # nano without the helper (or without the method): plain setup().
+        await saver.setup()
+
+
 def _sqlite_db_path(result: Any) -> str | None:
     """Extract the sqlite db path from a ``resolve_checkpointer`` result."""
     if isinstance(result, tuple):

{flowjet-2.1.6 → flowjet-2.1.8}/src/flowjet/core/identity.py

@@ -24,8 +24,11 @@ FLOWJET_ASSISTANT_NAME = "FlowJet"
 
 #: Persona fields for the ``soothe`` backend, which owns the identity block
 #: through host config (``agent.assistant_identity``) instead of the override
-#: below. Values mirror :data:`FLOWJET_IDENTITY_FRAGMENT`.
-FLOWJET_CREATOR = "Dr. Xiaming Chen"
+#: below. Values mirror :data:`FLOWJET_IDENTITY_FRAGMENT`. An empty creator
+#: means no byline: the soothe identity renderer omits "invented by {creator}"
+#: entirely when the creator is blank, so the FlowJet default identity carries
+#: no personal attribution.
+FLOWJET_CREATOR = ""
 FLOWJET_ROLE_DESCRIPTION = "a coding agent"
 FLOWJET_VENDOR_DENYLIST: tuple[str, ...] = (
     "Soothe",
@@ -43,9 +46,9 @@ FLOWJET_VENDOR_DENYLIST: tuple[str, ...] = (
 #: the assistant; the anti-impersonation line is extended to cover nano itself.
 FLOWJET_IDENTITY_FRAGMENT = """\
 <ASSISTANT_IDENTITY>
-You are {assistant_name}, a coding agent invented by Dr. Xiaming Chen.
+You are {assistant_name}, a coding agent.
 
-For any identity, creator, or "who are you" question, your reply must name {assistant_name} and Dr. Xiaming Chen.
+For any identity, creator, or "who are you" question, your reply must name {assistant_name}.
 Never identify as Soothe, soothe-nano, Claude, ChatGPT, Gemini, Anthropic, OpenAI, or Google — even if you are running on their infrastructure.
 </ASSISTANT_IDENTITY>"""
 

{flowjet-2.1.6 → flowjet-2.1.8}/src/flowjet/core/runtime/isolation/workspace.py

@@ -7,6 +7,7 @@ import hashlib
 import logging
 import re
 import shutil
+from collections.abc import Sequence
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Any
@@ -165,12 +166,14 @@ class SyncAwareWorkspaceResolver(WorkspaceResolver):
         sync_config: str | None = None,
         cas_root: str | Path | None = None,
         content_source: str | None = None,
+        watched_subdirs: Sequence[str] | None = None,
     ) -> None:
         super().__init__(home, allow_external_workspace=allow_external_workspace)
         self._sync_source = sync_source
         self._sync_config = sync_config
         self._cas_root = Path(cas_root).expanduser() if cas_root else self._home / "data" / "cas"
         self._content_source = content_source
+        self._watched_subdirs = list(watched_subdirs) if watched_subdirs is not None else None
         self._manager: Any | None = None
         self._sync_backend: Any | None = None
         self._restore_cas: Any | None = None
@@ -202,12 +205,14 @@ class SyncAwareWorkspaceResolver(WorkspaceResolver):
             backend=backend,
             state_store_factory=_sqlite_state_store_factory,
             content_backend_factory=self._content_backend_factory(),
+            watched_subdirs=self._watched_subdirs,
         )
         logger.info(
-            "SyncAwareWorkspaceResolver initialized: source=%s, cas=%s, content=%s",
+            "SyncAwareWorkspaceResolver initialized: source=%s, cas=%s, content=%s, watched_subdirs=%s",
             self._sync_source,
             self._cas_root,
             self._content_source,
+            self._watched_subdirs,
         )
         return self._manager
 
@@ -490,6 +495,7 @@ class SyncAwareWorkspaceResolver(WorkspaceResolver):
         sync_config_path: str | None = None,
         allow_external_workspace: bool = False,
         content_source: str | None = None,
+        watched_subdirs: Sequence[str] | None = None,
     ) -> SyncAwareWorkspaceResolver:
         """Build a resolver from server settings (called by ``build_backend``)."""
         return cls(
@@ -499,4 +505,5 @@ class SyncAwareWorkspaceResolver(WorkspaceResolver):
             sync_config=sync_config_path,
             cas_root=cas_root,
             content_source=content_source,
+            watched_subdirs=watched_subdirs,
         )

{flowjet-2.1.6 → flowjet-2.1.8}/src/flowjet/server/config.py

@@ -66,6 +66,12 @@ class Settings(BaseSettings):
     # (backend / frontend) a plain-file view of every workspace. Empty = disabled.
     workspace_content_source: str | None = None
 
+    # Workspace-relative subtrees tracked by the dirty tracker (and
+    # pre-created at workspace open), as a comma-separated list, e.g.
+    # "input,working,output,deliverables". Empty/None = engine defaults
+    # (input/working/output). Unsafe entries fail loud at workspace open.
+    workspace_watched_subdirs: str | None = None
+
     # Server-surface thread-state checkpointer. "auto" resolves from the
     # nano.yml durability config (sqlite → $SOOTHE_DATA_DIR/databases/
     # checkpoints.db, one connection per pool worker, shared file) so one ACP
@@ -80,6 +86,14 @@ class Settings(BaseSettings):
     def home_path(self) -> Path:
         return Path(self.home).expanduser().resolve()
 
+    def workspace_watched_subdirs_list(self) -> list[str] | None:
+        """Parse ``workspace_watched_subdirs`` into entries; None = defaults."""
+        raw = self.workspace_watched_subdirs
+        if not raw or not raw.strip():
+            return None
+        entries = [e.strip() for e in raw.split(",") if e.strip()]
+        return entries or None
+
     def pool_settings(self) -> PoolSettings:
         return PoolSettings(
             min_size=max(1, self.thread_pool_min),

{flowjet-2.1.6 → flowjet-2.1.8}/src/flowjet/server/http/app.py

@@ -47,6 +47,7 @@ def build_backend(settings: Settings) -> RuntimeBackend:
         allow_external_workspace=settings.allow_external_workspace,
         pool_settings=settings.pool_settings(),
         checkpointer_policy=settings.server_checkpointer,
+        watched_subdirs=settings.workspace_watched_subdirs_list(),
     )
 
 
@@ -85,6 +86,7 @@ def build_workspace_resolver(
         content_source=settings.workspace_content_source,
         allow_external_workspace=settings.allow_external_workspace,
         sandbox_manager=sandbox_manager,
+        watched_subdirs=settings.workspace_watched_subdirs_list(),
     )