Return PermissionRequestResult in Python permission samples

Python permission request handlers return PermissionRequestResult objects,
not raw dictionaries. Update the docs and scenario samples that were still
using dict-shaped examples so readers and scenario runs get the intended
approve-once behavior instead of falling back to user-not-available.

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

Author: Copilot

docs/features/hooks.md

@@ -61,12 +61,13 @@ const session = await client.createSession({
 
 ```python
 from copilot import CopilotClient
+from copilot.session import PermissionRequestResult
 
 client = CopilotClient()
 await client.start()
 
 session = await client.create_session(
-    on_permission_request=lambda req, inv: {"kind": "approve-once"},
+    on_permission_request=lambda req, inv: PermissionRequestResult(kind="approve-once"),
     hooks={
         "on_session_start": on_session_start,
         "on_pre_tool_use":  on_pre_tool_use,
@@ -261,6 +262,8 @@ const session = await client.createSession({
 <summary><strong>Python</strong></summary>
 
 ```python
+from copilot.session import PermissionRequestResult
+
 READ_ONLY_TOOLS = ["read_file", "glob", "grep", "view"]
 
 async def on_pre_tool_use(input_data, invocation):
@@ -273,7 +276,7 @@ async def on_pre_tool_use(input_data, invocation):
     return {"permissionDecision": "allow"}
 
 session = await client.create_session(
-    on_permission_request=lambda req, inv: {"kind": "approve-once"},
+    on_permission_request=lambda req, inv: PermissionRequestResult(kind="approve-once"),
     hooks={"on_pre_tool_use": on_pre_tool_use},
 )
 ```
@@ -575,6 +578,7 @@ const session = await client.createSession({
 <!-- docs-validate: skip -->
 ```python
 import json, aiofiles
+from copilot.session import PermissionRequestResult
 
 audit_log = []
 
@@ -626,7 +630,7 @@ async def on_session_end(input_data, invocation):
     return None
 
 session = await client.create_session(
-    on_permission_request=lambda req, inv: {"kind": "approve-once"},
+    on_permission_request=lambda req, inv: PermissionRequestResult(kind="approve-once"),
     hooks={
         "on_session_start": on_session_start,
         "on_user_prompt_submitted": on_user_prompt_submitted,
@@ -705,6 +709,7 @@ const session = await client.createSession({
 
 ```python
 import subprocess
+from copilot.session import PermissionRequestResult
 
 async def on_session_end(input_data, invocation):
     sid = invocation["session_id"][:8]
@@ -723,7 +728,7 @@ async def on_error_occurred(input_data, invocation):
     return None
 
 session = await client.create_session(
-    on_permission_request=lambda req, inv: {"kind": "approve-once"},
+    on_permission_request=lambda req, inv: PermissionRequestResult(kind="approve-once"),
     hooks={
         "on_session_end": on_session_end,
         "on_error_occurred": on_error_occurred,
@@ -927,6 +932,8 @@ const session = await client.createSession({
 <summary><strong>Python</strong></summary>
 
 ```python
+from copilot.session import PermissionRequestResult
+
 session_metrics = {}
 
 async def on_session_start(input_data, invocation):
@@ -956,7 +963,7 @@ async def on_session_end(input_data, invocation):
     return None
 
 session = await client.create_session(
-    on_permission_request=lambda req, inv: {"kind": "approve-once"},
+    on_permission_request=lambda req, inv: PermissionRequestResult(kind="approve-once"),
     hooks={
         "on_session_start": on_session_start,
         "on_user_prompt_submitted": on_user_prompt_submitted,

docs/features/skills.md

@@ -50,7 +50,7 @@ async def main():
     await client.start()
 
     session = await client.create_session(
-        on_permission_request=lambda req, inv: {"kind": "approve-once"},
+        on_permission_request=lambda req, inv: PermissionRequestResult(kind="approve-once"),
         model="gpt-4.1",
         skill_directories=[
             "./skills/code-review",

test/scenarios/callbacks/hooks/python/main.py

@@ -2,13 +2,14 @@
 import os
 from copilot import CopilotClient
 from copilot.client import SubprocessConfig
+from copilot.session import PermissionRequestResult
 
 
 hook_log: list[str] = []
 
 
 async def auto_approve_permission(request, invocation):
-    return {"kind": "approve-once"}
+    return PermissionRequestResult(kind="approve-once")
 
 
 async def on_session_start(input_data, invocation):

test/scenarios/callbacks/permissions/python/main.py

@@ -2,14 +2,15 @@
 import os
 from copilot import CopilotClient
 from copilot.client import SubprocessConfig
+from copilot.session import PermissionRequestResult
 
 # Track which tools requested permission
 permission_log: list[str] = []
 
 
 async def log_permission(request, invocation):
     permission_log.append(f"approved:{request.tool_name}")
-    return {"kind": "approve-once"}
+    return PermissionRequestResult(kind="approve-once")
 
 
 async def auto_approve_tool(input_data, invocation):

test/scenarios/callbacks/user-input/python/main.py

@@ -2,13 +2,14 @@
 import os
 from copilot import CopilotClient
 from copilot.client import SubprocessConfig
+from copilot.session import PermissionRequestResult
 
 
 input_log: list[str] = []
 
 
 async def auto_approve_permission(request, invocation):
-    return {"kind": "approve-once"}
+    return PermissionRequestResult(kind="approve-once")
 
 
 async def auto_approve_tool(input_data, invocation):

test/scenarios/tools/skills/python/main.py

@@ -4,6 +4,7 @@
 
 from copilot import CopilotClient
 from copilot.client import SubprocessConfig
+from copilot.session import PermissionRequestResult
 
 
 async def main():
@@ -16,7 +17,7 @@ async def main():
         skills_dir = str(Path(__file__).resolve().parent.parent / "sample-skills")
 
         session = await client.create_session(
-            on_permission_request=lambda _, __: {"kind": "approve-once"},
+            on_permission_request=lambda _, __: PermissionRequestResult(kind="approve-once"),
             model="claude-haiku-4.5",
             skill_directories=[skills_dir],
             hooks={

test/scenarios/tools/virtual-filesystem/python/main.py

@@ -2,6 +2,7 @@
 import os
 from copilot import CopilotClient, define_tool
 from copilot.client import SubprocessConfig
+from copilot.session import PermissionRequestResult
 from pydantic import BaseModel, Field
 
 # In-memory virtual filesystem
@@ -39,7 +40,7 @@ def list_files() -> str:
 
 
 async def auto_approve_permission(request, invocation):
-    return {"kind": "approve-once"}
+    return PermissionRequestResult(kind="approve-once")
 
 
 async def auto_approve_tool(input_data, invocation):