jac-coder 0.2.3__tar.gz → 0.2.5__tar.gz

{jac_coder-0.2.3 → jac_coder-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jac-coder
-Version: 0.2.3
+Version: 0.2.5
 Summary: AI coding agent backend for Jac, powered by jac-byllm
 Requires-Python: >=3.12
 Requires-Dist: python-dotenv>=1.0.0
@@ -8,3 +8,4 @@ Requires-Dist: jaclang
 Requires-Dist: byllm
 Requires-Dist: mcp>=1.0.0
 Requires-Dist: jac-mcp
+Requires-Dist: rich>=13.0

{jac_coder-0.2.3 → jac_coder-0.2.5}/README.md

@@ -1,6 +1,8 @@
 # JacCoder
 
-![JacCoder CLI](assets/cli.png)
+<p align="center">
+  <img width="520" height="226" alt="image" src="https://github.com/user-attachments/assets/f245c84e-b88c-433a-99b8-a3609dcbe691" />
+</p>
 
 AI coding agent for the Jaseci stack, built entirely in [Jac](https://github.com/jaseci-labs/jaseci) using Object-Spatial Programming. Features an orchestrator-worker architecture with compiler-level Jac Intelligence, self-correcting code writes, and in-process SubAgent delegation.
 
@@ -40,13 +42,13 @@ Dependencies (auto-installed): `jaclang`, `byllm`, `mcp>=1.0.0`, `jac-mcp`, `pyt
 export OPENAI_API_KEY="sk-..."
 
 # Interactive REPL
-jac cli.jac
+jac-coder
 
 # Single prompt (non-interactive)
-jac cli.jac run "build a hello world jac app at /tmp/myapp"
+jac-coder run "build a hello world jac app at /tmp/myapp"
 
 # Resume a session
-jac cli.jac session <id-prefix>
+jac-coder session <id-prefix>
 ```
 
 ## Architecture
@@ -89,7 +91,7 @@ MainAgent has 27 tools, grouped by domain:
 | Web | `web_fetch`, `web_search` | HTTP fetch + DuckDuckGo search |
 | Browser | `browser_open`, `browser_do`, `browser_state`, `browser_validate`, `browser_close` | Visual QA via agent-browser; `browser_validate` is the primary pass/fail check |
 | Delegate | `spawn_agent` | In-process WorkerAgent / ExplorerAgent walker |
-| Interact | `ask_question`, `update_todos` | User prompt + multi-step task tracking |
+| Interact | `clarify_intent`, `update_todos` | Structured clarifying questions (blocking, multi-mode) + multi-step task tracking |
 | MCP | `mcp_call` | Call any tool from a connected MCP server |
 
 ## Public API
@@ -144,7 +146,7 @@ jac-code/
 │   │   ├── skills.jac            # SKILL.md registry + listing injection
 │   │   └── cost_tracker.jac      # Opt-in token + USD cost tracking
 │   ├── tool/                     # 28 tools organized by domain
-│   │   ├── meta/                 # think, spawn_agent, update_todos, ask_question, validate
+│   │   ├── meta/                 # think, spawn_agent, update_todos, clarify_intent, validate
 │   │   ├── read/                 # filesystem, search, jac_analyzer, load_jac_skill
 │   │   ├── write/                # checked (write_code/edit_code), scaffold
 │   │   ├── run/                  # shell, guarded, jac_tools

{jac_coder-0.2.3 → jac_coder-0.2.5}/jac_coder/__init__.jac

@@ -1,4 +1,4 @@
-"""jac-coder — AI coding agent for Jac.
+"""jac-coder — AI coding agent for Jaseci.
 
 Top-level re-exports. Existing CLI / stdio-server consumers continue
 to import from jac_coder.api; this file exposes the library-mode

{jac_coder-0.2.3 → jac_coder-0.2.5}/jac_coder/api.impl.jac

@@ -150,6 +150,7 @@ impl get_session(session_id: str) -> dict {
         "status": s.status,
         "directory": s.directory,
         "chat_history": s.chat_history,
+        "clarification_history": s.clarification_history,
         "created_at": s.created_at,
         "updated_at": s.updated_at
     };
@@ -257,15 +258,24 @@ impl chat(
         # role=system dicts to session.chat_history without them persisting stale.
         prefix_parts: list[str] = [];
 
-        if session.project_summary {
-            is_progress_file = session.project_summary.lstrip().startswith("#");
-            label = (
-                "Project progress (.jaccoder/progress.md)"
-                if is_progress_file
-                else "Project context"
+        # Tell the LLM the actual working directory — without this, relative
+        # paths are unresolvable and the model guesses (e.g. "/home/user").
+        if work_dir {
+            prefix_parts.append(
+                f"Working directory: {work_dir}\n"
+                "Default to this directory: resolve relative paths and deictic "
+                "references (e.g. 'here', 'this folder', '.', './sub') against it. "
+                "Use absolute paths for anything outside it."
             );
+        }
+
+        if session.project_summary {
             prefix_parts.append(
-                f"[INTERNAL — do NOT present this to the user unless they ask about the project. This is your background knowledge for making informed decisions.]\n{label}:\n{session.project_summary}"
+                "[INTERNAL — background context from .jaccoder/progress.md. "
+                "Do NOT acknowledge, summarize, or volunteer this to the user "
+                "unless they explicitly ask about the project. Use it only to "
+                "inform your decisions on real work prompts.]\n"
+                f"Project progress (.jaccoder/progress.md):\n{session.project_summary}"
             );
         }
         if session.active_files {
@@ -373,13 +383,18 @@ impl chat(
         } else {
             session.pending_errors = [];
         }
-        if files_modified and session.directory {
-            memory = find_or_create_memory(session.directory);
-            if memory {
-                update_memory_from_session(
-                    memory, files_modified, response_text[:500]
-                );
-                session.project_summary = memory.summarize();
+        if session.directory {
+            _progress_path = os.path.join(session.directory, ".jaccoder", "progress.md");
+            if os.path.isfile(_progress_path) {
+                try {
+                    with open(_progress_path, "r", encoding="utf-8") as _pf {
+                        _pc = _pf.read();
+                    }
+                    if len(_pc) > 4000 {
+                        _pc = _pc[:4000] + "\n\n[... truncated]";
+                    }
+                    session.project_summary = _pc;
+                } except Exception { }
             }
         }
 
@@ -443,21 +458,19 @@ def _ensure_memory(session: Session, work_dir: str) -> None {
     if not work_dir or session.project_summary {
         return;
     }
-    memory = find_or_create_memory(work_dir);
-    if not memory {
+    progress_path = os.path.join(work_dir, ".jaccoder", "progress.md");
+    if not os.path.isfile(progress_path) {
         return;
     }
-    has_project = (
-        os.path.exists(os.path.join(work_dir, "jac.toml"))
-        or os.path.exists(os.path.join(work_dir, "main.jac"))
-    );
-    if not memory.architecture and not memory.scan_attempted and has_project {
-        _init_memory(memory, work_dir);
-    }
-    summary = memory.summarize();
-    if summary {
-        session.project_summary = summary;
-    }
+    try {
+        with open(progress_path, "r", encoding="utf-8") as f {
+            content = f.read();
+        }
+        if len(content) > 4000 {
+            content = content[:4000] + "\n\n[... truncated]";
+        }
+        session.project_summary = content;
+    } except Exception { }
 }
 
 
@@ -484,14 +497,19 @@ def _post_process(session: Session, response_obj: Any) -> None {
         session.pending_errors = [];
     }
 
-    # Update memory
-    if response_obj.files_modified and session.directory {
-        memory = find_or_create_memory(session.directory);
-        if memory {
-            update_memory_from_session(
-                memory, response_obj.files_modified, response_obj.content[:500]
-            );
-            session.project_summary = memory.summarize();
+    # Refresh project_summary from progress.md (agent may have updated it).
+    if session.directory {
+        progress_path = os.path.join(session.directory, ".jaccoder", "progress.md");
+        if os.path.isfile(progress_path) {
+            try {
+                with open(progress_path, "r", encoding="utf-8") as f {
+                    pc = f.read();
+                }
+                if len(pc) > 4000 {
+                    pc = pc[:4000] + "\n\n[... truncated]";
+                }
+                session.project_summary = pc;
+            } except Exception { }
         }
     }
 
@@ -591,6 +609,34 @@ impl abort_session(session_id: str) -> None {
     }
 }
 
+"""Receive the user's decision from a clarification prompt and unblock the agent waiting for it.
+- selected_id: the ID of the option the user selected, if applicable
+- custom_text: any custom text input the user provided, if applicable 
+- skipped: whether the user skipped the clarification 
+"""
+impl clarification_response(
+    session_id: str,
+    request_id: str,
+    selected_id: str = "",
+    custom_text: str = "",
+    skipped: bool = False
+) -> dict {
+    if not session_id {
+        return {"ok": False, "error": "session_id required"};
+    }
+    _clarification_decisions[session_id] = {
+        "request_id": request_id,
+        "selected_id": selected_id,
+        "custom_text": custom_text,
+        "skipped": skipped
+    };
+    gate = _clarification_events.get(session_id);
+    if gate {
+        gate.set();
+    }
+    return {"ok": True};
+}
+
 
 """Build MCP tools context message for the LLM system prompt.
 

{jac_coder-0.2.3 → jac_coder-0.2.5}/jac_coder/api.jac

@@ -13,7 +13,12 @@ import from jac_coder.util.tool_output { tool_end }
 import from jac_coder.runtime.permission { permission_engine }
 import from jac_coder.util.sandbox { set_sandbox_root, set_browser_exec }
 import from jac_coder.runtime.context { build_context, ContextConfig }
-import from jac_coder.core.walkers { new_session, ensure_main_agent, _consume_llm_stream, _find_session }
+import from jac_coder.core.walkers {
+    new_session,
+    ensure_main_agent,
+    _consume_llm_stream,
+    _find_session
+}
 import from jac_coder.infra.mcp_manager {
     mcp_add_server,
     mcp_disconnect_server,
@@ -29,8 +34,17 @@ import from jac_coder.runtime.memory {
     update_memory_from_session
 }
 import from jac_coder.core.nodes { Session, MainAgent }
-import from jac_coder.runtime.cost_tracker { get_summary as _ct_get_summary, is_cost_tracking_enabled as _ct_enabled }
-import from jac_coder.tool.run.guarded { _set_chat_session, _clear_chat_session, _chat_contexts }
+import from jac_coder.runtime.cost_tracker {
+    get_summary as _ct_get_summary,
+    is_cost_tracking_enabled as _ct_enabled
+}
+import from jac_coder.tool.run.guarded {
+    _set_chat_session,
+    _clear_chat_session,
+    _chat_contexts,
+    _clarification_events,
+    _clarification_decisions
+}
 import from jac_coder.runtime.events {
     register_event_callback,
     clear_event_callbacks,
@@ -47,7 +61,7 @@ import from jac_coder.runtime.events {
 def initialize(mode: str = "web") -> None;
 
 """Remove root edges whose target no longer resolves (e.g. after a class-path rename)."""
-def _prune_dangling_root_edges() -> int;
+def _prune_dangling_root_edges -> int;
 
 """Create a new session."""
 def create_session(directory: str, title: str = "", agent: str = "main") -> dict;
@@ -65,7 +79,7 @@ def chat(
     env_overrides: dict = {}
 ) -> dict;
 
-def list_sessions() -> list;
+def list_sessions -> list;
 
 def get_session(session_id: str) -> dict;
 
@@ -76,7 +90,7 @@ def close_session(session_id: str) -> dict;
 def api_set_model(model: str) -> dict;
 
 """Get current model info."""
-def api_get_model() -> dict;
+def api_get_model -> dict;
 
 """Check if local model runtime and model weights are ready for a given alias."""
 def api_check_local_setup(alias: str) -> dict;
@@ -95,7 +109,16 @@ def api_mcp_reconnect(name: str) -> dict;
 def api_mcp_delete(name: str) -> dict;
 
 """List all configured MCP servers."""
-def api_mcp_list() -> list;
+def api_mcp_list -> list;
 
 """Append an abort note to a session's chat_history (called synchronously from stop handler)."""
 def abort_session(session_id: str) -> None;
+
+"""Accept a user's clarification response and unblock the waiting agent thread."""
+def clarification_response(
+    session_id: str,
+    request_id: str,
+    selected_id: str = "",
+    custom_text: str = "",
+    skipped: bool = False
+) -> dict;