mvge 0.1.1__tar.gz

mvge-0.1.1/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: mvge
+Version: 0.1.1
+Summary: mvge — a Python-based AI coding agent
+License-Expression: MIT
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: packaging>=24.0
+Requires-Dist: portalocker>=3.0.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.2.2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.27.1
+Requires-Dist: watchdog>=6.0.0
+Requires-Python: >=3.13
+Project-URL: Repository, https://github.com/IAmNo1Special/mvge

mvge-0.1.1/pyproject.toml

@@ -0,0 +1,112 @@
+[project]
+name = "mvge"
+version = "0.1.1"
+description = "mvge — a Python-based AI coding agent"
+requires-python = ">=3.13"
+license = "MIT"
+dependencies = [
+    "click>=8.0",
+    "httpx>=0.28.1",
+    "packaging>=24.0",
+    "portalocker>=3.0.0",
+    "prompt-toolkit>=3.0",
+    "pydantic>=2.0",
+    "python-dotenv>=1.2.2",
+    "pyyaml>=6.0",
+    "rich>=13.0",
+    "typer>=0.27.1",
+    "watchdog>=6.0.0",
+]
+
+[project.scripts]
+mvge = "mvge.cli.main:main"
+
+[project.urls]
+Repository = "https://github.com/IAmNo1Special/mvge"
+
+[build-system]
+requires = ["uv_build>=0.11.2,<0.14"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "git-cliff>=2.13.1",
+    "mypy>=2.3.1",
+    "pre-commit>=4.6.2",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.16.2",
+    "types-pyyaml>=6.0.12.20260815",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py313"
+exclude = ["prototypes"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "SIM",
+    "C4",
+    "PT",
+    "T20",
+    "RSE",
+    "PGH",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "T20",
+    "PT001",
+]
+"*/__init__.py" = [
+    "E402",
+    "F401",
+]
+"scripts/**" = ["T20"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+warn_unreachable = true
+exclude = [
+    "(^|/)(tests|scripts|prototypes)/",
+    'test_keys\.py',
+    "benchmarks",
+]
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+    "scripts/tests",
+]
+pythonpath = [
+    ".",
+    "src",
+    "scripts",
+    "tests/unit/provider",
+]
+python_files = "*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+consider_namespace_packages = false
+addopts = "--import-mode=importlib -W ignore::RuntimeWarning"
+
+[tool.coverage.run]
+branch = true
+source = ["mvge"]
+omit = [
+    "src/mvge/__main__.py",
+    "src/mvge/cli/__main__.py",
+]
+
+[tool.coverage.report]
+fail_under = 90

mvge-0.1.1/pyproject.toml.orig

@@ -0,0 +1,101 @@
+[project]
+name = "mvge"
+version = "0.1.1"
+description = "mvge — a Python-based AI coding agent"
+requires-python = ">=3.13"
+license = "MIT"
+dependencies = [
+    "click>=8.0",
+    "httpx>=0.28.1",
+    "packaging>=24.0",
+    "portalocker>=3.0.0",
+    "prompt-toolkit>=3.0",
+    "pydantic>=2.0",
+    "python-dotenv>=1.2.2",
+    "pyyaml>=6.0",
+    "rich>=13.0",
+    "typer>=0.27.1",
+    "watchdog>=6.0.0",
+]
+
+[project.scripts]
+mvge = "mvge.cli.main:main"
+
+[build-system]
+requires = ["uv_build>=0.11.2,<0.14"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "git-cliff>=2.13.1",
+    "mypy>=2.3.1",
+    "pre-commit>=4.6.2",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.16.2",
+    "types-pyyaml>=6.0.12.20260815",
+]
+
+[project.urls]
+Repository = "https://github.com/IAmNo1Special/mvge"
+
+[tool.ruff]
+line-length = 88
+target-version = "py313"
+exclude = ["prototypes"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "SIM",
+    "C4",
+    "PT",
+    "T20",
+    "RSE",
+    "PGH",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["T20", "PT001"]
+"*/__init__.py" = ["E402", "F401"]
+# Release tooling reports to a terminal; printing is its interface, not a slip.
+# mypy already excludes /scripts/ for the same reason.
+"scripts/**" = ["T20"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+warn_unreachable = true
+exclude = ["(^|/)(tests|scripts|prototypes)/", "test_keys\\.py", "benchmarks"]
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+    "scripts/tests",
+]
+pythonpath = [".", "src", "scripts", "tests/unit/provider"]
+python_files = "*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+consider_namespace_packages = false
+addopts = "--import-mode=importlib -W ignore::RuntimeWarning"
+
+[tool.coverage.run]
+branch = true
+source = [
+    "mvge",
+]
+omit = [
+    "src/mvge/__main__.py",
+    "src/mvge/cli/__main__.py",
+]
+
+[tool.coverage.report]
+fail_under = 90

mvge-0.1.1/src/mvge/__init__.py

@@ -0,0 +1,7 @@
+"""The `mvge` package -- an operating system for AI agents."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]

mvge-0.1.1/src/mvge/__main__.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from mvge.cli.main import main
+
+if __name__ == "__main__":
+    main()

mvge-0.1.1/src/mvge/agent/__init__.py

@@ -0,0 +1,100 @@
+from mvge.agent.agent_session import MvgeTome
+from mvge.agent.auth import load_api_key_from_auth, save_api_key_to_auth
+from mvge.agent.commands import (
+    SLASH_COMMANDS,
+    CommandAction,
+    CommandDispatcher,
+    CommandOutcome,
+)
+from mvge.agent.environment import (
+    AgentConfig,
+    MvgeEnvironment,
+    PromptSource,
+    ResolvedPrompt,
+)
+from mvge.agent.function_spell import (
+    FunctionSpell,
+    PEP723Metadata,
+    PEP723ScriptSpell,
+    RuneSpellWrapper,
+    SpellUnion,
+    coerce_spell,
+    discover_spells_from_dir,
+    parse_pep723_metadata,
+)
+from mvge.agent.harness import MvgeHarness
+from mvge.agent.installer import (
+    DEFAULT_PROFILES,
+    ProfileInstallResult,
+    fetch_marketplace_mvges,
+    fetch_marketplace_profiles,
+    install_mvge,
+    install_profile,
+    list_installed_mvges,
+    uninstall_mvge,
+)
+from mvge.agent.mvge import Mvge
+from mvge.agent.protocol import AgentFactory, MvgeAgent, ReloadResult
+from mvge.agent.snapshot import (
+    RuntimeSnapshot,
+    SnapshotConfigEntry,
+    SnapshotDiagnostic,
+    SnapshotPrompt,
+    SnapshotRune,
+    SnapshotSkill,
+    SnapshotSpell,
+    SpellSource,
+)
+from mvge.agent.sub_mvge import (
+    SubMvgeManager,
+    SubMvgeRecord,
+    SubMvgeSpec,
+    SubMvgeState,
+)
+
+__all__ = [
+    "AgentConfig",
+    "AgentFactory",
+    "CommandAction",
+    "CommandDispatcher",
+    "CommandOutcome",
+    "DEFAULT_PROFILES",
+    "FunctionSpell",
+    "Mvge",
+    "MvgeAgent",
+    "MvgeEnvironment",
+    "MvgeHarness",
+    "MvgeTome",
+    "PEP723Metadata",
+    "PEP723ScriptSpell",
+    "ProfileInstallResult",
+    "PromptSource",
+    "ResolvedPrompt",
+    "ReloadResult",
+    "RuneSpellWrapper",
+    "RuntimeSnapshot",
+    "SLASH_COMMANDS",
+    "SnapshotConfigEntry",
+    "SnapshotDiagnostic",
+    "SnapshotPrompt",
+    "SnapshotRune",
+    "SnapshotSkill",
+    "SnapshotSpell",
+    "SpellSource",
+    "SpellUnion",
+    "SubMvgeManager",
+    "SubMvgeRecord",
+    "SubMvgeSpec",
+    "SubMvgeState",
+    "coerce_spell",
+    "discover_spells_from_dir",
+    "fetch_marketplace_mvges",
+    "fetch_marketplace_profiles",
+    "install_mvge",
+    "install_profile",
+    "list_installed_mvges",
+    "load_api_key_from_auth",
+    "parse_pep723_metadata",
+    "save_api_key_to_auth",
+    "uninstall_mvge",
+]

mvge-0.1.1/src/mvge/agent/agent_name.py

@@ -0,0 +1,152 @@
+"""Which Mvge an invocation runs.
+
+Every question about an agent name is answered here, because a second
+answerer is how the engine came to carry a marketplace artifact's slug:
+two call sites, two different rules, the same hardcoded name, and a
+second precedence pass that ADR-0014 was written to end.
+
+The engine discovers what is installed and never names one. That is what
+lets the marketplace change its catalog, rename an artifact, or ship a
+second Mvge without a release here.
+
+The Summoner's own naming always wins. Discovery only speaks when they
+said nothing actionable and there is nothing to guess wrong.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+from mvge.core.constants import DEFAULT_AGENT_NAME
+from mvge.core.layers import agents_dir
+
+AGENT_NAME_PATTERN = re.compile(r"^[a-zA-Z0-9_-]+$")
+
+#: The one name the engine answers for without looking at the disk. It names
+#: the engine's own fallback agent, not an artifact anyone ships, so it is a
+#: constant rather than a discovery result.
+ENGINE_DEFAULT_AGENT = DEFAULT_AGENT_NAME
+
+
+def installed_agent_names(*, agent_config_base: Path | None = None) -> list[str]:
+    """Agent names with an agent-scope directory, sorted.
+
+    The agent scope is ``<global>/agents/<name>/``. Only directories count:
+    a file at that depth is not an agent, and `sys.path` receives the agent
+    root, so a stray file here is a latent import collision rather than a Mvge.
+    """
+    base = agent_config_base if agent_config_base is not None else agents_dir()
+    if not base.is_dir():
+        return []
+    return sorted(child.name for child in base.iterdir() if child.is_dir())
+
+
+def is_known_agent(
+    agent_name: str,
+    *,
+    agent_config_base: Path | None = None,
+    project_dir: Path | None = None,
+) -> bool:
+    """Whether an agent name is valid and usable.
+
+    An agent is known when the name is syntactically right *and* something
+    backs it: the engine's own default, an agent-scope directory, or a
+    project-scope one. A syntactically valid name with nothing behind it is
+    a typo, and saying so is the point.
+    """
+    if not isinstance(agent_name, str) or not AGENT_NAME_PATTERN.match(agent_name):
+        return False
+
+    if agent_name == DEFAULT_AGENT_NAME:
+        return True
+
+    base = (
+        agent_config_base.expanduser()
+        if agent_config_base is not None
+        else agents_dir()
+    )
+    if (base / agent_name).is_dir():
+        return True
+
+    proj_dir = project_dir or Path.cwd()
+    return (proj_dir / ".agents" / "agents" / agent_name).is_dir()
+
+
+def validate_agent_name(
+    agent_name: str,
+    *,
+    agent_config_base: Path | None = None,
+    project_dir: Path | None = None,
+    allow_create: bool = False,
+) -> None:
+    """Validate that an agent name exists and is syntactically valid.
+
+    Raises ValueError with an actionable message if invalid or unknown.
+    """
+    if not isinstance(agent_name, str) or not AGENT_NAME_PATTERN.match(agent_name):
+        raise ValueError(
+            f"Invalid agent name '{agent_name}'. Agent names must contain "
+            "only alphanumeric characters, dashes, and underscores."
+        )
+
+    if allow_create:
+        return
+
+    if is_known_agent(
+        agent_name, agent_config_base=agent_config_base, project_dir=project_dir
+    ):
+        return
+
+    base = (
+        agent_config_base.expanduser()
+        if agent_config_base is not None
+        else agents_dir()
+    )
+    agent_dir = base / agent_name
+    raise ValueError(
+        f"Unknown agent '{agent_name}'. Agent configuration or directory "
+        f"does not exist at '{agent_dir}'. Configure it with "
+        f"'mvge config set --agent-name {agent_name} <key> <value>'."
+    )
+
+
+def resolve_active_agent_name(
+    requested: str = DEFAULT_AGENT_NAME,
+    *,
+    agent_config_base: Path | None = None,
+) -> str:
+    """The Mvge an invocation runs, given what the Summoner asked for.
+
+    Three rules, in order. Each is a reason not to guess.
+
+    1. **What they asked for, when it is backed.** A name with an agent-scope
+       directory is that Mvge, spelled their way.
+    2. **What is installed, when they named nothing.** ``DEFAULT_AGENT_NAME``
+       means the Summoner asked for no particular Mvge. With exactly one
+       agent in the agent scope, adopt it: one candidate means there is
+       nothing to guess wrong, and it is how a first run works with an
+       installed Mvge and no flag.
+    3. **Their name, unchanged.** Any name other than the default was a
+       request, so it survives even when nothing backs it -- an unknown name
+       then surfaces where it is actionable instead of being silently swapped
+       for another. Two or more installed agents is the same case: a real
+       choice, and an engine that picks for you here is the second precedence
+       pass this module exists to end.
+    """
+    if not isinstance(requested, str) or not AGENT_NAME_PATTERN.match(requested):
+        raise ValueError(
+            f"Invalid agent name '{requested}'. Agent names must contain "
+            "only alphanumeric characters, dashes, and underscores."
+        )
+
+    base = agent_config_base if agent_config_base is not None else agents_dir()
+    if (base / requested).is_dir():
+        return requested
+
+    if requested == DEFAULT_AGENT_NAME:
+        candidates = installed_agent_names(agent_config_base=agent_config_base)
+        if len(candidates) == 1:
+            return candidates[0]
+
+    return requested