gemcode 0.3.74__tar.gz → 0.3.75__tar.gz

{gemcode-0.3.74/src/gemcode.egg-info → gemcode-0.3.75}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.74
+Version: 0.3.75
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License

{gemcode-0.3.74 → gemcode-0.3.75}/pyproject.toml

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

{gemcode-0.3.74 → gemcode-0.3.75}/src/gemcode/cli.py

@@ -19,6 +19,7 @@ from gemcode.capability_routing import apply_capability_routing
 from gemcode.session_runtime import create_runner
 from gemcode.trust import is_trusted_root, trust_root
 from gemcode.repl_slash import process_repl_slash
+from gemcode.ide_stdio import main as ide_stdio_main
 
 
 def _events_to_text(events) -> str:
@@ -339,6 +340,20 @@ def main() -> None:
       "enable Terminal for Desktop Folder (or grant Full Disk Access)."
     )
 
+  # Hidden IDE engine mode: `gemcode ide --stdio`
+  if len(sys.argv) >= 2 and sys.argv[1] == "ide":
+    ide_parser = argparse.ArgumentParser(prog="gemcode ide")
+    ide_parser.add_argument(
+      "--stdio",
+      action="store_true",
+      help="Run IDE engine over stdin/stdout (JSONL)",
+    )
+    ide_args = ide_parser.parse_args(sys.argv[2:])
+    if ide_args.stdio:
+      ide_stdio_main()
+      return
+    raise SystemExit("Usage: gemcode ide --stdio")
+
   # Persist or rotate API key (Claude Code–style `claude login`).
   if len(sys.argv) > 1 and sys.argv[1] == "login":
     load_cli_environment()

{gemcode-0.3.74 → gemcode-0.3.75}/src/gemcode/config.py

@@ -340,6 +340,12 @@ class GemCodeConfig:
     default_factory=lambda: _truthy_env("GEMCODE_ENABLE_WEB_SEARCH", default=False)
   )
 
+  # IDE mode (VS Code extension): the engine should *propose* writes/commands,
+  # and the IDE applies them (WorkspaceEdit / terminal task) after user approval.
+  ide_proposal_mode: bool = False
+  ide_allow_write: bool = False
+  ide_allow_shell: bool = 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).

gemcode-0.3.75/src/gemcode/ide_protocol.py

@@ -0,0 +1,58 @@
+"""
+GemCode IDE stdio protocol (JSON Lines).
+
+This module defines the *wire format* for `gemcode ide --stdio`, used by IDE
+extensions (VS Code) to talk to a long-lived GemCode engine process.
+
+Design goals:
+- Human-readable JSONL (easy to debug)
+- Streaming (token deltas + progress)
+- Safe editing (engine proposes; IDE applies via WorkspaceEdit)
+"""
+
+from __future__ import annotations
+
+import json
+import sys
+import time
+from dataclasses import dataclass
+from typing import Any
+
+
+PROTOCOL_VERSION = 1
+
+
+def _now_ms() -> int:
+  return int(time.time() * 1000)
+
+
+def dumps(obj: Any) -> str:
+  return json.dumps(obj, ensure_ascii=False, separators=(",", ":"))
+
+
+@dataclass
+class IdeEmitter:
+  """Writes JSONL messages to stdout (flushes each line)."""
+
+  stream: Any = sys.stdout
+
+  def send(self, msg: dict) -> None:
+    msg = dict(msg or {})
+    msg.setdefault("v", PROTOCOL_VERSION)
+    msg.setdefault("ts_ms", _now_ms())
+    self.stream.write(dumps(msg) + "\n")
+    try:
+      self.stream.flush()
+    except Exception:
+      pass
+
+
+def parse_json_line(line: str) -> dict[str, Any]:
+  try:
+    obj = json.loads(line)
+  except Exception as e:
+    return {"type": "invalid", "error": f"invalid_json: {e}"}
+  if not isinstance(obj, dict):
+    return {"type": "invalid", "error": "message must be a JSON object"}
+  return obj
+

gemcode-0.3.75/src/gemcode/ide_stdio.py

