hypha-debugger 0.2.1__tar.gz → 0.2.3__tar.gz

{hypha_debugger-0.2.1 → hypha_debugger-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypha-debugger
-Version: 0.2.1
+Version: 0.2.3
 Summary: Injectable debugger for Python processes and AI agents, powered by Hypha RPC
 Author: Amun AI AB
 License: MIT
@@ -20,6 +20,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: hypha-rpc>=0.20.0
 Requires-Dist: pydantic>=2.0
+Requires-Dist: certifi
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"

{hypha_debugger-0.2.1 → hypha_debugger-0.2.3}/hypha_debugger/__init__.py

@@ -12,5 +12,5 @@ Usage (sync):
 
 from hypha_debugger.debugger import start_debugger, start_debugger_sync, DebugSession
 
-__version__ = "0.2.1"
+__version__ = "0.2.3"
 __all__ = ["start_debugger", "start_debugger_sync", "DebugSession", "__version__"]

{hypha_debugger-0.2.1 → hypha_debugger-0.2.3}/hypha_debugger/cli.py

@@ -22,6 +22,7 @@ after every ``hyd sh``. See any debugger's ``GET <url>/get_skill_md``.
 import json
 import os
 import shlex
+import ssl
 import sys
 import urllib.error
 import urllib.request
@@ -29,6 +30,24 @@ import urllib.request
 __all__ = ["main"]
 
 
+def _ssl_context() -> ssl.SSLContext:
+    """A TLS context that verifies certs using certifi's CA bundle when available.
+
+    Python's default context uses the system/OpenSSL trust store, which is often
+    missing or unconfigured (macOS framework Python, minimal containers, fresh
+    venvs) — causing CERTIFICATE_VERIFY_FAILED on HTTPS service URLs even though
+    `curl` works. certifi (a transitive dep of hypha-rpc) fixes that portably.
+    """
+    try:
+        import certifi
+        return ssl.create_default_context(cafile=certifi.where())
+    except Exception:
+        return ssl.create_default_context()
+
+
+_SSL_CTX = _ssl_context()
+
+
 class CliError(Exception):
     pass
 
@@ -164,7 +183,7 @@ def _call_remote(profile: dict, fn: str, params: dict, http_timeout: int = 75) -
     if profile.get("token"):
         req.add_header("Authorization", "Bearer " + profile["token"])
     try:
-        with urllib.request.urlopen(req, timeout=http_timeout) as resp:
+        with urllib.request.urlopen(req, timeout=http_timeout, context=_SSL_CTX) as resp:
             raw = resp.read().decode("utf-8", "replace")
     except urllib.error.HTTPError as e:
         body = e.read().decode("utf-8", "replace") if e.fp else ""

{hypha_debugger-0.2.1 → hypha_debugger-0.2.3}/hypha_debugger/services/source.py

@@ -90,18 +90,20 @@ def _get_skill_md_impl() -> str:
 
 ## Overview
 A remote debugger is attached to a running Python process. You have full access
-to execute code, read/write files, inspect variables, and install packages.
+to run shell + Python, read/write files, inspect variables, and install packages.
 
-**Recommended approach**: Use `execute_code` as your primary tool — it's a
-persistent Python REPL where variables, imports, and functions survive across
-calls. The other endpoints are convenience shortcuts.
+**START HERE → install the `hyd` CLI (next section).** Decision rule: if you'll run
+more than ~2 commands here (i.e. almost any real task), `hyd` is the intended
+interface — one `pip install`, then every command is a short `hyd sh '…'` /
+`hyd py '…'` with the connection + working directory remembered for you, far fewer
+tokens than re-sending an authenticated curl each time, and it behaves like a local
+shell. Only for a single throwaway call is raw curl (further down) simpler. The raw
+HTTP API is the low-level fallback and powers the CLI.
 
-## Fast path — the `hyd` CLI (recommended for agents)
+## Fast path — the `hyd` CLI (do this first)
 
-For repeated shell work, don't hand-write authenticated curl calls — install the
-`hyd` client CLI once and run remote commands with almost no per-call overhead.
-It stores this connection as a named **profile** (URL + token) on disk, so later
-calls carry no auth or JSON boilerplate. Bootstrap yourself:
+Bootstrap yourself in three lines (THIS_SERVICE_URL = the URL you fetched this doc
+from, without the trailing `/get_skill_md`):
 
 ```bash
 pip install hypha-debugger            # ships the `hyd` command
@@ -111,8 +113,14 @@ export HYD_PROFILE=main               # select it (env var — per-terminal, not
 hyd sh 'uname -a && pwd'              # run a remote shell command
 hyd 'ls -la'                         # bare form: anything not a subcommand runs as a command
 hyd py 'import sys; sys.version'      # run Python via execute_code
+hyd status                           # confirm it's connected
 ```
 
+Install tip: `pipx install hypha-debugger` is the most reliable — it always puts
+`hyd` on your PATH. If instead you used `pip install --user` and `hyd` isn't found,
+either add the user bin dir to PATH, or just use `python -m hypha_debugger.cli` in
+place of `hyd` — identical arguments (`python -m hypha_debugger.cli sh 'pwd'`).
+
 Key ideas:
 - **The remote is stateless.** The "current directory" and "current profile" live
   in the environment variables `HYD_CWD` and `HYD_PROFILE` (per shell), so different

{hypha_debugger-0.2.1 → hypha_debugger-0.2.3}/hypha_debugger.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypha-debugger
-Version: 0.2.1
+Version: 0.2.3
 Summary: Injectable debugger for Python processes and AI agents, powered by Hypha RPC
 Author: Amun AI AB
 License: MIT
@@ -20,6 +20,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: hypha-rpc>=0.20.0
 Requires-Dist: pydantic>=2.0
+Requires-Dist: certifi
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"

{hypha_debugger-0.2.1 → hypha_debugger-0.2.3}/hypha_debugger.egg-info/requires.txt

@@ -1,5 +1,6 @@
 hypha-rpc>=0.20.0
 pydantic>=2.0
+certifi
 
 [dev]
 pytest>=7.0

{hypha_debugger-0.2.1 → hypha_debugger-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hypha-debugger"
-version = "0.2.1"
+version = "0.2.3"
 description = "Injectable debugger for Python processes and AI agents, powered by Hypha RPC"
 readme = "README.md"
 license = {text = "MIT"}
@@ -25,6 +25,7 @@ classifiers = [
 dependencies = [
     "hypha-rpc>=0.20.0",
     "pydantic>=2.0",
+    "certifi",
 ]
 
 [project.urls]