cocoindex-code 0.2.33__tar.gz → 0.2.34__tar.gz

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/.gitignore

@@ -33,6 +33,9 @@ ENV/
 *.swp
 *.swo
 
+# Claude Code local config and state
+/.claude/
+
 # Testing
 .tox/
 .coverage

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cocoindex-code
-Version: 0.2.33
+Version: 0.2.34
 Summary: MCP server for indexing and querying codebases using CocoIndex
 Project-URL: Homepage, https://github.com/cocoindex-io/cocoindex-code
 Project-URL: Repository, https://github.com/cocoindex-io/cocoindex-code
@@ -17,7 +17,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
-Requires-Dist: cocoindex[litellm]<1.1.0,>=1.0.0
+Requires-Dist: cocoindex[litellm]<1.1.0,>=1.0.6
 Requires-Dist: einops>=0.8.2
 Requires-Dist: mcp>=1.0.0
 Requires-Dist: msgspec>=0.19.0
@@ -29,7 +29,7 @@ Requires-Dist: questionary>=2.0.0
 Requires-Dist: sqlite-vec>=0.1.0
 Requires-Dist: typer>=0.9.0
 Provides-Extra: dev
-Requires-Dist: cocoindex[sentence-transformers]<1.1.0,>=1.0.0; extra == 'dev'
+Requires-Dist: cocoindex[sentence-transformers]<1.1.0,>=1.0.6; extra == 'dev'
 Requires-Dist: mypy>=1.0.0; extra == 'dev'
 Requires-Dist: prek>=0.1.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
@@ -37,9 +37,9 @@ Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.0; extra == 'dev'
 Provides-Extra: embeddings-local
-Requires-Dist: cocoindex[sentence-transformers]<1.1.0,>=1.0.0; extra == 'embeddings-local'
+Requires-Dist: cocoindex[sentence-transformers]<1.1.0,>=1.0.6; extra == 'embeddings-local'
 Provides-Extra: full
-Requires-Dist: cocoindex[sentence-transformers]<1.1.0,>=1.0.0; extra == 'full'
+Requires-Dist: cocoindex[sentence-transformers]<1.1.0,>=1.0.6; extra == 'full'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -568,6 +568,23 @@ envs:
 
 </details>
 
+<details>
+<summary>OpenAI-compatible (custom endpoint)</summary>
+
+Many providers (vLLM, LM Studio, LocalAI, Together, Fireworks, DeepInfra, …) expose an OpenAI-compatible embedding API. Use the `openai/` prefix and point `OPENAI_BASE_URL` at your endpoint:
+
+```yaml
+embedding:
+  model: openai/your-model-name
+envs:
+  OPENAI_BASE_URL: https://your-endpoint/v1
+  OPENAI_API_KEY: your-api-key
+```
+
+Don't append `/embeddings` to the base URL — LiteLLM handles that.
+
+</details>
+
 <details>
 <summary>Azure OpenAI</summary>
 
@@ -656,7 +673,7 @@ envs:
 
 </details>
 