@@ -0,0 +1,164 @@
+"""
+`gemcode ide --stdio`
+
+Long-lived engine process that communicates over stdin/stdout using JSONL.
+
+The IDE is responsible for:
+- presenting UI
+- previewing diffs
+- applying changes (WorkspaceEdit)
+
+GemCode is responsible for:
+- planning + tool calls
+- proposing edits/commands (when in proposal mode)
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+import sys
+from typing import Any
+
+from gemcode.config import GemCodeConfig, load_cli_environment
+from gemcode.ide_protocol import IdeEmitter, parse_json_line
+from gemcode.invoke import run_turn
+from gemcode.session_runtime import create_runner
+
+
+def _truthy(v: Any, default: bool = False) -> bool:
+  if v is None:
+    return default
+  if isinstance(v, bool):
+    return v
+  if isinstance(v, (int, float)):
+    return bool(v)
+  if isinstance(v, str):
+    return v.strip().lower() in ("1", "true", "yes", "on")
+  return default
+
+
+def _build_prompt(prompt: str, attachments: list[dict] | None) -> str:
+  # Keep it simple: attachments are appended as fenced blocks.
+  if not attachments:
+    return prompt
+  parts = [prompt.rstrip()]
+  for a in attachments:
+    if not isinstance(a, dict):
+      continue
+    at = (a.get("type") or "").strip().lower()
+    if at == "selection":
+      txt = a.get("text") or ""
+      path = a.get("path") or ""
+      rng = a.get("range") or ""
+      header = f"Selection from {path}{(' ' + rng) if rng else ''}".strip()
+      parts.append(f"\n\n```text\n{header}\n{txt}\n```")
+    elif at == "file":
+      path = a.get("path") or ""
+      snippet = a.get("text") or ""
+      header = f"File context: {path}".strip()
+      parts.append(f"\n\n```text\n{header}\n{snippet}\n```")
+  return "\n".join(parts).strip() + "\n"
+
+
+async def run_stdio_loop() -> int:
+  load_cli_environment()
+  # Keep stdout reserved for protocol JSONL. Redirect accidental prints to stderr.
+  proto_out = sys.stdout
+  try:
+    sys.stdout = sys.stderr  # type: ignore[assignment]
+  except Exception:
+    pass
+  emitter = IdeEmitter(stream=proto_out)
+  emitter.send({"type": "hello", "protocol": 1})
+
+  runner = None
+  cfg: GemCodeConfig | None = None
+  session_id: str | None = None
+
+  try:
+    for raw in sys.stdin:
+      msg = parse_json_line(raw)
+      mtype = msg.get("type")
+      if mtype in ("invalid", None):
+        emitter.send({"type": "error", "error": msg.get("error") or "invalid"})
+        continue
+
+      if mtype == "shutdown":
+        emitter.send({"type": "bye"})
+        return 0
+
+      if mtype != "turn":
+        emitter.send({"type": "error", "error": f"unknown_type:{mtype}"})
+        continue
+
+      # Lazily initialize runner on first turn (needs project root).
+      if cfg is None:
+        root = msg.get("project_root") or os.getcwd()
+        model = msg.get("model") or os.environ.get("GEMCODE_MODEL") or ""
+        from pathlib import Path
+        cfg = GemCodeConfig(project_root=Path(str(root)), model=str(model))
+        # Attach emitter + proposal mode flags (used by tool wrappers).
+        object.__setattr__(cfg, "_ide_emitter", emitter)
+        object.__setattr__(cfg, "ide_proposal_mode", True)
+        runner = create_runner(cfg, extra_tools=None)
+
+      if session_id is None:
+        session_id = str(msg.get("session") or "vscode")
+
+      prompt = str(msg.get("prompt") or "")
+      attachments = msg.get("attachments") if isinstance(msg.get("attachments"), list) else None
+      full_prompt = _build_prompt(prompt, attachments)
+
+      # Per-turn allow flags (the engine still only proposes in IDE mode; the IDE applies).
+      allow_write = _truthy(msg.get("allowWrite"), default=False)
+      allow_shell = _truthy(msg.get("allowShell"), default=False)
+      object.__setattr__(cfg, "ide_allow_write", bool(allow_write))
+      object.__setattr__(cfg, "ide_allow_shell", bool(allow_shell))
+
+      emitter.send({"type": "turn_start", "session": session_id})
+      try:
+        events = await run_turn(
+          runner,
+          user_id="local",
+          session_id=session_id,
+          prompt=full_prompt,
+          max_llm_calls=cfg.max_llm_calls,
+          cfg=cfg,
+        )
+      except Exception as e:
+        emitter.send({"type": "error", "error": f"{type(e).__name__}: {e}"})
+        emitter.send({"type": "turn_done", "session": session_id, "ok": False})
+        continue
+
+      # Emit assistant text as a single message for now (delta streaming can be added later).
+      txt_parts: list[str] = []
+      for ev in events:
+        try:
+          if not getattr(ev, "content", None) or not ev.content.parts:
+            continue
+          if getattr(ev, "author", None) == "user":
+            continue
+          for p in ev.content.parts:
+            t = getattr(p, "text", None)
+            if t:
+              txt_parts.append(t)
+        except Exception:
+          continue
+      out_text = "".join(txt_parts).strip()
+      if out_text:
+        emitter.send({"type": "text", "text": out_text})
+      emitter.send({"type": "turn_done", "session": session_id, "ok": True})
+
+  finally:
+    if runner is not None:
+      try:
+        await runner.close()
+      except Exception:
+        pass
+  return 0
+
+
+def main() -> None:
+  raise SystemExit(asyncio.run(run_stdio_loop()))
+

{gemcode-0.3.74 → gemcode-0.3.75}/src/gemcode/tools/bash.py

@@ -30,6 +30,14 @@ def make_bash_tool(cfg: GemCodeConfig):
     root = cfg.project_root
     trusted = is_trusted_root(root)
 
+    def _emit(msg: dict) -> None:
+        em = getattr(cfg, "_ide_emitter", None)
+        if em is not None:
+            try:
+                em.send(msg)
+            except Exception:
+                pass
+
     def bash(
         command: str,
         timeout_seconds: int = 120,
@@ -95,6 +103,20 @@ def make_bash_tool(cfg: GemCodeConfig):
         explicit user approval. Quote file paths that contain spaces.
         cwd_subdir is relative to the project root.
         """
