[Python] Remove copilot.types

docs/auth/byok.md

@@ -335,7 +335,7 @@ const client = new CopilotClient({
 
 ```python
 from copilot import CopilotClient
-from copilot.types import ModelInfo, ModelCapabilities, ModelSupports, ModelLimits
+from copilot.client import ModelInfo, ModelCapabilities, ModelSupports, ModelLimits
 
 client = CopilotClient({
     "on_list_models": lambda: [

docs/features/custom-agents.md

@@ -65,7 +65,7 @@ const session = await client.createSession({
 
 ```python
 from copilot import CopilotClient
-from copilot.types import PermissionRequestResult
+from copilot.session import PermissionRequestResult
 
 client = CopilotClient()
 await client.start()

docs/features/image-input.md

@@ -69,7 +69,7 @@ await session.send({
 
 ```python
 from copilot import CopilotClient
-from copilot.types import PermissionRequestResult
+from copilot.session import PermissionRequestResult
 
 client = CopilotClient()
 await client.start()

docs/features/skills.md

@@ -43,7 +43,7 @@ await session.sendAndWait({ prompt: "Review this code for security issues" });
 
 ```python
 from copilot import CopilotClient
-from copilot.types import PermissionRequestResult
+from copilot.session import PermissionRequestResult
 
 async def main():
     client = CopilotClient()

docs/features/steering-and-queueing.md

@@ -70,7 +70,7 @@ await session.send({
 
 ```python
 from copilot import CopilotClient
-from copilot.types import PermissionRequestResult
+from copilot.session import PermissionRequestResult
 
 async def main():
     client = CopilotClient()
@@ -229,7 +229,7 @@ await session.send({
 
 ```python
 from copilot import CopilotClient
-from copilot.types import PermissionRequestResult
+from copilot.session import PermissionRequestResult
 
 async def main():
     client = CopilotClient()

docs/getting-started.md

@@ -129,7 +129,8 @@ Create `main.py`:
 
 ```python
 import asyncio
-from copilot import CopilotClient, PermissionHandler
+from copilot import CopilotClient
+from copilot.session import PermissionHandler
 
 async def main():
     client = CopilotClient()
@@ -275,7 +276,8 @@ Update `main.py`:
 ```python
 import asyncio
 import sys
-from copilot import CopilotClient, PermissionHandler
+from copilot import CopilotClient
+from copilot.session import PermissionHandler
 from copilot.generated.session_events import SessionEventType
 
 async def main():
@@ -651,7 +653,8 @@ Update `main.py`:
 import asyncio
 import random
 import sys
-from copilot import CopilotClient, PermissionHandler
+from copilot import CopilotClient
+from copilot.session import PermissionHandler
 from copilot.tools import define_tool
 from copilot.generated.session_events import SessionEventType
 from pydantic import BaseModel, Field
@@ -919,7 +922,8 @@ Create `weather_assistant.py`:
 import asyncio
 import random
 import sys
-from copilot import CopilotClient, PermissionHandler
+from copilot import CopilotClient
+from copilot.session import PermissionHandler
 from copilot.tools import define_tool
 from copilot.generated.session_events import SessionEventType
 from pydantic import BaseModel, Field
@@ -1312,7 +1316,8 @@ const session = await client.createSession({ onPermissionRequest: approveAll });
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient, PermissionHandler
+from copilot import CopilotClient
+from copilot.session import PermissionHandler
 
 client = CopilotClient({
     "cli_url": "localhost:4321"

docs/hooks/error-handling.md

@@ -35,18 +35,18 @@ type ErrorOccurredHandler = (
 
 <!-- docs-validate: hidden -->
 ```python
-from copilot.types import ErrorOccurredHookInput, HookInvocation, ErrorOccurredHookOutput
+from copilot.session import ErrorOccurredHookInput, ErrorOccurredHookOutput
 from typing import Callable, Awaitable
 
 ErrorOccurredHandler = Callable[
-    [ErrorOccurredHookInput, HookInvocation],
+    [ErrorOccurredHookInput, dict[str, str]],
     Awaitable[ErrorOccurredHookOutput | None]
 ]
 ```
 <!-- /docs-validate: hidden -->
 ```python
 ErrorOccurredHandler = Callable[
-    [ErrorOccurredHookInput, HookInvocation],
+    [ErrorOccurredHookInput, dict[str, str]],
     Awaitable[ErrorOccurredHookOutput | None]
 ]
 ```

docs/hooks/post-tool-use.md

@@ -35,18 +35,18 @@ type PostToolUseHandler = (
 
 <!-- docs-validate: hidden -->
 ```python
-from copilot.types import PostToolUseHookInput, HookInvocation, PostToolUseHookOutput
+from copilot.session import PostToolUseHookInput, PostToolUseHookOutput
 from typing import Callable, Awaitable
 
 PostToolUseHandler = Callable[
-    [PostToolUseHookInput, HookInvocation],
+    [PostToolUseHookInput, dict[str, str]],
     Awaitable[PostToolUseHookOutput | None]
 ]
 ```
 <!-- /docs-validate: hidden -->
 ```python
 PostToolUseHandler = Callable[
-    [PostToolUseHookInput, HookInvocation],
+    [PostToolUseHookInput, dict[str, str]],
     Awaitable[PostToolUseHookOutput | None]
 ]
 ```

docs/hooks/pre-tool-use.md

@@ -35,18 +35,18 @@ type PreToolUseHandler = (
 
 <!-- docs-validate: hidden -->
 ```python
-from copilot.types import PreToolUseHookInput, HookInvocation, PreToolUseHookOutput
+from copilot.session import PreToolUseHookInput, PreToolUseHookOutput
 from typing import Callable, Awaitable
 
 PreToolUseHandler = Callable[
-    [PreToolUseHookInput, HookInvocation],
+    [PreToolUseHookInput, dict[str, str]],
     Awaitable[PreToolUseHookOutput | None]
 ]
 ```
 <!-- /docs-validate: hidden -->
 ```python
 PreToolUseHandler = Callable[
-    [PreToolUseHookInput, HookInvocation],
+    [PreToolUseHookInput, dict[str, str]],
     Awaitable[PreToolUseHookOutput | None]
 ]
 ```

docs/hooks/session-lifecycle.md

@@ -39,18 +39,18 @@ type SessionStartHandler = (
 
 <!-- docs-validate: hidden -->
 ```python
-from copilot.types import SessionStartHookInput, HookInvocation, SessionStartHookOutput
+from copilot.session import SessionStartHookInput, SessionStartHookOutput
 from typing import Callable, Awaitable
 
 SessionStartHandler = Callable[
-    [SessionStartHookInput, HookInvocation],
+    [SessionStartHookInput, dict[str, str]],
     Awaitable[SessionStartHookOutput | None]
 ]
 ```
 <!-- /docs-validate: hidden -->
 ```python
 SessionStartHandler = Callable[
-    [SessionStartHookInput, HookInvocation],
+    [SessionStartHookInput, dict[str, str]],
     Awaitable[SessionStartHookOutput | None]
 ]
 ```
@@ -249,18 +249,18 @@ type SessionEndHandler = (
 
 <!-- docs-validate: hidden -->
 ```python
-from copilot.types import SessionEndHookInput, HookInvocation
+from copilot.session import SessionEndHookInput
 from typing import Callable, Awaitable
 
 SessionEndHandler = Callable[
-    [SessionEndHookInput, HookInvocation],
+    [SessionEndHookInput, dict[str, str]],
     Awaitable[None]
 ]
 ```
 <!-- /docs-validate: hidden -->
 ```python
 SessionEndHandler = Callable[
-    [SessionEndHookInput, HookInvocation],
+    [SessionEndHookInput, dict[str, str]],
     Awaitable[SessionEndHookOutput | None]
 ]
 ```

docs/hooks/user-prompt-submitted.md

@@ -35,18 +35,18 @@ type UserPromptSubmittedHandler = (
 
 <!-- docs-validate: hidden -->
 ```python
-from copilot.types import UserPromptSubmittedHookInput, HookInvocation, UserPromptSubmittedHookOutput
+from copilot.session import UserPromptSubmittedHookInput, UserPromptSubmittedHookOutput
 from typing import Callable, Awaitable
 
 UserPromptSubmittedHandler = Callable[
-    [UserPromptSubmittedHookInput, HookInvocation],
+    [UserPromptSubmittedHookInput, dict[str, str]],
     Awaitable[UserPromptSubmittedHookOutput | None]
 ]
 ```
 <!-- /docs-validate: hidden -->
 ```python
 UserPromptSubmittedHandler = Callable[
-    [UserPromptSubmittedHookInput, HookInvocation],
+    [UserPromptSubmittedHookInput, dict[str, str]],
     Awaitable[UserPromptSubmittedHookOutput | None]
 ]
 ```

docs/setup/azure-managed-identity.md

@@ -42,7 +42,8 @@ import asyncio
 import os
 
 from azure.identity import DefaultAzureCredential
-from copilot import CopilotClient, PermissionHandler
+from copilot import CopilotClient
+from copilot.session import ProviderConfig, SessionConfig
 
 COGNITIVE_SERVICES_SCOPE = "https://cognitiveservices.azure.com/.default"
 
@@ -58,14 +59,15 @@ async def main():
     await client.start()
 
     session = await client.create_session(
-        on_permission_request=PermissionHandler.approve_all,
-        model="gpt-4.1",
-        provider={
-            "type": "openai",
-            "base_url": f"{foundry_url.rstrip('/')}/openai/v1/",
-            "bearer_token": token,  # Short-lived bearer token
-            "wire_api": "responses",
-        },
+        SessionConfig(
+            model="gpt-4.1",
+            provider=ProviderConfig(
+                type="openai",
+                base_url=f"{foundry_url.rstrip('/')}/openai/v1/",
+                bearer_token=token,  # Short-lived bearer token
+                wire_api="responses",
+            ),
+        )
     )
 
     response = await session.send_and_wait({"prompt": "Hello from Managed Identity!"})
@@ -83,7 +85,8 @@ Bearer tokens expire (typically after ~1 hour). For servers or long-running agen
 
 ```python
 from azure.identity import DefaultAzureCredential
-from copilot import CopilotClient, PermissionHandler
+from copilot import CopilotClient
+from copilot.session import ProviderConfig, SessionConfig
 
 COGNITIVE_SERVICES_SCOPE = "https://cognitiveservices.azure.com/.default"
 
@@ -97,21 +100,24 @@ class ManagedIdentityCopilotAgent:
         self.credential = DefaultAzureCredential()
         self.client = CopilotClient()
 
-    def _get_provider_config(self) -> dict:
-        """Build a provider config dict with a fresh bearer token."""
+    def _get_session_config(self) -> SessionConfig:
+        """Build a SessionConfig with a fresh bearer token."""
         token = self.credential.get_token(COGNITIVE_SERVICES_SCOPE).token
-        return {
-            "type": "openai",
-            "base_url": f"{self.foundry_url}/openai/v1/",
-            "bearer_token": token,
-            "wire_api": "responses",
-        }
+        return SessionConfig(
+            model=self.model,
+            provider=ProviderConfig(
+                type="openai",
+                base_url=f"{self.foundry_url}/openai/v1/",
+                bearer_token=token,
+                wire_api="responses",
+            ),
+        )
 
     async def chat(self, prompt: str) -> str:
         """Send a prompt and return the response text."""
         # Fresh token for each session
-        provider = self._get_provider_config()
-        session = await self.client.create_session(on_permission_request=PermissionHandler.approve_all, model=self.model, provider=provider)
+        config = self._get_session_config()
+        session = await self.client.create_session(config)
 
         response = await session.send_and_wait({"prompt": prompt})
         await session.disconnect()