gemcode 0.3.105__tar.gz → 0.3.107__tar.gz

{gemcode-0.3.105/src/gemcode.egg-info → gemcode-0.3.107}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.105
+Version: 0.3.107
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License
@@ -327,6 +327,17 @@ GemCode combines:
 Reference:
 - [`../docs/tools-and-permissions.md`](../docs/tools-and-permissions.md)
 
+### Super mode (fully autonomous)
+
+Use when you want GemCode to run without GemCode’s own confirmation prompts (mutations, shell, ADK confirmation handoffs, AFC stdin prompt, attachment gate, auto-trust on CLI, and non-interactive `get_user_choice` = first option).
+
+- **CLI:** `gemcode -C . --super "your task"`
+- **Env:** `GEMCODE_SUPER_MODE=1`
+- **REPL/TUI:** `/super` (use `/super off` to clear the flag only)
+- **Kaira:** `gemcode kaira -C . --super`
+
+Details and safety notes: [`../docs/tools-and-permissions.md`](../docs/tools-and-permissions.md#super-mode-fully-autonomous).
+
 ## Common commands
 
 ### Inspect models
@@ -349,6 +360,33 @@ gemcode -C . --attach ./report.pdf "Summarize this"
 gemcode kaira -C .
 ```
 
+### Orchestration (Kaira + org delegation)
+
+Docs:
+- `../docs/orchestration.md`
+
+In one terminal:
+
+```bash
+gemcode kaira -C .
+```
+
+In another terminal:
+
+```bash
+gemcode -C .
+```
+
+Then in the REPL/TUI:
+
+```text
+/org tree
+/org hire verifier "QA / test planner" subagent gemcode "Find risks, propose tests, review plans."
+/org assign verifier "Review the plan and propose tests"
+/kaira jobs
+/kaira follow <job_id_prefix>
+```
+
 ### Start the IDE bridge
 ```bash
 gemcode ide --stdio
@@ -383,6 +421,7 @@ Status note:
 | `/review` | Run a review workflow |
 | `/eval` | Run evaluation gates |
 | `/kaira` | Show scheduler usage help |
+| `/super` | Super mode: auto-approve tools, no GemCode HITL · `/super off` |
 
 Detailed behavior:
 - [`../docs/cli-and-repl.md`](../docs/cli-and-repl.md)

{gemcode-0.3.105 → gemcode-0.3.107}/README.md

@@ -135,6 +135,17 @@ GemCode combines:
 Reference:
 - [`../docs/tools-and-permissions.md`](../docs/tools-and-permissions.md)
 
+### Super mode (fully autonomous)
+
+Use when you want GemCode to run without GemCode’s own confirmation prompts (mutations, shell, ADK confirmation handoffs, AFC stdin prompt, attachment gate, auto-trust on CLI, and non-interactive `get_user_choice` = first option).
+
+- **CLI:** `gemcode -C . --super "your task"`
+- **Env:** `GEMCODE_SUPER_MODE=1`
+- **REPL/TUI:** `/super` (use `/super off` to clear the flag only)
+- **Kaira:** `gemcode kaira -C . --super`
+
+Details and safety notes: [`../docs/tools-and-permissions.md`](../docs/tools-and-permissions.md#super-mode-fully-autonomous).
+
 ## Common commands
 
 ### Inspect models
@@ -157,6 +168,33 @@ gemcode -C . --attach ./report.pdf "Summarize this"
 gemcode kaira -C .
 ```
 
+### Orchestration (Kaira + org delegation)
+
+Docs:
+- `../docs/orchestration.md`
+
+In one terminal:
+
+```bash
+gemcode kaira -C .
+```
+
+In another terminal:
+
+```bash
+gemcode -C .
+```
+
+Then in the REPL/TUI:
+
+```text
+/org tree
+/org hire verifier "QA / test planner" subagent gemcode "Find risks, propose tests, review plans."
+/org assign verifier "Review the plan and propose tests"
+/kaira jobs
+/kaira follow <job_id_prefix>
+```
+
 ### Start the IDE bridge
 ```bash
 gemcode ide --stdio
@@ -191,6 +229,7 @@ Status note:
 | `/review` | Run a review workflow |
 | `/eval` | Run evaluation gates |
 | `/kaira` | Show scheduler usage help |
+| `/super` | Super mode: auto-approve tools, no GemCode HITL · `/super off` |
 
 Detailed behavior:
 - [`../docs/cli-and-repl.md`](../docs/cli-and-repl.md)

{gemcode-0.3.105 → gemcode-0.3.107}/pyproject.toml

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

{gemcode-0.3.105 → gemcode-0.3.107}/src/gemcode/agent.py

@@ -733,6 +733,11 @@ If you need more tool usage examples, set `GEMCODE_VERBOSE_INSTRUCTIONS=1`.
   - Always give the sub-agent enough context to operate independently.
   - End your task prompt with "Summarise your findings clearly." so the result is useful.
 
+- **`spawn_subtasks`** — spawn multiple isolated sub-agents in parallel (preferred fan-out helper).
+  - Use this instead of manually issuing many `run_subtask` calls.
+  - Provide 3–6 focused tasks; keep each subtask self-contained.
+  - Then synthesise the combined findings into a single plan/answer.
+
 ## Multi-step task execution
 One user message = many model↔tool rounds (up to 256 LLM calls by default). This is intentional — you are expected to do complete tasks autonomously.
 
@@ -1008,9 +1013,11 @@ def build_root_agent(
     tools = [preload_memory, *tools]
 
   # ADK built-in interactive + artifact tools — always available when ADK supports them.
+  # In super mode, ``get_user_choice`` auto-picks the first option (no UI).
   try:
-    from google.adk.tools import get_user_choice, load_artifacts, exit_loop
-    tools = [*tools, get_user_choice, load_artifacts, exit_loop]
+    from gemcode.tools.user_choice import append_user_choice_load_artifacts_exit_loop
+
+    append_user_choice_load_artifacts_exit_loop(cfg, tools)
   except Exception:
     pass
 

{gemcode-0.3.105 → gemcode-0.3.107}/src/gemcode/cli.py

@@ -13,7 +13,7 @@ import uuid
 import warnings
 from pathlib import Path
 
-from gemcode.config import GemCodeConfig, load_cli_environment
+from gemcode.config import GemCodeConfig, apply_super_mode, load_cli_environment
 from gemcode.tools_inspector import inspect_tools, smoke_tools
 from gemcode.invoke import run_turn
 from gemcode.model_routing import pick_effective_model
@@ -43,6 +43,11 @@ def _maybe_prompt_trust(cfg: GemCodeConfig) -> None:
   On first use in a project root, ask the user to trust the folder so file,
   shell, and git tools can run. If not trusted, we exit before any tool runs.
   """
+  if getattr(cfg, "super_mode", False):
+    root = cfg.project_root.resolve()
+    if not is_trusted_root(root):
+      trust_root(root, trusted=True)
+    return
   # Non-interactive sessions can't answer prompts.
   if not (hasattr(sys.stdin, "isatty") and sys.stdin.isatty()):
     return
@@ -220,7 +225,9 @@ async def _run_repl(cfg: GemCodeConfig, session_id: str, *, use_mcp: bool) -> No
       "on",
     ):
       try:
-        if (
+        if getattr(cfg, "super_mode", False):
+          pass
+        elif (
           hasattr(sys.stdin, "isatty")
           and sys.stdin.isatty()
           and not cfg.yes_to_all
@@ -922,6 +929,11 @@ def main() -> None:
       action="store_true",
       help="Allow write_file / search_replace (disables interactive HITL prompts).",
     )
+    kaira_parser.add_argument(
+      "--super",
+      action="store_true",
+      help="Fully autonomous jobs: auto-approve tools/shell, no HITL (implies --yes).",
+    )
     kaira_parser.add_argument(
       "--interactive-ask",
       action="store_true",
@@ -978,7 +990,11 @@ def main() -> None:
         cfg.model_mode = "fast"
 
     cfg.yes_to_all = bool(args.yes)
-    if args.interactive_ask:
+    if getattr(args, "super", False):
+      cfg.super_mode = True
+    if cfg.super_mode:
+      apply_super_mode(cfg)
+    elif args.interactive_ask:
       cfg.interactive_permission_ask = True
     else:
       if "GEMCODE_INTERACTIVE_PERMISSION_ASK" not in os.environ:
@@ -1023,6 +1039,11 @@ def main() -> None:
   parser.add_argument("-C", "--directory", type=Path, default=Path.cwd(), help="Project root")
   parser.add_argument("--session", default=None, help="Session id for SQLite-backed history")
   parser.add_argument("--yes", action="store_true", help="Allow write_file / search_replace")
+  parser.add_argument(
+    "--super",
+    action="store_true",
+    help="Super mode: auto-approve all tool/shell use, skip HITL and AFC prompts (implies --yes).",
+  )
   parser.add_argument(
     "--interactive-ask",
     action="store_true",
@@ -1096,7 +1117,11 @@ def main() -> None:
     if args.model_mode is None:
       cfg.model_mode = "fast"
   cfg.yes_to_all = args.yes
-  if args.interactive_ask:
+  if args.super:
+    cfg.super_mode = True
+  if cfg.super_mode:
+    apply_super_mode(cfg)
+  elif args.interactive_ask:
     cfg.interactive_permission_ask = True
   else:
     # If user didn't explicitly set env, default to HITL when we're in a TTY.

{gemcode-0.3.105 → gemcode-0.3.107}/src/gemcode/config.py

@@ -374,6 +374,13 @@ class GemCodeConfig:
     default_factory=lambda: _truthy_env("GEMCODE_BACKGROUND_LEARNER", default=False)
   )
 
+  # "Super" mode: fully autonomous session — auto-approve mutating/shell tools,
+  # skip interactive HITL and AFC tool-mode prompts, and prefer non-blocking UX.
+  # Enable with ``GEMCODE_SUPER_MODE=1`` or ``gemcode --super``.
+  super_mode: bool = field(
+    default_factory=lambda: _truthy_env("GEMCODE_SUPER_MODE", default=False)
+  )
+
   def __post_init__(self) -> None:
     self.project_root = self.project_root.resolve()
     # Default agentic depth when env omits GEMCODE_MAX_LLM_CALLS (was: None → SDK default).
@@ -479,6 +486,24 @@ class GemCodeConfig:
             "tar",
           )
         )
+    if self.super_mode:
+      apply_super_mode(self)
+
+
+def apply_super_mode(cfg: GemCodeConfig) -> None:
+  """
+  Apply super-mode policy: no interactive tool HITL, auto-approve GemCode gates,
+  keep all toolsets (skip AFC stdin prompt via ``_afc_choice``), relax strict
+  permission mode so shell tools can run.
+  """
+  if not getattr(cfg, "super_mode", False):
+    return
+  cfg.yes_to_all = True
+  cfg.interactive_permission_ask = False
+  if getattr(cfg, "permission_mode", "") == "strict":
+    cfg.permission_mode = "default"
+  object.__setattr__(cfg, "_afc_choice", "all")
+  object.__setattr__(cfg, "_attachments_allowed", True)
 
 
 def load_dotenv_optional() -> None:

{gemcode-0.3.105 → gemcode-0.3.107}/src/gemcode/invoke.py

@@ -25,6 +25,82 @@ _TRANSIENT_RETRY_DELAYS = [2.0, 5.0, 12.0]
 
 _HITL_PROMPT_LOCK = Lock()
 
+async def _maybe_enqueue_kaira_autopilot(*, cfg: "GemCodeConfig", session_id: str) -> None:
+  """If Kaira IPC is available, enqueue background quality checks after edits."""
+  try:
+    enabled = os.environ.get("GEMCODE_KAIRA_AUTOPILOT", "1").strip().lower() in (
+      "1",
+      "true",
+      "yes",
+      "on",
+    )
+    if not enabled:
+      return
+    # Only run when files were touched (edit tools track this).
+    touched = getattr(cfg, "_touched_paths", None)
+    if not touched:
+      return
+    # Avoid enqueuing repeatedly within the same session unless touched paths change.
+    last_fp = str(getattr(cfg, "_kaira_autopilot_fp", "") or "")
+    fp = ",".join(sorted(str(x) for x in touched))[:4000]
+    if fp and fp == last_fp:
+      return
+    object.__setattr__(cfg, "_kaira_autopilot_fp", fp)
+
+    sock = os.environ.get("GEMCODE_KAIRA_SOCKET") or str(cfg.project_root / ".gemcode" / "ipc.sock")
+    if not Path(sock).exists():
+      return
+    # Heuristic: suggest likely checks, but let the agent choose based on repo.
+    prompt = (
+      "You are Kaira (background worker). Run the most relevant automated quality checks for this repo "
+      "based on its files, and report succinctly.\n\n"
+      "Rules:\n"
+      "- Prefer fast checks first (lint/typecheck/unit tests).\n"
+      "- If Python: try `pytest -q` (or detect other common runners).\n"
+      "- If Node: try `npm test` / `npm run lint` when package.json exists.\n"
+      "- If there are failures, include the smallest actionable summary and exact command to reproduce.\n"
+      "- If everything passes, say PASS and list what you ran.\n"
+      "- Return a final STRICT JSON report with keys: status, summary, evidence, recommended_next_actions.\n\n"
+      f"Touched files (recent): {', '.join(sorted(list(touched))[:30])}"
+    )
+
+    # Org-aware routing: delegate to the kaira org member if present so the
+    # manager/worker hierarchy stays consistent.
+    try:
+      auto_org = os.environ.get("GEMCODE_AUTO_SLASH_ORG", "1").strip().lower() in (
+        "1",
+        "true",
+        "yes",
+        "on",
+      )
+      if auto_org:
+        from gemcode.org import find_member
+        m = find_member(cfg.project_root, "kaira")
+        if m is not None and m.kind == "kaira_worker":
+          from gemcode.tools.org_tools import make_org_tools
+          tools = make_org_tools(cfg)
+          org_delegate = None
+          for t in tools:
+            if getattr(t, "__name__", "") == "org_delegate":
+              org_delegate = t
+              break
+          if org_delegate is not None:
+            await org_delegate("kaira", prompt, "")  # type: ignore[misc]
+            return
+    except Exception:
+      pass
+
+    from gemcode.kaira_client import KairaIpcClient
+
+    client = await KairaIpcClient.connect(socket_path=sock)
+    try:
+      # Low priority by default; user can override with env in future.
+      await client.request(action="enqueue", prompt=prompt, priority=-1, session_id=session_id)
+    finally:
+      await client.close()
+  except Exception:
+    return
+
 
 def _events_to_text(events: list[Any]) -> str:
   """Best-effort extraction of assistant text from ADK events."""
@@ -102,6 +178,56 @@ async def run_turn(
       object.__setattr__(cfg, "_risk_score", risk)
     except Exception:
       pass
+
+    # Deterministic manager dispatcher: pre-delegate certain work to org members
+    # and inject their results into the prompt before the main agent runs.
+    try:
+      auto_mgr = os.environ.get("GEMCODE_MANAGER_DISPATCH", "1").strip().lower() in (
+        "1","true","yes","on"
+      )
+      if auto_mgr:
+        import re
+        p0 = (prompt or "")[:12_000]
+        # Only do this for broad/complex prompts.
+        score = float(getattr(cfg, "_parallelism_score", 0.0) or 0.0)
+        if score >= float(os.environ.get("GEMCODE_MANAGER_DISPATCH_THRESHOLD", "0.7")):
+          from gemcode.tools.org_tools import make_org_tools
+          tools = make_org_tools(cfg)
+          org_delegate = None
+          for t in tools:
+            if getattr(t, "__name__", "") == "org_delegate":
+              org_delegate = t
+              break
+          # Ask verifier for a quick risk check / plan critique (fast, in-process).
+          if org_delegate is not None and re.search(r"\\b(fix|refactor|rewrite|change|implement)\\b", p0, re.I):
+            v = await org_delegate("verifier", "Review the requested task and list key risks + verification steps.", p0)  # type: ignore[misc]
+            if isinstance(v, dict) and v.get("ok") and v.get("result"):
+              object.__setattr__(cfg, "_manager_verifier_context", str(v.get("result"))[:4000])
+    except Exception:
+      pass
+    # Parallelism score: heuristic signal for automatic subtask fan-out.
+    try:
+      import re
+      p2 = (prompt or "")[:20_000]
+      par = 0.0
+      if len(p2) > 800:
+        par += 0.15
+      if len(p2) > 2400:
+        par += 0.2
+      if re.search(r"\b(analy[sz]e|audit|map|inventory|scan|survey)\b", p2, re.I):
+        par += 0.2
+      if re.search(r"\b(refactor|migrate|rewrite|redesign|architecture)\b", p2, re.I):
+        par += 0.2
+      if re.search(r"\b(across|entire|whole|end-to-end|e2e|multiple modules|many files)\b", p2, re.I):
+        par += 0.2
+      if p2.count("/") >= 8 or p2.count(".py") + p2.count(".ts") + p2.count(".tsx") >= 5:
+        par += 0.15
+      if attachment_paths:
+        par += 0.08
+      par = max(0.0, min(1.0, float(par)))
+      object.__setattr__(cfg, "_parallelism_score", par)
+    except Exception:
+      pass
   run_config = (
     RunConfig(max_llm_calls=max_llm_calls) if max_llm_calls is not None else None
   )
@@ -222,9 +348,48 @@ async def run_turn(
         for w in attach_warn:
           print(f"[gemcode] {w}", file=sys.stderr)
       else:
-        current_message = types.Content(
-            role="user", parts=[types.Part(text=prompt)]
-        )
+        effective_prompt = prompt
+        # Auto fan-out: when prompt looks broad, guide model to spawn parallel
+        # isolated subtasks first (bounded) and then synthesise.
+        try:
+          auto_on = os.environ.get("GEMCODE_AUTO_FANOUT", "1").strip().lower() in (
+            "1",
+            "true",
+            "yes",
+            "on",
+          )
+          threshold = float(os.environ.get("GEMCODE_AUTO_FANOUT_THRESHOLD", "0.6"))
+          if auto_on and cfg is not None:
+            score = float(getattr(cfg, "_parallelism_score", 0.0) or 0.0)
+            already = bool(getattr(cfg, "_auto_fanout_applied", False))
+            if (not already) and score >= threshold:
+              object.__setattr__(cfg, "_auto_fanout_applied", True)
+              effective_prompt = (
+                "Before you answer, do a quick parallel exploration pass:\n"
+                "- Decompose this into 3–6 independent investigation subtasks.\n"
+                "- Call `spawn_subtasks(tasks=[...], max_concurrency=4)` to run them in parallel.\n"
+                "- If an org member is appropriate, prefer delegating with `org_delegate` / `org_spawn`.\n"
+                "- Synthesize the results into a single plan/answer, then proceed.\n\n"
+                + (prompt or "")
+              )
+        except Exception:
+          pass
+
+        # Inject dispatcher context (e.g., verifier critique) if available.
+        try:
+          if cfg is not None:
+            ctx = str(getattr(cfg, "_manager_verifier_context", "") or "").strip()
+            if ctx:
+              effective_prompt = (
+                "Manager pre-delegation result (verifier):\n"
+                + ctx
+                + "\n\nUser request:\n"
+                + (effective_prompt or "")
+              )
+        except Exception:
+          pass
+
+        current_message = types.Content(role="user", parts=[types.Part(text=effective_prompt)])
 
       async def _await_runner_events(
         *, next_message: types.Content, do_reset: bool
@@ -295,11 +460,20 @@ async def run_turn(
           and hasattr(sys.stdin, "isatty")
           and sys.stdin.isatty()
         )
+        auto_ok = bool(
+          cfg is not None
+          and (
+            bool(getattr(cfg, "yes_to_all", False))
+            or bool(getattr(cfg, "super_mode", False))
+          )
+        )
 
         parts: list[types.Part] = []
         for fc in confirmation_fcs:
           tool_name, hint = _extract_hint_and_tool(fc)
-          if interactive_enabled:
+          if auto_ok:
+            ok = True
+          elif interactive_enabled:
             suffix = f"\n  Hint: {hint}" if hint else ""
             ok = _prompt_yes_no(
               f"\n[gemcode HITL] Approve tool call '{tool_name}'? [y/N]{suffix}\n> "
@@ -347,6 +521,12 @@ async def run_turn(
           )
           continue
 
+      # Background autopilot: if we touched files, enqueue Kaira checks (best-effort).
+      if cfg is not None:
+        try:
+          await _maybe_enqueue_kaira_autopilot(cfg=cfg, session_id=session_id)
+        except Exception:
+          pass
       return collected
   finally:
     if cfg is not None and orig_ctx_chars is not None:

gemcode-0.3.107/src/gemcode/kaira_client.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import asyncio
+import uuid
+from dataclasses import dataclass
+from typing import Any, AsyncIterator
+
+from gemcode.ide_protocol import IdeEmitter, make_response, parse_json_line
+
+
+@dataclass
+class KairaIpcClient:
+  reader: asyncio.StreamReader
+  writer: asyncio.StreamWriter
+  emitter: IdeEmitter
+
+  @classmethod
+  async def connect(cls, *, socket_path: str) -> "KairaIpcClient":
+    reader, writer = await asyncio.open_unix_connection(socket_path)
+    return cls(reader=reader, writer=writer, emitter=IdeEmitter(stream=writer))
+
+  async def close(self) -> None:
+    try:
+      self.writer.close()
+      await self.writer.wait_closed()
+    except Exception:
+      pass
+
+  async def request(self, *, action: str, **payload: Any) -> dict[str, Any]:
+    req_id = f"req_{uuid.uuid4().hex[:12]}"
+    msg = {"type": "request", "id": req_id, "action": action}
+    msg.update(payload)
+    self.emitter.send(msg)
+    # Wait for matching response.
+    while True:
+      line = await self.reader.readline()
+      if not line:
+        return make_response(id=req_id, ok=False, error="ipc_eof")
+      obj = parse_json_line(line.decode("utf-8", errors="replace").strip())
+      if obj.get("type") == "response" and str(obj.get("id") or "") == req_id:
+        return obj
+      # Other messages (events) are ignored here; caller should use iter_messages.
+
+  async def iter_messages(self) -> AsyncIterator[dict[str, Any]]:
+    while True:
+      line = await self.reader.readline()
+      if not line:
+        return
+      obj = parse_json_line(line.decode("utf-8", errors="replace").strip())
+      yield obj
+