+        if getattr(cfg, "ide_proposal_mode", False):
+            if not getattr(cfg, "ide_allow_shell", False):
+                _emit({"type": "permission_request", "kind": "shell", "detail": "bash(...)"} )
+                return {"error": "shell_not_allowed"}
+            _emit(
+                {
+                    "type": "command_suggestion",
+                    "cmd": command,
+                    "cwd_subdir": cwd_subdir,
+                    "background": bool(background),
+                    "via": "bash",
+                }
+            )
+            return {"suggested": True, "via": "bash", "cmd": command, "cwd_subdir": cwd_subdir, "background": bool(background)}
         if not trusted:
             return {"error": "Project folder is not trusted. Re-run GemCode and approve folder trust."}
 

{gemcode-0.3.74 → gemcode-0.3.75}/src/gemcode/tools/edit.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import hashlib
+import time
 from pathlib import Path
 
 from gemcode.config import GemCodeConfig
@@ -11,6 +13,20 @@ from gemcode.paths import PathEscapeError, resolve_under_root
 def make_edit_tools(cfg: GemCodeConfig):
   root = cfg.project_root
 
+  def _sha256_text(s: str) -> str:
+    return hashlib.sha256(s.encode("utf-8", errors="strict")).hexdigest()
+
+  def _emit(msg: dict) -> None:
+    em = getattr(cfg, "_ide_emitter", None)
+    if em is not None:
+      try:
+        em.send(msg)
+      except Exception:
+        pass
+
+  def _proposal_id(prefix: str) -> str:
+    return f"{prefix}_{int(time.time()*1000)}"
+
   def write_file(path: str, content: str) -> dict:
     """
     Create or overwrite a file with the given content.
@@ -25,6 +41,47 @@ def make_edit_tools(cfg: GemCodeConfig):
     Never write non-textual content (binary, base64 blobs) — those belong in
     artifacts, not in source files.
     """
+    if getattr(cfg, "ide_proposal_mode", False):
+      if not getattr(cfg, "ide_allow_write", False):
+        _emit(
+          {
+            "type": "permission_request",
+            "kind": "write",
+            "detail": f"write_file({path})",
+          }
+        )
+        return {"error": "write_not_allowed"}
+      # Propose instead of executing.
+      try:
+        p = resolve_under_root(root, path)
+      except PathEscapeError as e:
+        return {"error": str(e)}
+      old_text = ""
+      existed = p.is_file()
+      if existed:
+        try:
+          old_text = p.read_text(encoding="utf-8", errors="strict")
+        except Exception:
+          old_text = ""
+      pid = _proposal_id("edit")
+      _emit(
+        {
+          "type": "edit_proposal",
+          "id": pid,
+          "files": [
+            {
+              "path": path,
+              "existed": existed,
+              "original_sha256": _sha256_text(old_text) if existed else None,
+              "new_sha256": _sha256_text(content),
+              "old_text": old_text,
+              "new_text": content,
+            }
+          ],
+        }
+      )
+      return {"proposal_id": pid, "path": path, "bytes": len(content.encode("utf-8"))}
+
     try:
       p = resolve_under_root(root, path)
     except PathEscapeError as e:
