cecli-dev 1.3.0rc1__tar.gz → 1.3.1rc1__tar.gz

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cecli-dev
-Version: 1.3.0rc1
+Version: 1.3.1rc1
 Summary: we also can't pronounce cecli
 Project-URL: Homepage, https://github.com/dwash96/cecli
 Project-URL: Documentation, https://github.com/dwash96/cecli
@@ -90,7 +90,7 @@ Requires-Dist: pympler; extra == "dev"
 Requires-Dist: guppy3; extra == "dev"
 Requires-Dist: psutil; extra == "dev"
 Provides-Extra: help
-Requires-Dist: llama-index-embeddings-huggingface; extra == "help"
+Requires-Dist: chromadb; extra == "help"
 Requires-Dist: numpy>=1.26.4; extra == "help"
 Provides-Extra: playwright
 Requires-Dist: playwright; extra == "playwright"

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/__init__.py

@@ -1,6 +1,6 @@
 from packaging import version
 
-__version__ = "1.3.0.dev"
+__version__ = "1.3.1.dev"
 safe_version = __version__
 
 try:

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.3.0rc1'
-__version_tuple__ = version_tuple = (1, 3, 0, 'rc1')
+__version__ = version = '1.3.1rc1'
+__version_tuple__ = version_tuple = (1, 3, 1, 'rc1')
 
-__commit_id__ = commit_id = 'gee851b36f'
+__commit_id__ = commit_id = 'g70c188dc9'

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/coders/base_coder.py

@@ -354,6 +354,23 @@ class Coder(metaclass=UsageMeta):
                 if from_coder.tui:
                     res.tui = from_coder.tui
 
+                # Sub-agents get a dedicated, independent MCP manager so they
+                # can rebuild a custom tool list (their own LocalServer tools /
+                # filters) and be disconnected independently from the parent.
+                # The parent's server configs are copied into a fresh manager
+                # whose connections are created on this loop; the Local server
+                # is left to initialize_mcp_tools() so it is recreated from the
+                # sub-agent's filters.
+                if (
+                    from_coder.mcp_manager
+                    and res.uuid
+                    and res.parent_uuid
+                    and res.parent_uuid != res.uuid
+                ):
+                    res.mcp_manager = await from_coder.mcp_manager.spawn_child(
+                        io=IOProxy.unwrap(res.io)
+                    )
+
                 if res.mcp_manager:
                     # When switching to a non-agent coder, disconnect the "Local" MCP server
                     # (which provides agent-only tools like tool calling and file editing)

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/commands/help.py

@@ -17,57 +17,74 @@ class HelpCommand(BaseCommand):
             await cls._basic_help(io, coder)
             return format_command_result(io, "help", "Displayed basic help")
 
+        import traceback
         from uuid import uuid4 as generate_unique_id
 
         from cecli.coders.base_coder import Coder
+        from cecli.commands import SwitchCoderSignal
         from cecli.help import Help, install_help_extra
 
         # Get the Commands instance from kwargs if available
         commands_instance = kwargs.get("commands_instance")
 
