imbue-mngr-opencode 0.2.0__py3-none-any.whl

imbue/mngr_opencode/plugin.py

@@ -0,0 +1,55 @@
+from pydantic import Field
+
+from imbue.mngr import hookimpl
+from imbue.mngr.config.data_types import AgentTypeConfig
+from imbue.mngr.errors import ConfigParseError
+from imbue.mngr.interfaces.agent import AgentInterface
+from imbue.mngr.primitives import CommandString
+
+
+class OpenCodeAgentConfig(AgentTypeConfig):
+    """Config for the opencode agent type."""
+
+    command: CommandString = Field(
+        default=CommandString("opencode"),
+        description="Command to run opencode agent",
+    )
+
+    def merge_with(self, override: AgentTypeConfig) -> AgentTypeConfig:
+        """
+        Merge this config with an override config.
+
+        Important note: despite the type signatures, any of these fields may be None in the override--this means that they were NOT set in the toml (and thus should be ignored)
+        """
+        if not isinstance(override, OpenCodeAgentConfig):
+            raise ConfigParseError("Cannot merge OpenCodeAgentConfig with different agent config type")
+
+        # Merge parent_type (scalar - override wins if not None)
+        merged_parent_type = override.parent_type if override.parent_type is not None else self.parent_type
+
+        # Merge command (scalar - override wins if not None)
+        merged_command = self.command
+        if hasattr(override, "command") and override.command is not None:
+            merged_command = override.command
+
+        # Merge cli_args (concatenate both tuples)
+        merged_cli_args = self.cli_args + override.cli_args if override.cli_args else self.cli_args
+
+        # Merge permissions (list - concatenate if override is not None)
+        merged_permissions = self.permissions
+        if override.permissions is not None:
+            merged_permissions = list(self.permissions) + list(override.permissions)
+
+        return self.__class__(
+            parent_type=merged_parent_type,
+            cli_args=merged_cli_args,
+            command=merged_command,
+            permissions=merged_permissions,
+        )
+
+
+# Module-level hook implementation for pluggy entry point discovery
+@hookimpl
+def register_agent_type() -> tuple[str, type[AgentInterface] | None, type[AgentTypeConfig]]:
+    """Register the opencode agent type."""
+    return ("opencode", None, OpenCodeAgentConfig)

imbue/mngr_opencode/plugin_test.py

@@ -0,0 +1,25 @@
+"""Unit tests for OpenCodeAgentConfig."""
+
+from imbue.mngr_opencode.plugin import OpenCodeAgentConfig
+
+
+def test_opencode_agent_config_has_correct_defaults() -> None:
+    """Verify that OpenCodeAgentConfig has the expected default values."""
+    config = OpenCodeAgentConfig()
+
+    assert str(config.command) == "opencode"
+    assert config.cli_args == ()
+    assert config.permissions == []
+    assert config.parent_type is None
+
+
+def test_opencode_agent_config_merge_with_override() -> None:
+    """Verify that merge_with works correctly for OpenCodeAgentConfig."""
+    base = OpenCodeAgentConfig()
+    override = OpenCodeAgentConfig(cli_args=("--verbose",))
+
+    merged = base.merge_with(override)
+
+    assert isinstance(merged, OpenCodeAgentConfig)
+    assert merged.cli_args == ("--verbose",)
+    assert str(merged.command) == "opencode"

imbue/mngr_opencode/test_ratchets.py