@@ -60,6 +117,16 @@ def make_edit_tools(cfg: GemCodeConfig):
       comments that explain non-obvious intent or trade-offs.
     - NEVER propose edits before reading. Read first. Edit second.
     """
+    if getattr(cfg, "ide_proposal_mode", False):
+      if not getattr(cfg, "ide_allow_write", False):
+        _emit(
+          {
+            "type": "permission_request",
+            "kind": "write",
+            "detail": f"search_replace({path})",
+          }
+        )
+        return {"error": "write_not_allowed"}
     try:
       p = resolve_under_root(root, path)
     except PathEscapeError as e:
@@ -76,6 +143,25 @@ def make_edit_tools(cfg: GemCodeConfig):
       new_text = text.replace(old_string, new_string)
     else:
       new_text = text.replace(old_string, new_string, 1)
+    if getattr(cfg, "ide_proposal_mode", False):
+      pid = _proposal_id("edit")
+      _emit(
+        {
+          "type": "edit_proposal",
+          "id": pid,
+          "files": [
+            {
+              "path": path,
+              "existed": True,
+              "original_sha256": _sha256_text(text),
+              "new_sha256": _sha256_text(new_text),
+              "old_text": text,
+              "new_text": new_text,
+            }
+          ],
+        }
+      )
+      return {"proposal_id": pid, "path": path, "replacements": count if replace_all else 1}
     p.write_text(new_text, encoding="utf-8")
     return {"path": path, "replacements": count if replace_all else 1}
 

{gemcode-0.3.74 → gemcode-0.3.75}/src/gemcode/tools/shell.py

@@ -37,6 +37,14 @@ def make_run_command(cfg: GemCodeConfig):
   root = cfg.project_root
   trusted = is_trusted_root(root)
 
+  def _emit(msg: dict) -> None:
+    em = getattr(cfg, "_ide_emitter", None)
+    if em is not None:
+      try:
+        em.send(msg)
+      except Exception:
+        pass
+
   def run_command(
     command: str,
     args: list[str] | None = None,
@@ -61,6 +69,22 @@ def make_run_command(cfg: GemCodeConfig):
     merged into the child environment (e.g. keys ["CI"], values ["1"] for
     non-interactive scaffolding tools). Omit both to use the default environment.
     """
+    if getattr(cfg, "ide_proposal_mode", False):
+      exe = str(command or "").strip()
+      args2 = list(args or [])
+      if not getattr(cfg, "ide_allow_shell", False):
+        _emit({"type": "permission_request", "kind": "shell", "detail": f"run_command({exe})"})
+        return {"error": "shell_not_allowed"}
+      _emit(
+        {
+          "type": "command_suggestion",
+          "cmd": " ".join([exe, *args2]).strip(),
+          "cwd_subdir": cwd_subdir,
+          "background": bool(background),
+        }
+      )
+      return {"suggested": True, "command": [exe, *args2], "cwd_subdir": cwd_subdir, "background": bool(background)}
+
     if not trusted:
       return {"error": "Project folder is not trusted. Re-run GemCode and approve folder trust."}
     if not (cwd_subdir or "").strip():

{gemcode-0.3.74 → gemcode-0.3.75/src/gemcode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.74
+Version: 0.3.75
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License

{gemcode-0.3.74 → gemcode-0.3.75}/src/gemcode.egg-info/SOURCES.txt

@@ -18,6 +18,8 @@ src/gemcode/credentials.py
 src/gemcode/dynamic_policy.py
 src/gemcode/hitl_session.py
 src/gemcode/hooks.py
+src/gemcode/ide_protocol.py
+src/gemcode/ide_stdio.py
 src/gemcode/intent_classifier.py
 src/gemcode/interactions.py
 src/gemcode/invoke.py