gemcode 0.3.71__py3-none-any.whl → 0.3.72__py3-none-any.whl

gemcode/agent.py

@@ -887,7 +887,6 @@ def build_root_agent(
             pre-built list that excludes run_subtask itself, preventing recursion).
             When set, build_function_tools() is NOT called.
   """
-  return (base + tool_guide).strip() + "\n"
   if _tools is not None:
     tools = list(_tools)
   else:
@@ -966,12 +965,51 @@ def build_root_agent(
       tool_config=tool_cfg,
     )
 
+  # ── ADK multi-agent tree (LLM-controlled transfer) ───────────────────────
+  sub_agents = []
+  if getattr(cfg, "enable_adk_agent_transfer", True) and _tools is None:
+    try:
+      # Explorer: read-only, fast, low-risk. Keep instruction short.
+      explorer_tools = build_function_tools(cfg, include_subtask=False)
+      explorer_tools = [t for t in explorer_tools if getattr(t, "__name__", "") not in ("write_file", "search_replace", "delete_file", "move_file", "bash", "run_command")]
+      explorer = LlmAgent(
+        name="explorer",
+        model=getattr(cfg, "model_alt", None) or cfg.model,
+        instruction=(
+          "You are Explorer. Your job is to quickly map the codebase and answer: "
+          "what files/symbols matter and where to look next. Use read-only tools only. "
+          "Return concise findings with file paths and symbol names."
+        ),
+        tools=explorer_tools,
+        generate_content_config=gen_cfg,
+        **cb_kwargs,
+      )
+      # Verifier: focuses on checking, tests, and consistency.
+      verifier_tools = build_function_tools(cfg, include_subtask=False)
+      verifier_tools = [t for t in verifier_tools if getattr(t, "__name__", "") not in ("write_file", "search_replace", "delete_file", "move_file")]
+      verifier = LlmAgent(
+        name="verifier",
+        model=getattr(cfg, "model_alt", None) or cfg.model,
+        instruction=(
+          "You are Verifier. Your job is to verify changes: run checks/tests when needed, "
+          "spot inconsistencies, and report PASS/FAIL with concrete evidence. "
+          "Prefer minimal commands and short outputs."
+        ),
+        tools=verifier_tools,
+        generate_content_config=gen_cfg,
+        **cb_kwargs,
+      )
+      sub_agents = [explorer, verifier]
+    except Exception:
+      sub_agents = []
+
   agent_kwargs: dict = dict(
       model=cfg.model,
       name="gemcode",
       instruction=build_instruction(cfg),
       tools=tools,
       generate_content_config=gen_cfg,
+      sub_agents=sub_agents or None,
       **cb_kwargs,
   )
 

gemcode/config.py

@@ -141,6 +141,31 @@ class GemCodeConfig:
     default_factory=lambda: int(os.environ.get("GEMCODE_TOOL_RESULT_GROUP_BUDGET_CHARS", "60000"))
   )
 
+  # ADK App-level event compaction (sliding-window summarization).
+  enable_adk_events_compaction: bool = field(
+    default_factory=lambda: _truthy_env("GEMCODE_ADK_EVENTS_COMPACTION", default=False)
+  )
+  adk_compaction_interval: int = field(
+    default_factory=lambda: int(os.environ.get("GEMCODE_ADK_COMPACTION_INTERVAL", "6"))
+  )
+  adk_compaction_overlap: int = field(
+    default_factory=lambda: int(os.environ.get("GEMCODE_ADK_COMPACTION_OVERLAP", "1"))
+  )
+  adk_compaction_token_threshold: int | None = field(
+    default_factory=lambda: _opt_positive_int("GEMCODE_ADK_COMPACTION_TOKEN_THRESHOLD")
+  )
+  adk_compaction_event_retention_size: int | None = field(
+    default_factory=lambda: _opt_positive_int("GEMCODE_ADK_COMPACTION_EVENT_RETENTION")
+  )
+  adk_compaction_summarizer_model: str = field(
+    default_factory=lambda: os.environ.get("GEMCODE_ADK_COMPACTION_MODEL", "gemini-2.5-flash")
+  )
+
+  # ADK multi-agent transfer (Explorer/Implementer/Verifier sub-agents).
+  enable_adk_agent_transfer: bool = field(
+    default_factory=lambda: _truthy_env("GEMCODE_ADK_AGENT_TRANSFER", default=True)
+  )
+
   # When enabled, oversized tool outputs are offloaded to disk under
   # .gemcode/tool-results/ and replaced in history with stable refs + previews.
   # This reduces context bloat and improves prompt-cache stability.

gemcode/repl_slash.py

@@ -400,6 +400,14 @@ async def process_repl_slash(
       out(f"    dynamic_token_policy:  {getattr(cfg, 'dynamic_token_policy', True)}")
       out(f"    dynamic_risk_policy:   {getattr(cfg, 'dynamic_risk_policy', True)}")
       out(f"    dynamic_risk_boost:    {getattr(cfg, 'dynamic_risk_boost', 0.6)}")
+      out()
+      out("  ADK advanced:")
+      out(f"    adk_agent_transfer:    {getattr(cfg, 'enable_adk_agent_transfer', True)}")
+      out(f"    adk_events_compaction: {getattr(cfg, 'enable_adk_events_compaction', False)}")
+      if getattr(cfg, "enable_adk_events_compaction", False):
+        out(f"    compaction_interval:   {getattr(cfg, 'adk_compaction_interval', 6)}")
+        out(f"    compaction_overlap:    {getattr(cfg, 'adk_compaction_overlap', 1)}")
+        out(f"    compaction_model:      {getattr(cfg, 'adk_compaction_summarizer_model', 'gemini-2.5-flash')}")
       out(f"    risk_score:            {risk:.2f}")
       if isinstance(pct, int):
         out(f"    context_percent_left:  {pct}%")

gemcode/session_runtime.py

@@ -66,11 +66,39 @@ def _build_app(agent, plugins, cfg: GemCodeConfig):
   """
   try:
     from google.adk.apps.app import App