@@ -0,0 +1,255 @@
+from pathlib import Path
+
+import pytest
+from inline_snapshot import snapshot
+
+from imbue.imbue_common.ratchet_testing import standard_ratchet_checks as rc
+from imbue.imbue_common.ratchet_testing.ratchets import check_no_ruff_errors
+from imbue.imbue_common.ratchet_testing.ratchets import check_no_type_errors
+
+_DIR = Path(__file__).parent.parent.parent
+
+pytestmark = pytest.mark.xdist_group(name="ratchets")
+
+
+# --- Code safety ---
+
+
+def test_prevent_todos() -> None:
+    rc.check_todos(_DIR, snapshot(0))
+
+
+def test_prevent_exec_usage() -> None:
+    rc.check_exec(_DIR, snapshot(0))
+
+
+def test_prevent_eval_usage() -> None:
+    rc.check_eval(_DIR, snapshot(0))
+
+
+def test_prevent_while_true() -> None:
+    rc.check_while_true(_DIR, snapshot(0))
+
+
+def test_prevent_time_sleep() -> None:
+    rc.check_time_sleep(_DIR, snapshot(0))
+
+
+def test_prevent_global_keyword() -> None:
+    rc.check_global_keyword(_DIR, snapshot(0))
+
+
+def test_prevent_bare_print() -> None:
+    rc.check_bare_print(_DIR, snapshot(0))
+
+
+# --- Exception handling ---
+
+
+def test_prevent_bare_except() -> None:
+    rc.check_bare_except(_DIR, snapshot(0))
+
+
+def test_prevent_broad_exception_catch() -> None:
+    rc.check_broad_exception_catch(_DIR, snapshot(0))
+
+
+def test_prevent_base_exception_catch() -> None:
+    rc.check_base_exception_catch(_DIR, snapshot(0))
+
+
+def test_prevent_builtin_exception_raises() -> None:
+    rc.check_builtin_exception_raises(_DIR, snapshot(0))
+
+
+# --- Import style ---
+
+
+def test_prevent_inline_imports() -> None:
+    rc.check_inline_imports(_DIR, snapshot(0))
+
+
+def test_prevent_relative_imports() -> None:
+    rc.check_relative_imports(_DIR, snapshot(0))
+
+
+def test_prevent_import_datetime() -> None:
+    rc.check_import_datetime(_DIR, snapshot(0))
+
+
+def test_prevent_importlib_import_module() -> None:
+    rc.check_importlib_import_module(_DIR, snapshot(0))
+
+
+def test_prevent_getattr() -> None:
+    rc.check_getattr(_DIR, snapshot(0))
+
+
+def test_prevent_setattr() -> None:
+    rc.check_setattr(_DIR, snapshot(0))
+
+
+# --- Banned libraries and patterns ---
+
+
+def test_prevent_asyncio_import() -> None:
+    rc.check_asyncio_import(_DIR, snapshot(0))
+
+
+def test_prevent_pandas_import() -> None:
+    rc.check_pandas_import(_DIR, snapshot(0))
+
+
+def test_prevent_dataclasses_import() -> None:
+    rc.check_dataclasses_import(_DIR, snapshot(0))
+
+
+def test_prevent_namedtuple_usage() -> None:
+    rc.check_namedtuple(_DIR, snapshot(0))
+
+
+def test_prevent_yaml_usage() -> None:
+    rc.check_yaml_usage(_DIR, snapshot(0))
+
+
+def test_prevent_functools_partial() -> None:
+    rc.check_functools_partial(_DIR, snapshot(0))
+
+
+# --- Naming conventions ---
+
+
+def test_prevent_num_prefix() -> None:
+    rc.check_num_prefix(_DIR, snapshot(0))
+
+
+# --- Documentation ---
+
+
+def test_prevent_trailing_comments() -> None:
+    rc.check_trailing_comments(_DIR, snapshot(0))
+
+
+def test_prevent_init_docstrings() -> None:
+    rc.check_init_docstrings(_DIR, snapshot(0))
+
+
+@pytest.mark.timeout(10)
+def test_prevent_args_in_docstrings() -> None:
+    rc.check_args_in_docstrings(_DIR, snapshot(0))
+
+
+@pytest.mark.timeout(10)
+def test_prevent_returns_in_docstrings() -> None:
+    rc.check_returns_in_docstrings(_DIR, snapshot(0))
+
+
+# --- Type safety ---
+
+
+def test_prevent_literal_with_multiple_options() -> None:
+    rc.check_literal_with_multiple_options(_DIR, snapshot(0))
+
+
+def test_prevent_bare_generic_types() -> None:
+    rc.check_bare_generic_types(_DIR, snapshot(0))
+
+
+def test_prevent_typing_builtin_imports() -> None:
+    rc.check_typing_builtin_imports(_DIR, snapshot(0))
+
+
+def test_prevent_short_uuid_ids() -> None:
+    rc.check_short_uuid_ids(_DIR, snapshot(0))
+
+
+# --- Pydantic / models ---
+
+
+def test_prevent_model_copy() -> None:
+    rc.check_model_copy(_DIR, snapshot(0))
+
+
+# --- Logging ---
+
+
+def test_prevent_fstring_logging() -> None:
+    rc.check_fstring_logging(_DIR, snapshot(0))
+
+
+def test_prevent_click_echo() -> None:
+    rc.check_click_echo(_DIR, snapshot(0))
+
+
+# --- Testing conventions ---
+
+
+def test_prevent_unittest_mock_imports() -> None:
+    rc.check_unittest_mock_imports(_DIR, snapshot(0))
+
+
+def test_prevent_monkeypatch_setattr() -> None:
+    rc.check_monkeypatch_setattr(_DIR, snapshot(0))
+
+
+def test_prevent_test_container_classes() -> None:
+    rc.check_test_container_classes(_DIR, snapshot(0))
+
+
+def test_prevent_pytest_mark_integration() -> None:
+    rc.check_pytest_mark_integration(_DIR, snapshot(0))
+
+
+# --- Process management ---
+
+
+def test_prevent_os_fork() -> None:
+    rc.check_os_fork(_DIR, snapshot(0))
+
+
+def test_prevent_direct_subprocess_usage() -> None:
+    rc.check_direct_subprocess(_DIR, snapshot(0))
+
+
+# --- AST-based ratchets ---
+
+
+def test_prevent_if_elif_without_else() -> None:
+    rc.check_if_elif_without_else(_DIR, snapshot(0))
+
+
+def test_prevent_inline_functions_in_non_test_code() -> None:
+    rc.check_inline_functions(_DIR, snapshot(0))
+
+
+def test_prevent_importing_underscore_prefixed_names_in_non_test_code() -> None:
+    rc.check_underscore_imports(_DIR, snapshot(0))
+
+
+def test_prevent_init_methods_in_non_exception_classes() -> None:
+    rc.check_init_methods_in_non_exception_classes(_DIR, snapshot(0))
+
+
+def test_prevent_cast_usage() -> None:
+    rc.check_cast_usage(_DIR, snapshot(0))
+
+
+def test_prevent_assert_isinstance_usage() -> None:
+    rc.check_assert_isinstance(_DIR, snapshot(0))
+
+
+# --- Project-level checks ---
+
+
+def test_prevent_code_in_init_files() -> None:
+    rc.check_code_in_init_files(_DIR, snapshot(0))
+
+
+def test_no_type_errors() -> None:
+    """Ensure the codebase has zero type errors."""
+    check_no_type_errors(_DIR)
+
+
+def test_no_ruff_errors() -> None:
+    """Ensure the codebase has zero ruff linting errors."""
+    check_no_ruff_errors(_DIR)

