gemcode 0.4.11__tar.gz → 0.4.13__tar.gz

{gemcode-0.4.11/src/gemcode.egg-info → gemcode-0.4.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.4.11
+Version: 0.4.13
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License
@@ -398,6 +398,8 @@ The LLM calls `transfer_to_agent(agent_name='verifier')` → ADK routes natively
 
 For background work: `org_delegate("kaira", "run tests")` → mesh runs kaira as a full GemCode session → result flows back via fleet reports.
 
+**Mesh / habits reliability:** overlapping jobs for the **same** org member serialize writes to that agent’s durable SQLite session so ADK does not raise “stale session” errors. Mesh workers default to **unattended tool approval** (env **`GEMCODE_MESH_WORKER_UNATTENDED`**, on by default) so background shell / delegation / writes do not block the main TUI on HITL. See [`../docs/configuration.md`](../docs/configuration.md) and [`../docs/orchestration.md`](../docs/orchestration.md).
+
 Docs:
 - [`../docs/orchestration.md`](../docs/orchestration.md)
 

{gemcode-0.4.11 → gemcode-0.4.13}/README.md

@@ -205,6 +205,8 @@ The LLM calls `transfer_to_agent(agent_name='verifier')` → ADK routes natively
 
 For background work: `org_delegate("kaira", "run tests")` → mesh runs kaira as a full GemCode session → result flows back via fleet reports.
 
+**Mesh / habits reliability:** overlapping jobs for the **same** org member serialize writes to that agent’s durable SQLite session so ADK does not raise “stale session” errors. Mesh workers default to **unattended tool approval** (env **`GEMCODE_MESH_WORKER_UNATTENDED`**, on by default) so background shell / delegation / writes do not block the main TUI on HITL. See [`../docs/configuration.md`](../docs/configuration.md) and [`../docs/orchestration.md`](../docs/orchestration.md).
+
 Docs:
 - [`../docs/orchestration.md`](../docs/orchestration.md)
 

{gemcode-0.4.11 → gemcode-0.4.13}/pyproject.toml

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

{gemcode-0.4.11 → gemcode-0.4.13}/src/gemcode/agent_habits.py

@@ -323,6 +323,11 @@ def make_habits_tools(cfg: GemCodeConfig) -> list:
     Habits run inside the main GemCode process — no separate daemon needed.
     They fire as long as GemCode is open (REPL/TUI session).
 
+    Results go to the fleet inbox (.gemcode/fleet_reports.jsonl). Fleet auto-continue
+    (GEMCODE_FLEET_REPORTS_AUTO_CONTINUE, default on) can inject digest turns after each assistant
+    reply so the main agent summarizes habit output. Set GEMCODE_FLEET_REPORTS_AUTO_CONTINUE=0 to
+    only drain on your next normal message.
+
     Args:
       name: Unique name for this habit (e.g., "test-watch", "nightly-audit").
       agent: Org member name to run this (e.g., "kaira", "verifier").

{gemcode-0.4.11 → gemcode-0.4.13}/src/gemcode/agent_mesh.py

@@ -24,7 +24,7 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any
 
-from gemcode.config import GemCodeConfig
+from gemcode.config import GemCodeConfig, _truthy_env
 from gemcode.event_bus import BusMessage, EventBus, get_bus
 from gemcode.org import OrgMember, find_member, list_members, resolve_fleet_root
 
@@ -44,6 +44,21 @@ class AgentJob:
   created_ms: int = field(default_factory=lambda: int(time.time() * 1000))
 
 
+def _apply_mesh_worker_unattended_policy(cfg: GemCodeConfig) -> None:
+  """
+  Mesh jobs run on a background thread: there is no human at a separate keyboard.
+  When enabled (default), treat the worker like ``--yes`` and disable in-run HITL so
+  shell / org_delegate / write tools from habits and workers do not block the main TUI.
+
+  Opt out: ``GEMCODE_MESH_WORKER_UNATTENDED=0`` (mesh workers then inherit the
+  manager's ``yes_to_all`` / ``interactive_permission_ask`` as before).
+  """
+  if not _truthy_env("GEMCODE_MESH_WORKER_UNATTENDED", default=True):
+    return
+  cfg.yes_to_all = True
+  cfg.interactive_permission_ask = False
+
+
 class AgentMesh:
   """
   In-process agent orchestration mesh.
@@ -72,6 +87,12 @@ class AgentMesh:
     # _stop is created lazily in the background loop
     self._stop_flag = False
 
+    # Serialize ADK SqliteSessionService writes per (db, user_id, session_id).
+    # Concurrent mesh jobs for the same agent share one session row; interleaved
+    # append_event calls hit optimistic-lock checks and raise "stale session".
+    self._mesh_sqlite_session_locks: dict[str, asyncio.Lock] = {}
+    self._mesh_sqlite_session_locks_guard = asyncio.Lock()
+
     # Subscribe to org.assign messages on the bus
     self._bus.subscribe(
       topic="org.assign",
@@ -115,6 +136,22 @@ class AgentMesh:
   def bus(self) -> EventBus:
     return self._bus
 
+  async def _lock_sqlite_session(
+      self,
+      *,
+      db_path: Path,
+      user_id: str,
+      session_id: str,
+  ) -> asyncio.Lock:
+    """Return the asyncio lock for this ADK SQLite session (create if needed)."""
+    key = f"{db_path.resolve()}\0{user_id}\0{session_id}"
+    async with self._mesh_sqlite_session_locks_guard:
+      lock = self._mesh_sqlite_session_locks.get(key)
+      if lock is None:
+        lock = asyncio.Lock()
+        self._mesh_sqlite_session_locks[key] = lock
+      return lock
+
   def start(self) -> None:
     """Start the mesh in a dedicated background thread with its own event loop.
 
@@ -400,16 +437,21 @@ class AgentMesh:
       except Exception:
         pass
 
-      # Persist to fleet reports
+      # Persist to fleet reports (include habit + member so the manager inbox reads clearly)
       try:
         from gemcode.fleet_reports import maybe_append_job_report
         fleet_root = resolve_fleet_root(self.cfg.project_root)
-        maybe_append_job_report(fleet_root, {
+        pl: dict[str, Any] = {
           "job_id": job.job_id,
           "session_id": job.session_id,
           "status": "finished",
           "report": result_text[:8000],
-        })
+          "member": job.member_name or "",
+        }
+        hm = job.meta.get("habit") if isinstance(job.meta, dict) else None
+        if isinstance(hm, dict):
+          pl["habit"] = hm
+        maybe_append_job_report(fleet_root, pl)
       except Exception:
         pass
 
@@ -434,12 +476,17 @@ class AgentMesh:
       try:
         from gemcode.fleet_reports import maybe_append_job_report
         fleet_root = resolve_fleet_root(self.cfg.project_root)
-        maybe_append_job_report(fleet_root, {
+        plf: dict[str, Any] = {
           "job_id": job.job_id,
           "session_id": job.session_id,
           "status": "failed",
           "report": job.error[:8000],
-        })
+          "member": job.member_name or "",
+        }
+        hm = job.meta.get("habit") if isinstance(job.meta, dict) else None
+        if isinstance(hm, dict):
+          plf["habit"] = hm
+        maybe_append_job_report(fleet_root, plf)
       except Exception:
         pass
 
@@ -465,14 +512,17 @@ class AgentMesh:
     This means agents build up context over time — they remember past tasks,
     learn from their history, and maintain their own notes.
     """
+    import hashlib
+
     from gemcode.invoke import run_turn
-    from gemcode.session_runtime import create_runner
+    from gemcode.session_runtime import create_runner, session_db_path
     from gemcode.capability_routing import apply_capability_routing
     from gemcode.model_routing import pick_effective_model
 
     # Resolve the agent's workspace as their project root
     # This gives them their own .gemcode/ directory, sessions, memory, etc.
     agent_cfg = copy.deepcopy(self.cfg)
+    _apply_mesh_worker_unattended_policy(agent_cfg)
     fleet_root = resolve_fleet_root(self.cfg.project_root)
 
     if job.member_name:
@@ -497,54 +547,56 @@ class AgentMesh:
     parent_tools = self._build_parent_access_tools(fleet_root)
     all_extra = (mesh_tools or []) + (parent_tools or [])
 
-    # Create a FULL runner rooted at the agent's workspace
-    # This gives them their own SQLite session DB, their own memory, etc.
-    runner = create_runner(agent_cfg, extra_tools=all_extra or None)
+    # Stable session ID per agent (same id across jobs = durable history).
+    stable_session_id = (job.session_id or "").strip()
+    if job.member_name:
+      stable_session_id = f"agent_{hashlib.sha256(job.member_name.encode()).hexdigest()[:12]}"
+    mesh_user_id = job.member_name or "mesh"
 
-    try:
-      # Use a stable session ID per agent so they accumulate history
-      # (not a random UUID — the same agent keeps the same session across jobs)
-      stable_session_id = job.session_id
-      if job.member_name:
-        # Stable session = agent name hash (persists across jobs)
-        import hashlib
-        stable_session_id = f"agent_{hashlib.sha256(job.member_name.encode()).hexdigest()[:12]}"
-
-      # Execute the turn with full power
-      max_calls = min(int(self.cfg.max_llm_calls or 128), 128)
-      events = await run_turn(
-        runner,
-        user_id=job.member_name or "mesh",
+    sqlite_lock = await self._lock_sqlite_session(
+        db_path=session_db_path(agent_cfg),
+        user_id=mesh_user_id,
         session_id=stable_session_id,
-        prompt=job.prompt,
-        max_llm_calls=max_calls,
-        cfg=agent_cfg,
-        consume_fleet_reports=False,
-      )
+    )
 
-      # Extract text from events
-      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
+    async with sqlite_lock:
+      # One runner + turn at a time per session row — avoids ADK "stale session"
+      # when habits or overlapping delegations write events concurrently.
+      runner = create_runner(agent_cfg, extra_tools=all_extra or None)
 
-      return "".join(parts).strip() or "(no output)"
-    finally:
-      # Clean up the runner
       try:
-        await runner.close()
-      except Exception:
-        pass
+        max_calls = min(int(self.cfg.max_llm_calls or 128), 128)
+        events = await run_turn(
+          runner,
+          user_id=mesh_user_id,
+          session_id=stable_session_id,
+          prompt=job.prompt,
+          max_llm_calls=max_calls,
+          cfg=agent_cfg,
+          consume_fleet_reports=False,
+        )
+
+        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
+
+        return "".join(parts).strip() or "(no output)"
+      finally:
+        try:
+          await runner.close()
+        except Exception:
+          pass
 
   def _build_parent_access_tools(self, fleet_root: Path) -> list:
     """

{gemcode-0.4.11 → gemcode-0.4.13}/src/gemcode/fleet_reports.py

@@ -33,12 +33,9 @@ def inject_enabled() -> bool:
 
 
 def auto_continue_enabled() -> bool:
-  return os.environ.get("GEMCODE_FLEET_REPORTS_AUTO_CONTINUE", "").strip().lower() in (
-    "1",
-    "true",
-    "yes",
-    "on",
-  )
+  """When true, queue a manager digest after each turn if fleet reports are pending (TUI/REPL). Default on; set GEMCODE_FLEET_REPORTS_AUTO_CONTINUE=0 to disable."""
+  v = os.environ.get("GEMCODE_FLEET_REPORTS_AUTO_CONTINUE", "1").strip().lower()
+  return v not in ("0", "false", "no", "off")
 
 
 def auto_continue_mode() -> str:
@@ -59,9 +56,10 @@ def max_auto_chain() -> int:
 def fleet_digest_prompt() -> str:
   return (
     f"{_DIGEST_MARKER}\n"
-    "Background agents may have completed work; fleet reports were drained at the start of this turn if any were queued.\n"
-    "Summarize outcomes for the user in short bullets. Do not call org_delegate, org_spawn, or spawn_subtasks "
-    "unless you must fix a reported error."
+    "New background work arrived (habits, mesh jobs, or agent messages). Summarize for the user in a short, "
+    "conversational way—like you are relaying what the other agent just did. Call out what changed since last time "
+    "if the report looks like a recurring check. Do not call org_delegate, org_spawn, or spawn_subtasks unless you "
+    "must fix a reported error."
   )
 
 
@@ -248,6 +246,15 @@ def _format_record(rec: dict[str, Any]) -> str:
       f"[job.report] job_id={payload.get('job_id')} status={payload.get('status')} "
       f"session_id={payload.get('session_id')}"
     )
