chore: agent-native baseline (AGENTS.md, make check, CI, dev env) - #72
Merged
Merged
Conversation
robotlearning123
enabled auto-merge (squash)
September 25, 2026 23:40
mcp 2.x removed FastMCP (replaced by MCPServer), so the loose 'mcp[server]>=1.0' spec now resolves a broken dependency on fresh pip installs and the re-export 'from mcp.server import FastMCP' no longer exists. Import from the canonical v1 path mcp.server.fastmcp and bound the requirement to <2 per upstream migration guidance.
numpy>=2.5 ships __init__.pyi using PEP 695 type statements (3.12+ syntax); mypy configured at python_version 3.11 fails to parse them. call_use never imports numpy (reached only via livekit stubs), so follow_imports=skip resolves it to Any and preserves the 3.11 check.
livekit-api stubs now expose list_rooms's required 'list' parameter to mypy; the doctor connectivity probe called it bare, which also raised a caught TypeError at runtime. Pass an empty ListRoomsRequest.
pytest-asyncio 1.4 no longer leaves a current event loop, so the
deprecated asyncio.get_event_loop() raised RuntimeError('There is no
current event loop') before the SDK's own 'No active call' path ran.
asyncio.run() is supported on all 3.11-3.13.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Agent-native baseline per agent-next standard v0.1.0.
Changes
@AGENTS.md). NOTE:.gitignoreline 49 ignoresCLAUDE.md— force-added per the baseline; delete the ignore line or drop the file at merge, your call.setuptarget plus a top-of-fileexport PATH := $(CURDIR)/.venv/bin:$(PATH)sosetup/checknever touch host/conda/user Python —setupcreates.venv/when no virtualenv is active, thenpython3 -m pip install -e ".[dev]" ruff build twine(ruff/build/twine arecheckinputs missing from thedevextra). The target was inserted mid-file so it does not overlap the Makefile hunks in open PR Reposition as modality primitive + add publish target #66 (line 1.PHONY, EOF append) — hunks are disjoint, merges cleanly either order.ci.yml/docs.yml/publish.ymlunchanged (matches make check: yes — the lint, typecheck, test, build jobs run the same commands; CI adds security/commit-lint/pr-size jobs on top)dependabot.ymlunchangedmcr.microsoft.com/devcontainers/python:3.12,postCreateCommand: make setup)Receipts
Env note: the PyPI mirror was intermittently timing out, so
.venvwas seeded fromuv.lock(uv sync --extra dev, which resolves nothing — lockfile only) plus the two non-locked tools, thenmake setupwas run for real.make setup(exit 0):make check(exit 0), tail:(lint: ruff check+format clean, 30 files; typecheck: mypy clean; test: full suite +
--cov-fail-under=100passed — 550+ tests, 100.00% coverage.)Not done / risks
pip install -e ".[dev]"resolves to a currently-broken dep set (upstream drift vsuv.lock, pre-existing on main — not caused by this PR):mcp 2.2.0removesmcp.server.FastMCP(2 collection errors intest_mcp_server.py,test_bdd_input_validation.py),numpy 2.5.3stubs use the 3.12typestatement vsmypy python_version=3.11(typecheck error), andlivekit-agents 1.8.2flips 2 BDD assertions (test_journey_sdk_cancel_without_active_call_raises,test_journey_sdk_takeover_without_active_call_raises— both pass in isolation and under lockfile versions). Underuv.lock(mcp 1.26.0,numpy 2.4.3,livekit-agents 1.4.5,livekit 1.1.2) every gate is green. CI runs the samepip installpath and will hit this drift on next run — worth a separate pinning/fix PR.build(project.licensetable) — pre-existing, non-fatal.git add -fover an existing.gitignorerule (see Changes).