gemcode 0.3.38__tar.gz → 0.3.40__tar.gz

{gemcode-0.3.38/src/gemcode.egg-info → gemcode-0.3.40}/PKG-INFO

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

{gemcode-0.3.38 → gemcode-0.3.40}/pyproject.toml

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

{gemcode-0.3.38 → gemcode-0.3.40}/src/gemcode/agent.py

@@ -397,8 +397,29 @@ You run locally via the GemCode CLI. You are the same agent the user launched
 {_build_runtime_facts(cfg)}
 
 ## Core identity and approach
-You are a senior engineer who *acts*, not just advises. When given a task:
-1. **Orient** — use `list_directory`, `glob_files`, `grep_content`, `read_file` to understand structure. These tools need **no permission** and are instant. Start here.
+
+### Intent-aware workflow
+
+Before you see this message, a lightweight LLM classifier already determined the user's intent
+and stored it in session state as `_gemcode_intent`. Read it and adapt your behaviour:
+
+| `_gemcode_intent` | Meaning | What to do |
+|---|---|---|
+| `GREETING` | Social / chitchat | *(You will never see this — handled upstream before reaching you.)* |
+| `CONCEPT` | General knowledge question | Answer from your training knowledge. No tools unless the answer truly requires this repo's files. |
+| `PROJECT_QUESTION` | Question about this codebase | Use 1–2 focused read-only tools (`list_directory`, `read_file`, `grep_content`) to find the answer, then reply concisely. |
+| `ENGINEERING_TASK` | Code modification / fix / build | Full workflow: **Orient → Plan → Execute → Verify**. |
+| `ANALYSIS` | Systematic audit or summarisation | Thorough tool sweep: list → read → grep across the affected area, then synthesise findings. |
+
+If `_gemcode_intent` is not set (first turn or classifier unavailable), infer the intent yourself
+from the message before acting — the categories above still apply.
+
+**Under no circumstances call `list_directory`, `read_project_notes`, or any tool in
+response to a greeting or a simple general question that requires no project context.**
+
+### Engineering task workflow
+When the intent is `ENGINEERING_TASK`:
+1. **Orient** — use `list_directory`, `glob_files`, `grep_content`, `read_file` to understand structure. These tools need **no permission** and are instant.
 2. **Plan** — for complex tasks, call `todo_write` upfront to map out the work.
 3. **Execute** — make the changes, run the checks, iterate.
 4. **Verify** — confirm the result is correct before reporting done.
@@ -426,8 +447,8 @@ You have native deep thinking capability — use it actively:
 - **For trade-off decisions** (which library, which pattern, which approach): reason through the pros/cons given this specific codebase.
 
 ## Interpreting requests
-- Treat every message as a software engineering task — start working immediately. Do NOT respond with just a greeting or introduction.
-- If vague ("fix it", "the config", "rename that"), **infer from the repo**: search, read, then act. Do not give abstract advice when concrete files exist.
+- **Let `_gemcode_intent` guide you.** The pre-classifier already did the hard work. Trust it and act accordingly (see the table above).
+- **Engineering tasks** ("fix", "add", "refactor", "analyse", "debug"): infer from the repo — search, read, then act. Do not give abstract advice when concrete files exist.
 - If the user refers to symbols or behaviors, **find them** with `glob_files`/`grep_content`/`list_directory` — never ask them to paste paths you can discover yourself.
 - **Never propose edits to files you haven't read.** Read first, then edit.
 - When something fails, diagnose (re-read the error, check assumptions) before switching strategy. Do not repeat the same failed call.
@@ -615,8 +636,7 @@ You have two tools to persist project insights across sessions, like Claude Code
   Call this **immediately** when you discover something useful — not just at the end of tasks.
   Notes are loaded at session start so future sessions inherit this knowledge.
 
-- **`read_project_notes()`** — read current notes before starting a new project task.
-  If notes exist and you haven't read them yet, read them first to avoid re-discovering known information."""
+- **`read_project_notes()`** — read current notes **only when starting a real engineering task** (editing, debugging, building). Do NOT call this for greetings or general questions. If notes exist and you're about to work on a task, read them once to avoid re-discovering known information."""
 
   # Inject capability-specific strategy sections only when those caps are on.
   if getattr(cfg, "enable_computer_use", False):

