imbue-mngr-opencode 0.2.0__tar.gz

imbue_mngr_opencode-0.2.0/.gitignore

@@ -0,0 +1,274 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+.venv-*
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# task folders for local custom claude workflow
+*/*/_tasks/
+.sesskey
+
+# Node.js
+node_modules/
+
+# Frontend build artifacts
+frontend-dist/
+
+# Claude Code local settings (session-specific permissions)
+.claude/settings.local.json
+
+# PR status and URL files written by main_claude_stop_hook.sh for status line display
+.claude/pr_url
+.claude/pr_status
+
+# Local Claude settings backup files
+.claude/*.bak
+
+# Local mngr settings (not committed)
+.mngr/settings.local.toml
+
+# so the user can make their own notification script
+scripts/notify_user.local.sh
+
+# Test output files (slow tests, coverage summaries)
+.test_output/
+
+# TMR output directories (reports + test outputs)
+tmr_*/
+
+# Active session marker file (used to detect interrupted sessions)
+.claude/active
+
+# we stick the image build artifacts here
+.mngr/dev/build/
+.mngr/dev/secrets/
+
+# Offload caches and local files
+.offload/**
+test-results
+current.tar.gz
+
+# Minds deploy-time build artifacts
+.minds/
+
+# Autofix session artifacts
+.autofix/
+.reviewer/outputs/
+.reviewer/settings.local.json
+**/.reviewer/.stop_hook_consecutive_blocks
+.reviews/
+
+# Stuck agent tracking (stop hook escape valve)
+.claude/blocked_stop_commits
+
+# Demo recordings (asciinema .cast, .txt, and scripts)
+.demos/
+
+# for git worktrees from other repos
+.external_worktrees/
+
+# ignore coverage files generated within subprojects
+cov.xml

imbue_mngr_opencode-0.2.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,35 @@
+# 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/conftest.py

@@ -0,0 +1,15 @@
+"""Project-level conftest for mngr-opencode.
+
+When running tests from libs/mngr_opencode/, this conftest provides the common pytest hooks
+that would otherwise come from the monorepo root conftest.py (which is not discovered
+when pytest runs from a subdirectory).
+
+When running from the monorepo root, the root conftest.py registers the hooks first,
+and this file's register_conftest_hooks() call is a no-op (guarded by a module-level flag).
+"""
+
+from imbue.imbue_common.conftest_hooks import register_conftest_hooks
+from imbue.mngr.utils.logging import suppress_warnings
+
+suppress_warnings()
+register_conftest_hooks(globals())

imbue_mngr_opencode-0.2.0/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-0.2.0/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-0.2.0/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/pyproject.toml

@@ -0,0 +1,71 @@
+[project]
+name = "imbue-mngr-opencode"
+version = "0.2.0"
+description = "OpenCode agent type plugin for mngr"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "imbue-mngr==0.2.0",
+]
+
+[project.entry-points.mngr]
+opencode = "imbue.mngr_opencode.plugin"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["imbue"]
+
+[tool.uv.sources]
+imbue-mngr = { workspace = true }
+
+# Shared pytest settings (markers, filterwarnings, coverage report config)
+# are centralized in:
+#   libs/imbue_common/imbue/imbue_common/conftest_hooks.py
+# The settings below remain here because they are read from pyproject.toml
+# before any hooks run: addopts, coverage.run, inline-snapshot, timeout_func_only.
+[tool.pytest.ini_options]
+timeout_func_only = true
+junit_family = "xunit1"
+testpaths = ["."]
+addopts = [
+  "-n 4",
+  "--dist=worksteal",
+  "--cov=imbue.mngr_opencode",
+  "--cov-report=term-missing",
+  "--cov-report=html",
+  "--cov-report=xml",
+  "--cov-fail-under=90",
+  "--durations=20",
+  "--timeout=10",
+  "--timeout-method=signal",
+  "--max-worker-restart=0",
+  "-m not acceptance and not release",
+  "--slow-tests-to-file",
+  "--coverage-to-file",
+]
+
+[tool.coverage.run]
+parallel = true
+concurrency = ["multiprocessing", "thread"]
+omit = [
+  "*_test.py",
+  "test_*.py",
+  "*/tests/*",
+  "*/conftest.py",
+  "*/utils/testing.py",
+]
+
+[tool.inline-snapshot]
+default-flags=["report"]
+default-flags-tui=["report"]
+default-flags-ide=["report"]
+format-command="uv run ruff format --force-exclude --config pyproject.toml --stdin-filename {filename}"
+
+[tool.pyright]
+venvPath = "../.."
+venv = ".venv"
+pythonVersion = "3.11"
+strict = ["**/*.py"]