+    events_compaction_config = None
+    if getattr(cfg, "enable_adk_events_compaction", False):
+      try:
+        from google.adk.apps.app import EventsCompactionConfig
+        summarizer = None
+        try:
+          from google.adk.apps.llm_event_summarizer import LlmEventSummarizer
+          from google.adk.models import Gemini
+          summarizer_llm = Gemini(model=getattr(cfg, "adk_compaction_summarizer_model", "gemini-2.5-flash"))
+          summarizer = LlmEventSummarizer(llm=summarizer_llm)
+        except Exception:
+          summarizer = None
+
+        kw = dict(
+          compaction_interval=max(2, int(getattr(cfg, "adk_compaction_interval", 6) or 6)),
+          overlap_size=max(0, int(getattr(cfg, "adk_compaction_overlap", 1) or 1)),
+        )
+        tt = getattr(cfg, "adk_compaction_token_threshold", None)
+        rs = getattr(cfg, "adk_compaction_event_retention_size", None)
+        if tt is not None and rs is not None:
+          kw["token_threshold"] = int(tt)
+          kw["event_retention_size"] = int(rs)
+        if summarizer is not None:
+          kw["summarizer"] = summarizer
+        events_compaction_config = EventsCompactionConfig(**kw)
+      except Exception:
+        events_compaction_config = None
     return App(
       name="gemcode",
       root_agent=agent,
       plugins=plugins,
       context_cache_config=_build_context_cache_config(),
+      events_compaction_config=events_compaction_config,
     )
   except Exception:
     # Fall back silently — Runner still accepts the legacy kwargs.