{gemcode-0.3.38 → gemcode-0.3.40}/src/gemcode/cli.py

@@ -154,6 +154,17 @@ async def _run_prompt(
   # MCP and OpenAPI toolsets are now loaded inside create_runner() directly.
   runner = create_runner(cfg, extra_tools=None)
   try:
+    # LLM intent pre-classifier: greetings bypass the main agent entirely.
+    try:
+      from gemcode.intent_classifier import (
+          classify_intent, generate_greeting_reply, INTENT_GREETING
+      )
+      _intent = await classify_intent(prompt)
+      if _intent == INTENT_GREETING:
+        return await generate_greeting_reply(prompt)
+    except Exception:
+      pass
+
     collected = await run_turn(
         runner,
         user_id="local",

gemcode-0.3.40/src/gemcode/intent_classifier.py

@@ -0,0 +1,185 @@
+"""
+LLM-based intent pre-classifier.
+
+Before each user turn a lightweight Gemini call (gemini-2.0-flash-lite by
+default) classifies the message into one of five intents.  The TUI / CLI
+can then:
+
+  - Short-circuit GREETING turns entirely (instant reply, zero tool calls)
+  - Inject the intent label into session state so the main agent adapts its
+    workflow automatically without re-classifying
+
+Configure:
+  GEMCODE_INTENT_MODEL  Override the classifier model (default: gemini-2.0-flash-lite)
+  GEMCODE_INTENT_CLASSIFY_ENABLED  Set "0" to disable (falls back to main agent)
+"""
+from __future__ import annotations
+
+import os
+
+# ── Intent labels ─────────────────────────────────────────────────────────────
+INTENT_GREETING          = "GREETING"
+INTENT_CONCEPT           = "CONCEPT"
+INTENT_PROJECT_QUESTION  = "PROJECT_QUESTION"
+INTENT_ENGINEERING_TASK  = "ENGINEERING_TASK"
+INTENT_ANALYSIS          = "ANALYSIS"
+
+_VALID_INTENTS = {
+    INTENT_GREETING,
+    INTENT_CONCEPT,
+    INTENT_PROJECT_QUESTION,
+    INTENT_ENGINEERING_TASK,
+    INTENT_ANALYSIS,
+}
+
+# Mapping from intent to a short description injected into the main agent's context
+INTENT_DESCRIPTIONS: dict[str, str] = {
+    INTENT_GREETING:         "Conversational greeting or social message — reply warmly, no tools.",
+    INTENT_CONCEPT:          "General knowledge question — answer from knowledge, no project files needed.",
+    INTENT_PROJECT_QUESTION: "Question about this specific codebase — use 1-2 read-only tools, then reply.",
+    INTENT_ENGINEERING_TASK: "Code task (fix / add / refactor / debug) — orient → plan → execute → verify.",
+    INTENT_ANALYSIS:         "Systematic audit or summarisation — thorough tool sweep, then synthesise.",
+}
+
+# ── Prompts ───────────────────────────────────────────────────────────────────
+_CLASSIFY_PROMPT = """\
+Classify the user message into exactly ONE intent label from the list below.
+
+Labels:
+  GREETING          — greetings, thanks, social messages, chitchat
+                      (hi, hii, hello, hey, thanks, cool, nice, ok, goodbye, how are you, etc.)
+  CONCEPT           — general knowledge question needing no project files
+                      (what is X, explain Y, compare A vs B, best practice for Z)
+  PROJECT_QUESTION  — question about THIS specific codebase
+                      (how does auth work here, what does this file do, where is X defined)
+  ENGINEERING_TASK  — request to write, fix, modify, debug, or implement code
+  ANALYSIS          — request to systematically audit, review, summarise, or map the codebase
+
+User message: "{message}"
+
+Reply with ONLY the label name, nothing else."""
+
+_GREETING_SYSTEM = (
+    "You are GemCode, an expert coding assistant. "
+    "The user sent you a short conversational message. "
+    "Reply naturally and warmly in ONE brief sentence. "
+    "Do not mention code, tools, files, or ask what they need."
+)
+
+_CLASSIFIER_MODEL_ENV = "GEMCODE_INTENT_MODEL"
+_DEFAULT_CLASSIFIER_MODEL = "gemini-2.0-flash-lite"
+
+# Single-word / very-short messages that are unambiguously greetings —
+# checked locally before spending an API call on the classifier.
+_OBVIOUS_GREETINGS: frozenset[str] = frozenset({
+    "hi", "hii", "hiii", "hey", "hello", "heya", "hiya", "howdy", "sup", "yo",
+    "thanks", "thank you", "thx", "ty", "thankyou",
+    "cool", "nice", "great", "awesome", "ok", "okay", "k",
+    "bye", "goodbye", "cya", "later",
+    "good morning", "good evening", "good night", "good afternoon",
+    "what's up", "whats up", "wassup",
+})
+
+
+def _classifier_enabled() -> bool:
+    v = os.environ.get("GEMCODE_INTENT_CLASSIFY_ENABLED", "1")
+    return v.lower() not in ("0", "false", "no", "off")
+
+
+def _get_classifier_model() -> str:
+    return os.environ.get(_CLASSIFIER_MODEL_ENV) or _DEFAULT_CLASSIFIER_MODEL
+
+
+def _get_api_key() -> str:
+    return (
+        os.environ.get("GOOGLE_API_KEY")
+        or os.environ.get("GEMINI_API_KEY")
+        or ""
+    )
+
+
+async def classify_intent(message: str) -> str:
+    """
+    Classify a user message using a lightweight Gemini call.
+
+    Returns one of: GREETING, CONCEPT, PROJECT_QUESTION, ENGINEERING_TASK, ANALYSIS.
+    Falls back to ENGINEERING_TASK on any error (the main agent handles all real
+    tasks safely with that default).
+
+    Classification is disabled when GEMCODE_INTENT_CLASSIFY_ENABLED=0.
+    """
+    if not _classifier_enabled():
+        return INTENT_ENGINEERING_TASK
+
+    stripped = (message or "").strip()
+    if not stripped:
+        return INTENT_GREETING
+
+    # Fast local check for unambiguously short greetings — saves an API round-trip.
+    lower = stripped.lower()
+    if lower in _OBVIOUS_GREETINGS or (len(lower) <= 3 and lower.isalpha()):
+        return INTENT_GREETING
+
+    try:
+        import google.genai as genai
+        from google.genai import types as gtypes
+
+        client = genai.Client(api_key=_get_api_key())
+        resp = await client.aio.models.generate_content(
+            model=_get_classifier_model(),
+            contents=_CLASSIFY_PROMPT.format(message=stripped[:600]),
+            config=gtypes.GenerateContentConfig(
+                temperature=0.0,
+                max_output_tokens=15,
+            ),
+        )
+        label = (resp.text or "").strip().upper()
+        # Exact match first
+        if label in _VALID_INTENTS:
+            return label
+        # Partial match (model may return extra punctuation or lowercase)
+        for key in _VALID_INTENTS:
+            if key in label:
+                return key
+        return INTENT_ENGINEERING_TASK
+    except Exception:
+        return INTENT_ENGINEERING_TASK
+
+
+async def generate_greeting_reply(message: str) -> str:
+    """
+    Generate a warm, natural one-sentence reply for a greeting message.
+
+    Uses the same lightweight classifier model so the response is instant.
+    Falls back to a generic reply on any error.
+    """
+    try:
+        import google.genai as genai
+        from google.genai import types as gtypes
+
+        client = genai.Client(api_key=_get_api_key())
+        resp = await client.aio.models.generate_content(
+            model=_get_classifier_model(),
+            contents=[
+                gtypes.Content(
+                    role="user",
+                    parts=[gtypes.Part(text=_GREETING_SYSTEM)],
+                ),
+                gtypes.Content(
+                    role="model",
+                    parts=[gtypes.Part(text="Got it.")],
+                ),
+                gtypes.Content(
+                    role="user",
+                    parts=[gtypes.Part(text=message)],
+                ),
+            ],
+            config=gtypes.GenerateContentConfig(
+                temperature=0.8,
+                max_output_tokens=80,
+            ),
+        )
+        text = (resp.text or "").strip()
+        return text or "Hey! What can I help you with today?"
+    except Exception:
+        return "Hey! What can I help you with today?"

{gemcode-0.3.38 → gemcode-0.3.40}/src/gemcode/tools/notes.py

@@ -86,8 +86,10 @@ def build_notes_tools(project_root: Path) -> list:
     """
     Read the current contents of .gemcode/notes.md.
 
-    Use this to check what has been previously noted about this project before
-    starting a task — avoids re-discovering things already documented.
+    ONLY call this when you are about to work on an actual engineering task
+    (editing files, debugging, building something) and want to avoid re-discovering
+    already-known project facts. Do NOT call this for greetings, chitchat, or
+    general questions that don't require project context.
 
     Returns the full notes content as a string, or an empty string if no notes exist.
     """

{gemcode-0.3.38 → gemcode-0.3.40}/src/gemcode/tui/scrollback.py

@@ -515,6 +515,57 @@ async def run_gemcode_scrollback_tui(
         continue
       prompt = slash.model_prompt or prompt
 
+    # ── LLM intent pre-classifier ────────────────────────────────────────────
+    # A lightweight Gemini call (gemini-2.0-flash-lite) classifies the message
+    # before the main agent runs.  Greetings are short-circuited entirely:
+    # we generate a natural reply directly and skip the main agent, so the
+    # user gets an instant response with zero unnecessary tool calls.
+    # For all other intents the classified label is stored in session state
+    # so the main agent can adapt its workflow without re-classifying.
+    try:
+      from gemcode.intent_classifier import (
+          classify_intent,
+          generate_greeting_reply,
+          INTENT_GREETING,
+          INTENT_DESCRIPTIONS,
+      )
+      _intent = await classify_intent(prompt)
+
+      if _intent == INTENT_GREETING:
+        # Fast path: generate a warm reply with the lightweight model and skip
+        # the main agent entirely — no tool calls, no spinner, instant UX.
+        _reply = await generate_greeting_reply(prompt)
+        print(f"  \u23bf  {ansi.bold}GemCode{ansi.reset}:")
+        console.print(_RichPadding(_RichMarkdown(_reply), (0, 0, 0, 4)))
+        # Print minimal footer (no token stats since we bypassed the main model)
+        print("")
+        if os.environ.get("GEMCODE_TUI_TURN_RULE", "1").lower() in (
+            "1", "true", "yes", "on"
+        ):
+          print(f"{ansi.dim}{_hr(ch='─')}{ansi.reset}")
+        print("")
+        continue
+
+      # Non-greeting: store classified intent in session state so the main
+      # agent can read it and adapt its tool-use strategy accordingly.
+      try:
+        ss = runner.session_service
+        app = getattr(runner, "app_name", None) or getattr(cfg, "app_name", "gemcode")
+        sess = await ss.get_session(
+            app_name=app, user_id="local", session_id=current_session_id
+        )
+        if sess is not None:
+          _desc = INTENT_DESCRIPTIONS.get(_intent, _intent)
+          sess.state["_gemcode_intent"] = _intent
+          sess.state["_gemcode_intent_desc"] = _desc
+          await ss.update_session(sess)
+      except Exception:
+        pass  # State injection is best-effort
+
+    except Exception:
+      pass  # Classifier unavailable — fall through to main agent unchanged
+    # ─────────────────────────────────────────────────────────────────────────
+
     # Snapshot pre-turn capability state so we can detect routing-triggered changes.
     _pre_dr  = cfg.enable_deep_research
     _pre_emb = cfg.enable_embeddings

{gemcode-0.3.38 → gemcode-0.3.40/src/gemcode.egg-info}/PKG-INFO

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

{gemcode-0.3.38 → gemcode-0.3.40}/src/gemcode.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ src/gemcode/context_warning.py
 src/gemcode/credentials.py
 src/gemcode/hitl_session.py
 src/gemcode/hooks.py
+src/gemcode/intent_classifier.py
 src/gemcode/interactions.py
 src/gemcode/invoke.py
 src/gemcode/kairos_daemon.py