[Python] Remove copilot.types (#871)

* Remove `copilot.types`
Along the way, simplify `copilot.__init__` to only export the high-level API.

* fix: reorder import statements in test_telemetry.py

* fix: ruff format client.py and session.py

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: update PermissionHandler import path in transform test

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fixes after rebase

* fix: use keyword params directly in create_session/resume_session bodies

Remove cfg dict intermediary and use keyword parameters directly,
fixing ty type checker errors where cfg.get() returned Any | None
and shadowed the typed parameter variables.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: restore system message transform support lost during rebase

Add back SectionTransformFn type, _extract_transform_callbacks helper,
_handle_system_message_transform handler, and systemMessage.transform
RPC registration that were part of PR #816 but lost during rebase.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: restore missing SystemMessageCustomizeConfig and related types

The customize mode types (SystemPromptSection, SYSTEM_PROMPT_SECTIONS,
SectionOverride, SystemMessageCustomizeConfig) were dropped when
types.py was deleted but not re-added to session.py. This also moves
SectionTransformFn and SectionOverrideAction before SectionOverride
so the definitions flow in dependency order.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Steve Sanderson <SteveSandersonMS@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: 3 people

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]
 ]
 ```