{gemcode-0.3.71.dist-info → gemcode-0.3.72.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.71
+Version: 0.3.72
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License
@@ -246,6 +246,11 @@ GemCode keeps project-local state under `.gemcode/`:
   - `gemcode tools smoke` fails non-zero if any tool’s declaration compilation fails
   - Optional inspection flags: `--deep-research`, `--maps-grounding`, `--embeddings`, `--memory`
 - **Optional compaction**: set `GEMCODE_ENABLE_COMPACT=1` to trim old `Content` entries before each model call (MVP sliding window; can break complex tool chains if too aggressive—tune `GEMCODE_MAX_CONTENT_ITEMS`).
+- **ADK multi-agent transfer (recommended)**: enabled by default; GemCode builds an ADK sub-agent tree (Explorer/Verifier) and allows the model to transfer with `transfer_to_agent` when specialization helps.
+  - Disable: `GEMCODE_ADK_AGENT_TRANSFER=0`
+- **ADK event compaction (new)**: optional ADK-native summarization of older events to keep long sessions coherent without exploding context.
+  - Enable: `GEMCODE_ADK_EVENTS_COMPACTION=1`
+  - Tune: `GEMCODE_ADK_COMPACTION_INTERVAL`, `GEMCODE_ADK_COMPACTION_OVERLAP`, `GEMCODE_ADK_COMPACTION_MODEL`
 - **Session token ceiling**: set `GEMCODE_MAX_SESSION_TOKENS` to stop the next LLM call when cumulative `usage_metadata.total_token_count` exceeds the limit.
 - **Token budget tracking**: set `GEMCODE_TOKEN_BUDGET` to enforce continuation/stop decisions per user turn (token-budget audit in `.gemcode/audit.log`).
 - **Stop-the-loop hooks**: set `GEMCODE_POST_TURN_HOOK=/path/to/hook.sh` (or place an executable at `.gemcode/hooks/post_turn`) to run after each user message.

{gemcode-0.3.71.dist-info → gemcode-0.3.72.dist-info}/RECORD

@@ -1,13 +1,13 @@
 gemcode/__init__.py,sha256=l0DCRYqK7KM7Fb7u49fqh-5_SlpeIL7r3LjMeJWMgSg,112
 gemcode/__main__.py,sha256=EX2s1hxq2Yvli_-tnBN3w5Qv4bOjsBBbjyISF0pDIQw,37
-gemcode/agent.py,sha256=yft-8lLJbX4abM_bUW156JWfVT3b4OHO-_hIoKdVaOs,52032
+gemcode/agent.py,sha256=EogvAa9qBHY_rYmC52wks8G4dTYrJK0li5_zHFF9yN8,53894
 gemcode/audit.py,sha256=bh9uhXaeh8wqxqoZtz3ZAowd8Ndk1ss-mw9993Vlrgo,469
 gemcode/autocompact.py,sha256=77h5tgFzJ2rjrhlCL2oIc28IHwLbP4Pqlo7cSNgDwiA,6727
 gemcode/callbacks.py,sha256=EYkJTRcHjCeqTgVZGat2Y3BYWg4tNtHl-cgl5cdUxpo,31076
 gemcode/capability_routing.py,sha256=yvQXwKtrfHXbgbNunU0Dxh9GCDN4cbySXIeccrdzr2o,3471
 gemcode/cli.py,sha256=kBXb4b4JCG3u0XewCJn8lCyOT62Y8bOvlVoDc2R-GKQ,25320
 gemcode/compaction.py,sha256=9YtA_qa23_8dHWVHx7AJwUduuI7jJQtq-m6sT8jgPWI,1186
-gemcode/config.py,sha256=APBKPIpGvKd46Xt0ZGOZfVr8Tl6EAPbwqDsuM45jc1U,15609
+gemcode/config.py,sha256=20OnbYjcvwTZ9qwKF5Ih-NfHxrpzctQ-bSXQtAZjYWI,16726
 gemcode/context_budget.py,sha256=Nhox9vFBtLbb7jtO7cyGW1MxtN7SVjlIeQ7d-cgGyKM,10544
 gemcode/context_warning.py,sha256=Q8mg5Vojj7EglPhsGAVL7vb8ROLuHVPgdzw25yw-Q2c,4263
 gemcode/credentials.py,sha256=04v-rLD8_Ams69FQdof2FwcL3ZgsroGUnMcHNQFuBZo,1296
@@ -33,9 +33,9 @@ gemcode/pricing.py,sha256=lftp0SwyDqOzHqC2-6XzgZZhjif5PLdCe1Q3wY-p6kQ,3558
 gemcode/prompt_suggestions.py,sha256=h-W_9LlfagS91PyoMEjEjsCqoG4XmIh3QBypA59HyGw,2553
 gemcode/refine.py,sha256=BijEZ4Z32wGa9aK_WottyAhZF-j0xEqRg5UpjedNv2A,7653
 gemcode/repl_commands.py,sha256=AHjDUhlq7IuSL6Fla17y0aeGZyp6snxwbMG7gz1PrRc,11330
-gemcode/repl_slash.py,sha256=4YZ4ZsPoWWQ6oV6WKxkXS7C6R55On0E4H1SH0oxqB88,48778
+gemcode/repl_slash.py,sha256=L5KFu4uriijEtxYgFJIpgiOrqk_F7aGnc7pJheYUDlM,49355
 gemcode/review_agent.py,sha256=4t7_5-aE60b4-EheJ_eSB_H2eQYf9GppKoui6jw0TME,5264
-gemcode/session_runtime.py,sha256=o65TYRkCiNKDk2o7CiTs7Trpm41RLI2g0HiK1QyvqQc,19216
+gemcode/session_runtime.py,sha256=mHZooqGPjaLwUcLzkTaHQ_i13OiRqHlPPQ9PYFmtDfM,20513
 gemcode/session_store.py,sha256=POUT_QQf715c74jbXj0s5vCd4dlAgJz_CLsIWuEUoO0,6051
 gemcode/slash_commands.py,sha256=Qylzsj1notk0xN_hvd3CR4HD8g-l99UENDMcg1pKeBA,794
 gemcode/thinking.py,sha256=RanBf_x9fKv1o4DNyNXPLfOdn2xT0KybJb65nYgmMEE,4885
@@ -87,9 +87,9 @@ gemcode/tui/welcome_rich.py,sha256=8FEZzLXrzqly5JWiDgV9ooRV1LNXDk-CXV1a7K6ua-U,4
 gemcode/web/__init__.py,sha256=EysmUAWs6g-lmMk4VFljKfaHVrEgb_FiIzwQmBdORJc,40
 gemcode/web/claude_sse_adapter.py,sha256=HcNp0Lh4DdBZBLOpstsqa-VzfqAUrRngZ6FSuJ-mIMg,8609
 gemcode/web/terminal_repl.py,sha256=k2irvFGbCY8gDm_pbirR7b_cakaeafcctoTIvnJkVXk,3902
-gemcode-0.3.71.dist-info/licenses/LICENSE,sha256=TD4524qn-W8Z07GTDnag-9jJPFutFZNB0a1WbMHPC54,8388
-gemcode-0.3.71.dist-info/METADATA,sha256=OkyL8aZtBhHoGZhMZslyEHdaEeMQf8uwUAU75YTXHYY,25852
-gemcode-0.3.71.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gemcode-0.3.71.dist-info/entry_points.txt,sha256=cZdLTLDiHbks7OSUCuxCh66dCWeQdpLR8BozoqfEjV4,45
-gemcode-0.3.71.dist-info/top_level.txt,sha256=UYrjULLBY2bcgK6KI6flomJWmsbDXu7n0rvW2SWFrbo,8
-gemcode-0.3.71.dist-info/RECORD,,
+gemcode-0.3.72.dist-info/licenses/LICENSE,sha256=TD4524qn-W8Z07GTDnag-9jJPFutFZNB0a1WbMHPC54,8388
+gemcode-0.3.72.dist-info/METADATA,sha256=Gc52r_EC_JeO0CEkJZN-zdfxrRkUWDHCToG4wHt5xmA,26402
+gemcode-0.3.72.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gemcode-0.3.72.dist-info/entry_points.txt,sha256=cZdLTLDiHbks7OSUCuxCh66dCWeQdpLR8BozoqfEjV4,45
+gemcode-0.3.72.dist-info/top_level.txt,sha256=UYrjULLBY2bcgK6KI6flomJWmsbDXu7n0rvW2SWFrbo,8
+gemcode-0.3.72.dist-info/RECORD,,