mm-agenttoolkit 0.1.0__tar.gz

mm_agenttoolkit-0.1.0/.claude/settings.local.json

@@ -0,0 +1,44 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(.venv/Scripts/python.exe *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git check-ignore *)",
+      "Read(//c/code/agenttoolkit/**)",
+      "Bash(git -C /c/code/agenttoolkit status --porcelain -- '*.md' '*.MD')",
+      "Bash(python *)",
+      "Bash(uv run *)",
+      "Bash(uv sync *)",
+      "Bash(pip show *)",
+      "Bash(.venv/Scripts/python -c \"import openai\")",
+      "Bash(.venv/Scripts/python -c \"from llmify import ChatOpenAI; print\\('ok'\\)\")",
+      "Bash(../.venv/Scripts/python chat.py)",
+      "Bash(C:/code/agenttoolkit/.venv/Scripts/python -c \"import sys; print\\(sys.executable\\)\")",
+      "Bash(C:/code/agenttoolkit/.venv/Scripts/python -c \"import llmify; print\\(llmify.__file__\\)\")",
+      "Bash(C:/code/agenttoolkit/.venv/Scripts/python -m pip list)",
+      "Bash(C:/code/agenttoolkit/.venv/Scripts/python *)",
+      "Read(//c/code/agenttoolkit/examples/**)",
+      "Read(//c/code/agenttoolkit/agenttoolkit/**)",
+      "Bash(rg -n \"ActionResult\\(?!\\\\[\\)\" -P tests examples experiments agenttoolkit)",
+      "Bash(uv lock *)",
+      "Bash(git mv *)",
+      "Bash(mv experiments/connected_sandbox.py experiments/sandboxing/connected_sandbox.py)",
+      "Bash(mv experiments/connected_sandbox.Dockerfile experiments/sandboxing/connected_sandbox.Dockerfile)",
+      "Bash(uv add *)",
+      "Bash(xargs grep -liE \"grep|search\")",
+      "Bash(git -C C:/code/agenttoolkit status --short .import_linter_cache)",
+      "Bash(uv python *)",
+      "Bash(git stash *)",
+      "Bash(docker update *)",
+      "Read(//c/code/agenttoolkit/.venv/Lib/site-packages/llmify/**)",
+      "Read(//c/code/agenttoolkit/experiments/**)",
+      "Bash(git rm *)",
+      "Bash(grep -v \"^\\\\./\\\\.venv/\")",
+      "Bash(gh auth *)",
+      "Bash(gh repo *)",
+      "Bash(git remote *)",
+      "Bash(git revert *)"
+    ]
+  }
+}

mm_agenttoolkit-0.1.0/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+
+updates:
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      python-dependencies:
+        patterns:
+          - "*"
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly

mm_agenttoolkit-0.1.0/.github/workflows/ci.yaml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --locked --python ${{ matrix.python-version }}
+
+      - name: Lint
+        run: uv run --locked --python ${{ matrix.python-version }} ruff check .
+
+      - name: Check architecture
+        run: uv run --locked --python ${{ matrix.python-version }} lint-imports
+
+      - name: Test with branch coverage
+        run: uv run --locked --python ${{ matrix.python-version }} pytest

mm_agenttoolkit-0.1.0/.gitignore

@@ -0,0 +1,51 @@
+# Byte-compiled / optimized files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Environment variables
+.env
+.env.*
+!.env.example
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# Type checkers / linters
+.mypy_cache/
+.ruff_cache/
+.pytype/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Import linter
+.import_linter_cache/

mm_agenttoolkit-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+
+  - repo: https://github.com/psf/black
+    rev: 26.1.0
+    hooks:
+      - id: black
+        args: [--line-length=88]

mm_agenttoolkit-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

mm_agenttoolkit-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing
+
+## Setup
+
+```console
+uv sync --locked
+```
+
+This installs the locked dev environment (`pytest`, `pytest-asyncio`,
+`pytest-cov`, `ruff`).
+
+## Before opening a PR
+
+```console
+uv run --locked ruff check .
+uv run --locked pytest
+```
+
+`pytest` measures branch coverage for `agenttoolkit` and fails the run
+below 90%; add tests alongside any new branch rather than special-casing
+the coverage gate. CI runs the same two commands on Python 3.13 and 3.14 —
+a change that only works on one of those versions isn't done.
+
+## Conventions
+
+- Python 3.13 evaluates annotations eagerly, so any module using a
+  forward reference (a class referencing its own name, or a name defined
+  later in the file) needs `from __future__ import annotations` at the
+  top. This isn't needed on 3.14 (PEP 649), but the project supports both,
+  so add it whenever it would matter on 3.13.
+- Use absolute imports (`from agenttoolkit.tools.context import
+  ToolContext`), not relative imports — except in `__init__.py` files,
+  which use relative imports to re-export their package's public API.
+- Don't add comments or docstrings that just restate what the code already
+  says. Only write one when it explains something a reader couldn't get
+  from the code itself: why something exists, a hidden constraint, or a
+  behavior that would otherwise be surprising.
+- Keep `agenttoolkit` provider-neutral and free of application-specific
+  tools or an agent loop — that scope belongs in consuming projects, not
+  here. `experiments/` holds example integrations and isn't part of the
+  published package.
+
+## Reporting issues
+
+Open a GitHub issue with a minimal reproduction. For bugs, include the
+Python version and the smallest `Tools`/`Tool` setup that reproduces the
+problem.

mm_agenttoolkit-0.1.0/Claude.md

@@ -0,0 +1,16 @@
+# Conventions
+
+- The project supports Python 3.13-3.14. Always add
+  `from __future__ import annotations` to modules that use forward
+  references (e.g. a class referencing its own name, or names defined later
+  in the file), since lazy annotation evaluation (PEP 649) is only native to
+  3.14+ and 3.13 will raise `NameError` at import time otherwise.
+- Use absolute imports (`from agenttoolkit.tools.context import ToolContext`),
+  not relative imports (`from .context import ToolContext`). The one
+  exception is `__init__.py` files, which use relative imports to re-export
+  their package's public API.
+- No comments or docstrings that just restate what the code does (e.g. a
+  docstring on `ActionResult` saying "Provider-neutral outcome of one tool
+  invocation" — the name and fields already say that). Only write one when
+  it explains something non-obvious: why it exists, a hidden constraint, or
+  a behavior that would otherwise surprise a reader.

mm_agenttoolkit-0.1.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mathis Arends
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.