agent-toolkit-cli 1.12.2__tar.gz → 1.14.0__tar.gz

{agent_toolkit_cli-1.12.2 → agent_toolkit_cli-1.14.0}/.gitignore

@@ -19,6 +19,8 @@ node_modules/
 # Build artifacts
 dist/
 build/
+# Precompiled make.vsh (`./make.vsh compile-make`)
+/make
 packages/pypi/agent-toolkit-cli/src/agent_toolkit/bin/agent-toolkit
 packages/pypi/agent-toolkit-cli/src/agent_toolkit/bin/agent-toolkit.exe
 packages/pypi/agent-toolkit-cli/.venv/

{agent_toolkit_cli-1.12.2 → agent_toolkit_cli-1.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-toolkit-cli
-Version: 1.12.2
+Version: 1.14.0
 Summary: Composable AI agent toolkit — loops, skills, profiles, and MCP for Claude Code, Cursor, OpenCode, Windsurf, and more
 Project-URL: Homepage, https://github.com/ulises-jeremias/agent-toolkit
 Project-URL: Documentation, https://github.com/ulises-jeremias/agent-toolkit/tree/main/docs
@@ -40,21 +40,16 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Requires-Python: >=3.10
-Provides-Extra: all
-Requires-Dist: pyyaml>=6.0; extra == 'all'
 Provides-Extra: dev
 Requires-Dist: jsonschema>=4.26.0; extra == 'dev'
-Requires-Dist: mypy>=2.3.0; extra == 'dev'
 Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
 Requires-Dist: pytest>=9.1.1; extra == 'dev'
 Requires-Dist: pyyaml>=6.0.3; extra == 'dev'
 Requires-Dist: ruff>=0.16.1; extra == 'dev'
-Requires-Dist: types-pyyaml>=6.0.12; extra == 'dev'
-Provides-Extra: yaml
-Requires-Dist: pyyaml>=6.0; extra == 'yaml'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -95,7 +90,7 @@ Description-Content-Type: text/markdown
 
 ## What is this package?
 
-`agent-toolkit-cli` is the **PyPI adapter** for the agent-toolkit monorepo ([ADR-021](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/adrs/ADR-021-pypi-binary.md)). Platform wheels bundle the native V binary; `agent-toolkit` / `agent-toolkit-cli` are a thin launcher. The Python implementation is a quarantined `agent-toolkit-py` fallback ([python-fallback.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/v/python-fallback.md)).
+`agent-toolkit-cli` is the **PyPI adapter** for the agent-toolkit monorepo ([ADR-021](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/adrs/ADR-021-pypi-binary.md)). Platform wheels bundle the native V binary; `agent-toolkit` / `agent-toolkit-cli` are a thin trampoline (same idea as the npm package). There is no Python CLI fallback — see [python-fallback.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/v/python-fallback.md).
 
 It also ships:
 
@@ -352,7 +347,7 @@ Issues and PRs welcome on the monorepo:
 git clone https://github.com/ulises-jeremias/agent-toolkit
 cd agent-toolkit
 uv sync --project packages/pypi/agent-toolkit-cli --all-extras
-uv run --project packages/pypi/agent-toolkit-cli --directory . agent-toolkit-py --help
+uv run --project packages/pypi/agent-toolkit-cli --directory . agent-toolkit --help
 ```
 
 ---

{agent_toolkit_cli-1.12.2 → agent_toolkit_cli-1.14.0}/README.md

@@ -36,7 +36,7 @@
 
 ## What is this package?
 
-`agent-toolkit-cli` is the **PyPI adapter** for the agent-toolkit monorepo ([ADR-021](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/adrs/ADR-021-pypi-binary.md)). Platform wheels bundle the native V binary; `agent-toolkit` / `agent-toolkit-cli` are a thin launcher. The Python implementation is a quarantined `agent-toolkit-py` fallback ([python-fallback.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/v/python-fallback.md)).
+`agent-toolkit-cli` is the **PyPI adapter** for the agent-toolkit monorepo ([ADR-021](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/adrs/ADR-021-pypi-binary.md)). Platform wheels bundle the native V binary; `agent-toolkit` / `agent-toolkit-cli` are a thin trampoline (same idea as the npm package). There is no Python CLI fallback — see [python-fallback.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/v/python-fallback.md).
 
 It also ships:
 
@@ -293,7 +293,7 @@ Issues and PRs welcome on the monorepo:
 git clone https://github.com/ulises-jeremias/agent-toolkit
 cd agent-toolkit
 uv sync --project packages/pypi/agent-toolkit-cli --all-extras
-uv run --project packages/pypi/agent-toolkit-cli --directory . agent-toolkit-py --help
+uv run --project packages/pypi/agent-toolkit-cli --directory . agent-toolkit --help
 ```
 
 ---

{agent_toolkit_cli-1.12.2 → agent_toolkit_cli-1.14.0}/hatch_build.py

@@ -72,7 +72,7 @@ def has_native_binary(root: Path) -> bool:
 class CustomBuildHook(BuildHookInterface):
     def initialize(self, version: str, build_data: dict) -> None:
         # Editable installs and sdist→wheel (macOS/Windows CI) have no bundled ELF.
-        # Product scripts still point at the launcher (exit 127), not agent-toolkit-py.
+        # Console scripts always point at the thin V launcher (exit 127 if binary missing).
         if version == "editable" or not has_native_binary(Path(self.root)):
             return
         # Binary is CPython-ABI agnostic; cp311-cp311-* wheels fail on other Pythons.

{agent_toolkit_cli-1.12.2 → agent_toolkit_cli-1.14.0}/pyproject.toml

@@ -23,9 +23,11 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Application Frameworks",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
+# No runtime deps — this package is an npm-style trampoline over the bundled V binary.
 dependencies = []
 
 [project.optional-dependencies]
@@ -35,17 +37,12 @@ dev = [
     "pyyaml>=6.0.3",
     "jsonschema>=4.26.0",
     "pytest-cov>=7.1.0",
-    "mypy>=2.3.0",
-    "types-PyYAML>=6.0.12",
 ]
-yaml = ["pyyaml>=6.0"]
-all = ["pyyaml>=6.0"]
 
 [project.scripts]
+# Same idea as packages/npm/agent-toolkit-cli/bin/agent-toolkit.js — exec the V binary.
 agent-toolkit = "agent_toolkit.launcher:main"
 agent-toolkit-cli = "agent_toolkit.launcher:main"
-# Quarantined fallback (insights/release + pytest). Not the product. docs/v/python-fallback.md
-agent-toolkit-py = "agent_toolkit.cli.main:main"
 
 [project.urls]
 Homepage = "https://github.com/ulises-jeremias/agent-toolkit"
@@ -65,8 +62,7 @@ packages = ["src/agent_toolkit"]
 path = "hatch_build.py"
 
 # Capability trees are copied into src/agent_toolkit/data/ by
-# scripts/prepare-package-data.sh before sdist/wheel builds. Editable
-# installs resolve monorepo root via agent_toolkit._paths (no packed data).
+# scripts/prepare-package-data.sh before sdist/wheel builds.
 [tool.hatch.build.targets.sdist]
 include = [
     "src/",
@@ -82,26 +78,20 @@ include = [
 branch = true
 source = ["agent_toolkit"]
 relative_files = true
-omit = ["*/tests/*", "*/__pycache__/*", "*/site-packages/*"]
+omit = ["*/tests/*", "*/__pycache__/*", "*/site-packages/*", "*/data/*"]
 
 [tool.coverage.report]
 precision = 1
 show_missing = true
-# Scoped gate (#271): compiler + installer + cli/install.py only.
 fail_under = 70
 include = [
-    "*/agent_toolkit/compiler/*",
-    "*/agent_toolkit/installer/*",
-    "*/agent_toolkit/cli/install.py",
+    "*/agent_toolkit/launcher.py",
 ]
 skip_covered = false
 
-[tool.mypy]
-python_version = "3.10"
-# Incremental typing (#275): narrow, warn-only in CI.
-follow_imports = "skip"
-ignore_missing_imports = true
-warn_unused_ignores = true
-warn_redundant_casts = true
-warn_unused_configs = true
-strict_optional = true
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

{agent_toolkit_cli-1.12.2 → agent_toolkit_cli-1.14.0}/src/agent_toolkit/__init__.py

@@ -1,4 +1,4 @@
 """agent-toolkit: Composable AI agent capabilities for all major AI coding tools."""
 
-__version__ = "1.12.2"
+__version__ = "1.14.0"
 __author__ = "ulises-jeremias"

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/changelog-drafter/README.md

@@ -0,0 +1,19 @@
+# changelog-drafter
+
+Drafts release notes in [Keep a Changelog](https://keepachangelog.com/) format by collecting all pull requests merged since the last git tag.
+
+## When to Use
+Use this loop to automate draft release notes creation for review before tagging or publishing a release.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run changelog-drafter
+```
+
+## Details
+* **Artifact Output:** Draft changelog is written to `loops/changelog-drafter/runs/<run_id>/report.md` on each run.
+* **Safety:** This loop is L1 (Observe and Report). It does not commit, tag, or push to the repository.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/ci-sweeper/README.md

@@ -0,0 +1,19 @@
+# ci-sweeper
+
+Monitors failing CI runs on open PRs and the main branch, diagnoses the root cause, and opens a draft PR with a minimal fix if straightforward.
+
+## When to Use
+Use this loop to automatically detect and propose fixes for minor, repetitive CI breakages (such as lockfile issues, syntax bugs, or test environment problems).
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run ci-sweeper
+```
+
+## Details
+* **Artifact Output:** Execution plans are written to `loops/ci-sweeper/runs/<run_id>/plan.md` on each run.
+* **Safety:** This loop is L2 (Controlled Mutations). It only comments or opens draft PRs. It never merges, force-pushes, or deletes branches.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/daily-triage/README.md

@@ -0,0 +1,20 @@
+# daily-triage
+
+Scans open issues created in the last 24 hours to propose priority scores, labels, and brief summaries.
+
+## When to Use
+Use this loop to stay on top of incoming issues on a single repository with a low token budget.
+
+## Execution
+To initialize and run this loop:
+```bash
+agent-toolkit loop init daily-triage
+agent-toolkit loop run daily-triage
+```
+
+## Details
+* **Artifact Output:** Triage proposals are written to `loops/daily-triage/runs/<run_id>/report.md`.
+* **Safety:** This loop is L1 (Observe and Report). It does not write comments or apply labels directly.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/dep-sweeper/README.md

@@ -0,0 +1,20 @@
+# dep-sweeper
+
+Scans for available patch-level updates across ecosystems (npm, pip, cargo, etc.) and opens draft PRs if local tests pass.
+
+## When to Use
+Use this loop to automate mechanical, low-risk dependencies maintenance without manual checking.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run dep-sweeper
+```
+
+## Details
+* **Artifact Output:** Execution plans are written to `loops/dep-sweeper/runs/<run_id>/plan.md`.
+* **SemVer Safety:** Only patch updates are applied. The loop skips updates when the major or minor versions in the version string change.
+* **Safety:** This loop is L2 (Controlled Mutations). It only comments or opens draft PRs. It never merges or force-pushes.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/issue-triage/README.md

@@ -0,0 +1,19 @@
+# issue-triage
+
+Triages unlabeled issues by proposing labels, type classifications, and priority ratings.
+
+## When to Use
+Use this loop to stay organized on repositories with high issue activity.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run issue-triage
+```
+
+## Details
+* **Artifact Output:** Triage proposals are written to `loops/issue-triage/runs/<run_id>/report.md` on each run.
+* **Safety:** This loop is L1 (Observe and Report). It does not apply labels or write comments directly.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/oss-daily-briefing/README.md

@@ -0,0 +1,20 @@
+# oss-daily-briefing
+
+Generates a daily read-only briefing across configured OSS ecosystem repositories, covering new PRs, active issues, and CI health.
+
+## When to Use
+Use this loop to stay updated on multiple open-source repositories from a single report.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run oss-daily-briefing
+```
+
+## Details
+* **Artifact Output:** The daily briefing is written to `loops/oss-daily-briefing/runs/<run_id>/report.md`.
+* **State Checkpointing:** Supports progress checkpointing via `loops/oss-daily-briefing/STATE.md`.
+* **Safety:** This loop is L1 (Observe and Report) and does not perform any mutations on repositories.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/oss-pr-monitor/README.md

@@ -0,0 +1,20 @@
+# oss-pr-monitor
+
+Evaluates open pull requests across all configured OSS repositories. Auto-merges Dependabot PRs with passing CI, closes dirty Dependabot PRs, and reports on human PRs.
+
+## When to Use
+Use this loop to automate Dependabot updates and get quick diagnostics on human-submitted PRs across a multi-repo ecosystem.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run oss-pr-monitor
+```
+
+## Details
+* **Artifact Output:** Triage details are written to `loops/oss-pr-monitor/runs/<run_id>/report.md` on each run.
+* **State Checkpointing:** Supports progress checkpointing via `loops/oss-pr-monitor/STATE.md`.
+* **Safety:** This loop is L3 (High Autonomy). It only merges or closes Dependabot PRs under passing CI. It never merges or closes human PRs.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints. For discovery, see `docs/LOOPS.md` and `examples/oss-maintenance/README.md`.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/oss-triage/README.md

@@ -0,0 +1,20 @@
+# oss-triage
+
+Scans open issues across configured OSS repositories. Flags security issues, applies labels, and drafts/posts response comments.
+
+## When to Use
+Use this loop to automate basic triage tasks (like labelling or asking for reproducers) across a multi-repository ecosystem.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run oss-triage
+```
+
+## Details
+* **Artifact Output:** Triaged items are written to `loops/oss-triage/runs/<run_id>/report.md` on each run.
+* **State Checkpointing:** Supports progress checkpointing via `loops/oss-triage/STATE.md`.
+* **Safety:** This loop is L1 (Observe and Report). The runner hard-gates all L1 loops as report-only, blocking mutations regardless of allowlist declarations.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/post-merge-cleanup/README.md

@@ -0,0 +1,19 @@
+# post-merge-cleanup
+
+Performs off-peak housekeeping tasks on the repository. Scans for merged branches to delete, closes resolved issues, and warns on stale ones.
+
+## When to Use
+Use this loop to keep git history, pull request interfaces, and issue boards clean on an active repository.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run post-merge-cleanup
+```
+
+## Details
+* **Artifact Output:** Cleaned up items are written to `loops/post-merge-cleanup/runs/<run_id>/plan.md` on each run.
+* **Safety:** This loop is L2 (Controlled Mutations). It deletes branches merged more than 7 days ago and closes resolved issues. It never force-pushes or deletes unmerged branches.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

agent_toolkit_cli-1.14.0/src/agent_toolkit/data/loops/pr-babysitter/README.md

@@ -0,0 +1,19 @@
+# pr-babysitter
+
+Monitors open PRs that have received no activity or reviews for over an hour and posts constructive review comments.
+
+## When to Use
+Use this loop to reduce pull request review latency and keep contributors unblocked on active repositories.
+
+## Execution
+To run this loop:
+```bash
+agent-toolkit loop run pr-babysitter
+```
+
+## Details
+* **Artifact Output:** Execution logs are written to `loops/pr-babysitter/runs/<run_id>/plan.md` on each run.
+* **Safety:** This loop is L2 (Controlled Mutations). It only writes review comments. It never merges, force-pushes, or deletes branches.
+* **Configuration:** See [loop.yaml](loop.yaml) for tier, cadence, budget, and safety constraints.
+
+For more details on loops and safety tiers, see [docs/LOOPS.md](../../docs/LOOPS.md).

{agent_toolkit_cli-1.12.2 → agent_toolkit_cli-1.14.0}/src/agent_toolkit/launcher.py

@@ -65,8 +65,8 @@ def missing_binary_message() -> str:
     return (
         "agent-toolkit: native V binary not found (ADR-021).\n"
         "  Packaged wheels bundle the binary under agent_toolkit/bin/.\n"
-        "  Dev: make build-cli, or set AGENT_TOOLKIT_BIN to that executable.\n"
-        "  Quarantined Python fallback: agent-toolkit-py\n"
+        "  Dev: ./make.vsh build-cli, or set AGENT_TOOLKIT_BIN to that executable.\n"
+        "  Other channels: GitHub Release, Homebrew, AUR agent-toolkit-bin, npm.\n"
     )
 
 

agent_toolkit_cli-1.12.2/src/agent_toolkit/_paths.py

@@ -1,145 +0,0 @@
-"""Shared toolkit path resolution — works in both editable and wheel installs."""
-
-from __future__ import annotations
-
-import os
-from pathlib import Path
-
-
-def _offline_mode() -> bool:
-    return os.environ.get("AGENT_TOOLKIT_OFFLINE", "").strip().lower() in ("1", "true", "yes")
-
-
-def _bundled_data_paths() -> list[Path]:
-    paths: list[Path] = []
-    try:
-        import importlib.resources as _ir
-
-        paths.append(Path(str(_ir.files("agent_toolkit").joinpath("data"))))
-    except (ImportError, TypeError, ModuleNotFoundError, FileNotFoundError):
-        pass
-
-    pkg_dir = Path(__file__).resolve().parent
-    paths.append(pkg_dir / "data")
-    return paths
-
-
-def _is_data_root(path: Path) -> bool:
-    return path.is_dir() and (path / "profiles").is_dir()
-
-
-def find_toolkit_root(*, offline: bool | None = None) -> Path:
-    """
-    Locate the agent-toolkit root directory (where skills/, loops/, profiles/ live).
-
-    Resolution order:
-    1. AGENT_TOOLKIT_ROOT / AI_WORKSPACE env var (user override)
-    2. importlib.resources / package data (wheel install)
-    3. XDG cache (~/.local/share/agent-toolkit/data) or first-run GitHub download
-    4. Walk up from module file (editable install)
-    5. CWD fallback
-
-    Raises EnvironmentError if no root can be found with required subdirs.
-    """
-    offline = _offline_mode() if offline is None else offline
-
-    for env in ("AGENT_TOOLKIT_ROOT", "AI_WORKSPACE"):
-        val = os.environ.get(env, "").strip()
-        if val:
-            p = Path(val)
-            if (p / "skills").is_dir() or (p / "loops").is_dir() or _is_data_root(p):
-                return p
-
-    for data_path in _bundled_data_paths():
-        if _is_data_root(data_path):
-            return data_path
-
-    # 2b. XDG cache (GitHub Release download on first run — see data_cache.py)
-    if os.environ.get("AGENT_TOOLKIT_OFFLINE", "").strip() not in ("1", "true", "yes"):
-        try:
-            from agent_toolkit.data_cache import ensure_cached_data
-
-            cached = ensure_cached_data(offline=False)
-            if cached and (cached / "profiles").is_dir():
-                return cached
-        except Exception:
-            pass
-    else:
-        cache_home = Path(os.environ.get("XDG_CACHE_HOME", str(Path.home() / ".cache")))
-        cached_data = cache_home / "agent-toolkit"
-        if (cached_data / "profiles").is_dir():
-            return cached_data
-
-    # 2c. Direct path relative to the package (uvx / pip installs)
-    pkg_dir = Path(__file__).resolve().parent  # .../site-packages/agent_toolkit/
-    data_dir = pkg_dir / "data"
-    if data_dir.is_dir() and (data_dir / "profiles").is_dir():
-        return data_dir
-
-    here = Path(__file__).resolve()
-    for parent in here.parents:
-        if (parent / "skills").is_dir() and (parent / "loops").is_dir():
-            return parent
-
-    cwd = Path.cwd()
-    if (cwd / "skills").is_dir() or (cwd / "loops").is_dir():
-        return cwd
-
-    hint = (
-        "Set AGENT_TOOLKIT_ROOT to your agent-toolkit checkout, "
-        "or run without --offline to download data on first use."
-    )
-    if offline:
-        hint = (
-            "Offline mode: bundled/cache data missing. "
-            "Install the full wheel or populate ~/.local/share/agent-toolkit/data."
-        )
-    raise EnvironmentError(f"Cannot locate agent-toolkit data directory.\n{hint}")
-
-
-_root: Path | None = None
-
-
-def reset_toolkit_root() -> None:
-    """Clear cached toolkit root (e.g. after toggling offline mode)."""
-    global _root
-    _root = None
-
-
-def toolkit_root(*, offline: bool | None = None) -> Path:
-    """Cached toolkit root."""
-    global _root
-    if _root is None or offline is not None:
-        resolved = find_toolkit_root(offline=offline)
-        if offline is None:
-            _root = resolved
-        return resolved
-    return _root
-
-
-def find_workspace_root(*, override: str | None = None) -> Path | None:
-    """Locate the user harness / AI workspace root (not toolkit package data).
-
-    Resolution order (#207):
-    1. Explicit override (CLI ``--workspace``)
-    2. ``AGENT_TOOLKIT_WORKSPACE``
-    3. ``HARNESS_DIR`` (agentic-harness compatibility)
-    4. Walk up from CWD for ``AGENTS.md`` or ``knowledge/``
-    """
-    if override:
-        p = Path(override).expanduser().resolve()
-        return p if p.is_dir() else None
-
-    for env in ("AGENT_TOOLKIT_WORKSPACE", "HARNESS_DIR"):
-        val = os.environ.get(env, "").strip()
-        if val:
-            p = Path(val).expanduser().resolve()
-            if p.is_dir():
-                return p
-
-    current = Path.cwd()
-    for candidate in [current, *current.parents]:
-        if (candidate / "AGENTS.md").exists() or (candidate / "knowledge").is_dir():
-            return candidate
-
-    return None

agent_toolkit_cli-1.12.2/src/agent_toolkit/cli/README.md

@@ -1,10 +0,0 @@
-# Quarantined Python CLI (`agent-toolkit-py`)
-
-This package tree is **not** the product CLI.
-
-- Product: native V binary via `agent_toolkit.launcher` (`agent-toolkit` / `agent-toolkit-cli`).
-- This directory: Python business logic behind the `agent-toolkit-py` console script.
-
-Kept for pytest parity and for [#560](https://github.com/ulises-jeremias/agent-toolkit/issues/560) DEPRECATE/REMOVE commands (`insights`, `release`). Do not add new product features here.
-
-Canonical note: `docs/v/python-fallback.md` in the monorepo.

agent_toolkit_cli-1.12.2/src/agent_toolkit/cli/__main__.py

@@ -1,5 +0,0 @@
-"""Quarantined Python CLI — python -m agent_toolkit.cli (docs/v/python-fallback.md)."""
-
-from agent_toolkit.cli.main import main
-
-main()