-        if not commands_instance or not hasattr(commands_instance, "help"):
-            res = await install_help_extra(io)
-            if not res:
-                io.tool_error("Unable to initialize interactive help.")
-                return format_command_result(io, "help", "Unable to initialize interactive help")
-
-            if not commands_instance:
-                # Create a minimal Commands instance if not provided
-                from cecli.commands import Commands
-
-                commands_instance = Commands(io, coder)
-            commands_instance.help = Help(coder=coder)
-
-        help_instance = commands_instance.help
-
-        # Use the editor_model from the main_model if it exists, otherwise use the main_model itself
-        editor_model = coder.main_model.editor_model or coder.main_model
-
-        original_coder = coder
-
-        kwargs = dict()
-        kwargs["io"] = io
-        kwargs["uuid"] = str(generate_unique_id())
-        kwargs["from_coder"] = coder
-        kwargs["edit_format"] = "help"
-        kwargs["summarize_from_coder"] = False
-        kwargs["map_tokens"] = 512
-        kwargs["map_mul_no_files"] = 1
-        kwargs["main_model"] = editor_model
-        kwargs["args"] = coder.args
-        kwargs["suggest_shell_commands"] = False
-        kwargs["cache_prompts"] = False
-        kwargs["num_cache_warming_pings"] = 0
-
-        help_coder = await Coder.create(**kwargs)
-        user_msg = help_instance.ask(args)
-        user_msg += """
+        # The announcement lines read ``coder.args``, which is None when a coder
+        # is created without CLI args (e.g. in tests). Skip them in that case.
+        has_args = bool(getattr(coder, "args", None))
+
+        try:
+            if not commands_instance or not hasattr(commands_instance, "help"):
+                res = await install_help_extra(io)
+                if not res:
+                    io.tool_error("Unable to initialize interactive help.")
+                    await cls._basic_help(io, coder)
+                    return format_command_result(
+                        io, "help", "Unable to initialize interactive help"
+                    )
+
+                if not commands_instance:
+                    # Create a minimal Commands instance if not provided
+                    from cecli.commands import Commands
+
+                    commands_instance = Commands(io, coder)
+                commands_instance.help = Help(coder=coder)
+
+            help_instance = commands_instance.help
+
+            # Use the editor_model from the main_model if it exists, otherwise use the main_model itself
+            editor_model = coder.main_model.editor_model or coder.main_model
+
+            original_coder = coder
+
+            kwargs = dict()
+            kwargs["io"] = io
+            kwargs["uuid"] = str(generate_unique_id())
+            kwargs["from_coder"] = coder
+            kwargs["edit_format"] = "help"
+            kwargs["summarize_from_coder"] = False
+            kwargs["map_tokens"] = 512
+            kwargs["map_mul_no_files"] = 1
+            kwargs["main_model"] = editor_model
+            kwargs["args"] = coder.args
+            kwargs["suggest_shell_commands"] = False
+            kwargs["cache_prompts"] = False
+            kwargs["num_cache_warming_pings"] = 0
+
+            help_coder = await Coder.create(**kwargs)
+            user_msg = help_instance.ask(args)
+            user_msg += """
 # Announcement lines from when this session of cecli was launched:
 
 """
-        user_msg += "\n".join(coder.get_announcements()) + "\n"
+            user_msg += "\n".join(coder.get_announcements() if has_args else []) + "\n"
 
-        await help_coder.run(user_msg, preproc=False)
+            await help_coder.run(user_msg, preproc=False)
+        except Exception as err:
+            io.tool_error(f"Interactive help failed to initialize: {err}")
+            io.tool_error(traceback.format_exc())
+            await cls._basic_help(io, coder)
+            return format_command_result(
+                io, "help", f"Interactive help failed to initialize: {err}"
+            )
 
         if coder.repo_map:
             map_tokens = coder.repo_map.max_map_tokens
@@ -76,8 +93,6 @@ class HelpCommand(BaseCommand):
             map_tokens = 0
             map_mul_no_files = 1
 
-        from cecli.commands import SwitchCoderSignal
-
         raise SwitchCoderSignal(
             edit_format=coder.edit_format,
             summarize_from_coder=False,

cecli_dev-1.3.1rc1/cecli/help.py

@@ -0,0 +1,163 @@
+import os
+import warnings
+from pathlib import Path
+
+import importlib_resources
+
+from cecli import __version__, utils
+from cecli.help_pats import exclude_website_pats
+
+warnings.simplefilter("ignore", category=FutureWarning)
+
+os.environ["TQDM_DISABLE"] = "1"
+os.environ["HF_HUB_DISABLE_PROGRESS_BARS"] = "1"
+os.environ["HF_DATASETS_DISABLE_PROGRESS_BARS"] = "1"
+os.environ["TOKENIZERS_PARALLELISM"] = "true"
+
+
+async def install_help_extra(io):
+    """Ensure the local chromadb backend is installed for interactive /help.
+
+    The previous dependency chain (``llama_index.embeddings.huggingface`` ->
+    ``sentence_transformers`` -> ``datasets``) crashed on the WSL2 + OpenSSL 3.5 +
+    Python 3.14 lazy-init flake and on a ``datasets`` circular import. Chroma's
+    default ONNX embedding needs neither, so it is what ``Help`` uses.
+    """
+    pip_install_cmd = [
+        "cecli-dev[help]",
+        "--extra-index-url",
+        "https://download.pytorch.org/whl/cpu",
+    ]
+    return await utils.check_pip_install_extra(
+        io,
+        "chromadb",
+        "To use interactive /help you need to install the help extras",
+        pip_install_cmd,
+    )
+
+
+def get_package_files():
+    docs = importlib_resources.files("cecli.website") / "docs"
+    for path in docs.rglob("*.md"):
+        yield path
+
+
+def fname_to_url(filepath):
+    """Map a file path in the website package to its published URL.
+
+    Doc sources live under ``website/docs/`` and docmd renders each ``<name>.md``
+    to ``<name>/index.html``, so ``docs/<path>/page.md`` becomes
+    ``https://cecli.dev/docs/<path>/page/``. Top-level site files (``index.html``)
+    publish to the site root. Everything else — build artifacts, ``_includes``
+    partials, okf sources — is not a published page and returns ``""``.
+    """
+    website = "website"
+    docs = "docs"
+    index = "index.md"
+    md = ".md"
+
+    filepath = filepath.replace("\\", "/")
+    parts = Path(filepath).parts
+
+    try:
+        website_index = [p.lower() for p in parts].index(website.lower())
+    except ValueError:
+        return ""
+
+    relevant_parts = parts[website_index + 1 :]
+    if not relevant_parts:
+        return ""
+
+    # Doc pages live under website/docs/ and publish to /docs/<path>/.
+    if relevant_parts[0].lower() == docs:
+        url_path = _strip_doc_suffix("/".join(relevant_parts[1:]), index, md)
+        return _format_docs_url(url_path)
+
+    # Only top-level site files publish to the site root; anything nested
+    # (_includes, _site, .docmd-*, share, etc.) is not a page.
+    if len(relevant_parts) == 1:
+        return f"https://cecli.dev/{relevant_parts[0].lstrip('/')}"
+
+    return ""
+
+
+def get_index(coder=None):
+    """Build a local chromadb vector index over the bundled help docs.
+
+    Chroma's default ONNX embedding needs no ``sentence_transformers`` or
+    ``datasets``, so it avoids the WSL2 + OpenSSL 3.5 + Python 3.14 lazy-init
+    flake and the ``datasets`` circular import that broke ``/help <question>``.
+    Returns the chromadb collection ready for text queries.
+    """
+    import chromadb
+    from chromadb.utils.embedding_functions import DefaultEmbeddingFunction
+
+    dname = Path.home() / ".cecli" / "caches" / ("help." + __version__)
+    dname.parent.mkdir(parents=True, exist_ok=True)
+
+    client = chromadb.PersistentClient(path=str(dname))
+    collection = client.get_or_create_collection(
+        "help", embedding_function=DefaultEmbeddingFunction()
+    )
+
+    if collection.count() == 0:
+        documents = []
+        ids = []
+        metadatas = []
+        for fname in get_package_files():
+            fname = Path(fname)
+            if any(fname.match(pat) for pat in exclude_website_pats):
+                continue
+            documents.append(fname.read_text(encoding="utf-8"))
+            ids.append(str(fname))
+            metadatas.append(dict(filename=fname.name, url=fname_to_url(str(fname))))
+
+        if documents:
+            collection.add(ids=ids, documents=documents, metadatas=metadatas)
+
+    return collection
+
+
+class Help:
+    """Vector retriever over the bundled help docs using a local chromadb store."""
+
+    def __init__(self, coder=None):
+        self.collection = get_index(coder=coder)
+
+    def ask(self, question):
+        results = self.collection.query(
+            query_texts=[question],
+            n_results=20,
+            include=["documents", "metadatas"],
+        )
+        documents = results.get("documents", [[]])[0]
+        metadatas = results.get("metadatas", [[]])[0]
+
+        context = f"# Question: {question}\n\n# Relevant docs:\n\n"
+        for doc, meta in zip(documents, metadatas):
+            url = (meta or {}).get("url", "")
+            if url:
+                url = f' from_url="{url}"'
+            context += f"<doc{url}>\n"
+            context += doc
+            context += "\n</doc>\n\n"
+        return context
+
+
+def _strip_doc_suffix(url_path, index, md):
+    if url_path.lower().endswith(index.lower()):
+        return url_path[: -len(index)]
+
+    if url_path.lower().endswith(md.lower()):
+        return url_path[: -len(md)]
+
+    return url_path
+
+
+def _format_docs_url(url_path):
+    url_path = url_path.strip("/")
+
+    if not url_path:
+        return "https://cecli.dev/docs/"
+
+    return f"https://cecli.dev/docs/{url_path}/"

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/helpers/agents/defaults/memorizer.md

@@ -21,7 +21,7 @@ agent-config:
     - directory_structure
     - environment_info
     - git_status
-    - symbol_outli",
+    - symbol_outline
     - todo_list
     - sub_agents
     - skills

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/helpers/hashpos/hashpos.py

@@ -74,10 +74,8 @@ class HashPos:
         rf"^({UNIQUE_HASH_DELIMITER}|{HASH_DELIMITER}[{_B1024_REGEX_SET}]{{4}}{HASH_DELIMITER})$"
     )
 
-    # Loose prefix for robust stripping: Matches a tilde-wrapped 4-char string containing non-ASCII
-    _LOOSE_PREFIX_RE = re.compile(
-        rf"^[{HASH_DELIMITER}]?(?=.{{0,3}}[^\x00-\x7f]).{{4}}{HASH_DELIMITER}"
-    )
+    # Loose prefix for robust stripping: Matches a emdash-wrapped 4-char string containing non-ASCII
+    _LOOSE_PREFIX_RE = re.compile(rf"^[{HASH_DELIMITER}]?\S{{0,4}}{HASH_DELIMITER}")
 
     def __init__(self, source_text: str = ""):
         self.lines = source_text.splitlines()

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/mcp/manager.py

@@ -387,6 +387,46 @@ class McpServerManager:
                     tool_desc = tool.get("function", {}).get("description", "").split("\n")[0]
                     self.io.tool_output(f"    - {tool_name}: {tool_desc}")
 
+    async def spawn_child(self, io=None) -> "McpServerManager":
+        """Create a new, independent manager for a sub-agent.
+
+        Rebuilds fresh McpServer instances from this manager's server configs
+        so the sub-agent sees the same full set of servers it can include or
+        exclude (via registered_servers), but with its own connections that
+        can be torn down together with the sub-agent instead of being shared
+        with the parent. The "Local" server is deliberately left out so
+        AgentCoder.initialize_mcp_tools() can create and connect its own
+        instance and rebuild the tool list from the sub-agent's own filters
+        (the parent may exclude tools a child opts into).
+        """
+        server_io = io if io is not None else self.io
+        servers = [
+            _recreate_server(server, io=server_io, verbose=self.verbose)
+            for server in self._servers
+            if not isinstance(server, LocalServer)
+        ]
+
+        child = McpServerManager(servers=servers, io=server_io, verbose=self.verbose)
+        child._connection_loop = asyncio.get_running_loop()
+
+        # Mirror the parent's connected set, but with independent connections so
+        # the child can be disconnected without affecting the parent.
+        connected_names = {
+            server.name
+            for server in self._servers
+            if server in self._connected_servers or server.is_connected
+        }
+        for server in servers:
+            if server.name in connected_names:
+                try:
+                    await child.connect_server(server.name)
+                except Exception as exc:
+                    child._log_warning(
+                        f"Failed to connect MCP server {server.name} for sub-agent: {exc}"
+                    )
+
+        return child
+
 
 def get_local_tool_schemas():
     """Returns the JSON schemas for all local tools using the tool registry."""
@@ -449,3 +489,11 @@ def _mcp_tools_to_openai_tools(tools):
         }
         for tool in tools
     ]
+
+
+def _recreate_server(server, io=None, verbose=False):
+    """Rebuild a fresh McpServer of the same type/config as an existing one."""
+    import copy
+
+    config = copy.deepcopy(server.config)
+    return type(server)(config, io=io, verbose=verbose)

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/utils.py

@@ -4,6 +4,7 @@ import os
 import platform
 import shlex
 import shutil
+import ssl
 import subprocess
 import sys
 import tempfile
@@ -387,11 +388,20 @@ def touch_file(fname):
 
 async def check_pip_install_extra(io, module, prompt, pip_install_cmd, self_update=False):
     if module:
-        try:
-            __import__(module)
-            return True
-        except (ImportError, ModuleNotFoundError, RuntimeError):
-            pass
+        for _attempt in range(2):
+            try:
+                __import__(module)
+                return True
+            except ssl.SSLError:
+                # OpenSSL CONF module lazy-init flake (WSL2 + OpenSSL 3.5 + Py3.14):
+                # the very first SSL context creation can fail with
+                # ``[CONF: MODULE_INITIALIZATION_ERROR]`` / "unknown error (0x0)",
+                # and a second attempt succeeds. Mirrors llms.runtime.make_client.
+                if _attempt == 0:
+                    continue
+                raise
+            except (ImportError, ModuleNotFoundError, RuntimeError):
+                break
 
     cmd = get_pip_install(pip_install_cmd)
 

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli/website/docs/config/persistent-memory.md

@@ -42,13 +42,13 @@ A virtual FTS5 table (`facts_fts`) is kept in sync automatically via SQL trigger
 
 ## How to Enable
 
-Agent Memory is **enabled by default** (`--auto-memory`). You can control it with the `--auto-memory` / `--no-auto-memory` flag:
+Agent Memory is **disabled by default** as it adds to overall system token usage. You can control it with the `--auto-memory` / `--no-auto-memory` flag:
 
 ```bash
-# Enable (default)
+# Enable
 cecli --auto-memory
 
-# Disable
+# Disable (default)
 cecli --no-auto-memory
 ```
 

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli_dev.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cecli-dev
-Version: 1.3.0rc1
+Version: 1.3.1rc1
 Summary: we also can't pronounce cecli
 Project-URL: Homepage, https://github.com/dwash96/cecli
 Project-URL: Documentation, https://github.com/dwash96/cecli
@@ -90,7 +90,7 @@ Requires-Dist: pympler; extra == "dev"
 Requires-Dist: guppy3; extra == "dev"
 Requires-Dist: psutil; extra == "dev"
 Provides-Extra: help
-Requires-Dist: llama-index-embeddings-huggingface; extra == "help"
+Requires-Dist: chromadb; extra == "help"
 Requires-Dist: numpy>=1.26.4; extra == "help"
 Provides-Extra: playwright
 Requires-Dist: playwright; extra == "playwright"

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli_dev.egg-info/SOURCES.txt

@@ -431,7 +431,6 @@ cecli/resources/model-metadata.json
 cecli/resources/model-settings-condensed.yml
 cecli/resources/model-settings.yml
 cecli/resources/providers.json
-cecli/tests/test_queue_commands.py
 cecli/tools/__init__.py
 cecli/tools/_yield.py
 cecli/tools/command.py

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli_dev.egg-info/requires.txt

@@ -82,7 +82,7 @@ psutil
 memray
 
 [help]
-llama-index-embeddings-huggingface
+chromadb
 numpy>=1.26.4
 
 [playwright]

{cecli_dev-1.3.0rc1 → cecli_dev-1.3.1rc1}/cecli_dev.egg-info/scm_file_list.json

@@ -421,7 +421,6 @@
     "cecli/sessions.py",
     "cecli/signals.py",
     "cecli/special.py",
-    "cecli/tests/test_queue_commands.py",
     "cecli/tools/__init__.py",
     "cecli/tools/_yield.py",
     "cecli/tools/command.py",

cecli_dev-1.3.1rc1/cecli_dev.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.3.1rc1",
+  "distance": 0,
+  "node": "g70c188dc9c502a55cebf11d815050d4cac0bb08e",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-23"
+}