Azure · Shiva S (Shivakishore14) · Aug 4, 2026 · Jul 10, 2026 · Jul 10, 2026 · Jul 10, 2026
@@ -4,6 +4,7 @@
 
 ### Other Changes
 
+- Cleaned up the public API surface by moving validation-only error helpers and runtime response builder helpers to private implementation modules.
 - Bumped the minimum `azure-ai-agentserver-core` dependency to `>=2.0.0b10`, which adds an opt-in gate for resilient-task startup recovery. The resilient Responses samples now call `set_resilient_tasks_enabled(True)` to explicitly opt in, mirroring the invocations resilient samples.
 
 ## 2.0.0b0 (2026-07-29)

@@ -1,15 +1,9 @@
 ```py
 namespace azure.ai.agentserver.responses
 
-    def azure.ai.agentserver.responses.get_conversation_id(request: CreateResponse | ResponseObject) -> Optional[str]: ...
-
-
     def azure.ai.agentserver.responses.get_input_expanded(request: CreateResponse) -> list[Item]: ...
 
 
-    def azure.ai.agentserver.responses.to_output_item(item: Item, response_id: str | None = None) -> OutputItem | None: ...
-
-
     class azure.ai.agentserver.responses.ConversationChainMetadataNamespace(Protocol): implements Collection 
 
         def __call__(self, name: Optional[str] = None) -> ConversationChainMetadataNamespace: ...
@@ -5927,47 +5921,6 @@ namespace azure.ai.agentserver.responses.models
         type: Literal[workflow_action]
 
 
-namespace azure.ai.agentserver.responses.models.errors
-
-    class azure.ai.agentserver.responses.models.errors.ApiErrorResponse(TypedDict, total=False):
-        key "error": Required[Error]
-        error: Error
-
-
-    class azure.ai.agentserver.responses.models.errors.Error(TypedDict, total=False):
-        key "code": Required[Optional[str]]
-        key "message": Required[str]
-        key "param": Optional[str]
-        key "type": str
-        additionalInfo: dict[str, Any]
-        additional_info: dict[str, Any]
-        code: str
-        debugInfo: dict[str, Any]
-        debug_info: dict[str, Any]
-        details: list[Error]
-        message: str
-        param: str
-        type: str
-
-
-    class azure.ai.agentserver.responses.models.errors.RequestValidationError(ValueError):
-
-        def __init__(
-                self, 
-                message: str, 
-                *, 
-                code: str = "invalid_request_error", 
-                debug_info: dict[str, Any] | None = ..., 
-                details: list[dict[str, str]] | None = ..., 
-                error_type: str = "invalid_request_error", 
-                param: str | None = ...
-            ) -> None: ...
-
-        def to_api_error_response(self) -> ApiErrorResponse: ...
-
-        def to_error(self) -> Error: ...
-
-
 namespace azure.ai.agentserver.responses.models.runtime
 
     def azure.ai.agentserver.responses.models.runtime.apply_cancelled_terminal(base: Mapping[str, Any]) -> dict[str, Any]: ...
@@ -5980,24 +5933,6 @@ namespace azure.ai.agentserver.responses.models.runtime
         ) -> dict[str, Any]: ...
 
 
-    def azure.ai.agentserver.responses.models.runtime.build_cancelled_response(
-            response_id: str, 
-            agent_reference: AgentReference | dict[str, Any], 
-            model: str | None, 
-            created_at: datetime | None = None
-        ) -> ResponseObject: ...
-
-
-    def azure.ai.agentserver.responses.models.runtime.build_failed_response(
-            response_id: str, 
-            agent_reference: AgentReference | dict[str, Any], 
-            model: str | None, 
-            created_at: datetime | None = None, 
-            error_message: str = "An internal server error occurred.", 
-            error_code: str = "server_error"
-        ) -> ResponseObject: ...
-
-
     def azure.ai.agentserver.responses.models.runtime.resolve_cancelled_response(
             base: Mapping[str, Any] | None, 
             response_id: str, 

@@ -1,3 +1,3 @@
-apiMdSha256: 2c3ff121746e6028ece71257bcd47d7421233e6f92f2d3f6612a03a5ca34735a
+apiMdSha256: 791aa262be4b10719e1a9ddde5516041bdad4d169806f83d5ebaef26474ccb30
 parserVersion: 0.3.30
-pythonVersion: 3.12.10
+pythonVersion: 3.11.15
@@ -18,9 +18,7 @@
 from .hosting._routing import ResponsesAgentServerHost
 from .models import CreateResponse, ResponseObject
 from .models._helpers import (
-    get_conversation_id,
     get_input_expanded,
-    to_output_item,
 )
 from .store._base import ResponseProviderProtocol
 from .store._file import FileResponseStore
@@ -59,7 +57,5 @@
     "TextResponse",
     "CreateResponse",
     "ResponseObject",
-    "get_conversation_id",
     "get_input_expanded",
-    "to_output_item",
 ]
@@ -13,7 +13,7 @@
 from ..models import AgentReference, CreateResponse
 
 from .._id_generator import IdGenerator
-from ..models.errors import RequestValidationError
+from ..models._errors import RequestValidationError
 
 _X_AGENT_RESPONSE_ID_HEADER = "x-agent-response-id"
 

@@ -17,7 +17,7 @@
 from .._id_generator import IdGenerator
 from .._options import ResponsesServerOptions
 from ..models import ApiErrorResponse, CreateResponse
-from ..models.errors import RequestValidationError
+from ..models._errors import RequestValidationError
 from ..models._validators import (
     validate_create_response_payload,
 )

@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT license.
-"""Error model types for request validation failures."""
+"""Internal error model helpers for request validation failures."""
 
 from __future__ import annotations
 

@@ -341,7 +341,7 @@ def terminal_event_seen(self) -> bool:
         return bool(self.events and self.events[-1].terminal)
 
 
-def build_cancelled_response(
+def _build_cancelled_response(
     response_id: str,
     agent_reference: AgentReference | dict[str, Any],
     model: str | None,
@@ -374,7 +374,7 @@ def build_cancelled_response(
     return cast(ResponseObject, payload)
 
 
-def build_failed_response(
+def _build_failed_response(
     response_id: str,
     agent_reference: AgentReference | dict[str, Any],
     model: str | None,
@@ -481,7 +481,7 @@ def resolve_failed_response(
     When ``base`` (the handler-produced snapshot) exists, the failed terminal
     is overlaid onto it so no handler-owned fields are lost. When it is absent
     (the handler crashed before ``response.created``, so there is nothing to
-    preserve), a minimal object is synthesized via :func:`build_failed_response`.
+    preserve), a minimal object is synthesized via :func:`_build_failed_response`.
 
     :param base: The handler's response snapshot, or ``None`` if none exists.
     :type base: ~typing.Mapping[str, ~typing.Any] | None
@@ -502,7 +502,7 @@ def resolve_failed_response(
     """
     if base is not None:
         return cast(ResponseObject, apply_failed_terminal(base, error={"code": error_code, "message": error_message}))
-    return build_failed_response(
+    return _build_failed_response(
         response_id, agent_reference, model, created_at=created_at, error_message=error_message, error_code=error_code
     )
 
@@ -519,7 +519,7 @@ def resolve_cancelled_response(
 
     When ``base`` exists it is overlaid (status → ``cancelled``, output
     cleared); otherwise a minimal object is synthesized via
-    :func:`build_cancelled_response`.
+    :func:`_build_cancelled_response`.
 
     :param base: The handler's response snapshot, or ``None`` if none exists.
     :type base: ~typing.Mapping[str, ~typing.Any] | None
@@ -536,4 +536,4 @@ def resolve_cancelled_response(
     """
     if base is not None:
         return cast(ResponseObject, apply_cancelled_terminal(base))
-    return build_cancelled_response(response_id, agent_reference, model, created_at=created_at)
+    return _build_cancelled_response(response_id, agent_reference, model, created_at=created_at)
@@ -9,14 +9,6 @@ azure.ai.agentserver.responses.models package
 Submodules
 ----------
 
-azure.ai.agentserver.responses.models.errors module
----------------------------------------------------
-
-.. automodule:: azure.ai.agentserver.responses.models.errors
-   :inherited-members:
-   :members:
-   :undoc-members:
-
 azure.ai.agentserver.responses.models.runtime module
 ----------------------------------------------------
 

@@ -27,7 +27,7 @@
     service_unavailable_response,
     tag_platform_error,
 )
-from azure.ai.agentserver.responses.models.errors import RequestValidationError
+from azure.ai.agentserver.responses.models._errors import RequestValidationError
 
 # ---------------------------------------------------------------------------
 # is_platform_error / tag_platform_error

@@ -8,7 +8,7 @@
 
 from azure.ai.agentserver.responses.hosting._validation import parse_create_response
 from azure.ai.agentserver.responses.models._validators import validate_create_response_payload
-from azure.ai.agentserver.responses.models.errors import RequestValidationError
+from azure.ai.agentserver.responses.models._errors import RequestValidationError
 
 # ---------------------------------------------------------------------------
 # parse_create_response integration tests (real validator + real model)

@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT license.
-"""Unit tests for ResponseExecution fields, properties, apply_event, and build_cancelled_response."""
+"""Unit tests for ResponseExecution fields, properties, apply_event, and cancelled response building."""
 
 from __future__ import annotations
 
@@ -11,7 +11,7 @@
 from azure.ai.agentserver.responses.models.runtime import (
     ResponseExecution,
     ResponseModeFlags,
-    build_cancelled_response,
+    _build_cancelled_response,
 )
 
 # ---------------------------------------------------------------------------
@@ -222,12 +222,12 @@ def test_apply_event_output_item_added() -> None:
 
 
 # ---------------------------------------------------------------------------
-# T12 – build_cancelled_response
+# T12 - _build_cancelled_response
 # ---------------------------------------------------------------------------
 
 
 def test_build_cancelled_response() -> None:
-    response = build_cancelled_response(
+    response = _build_cancelled_response(
         "caresp_xxx0000000000000000000000000000",
         {"name": "agent-a"},
         "gpt-4o",

@@ -11,7 +11,7 @@
     to_api_error_response,
     validate_create_response,
 )
-from azure.ai.agentserver.responses.models.errors import RequestValidationError
+from azure.ai.agentserver.responses.models._errors import RequestValidationError
 
 
 class _FakeCreateRequest(dict):