feat(codegen): generate experimental v2 bindings (#141)

* chore(schema): pin experimental v2 alpha schema

* feat(codegen): generate experimental v2 bindings

* test(schema): cover experimental v2 bindings

* fix(codegen): expose protocol method metadata

* fix(codegen): isolate v2 schema semantics

Author: PsiACE

Makefile

@@ -11,10 +11,18 @@ gen-all: ## Generate all code from schema
 	@uv run ruff check --fix
 	@uv run ruff format .
 
+.PHONY: gen-v2
+gen-v2: ## Generate experimental v2 schema bindings
+	@echo "🚀 Generating experimental v2 schema bindings"
+	@uv run scripts/gen_all.py --protocol-version 2
+
 .PHONY: gen-check
 gen-check: ## Verify generated schema bindings without changing the worktree
 	@echo "🚀 Checking generated schema bindings"
 	@uv run --frozen python -m scripts.gen_schema --check
+	@uv run --frozen python -m scripts.gen_meta --check
+	@uv run --frozen python -m scripts.gen_schema --protocol-version 2 --check
+	@uv run --frozen python -m scripts.gen_meta --protocol-version 2 --check
 
 .PHONY: check
 check: ## Run code quality tools.
@@ -23,7 +31,7 @@ check: ## Run code quality tools.
 	@echo "🚀 Linting code: Running pre-commit via prek"
 	@uv run prek run -a
 	@echo "🚀 Static type checking: Running ty"
-	@uv run ty check --exclude "src/acp/meta.py" --exclude "src/acp/schema.py" --exclude "examples/*.py"
+	@uv run ty check --exclude "src/acp/meta.py" --exclude "src/acp/schema.py" --exclude "src/acp/experimental/v2/meta.py" --exclude "src/acp/experimental/v2/schema.py" --exclude "examples/*.py"
 	@echo "🚀 Checking for obsolete dependencies: Running deptry"
 	@uv run deptry src
 

pyproject.toml

@@ -120,6 +120,8 @@ ignore = [
 "tests/*" = ["S101"]
 "src/acp/meta.py" = ["ALL"]
 "src/acp/schema.py" = ["ALL"]
+"src/acp/experimental/v2/meta.py" = ["ALL"]
+"src/acp/experimental/v2/schema.py" = ["ALL"]
 
 [tool.ruff.format]
 preview = true

schema/v2/VERSION

@@ -0,0 +1 @@
+refs/tags/schema-v2.0.0-alpha.3

schema/v2/meta.json

@@ -0,0 +1,43 @@
+{
+  "version": 2,
+  "agentMethods": {
+    "initialize": "initialize",
+    "auth_login": "auth/login",
+    "providers_list": "providers/list",
+    "providers_set": "providers/set",
+    "providers_disable": "providers/disable",
+    "session_new": "session/new",
+    "session_set_config_option": "session/set_config_option",
+    "session_prompt": "session/prompt",
+    "session_cancel": "session/cancel",
+    "mcp_message": "mcp/message",
+    "session_list": "session/list",
+    "session_delete": "session/delete",
+    "session_fork": "session/fork",
+    "session_resume": "session/resume",
+    "session_close": "session/close",
+    "auth_logout": "auth/logout",
+    "nes_start": "nes/start",
+    "nes_suggest": "nes/suggest",
+    "nes_accept": "nes/accept",
+    "nes_reject": "nes/reject",
+    "nes_close": "nes/close",
+    "document_did_open": "document/didOpen",
+    "document_did_change": "document/didChange",
+    "document_did_close": "document/didClose",
+    "document_did_save": "document/didSave",
+    "document_did_focus": "document/didFocus"
+  },
+  "clientMethods": {
+    "session_request_permission": "session/request_permission",
+    "session_update": "session/update",
+    "mcp_connect": "mcp/connect",
+    "mcp_message": "mcp/message",
+    "mcp_disconnect": "mcp/disconnect",
+    "elicitation_create": "elicitation/create",
+    "elicitation_complete": "elicitation/complete"
+  },
+  "protocolMethods": {
+    "cancel_request": "$/cancel_request"
+  }
+}