python-sdk: expose canonical app-server types (2026-03-16)

Remove the SDK alias/result layers so the wrapper surface returns canonical generated app-server models directly.

- delete public type alias modules and regenerate v2_all.py against current schema
- return InitializeResponse from metadata and generated Turn from run()
- update docs, examples, notebook, and tests to use canonical generated models and repo-only text extraction helpers

Validation:
- PYTHONPATH=sdk/python/src python3 -m pytest sdk/python/tests
- GH_TOKEN="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" RUN_REAL_CODEX_TESTS=1 PYTHONPATH=sdk/python/src python3 -m pytest sdk/python/tests -rs

Co-authored-by: Codex <noreply@openai.com>

sdk/python/examples/_bootstrap.py

@@ -4,6 +4,7 @@ import importlib.util
 import os
 import sys
 from pathlib import Path
+from typing import Iterable
 
 _SDK_PYTHON_DIR = Path(__file__).resolve().parents[1]
 _SDK_PYTHON_STR = str(_SDK_PYTHON_DIR)
@@ -49,3 +50,51 @@ def runtime_config():
 
     ensure_runtime_package_installed(sys.executable, _SDK_PYTHON_DIR)
     return AppServerConfig()
+
+
+def server_label(metadata: object) -> str:
+    server = getattr(metadata, "serverInfo", None)
+    server_name = ((getattr(server, "name", None) or "") if server is not None else "").strip()
+    server_version = ((getattr(server, "version", None) or "") if server is not None else "").strip()
+    if server_name and server_version:
+        return f"{server_name} {server_version}"
+
+    user_agent = ((getattr(metadata, "userAgent", None) or "") if metadata is not None else "").strip()
+    return user_agent or "unknown"
+
+
+def find_turn_by_id(turns: Iterable[object] | None, turn_id: str) -> object | None:
+    for turn in turns or []:
+        if getattr(turn, "id", None) == turn_id:
+            return turn
+    return None
+
+
+def assistant_text_from_turn(turn: object | None) -> str:
+    if turn is None:
+        return ""
+
+    chunks: list[str] = []
+    for item in getattr(turn, "items", []) or []:
+        raw_item = item.model_dump(mode="json") if hasattr(item, "model_dump") else item
+        if not isinstance(raw_item, dict):
+            continue
+
+        item_type = raw_item.get("type")
+        if item_type == "agentMessage":
+            text = raw_item.get("text")
+            if isinstance(text, str) and text:
+                chunks.append(text)
+            continue
+
+        if item_type != "message" or raw_item.get("role") != "assistant":
+            continue
+
+        for content in raw_item.get("content") or []:
+            if not isinstance(content, dict) or content.get("type") != "output_text":
+                continue
+            text = content.get("text")
+            if isinstance(text, str) and text:
+                chunks.append(text)
+
+    return "".join(chunks)