+    mem = str(payload.get("member") or "").strip()
+    if mem:
+      lines.append(f"  member: {mem}")
+    hab = payload.get("habit")
+    if isinstance(hab, dict):
+      hn = str(hab.get("name") or "").strip()
+      ha = str(hab.get("agent") or "").strip()
+      if hn:
+        lines.append(f"  habit: {hn}" + (f" (runs as agent `{ha}`)" if ha else ""))
     rpt = str(payload.get("report") or "").strip()
     if rpt:
       lines.append(f"  report: {rpt[:8000]}")

{gemcode-0.4.11 → gemcode-0.4.13/src/gemcode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.4.11
+Version: 0.4.13
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License
@@ -398,6 +398,8 @@ The LLM calls `transfer_to_agent(agent_name='verifier')` → ADK routes natively
 
 For background work: `org_delegate("kaira", "run tests")` → mesh runs kaira as a full GemCode session → result flows back via fleet reports.
 
+**Mesh / habits reliability:** overlapping jobs for the **same** org member serialize writes to that agent’s durable SQLite session so ADK does not raise “stale session” errors. Mesh workers default to **unattended tool approval** (env **`GEMCODE_MESH_WORKER_UNATTENDED`**, on by default) so background shell / delegation / writes do not block the main TUI on HITL. See [`../docs/configuration.md`](../docs/configuration.md) and [`../docs/orchestration.md`](../docs/orchestration.md).
+
 Docs:
 - [`../docs/orchestration.md`](../docs/orchestration.md)
 

{gemcode-0.4.11 → gemcode-0.4.13}/tests/test_agent_mesh.py

@@ -3,11 +3,18 @@
 from __future__ import annotations
 
 import asyncio
+import os
 from pathlib import Path
 
 import pytest
 
-from gemcode.agent_mesh import AgentMesh, ensure_mesh, get_mesh, reset_mesh
+from gemcode.agent_mesh import (
+  AgentMesh,
+  _apply_mesh_worker_unattended_policy,
+  ensure_mesh,
+  get_mesh,
+  reset_mesh,
+)
 from gemcode.config import GemCodeConfig
 from gemcode.event_bus import BusMessage, get_bus, reset_bus
 
@@ -21,6 +28,26 @@ def _reset():
   reset_bus()
 
 
+@pytest.mark.asyncio
+async def test_lock_sqlite_session_same_key_reuses_lock(tmp_path: Path) -> None:
+  cfg = GemCodeConfig(project_root=tmp_path)
+  mesh = AgentMesh(cfg)
+  db = tmp_path / ".gemcode" / "sessions.sqlite"
+  a = await mesh._lock_sqlite_session(db_path=db, user_id="agent_x", session_id="sess1")
+  b = await mesh._lock_sqlite_session(db_path=db, user_id="agent_x", session_id="sess1")
+  assert a is b
+
+
+@pytest.mark.asyncio
+async def test_lock_sqlite_session_different_session_distinct_locks(tmp_path: Path) -> None:
+  cfg = GemCodeConfig(project_root=tmp_path)
+  mesh = AgentMesh(cfg)
+  db = tmp_path / ".gemcode" / "sessions.sqlite"
+  a = await mesh._lock_sqlite_session(db_path=db, user_id="agent_x", session_id="sess1")
+  b = await mesh._lock_sqlite_session(db_path=db, user_id="agent_x", session_id="sess2")
+  assert a is not b
+
+
 def test_mesh_creation(tmp_path: Path) -> None:
   cfg = GemCodeConfig(project_root=tmp_path)
   mesh = ensure_mesh(cfg)
@@ -76,6 +103,40 @@ def test_mesh_bus_integration(tmp_path: Path) -> None:
   assert received[0].payload["member"] == "test"
 
 
+def test_apply_mesh_worker_unattended_default_on(tmp_path: Path) -> None:
+  cfg = GemCodeConfig(project_root=tmp_path)
+  cfg.yes_to_all = False
+  cfg.interactive_permission_ask = True
+  old = os.environ.get("GEMCODE_MESH_WORKER_UNATTENDED")
+  try:
+    os.environ.pop("GEMCODE_MESH_WORKER_UNATTENDED", None)
+    _apply_mesh_worker_unattended_policy(cfg)
+  finally:
+    if old is None:
+      os.environ.pop("GEMCODE_MESH_WORKER_UNATTENDED", None)
+    else:
+      os.environ["GEMCODE_MESH_WORKER_UNATTENDED"] = old
+  assert cfg.yes_to_all is True
+  assert cfg.interactive_permission_ask is False
+
+
+def test_apply_mesh_worker_unattended_off_inherits_manager(tmp_path: Path) -> None:
+  cfg = GemCodeConfig(project_root=tmp_path)
+  cfg.yes_to_all = False
+  cfg.interactive_permission_ask = True
+  old = os.environ.get("GEMCODE_MESH_WORKER_UNATTENDED")
+  try:
+    os.environ["GEMCODE_MESH_WORKER_UNATTENDED"] = "0"
+    _apply_mesh_worker_unattended_policy(cfg)
+  finally:
+    if old is None:
+      os.environ.pop("GEMCODE_MESH_WORKER_UNATTENDED", None)
+    else:
+      os.environ["GEMCODE_MESH_WORKER_UNATTENDED"] = old
+  assert cfg.yes_to_all is False
+  assert cfg.interactive_permission_ask is True
+
+
 def test_mesh_priority_ordering(tmp_path: Path) -> None:
   """Higher priority jobs should be dequeued first."""
   cfg = GemCodeConfig(project_root=tmp_path)