-Any [LiteLLM-supported model](https://docs.litellm.ai/docs/embedding/supported_embedding) works. When using a LiteLLM model, set `provider: litellm` (or omit `provider` — LiteLLM is the default for non-`sentence-transformers` models).
+Any [LiteLLM-supported model](https://docs.litellm.ai/docs/embedding/supported_embedding) works. When using a LiteLLM model, set `provider: litellm` (or omit `provider` — LiteLLM is the default for non-`sentence-transformers` models). For the full list of env vars each provider reads (API keys, base URLs, regions, …), see LiteLLM's [Setting API Keys](https://docs.litellm.ai/docs/set_keys).
 
 ### Local SentenceTransformers Models
 
@@ -776,6 +793,18 @@ If you previously configured `cocoindex-code` via environment variables, the `co
 | `COCOINDEX_CODE_EXCLUDED_PATTERNS` | `exclude_patterns` in project `settings.yml` |
 | `COCOINDEX_CODE_EXTRA_EXTENSIONS` | `include_patterns` + `language_overrides` in project `settings.yml` |
 
+## Telemetry
+
+`cocoindex-code` sends anonymous usage telemetry through CocoIndex so we can see how the tool is used in aggregate and prioritize improvements. The events identify themselves as `application: cocoindex-code`.
+
+We **do not** collect your source code, file paths, queries, search results, embeddings, settings, or any other content from your codebase or environment.
+
+To opt out, set:
+
+```bash
+export COCOINDEX_DISABLE_USAGE_TRACKING=1
+```
+
 ## Large codebase / Enterprise
 [CocoIndex](https://github.com/cocoindex-io/cocoindex) is an ultra efficient indexing engine that also works on large codebases at scale for enterprises. In enterprise scenarios it is a lot more efficient to share indexes with teammates when there are large or many repos. We also have advanced features like branch dedupe etc designed for enterprise users.
 

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/README.md

@@ -524,6 +524,23 @@ envs:
 
 </details>
 
+<details>
+<summary>OpenAI-compatible (custom endpoint)</summary>
+
+Many providers (vLLM, LM Studio, LocalAI, Together, Fireworks, DeepInfra, …) expose an OpenAI-compatible embedding API. Use the `openai/` prefix and point `OPENAI_BASE_URL` at your endpoint:
+
+```yaml
+embedding:
+  model: openai/your-model-name
+envs:
+  OPENAI_BASE_URL: https://your-endpoint/v1
+  OPENAI_API_KEY: your-api-key
+```
+
+Don't append `/embeddings` to the base URL — LiteLLM handles that.
+
+</details>
+
 <details>
 <summary>Azure OpenAI</summary>
 
@@ -612,7 +629,7 @@ envs:
 
 </details>
 
-Any [LiteLLM-supported model](https://docs.litellm.ai/docs/embedding/supported_embedding) works. When using a LiteLLM model, set `provider: litellm` (or omit `provider` — LiteLLM is the default for non-`sentence-transformers` models).
+Any [LiteLLM-supported model](https://docs.litellm.ai/docs/embedding/supported_embedding) works. When using a LiteLLM model, set `provider: litellm` (or omit `provider` — LiteLLM is the default for non-`sentence-transformers` models). For the full list of env vars each provider reads (API keys, base URLs, regions, …), see LiteLLM's [Setting API Keys](https://docs.litellm.ai/docs/set_keys).
 
 ### Local SentenceTransformers Models
 
@@ -732,6 +749,18 @@ If you previously configured `cocoindex-code` via environment variables, the `co
 | `COCOINDEX_CODE_EXCLUDED_PATTERNS` | `exclude_patterns` in project `settings.yml` |
 | `COCOINDEX_CODE_EXTRA_EXTENSIONS` | `include_patterns` + `language_overrides` in project `settings.yml` |
 
+## Telemetry
+
+`cocoindex-code` sends anonymous usage telemetry through CocoIndex so we can see how the tool is used in aggregate and prioritize improvements. The events identify themselves as `application: cocoindex-code`.
+
+We **do not** collect your source code, file paths, queries, search results, embeddings, settings, or any other content from your codebase or environment.
+
+To opt out, set:
+
+```bash
+export COCOINDEX_DISABLE_USAGE_TRACKING=1
+```
+
 ## Large codebase / Enterprise
 [CocoIndex](https://github.com/cocoindex-io/cocoindex) is an ultra efficient indexing engine that also works on large codebases at scale for enterprises. In enterprise scenarios it is a lot more efficient to share indexes with teammates when there are large or many repos. We also have advanced features like branch dedupe etc designed for enterprise users.
 

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
 
 dependencies = [
     "mcp>=1.0.0",
-    "cocoindex[litellm]>=1.0.0,<1.1.0",
+    "cocoindex[litellm]>=1.0.6,<1.1.0",
     "sqlite-vec>=0.1.0",
     "pydantic>=2.0.0",
     "numpy>=1.24.0",
@@ -39,7 +39,7 @@ dependencies = [
 # `embeddings-local` is the primary feature extra: it pulls in
 # `sentence-transformers` (via cocoindex) so local embeddings work without
 # an API key.
-embeddings-local = ["cocoindex[sentence-transformers]>=1.0.0,<1.1.0"]
+embeddings-local = ["cocoindex[sentence-transformers]>=1.0.6,<1.1.0"]
 # `full` is the umbrella "batteries-included" alias. Today it's just
 # `embeddings-local`, but we expect to bundle more optional niceties under
 # it over time — users who want everything can keep using `[full]` and pick
@@ -47,7 +47,7 @@ embeddings-local = ["cocoindex[sentence-transformers]>=1.0.0,<1.1.0"]
 # `:full` image variant for consistency across install paths. Contents are
 # inlined rather than self-referencing `cocoindex-code[embeddings-local]`
 # to avoid resolver edge cases with older pip.
-full = ["cocoindex[sentence-transformers]>=1.0.0,<1.1.0"]
+full = ["cocoindex[sentence-transformers]>=1.0.6,<1.1.0"]
 dev = [
     "pytest>=7.0.0",
     "pytest-asyncio>=0.21.0",
@@ -55,7 +55,7 @@ dev = [
     "ruff>=0.1.0",
     "mypy>=1.0.0",
     "prek>=0.1.0",
-    "cocoindex[sentence-transformers]>=1.0.0,<1.1.0",
+    "cocoindex[sentence-transformers]>=1.0.6,<1.1.0",
 ]
 
 [project.scripts]
@@ -89,7 +89,7 @@ dev = [
     "mypy>=1.0.0",
     "prek>=0.1.0",
     "types-pyyaml>=6.0.12.20250915",
-    "cocoindex[sentence-transformers]>=1.0.3,<1.1.0",
+    "cocoindex[sentence-transformers]>=1.0.7,<1.1.0",
 ]
 
 [tool.ruff]

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/src/cocoindex_code/__init__.py

@@ -3,8 +3,14 @@
 from __future__ import annotations
 
 import logging
+import os
 from typing import TYPE_CHECKING, Any
 
+# Identify this application in cocoindex's telemetry payloads. Must be set
+# before any `import cocoindex` runs (the value is read once at telemetry
+# init time). See cocoindex-io/cocoindex#1992.
+os.environ.setdefault("COCOINDEX_APPLICATION_FOR_TRACKING", "cocoindex-code")
+
 logging.basicConfig(level=logging.WARNING)
 
 from ._version import __version__  # noqa: E402

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/src/cocoindex_code/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.33'
-__version_tuple__ = version_tuple = (0, 2, 33)
+__version__ = version = '0.2.34'
+__version_tuple__ = version_tuple = (0, 2, 34)
 
 __commit_id__ = commit_id = None

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/src/cocoindex_code/cli.py

@@ -703,6 +703,9 @@ def _print_doctor_result(result: DoctorCheckResult) -> None:
         _typer.echo(f"    {line}")
     for err in result.errors:
         _typer.echo(_click.style(f"    ERROR: {err}", fg="red"), err=True)
+    if result.traceback:
+        for line in result.traceback.splitlines():
+            _typer.echo(_click.style(f"    {line}", fg="bright_black"), err=True)
 
 
 @app.command()

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/src/cocoindex_code/client.py

@@ -363,7 +363,10 @@ def doctor(
                 raise RuntimeError("Connection to daemon lost during doctor checks")
             resp = decode_response(data)
             if isinstance(resp, ErrorResponse):
-                raise RuntimeError(f"Daemon error: {resp.message}")
+                detail = f"Daemon error: {resp.message}"
+                if resp.traceback:
+                    detail += f"\n{resp.traceback}"
+                raise RuntimeError(detail)
             if isinstance(resp, DoctorResponse):
                 results.append(resp.result)
                 if on_result is not None:

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/src/cocoindex_code/daemon.py

@@ -10,6 +10,7 @@ import signal
 import sys
 import threading
 import time
+import traceback
 from collections.abc import AsyncIterator, Callable
 from multiprocessing.connection import Connection, Listener
 from pathlib import Path
@@ -250,7 +251,11 @@ async def handle_connection(
                     conn.send_bytes(encode_response(resp))
             except Exception as exc:
                 logger.exception("Error during streaming response")
-                conn.send_bytes(encode_response(ErrorResponse(message=str(exc))))
+                conn.send_bytes(
+                    encode_response(
+                        ErrorResponse(message=str(exc), traceback=traceback.format_exc())
+                    )
+                )
         else:
             conn.send_bytes(encode_response(result))
     except (EOFError, OSError, asyncio.CancelledError):
@@ -359,6 +364,7 @@ async def _check_model(
         ok=False,
         details=[params_detail],
         errors=[result.error],
+        traceback=result.traceback,
     )
 
 

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/src/cocoindex_code/protocol.py

@@ -154,6 +154,9 @@ class DoctorCheckResult(_msgspec.Struct):
     ok: bool
     details: list[str]
     errors: list[str]
+    # Full formatted traceback for a failed check, shown by `ccc doctor` to aid
+    # debugging of daemon-side exceptions (e.g. a failing model check).
+    traceback: str | None = None
 
 
 class DoctorResponse(_msgspec.Struct, tag="doctor"):
@@ -175,6 +178,9 @@ class DaemonEnvResponse(_msgspec.Struct, tag="daemon_env"):
 
 class ErrorResponse(_msgspec.Struct, tag="error"):
     message: str
+    # Full formatted traceback from the daemon, when the error originates from an
+    # unhandled exception. Surfaced by the CLI so daemon-side failures are debuggable.
+    traceback: str | None = None
 
 
 Response = (

{cocoindex_code-0.2.33 → cocoindex_code-0.2.34}/src/cocoindex_code/shared.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import importlib.util
 import logging
 import pathlib
+import traceback as _tb
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Annotated, Any, NamedTuple, Union
 
@@ -47,11 +48,14 @@ def is_sentence_transformers_installed() -> bool:
 class EmbeddingCheckResult(NamedTuple):
     """Outcome of a single embed-test call. See `check_embedding`.
 
-    Exactly one of ``dim`` / ``error`` is set: ``error is None`` means success.
+    On success ``error is None`` and ``dim`` holds the embedding dimension. On
+    failure ``error`` holds a one-line summary and ``traceback`` the full
+    formatted traceback (for surfacing daemon-side stack traces in `ccc doctor`).
     """
 
     dim: int | None
     error: str | None
+    traceback: str | None = None
 
 
 async def check_embedding(
@@ -73,7 +77,7 @@ async def check_embedding(
         msg = " ".join(f"{type(e).__name__}: {e}".splitlines())
         if len(msg) > 500:
             msg = msg[:500] + "…"
-        return EmbeddingCheckResult(dim=None, error=msg)
+        return EmbeddingCheckResult(dim=None, error=msg, traceback=_tb.format_exc())
 
 
 def create_embedder(