imbue_mngr_opencode-0.2.0.dist-info/METADATA

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: imbue-mngr-opencode
+Version: 0.2.0
+Summary: OpenCode agent type plugin for mngr
+Requires-Python: >=3.11
+Requires-Dist: imbue-mngr==0.2.0
+Description-Content-Type: text/markdown
+
+# imbue-mngr-opencode
+
+Plugin that registers the `opencode` agent type for mngr.
+
+[OpenCode](https://github.com/sst/opencode) is an open-source terminal-based AI coding assistant. This plugin lets you run it as an mngr agent.
+
+## Usage
+
+```bash
+mngr create my-agent opencode
+```
+
+Pass arguments to the opencode command with `--`:
+
+```bash
+mngr create my-agent opencode -- --help
+```
+
+## Configuration
+
+Define a custom variant in your mngr config (`mngr config edit`):
+
+```toml
+[agent_types.my_opencode]
+parent_type = "opencode"
+cli_args = "--some-flag"
+```
+
+Then create agents with your custom type:
+
+```bash
+mngr create my-agent my_opencode
+```
+
+See the [mngr agent types documentation](https://github.com/imbue-ai/mngr/blob/main/libs/mngr/docs/concepts/agent_types.md) for more details.

imbue_mngr_opencode-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+imbue/mngr_opencode/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+imbue/mngr_opencode/plugin.py,sha256=VmBbGpvwXmNxPU2uwz7LJsIRtxjXomHwslkNrrCFTKY,2254
+imbue/mngr_opencode/plugin_test.py,sha256=dfqHUGalXfbKT9RFG7zbPiMhRutVe_103RBNrmCjRQ8,843
+imbue/mngr_opencode/test_ratchets.py,sha256=fpHczdLMBHvmko6Dh_k7E0vhfc2efPBJngSyDD8NMU8,5721
+imbue_mngr_opencode-0.2.0.dist-info/METADATA,sha256=zyh-CpzAFgE3XEGeh24d9OoLynVnPfKYIwALTvJ2Sp0,995
+imbue_mngr_opencode-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+imbue_mngr_opencode-0.2.0.dist-info/entry_points.txt,sha256=78f6wk2fdFHHJ8ltL94prcLHHU7NfIb7vXrTLLsQLs8,45
+imbue_mngr_opencode-0.2.0.dist-info/RECORD,,

imbue_mngr_opencode-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

imbue_mngr_opencode-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[mngr]
+opencode = imbue.mngr_opencode.plugin