feat: update to unstable schema and metadata

Signed-off-by: Frost Ming <me@frostming.com>

Author: frostming

schema/VERSION

@@ -1 +1 @@
-refs/tags/v0.6.3
+refs/heads/main

schema/schema.json

@@ -109,8 +109,8 @@ def resolve_ref(version: str | None) -> str:
 
 def download_schema(repo: str, ref: str) -> None:
     SCHEMA_DIR.mkdir(parents=True, exist_ok=True)
-    schema_url = f"https://raw.githubusercontent.com/{repo}/{ref}/schema/schema.json"
-    meta_url = f"https://raw.githubusercontent.com/{repo}/{ref}/schema/meta.json"
+    schema_url = f"https://raw.githubusercontent.com/{repo}/{ref}/schema/schema.unstable.json"
+    meta_url = f"https://raw.githubusercontent.com/{repo}/{ref}/schema/meta.unstable.json"
     try:
         schema_data = fetch_json(schema_url)
         meta_data = fetch_json(meta_url)

scripts/gen_all.py

@@ -93,6 +93,8 @@
     ("ToolCallStart", "status", "ToolCallStatus", True),
     ("ToolCall", "kind", "ToolKind", True),
     ("ToolCall", "status", "ToolCallStatus", True),
+    ("ToolCallUpdate", "kind", "ToolKind", True),
+    ("ToolCallUpdate", "status", "ToolCallStatus", True),
 )
 
 DEFAULT_VALUE_OVERRIDES: tuple[tuple[str, str, str], ...] = (

scripts/gen_schema.py

@@ -28,9 +28,9 @@
     SessionNotification,
     TerminalOutputRequest,
     TerminalOutputResponse,
-    ToolCall,
     ToolCallProgress,
     ToolCallStart,
+    ToolCallUpdate,
     UserMessageChunk,
     WaitForTerminalExitRequest,
     WaitForTerminalExitResponse,
@@ -92,7 +92,7 @@ async def session_update(
 
     @param_model(RequestPermissionRequest)
     async def request_permission(
-        self, options: list[PermissionOption], session_id: str, tool_call: ToolCall, **kwargs: Any
+        self, options: list[PermissionOption], session_id: str, tool_call: ToolCallUpdate, **kwargs: Any
     ) -> RequestPermissionResponse:
         return await request_model(
             self._conn,

src/acp/agent/connection.py

@@ -47,6 +47,7 @@ def build_agent_router(agent: Agent) -> MessageRouter:
         agent,
         "set_session_model",
         adapt_result=normalize_result,
+        unstable=True,
     )
     router.route_request(
         AGENT_METHODS["authenticate"],

src/acp/agent/router.py

@@ -4,7 +4,7 @@
 from typing import Any
 
 from ..helpers import text_block, tool_content
-from ..schema import PermissionOption, RequestPermissionRequest, RequestPermissionResponse, ToolCall
+from ..schema import PermissionOption, RequestPermissionRequest, RequestPermissionResponse, ToolCallUpdate
 from .tool_calls import ToolCallTracker, _copy_model_list
 
 
@@ -60,7 +60,7 @@ async def request_for(
         description: str | None = None,
         options: Sequence[PermissionOption] | None = None,
         content: Sequence[Any] | None = None,
-        tool_call: ToolCall | None = None,
+        tool_call: ToolCallUpdate | None = None,
     ) -> RequestPermissionResponse:
         """Request user approval for a tool call."""
         if tool_call is None:

src/acp/contrib/permissions.py

@@ -7,7 +7,14 @@
 from pydantic import BaseModel, ConfigDict
 
 from ..helpers import text_block, tool_content
-from ..schema import ToolCall, ToolCallLocation, ToolCallProgress, ToolCallStart, ToolCallStatus, ToolKind
+from ..schema import (
+    ToolCallLocation,
+    ToolCallProgress,
+    ToolCallStart,
+    ToolCallStatus,
+    ToolCallUpdate,
+    ToolKind,
+)
 
 
 class _MissingToolCallTitleError(ValueError):
@@ -91,8 +98,8 @@ def to_view(self) -> TrackedToolCallView:
             raw_output=self.raw_output,
         )
 
-    def to_tool_call_model(self) -> ToolCall:
-        return ToolCall(
+    def to_tool_call_model(self) -> ToolCallUpdate:
+        return ToolCallUpdate(
             tool_call_id=self.tool_call_id,
             title=self.title,
             kind=self.kind,
@@ -249,7 +256,7 @@ def view(self, external_id: str) -> TrackedToolCallView:
         state = self._require_call(external_id)
         return state.to_view()
 
-    def tool_call_model(self, external_id: str) -> ToolCall:
+    def tool_call_model(self, external_id: str) -> ToolCallUpdate:
         """Return a deep copy of the tool call suitable for permission requests."""
         state = self._require_call(external_id)
         return state.to_tool_call_model()

src/acp/contrib/tool_calls.py

@@ -48,9 +48,9 @@
     TerminalOutputRequest,
     TerminalOutputResponse,
     TextContentBlock,
-    ToolCall,
     ToolCallProgress,
     ToolCallStart,
+    ToolCallUpdate,
     UserMessageChunk,
     WaitForTerminalExitRequest,
     WaitForTerminalExitResponse,
@@ -65,7 +65,7 @@
 class Client(Protocol):
     @param_model(RequestPermissionRequest)
     async def request_permission(
-        self, options: list[PermissionOption], session_id: str, tool_call: ToolCall, **kwargs: Any
+        self, options: list[PermissionOption], session_id: str, tool_call: ToolCallUpdate, **kwargs: Any
     ) -> RequestPermissionResponse: ...
 
     @param_model(SessionNotification)

src/acp/interfaces.py

@@ -1,5 +1,5 @@
 # Generated from schema/meta.json. Do not edit by hand.
-# Schema ref: refs/tags/v0.6.3
+# Schema ref: refs/heads/main
 AGENT_METHODS = {
     "authenticate": "authenticate",
     "initialize": "initialize",