Fix documentation accuracy issues

Go SDK fixes:
- NewClient returns *Client (not error), takes *ClientOptions
- CreateSession requires context.Context and *SessionConfig (pointer)
- Updated all Go examples in debugging.md, hooks/*.md

Session API fixes:
- sendPrompt/SendPrompt doesn't exist - use send/sendAndWait
- Fixed all TypeScript, Python, Go, .NET examples in session-persistence.md

Link fixes:
- getting-started.md: ./mcp.md → ./mcp/overview.md (file moved)

Author: patniko

docs/debugging.md

@@ -47,7 +47,7 @@ client = CopilotClient(log_level="debug")
 ```go
 import copilot "github.com/github/copilot-sdk/go"
 
-client, err := copilot.NewClient(copilot.ClientOptions{
+client := copilot.NewClient(&copilot.ClientOptions{
     LogLevel: "debug",
 })
 ```
@@ -169,7 +169,7 @@ var client = new CopilotClient(new CopilotClientOptions
    <summary><strong>Go</strong></summary>
 
    ```go
-   client, _ := copilot.NewClient(copilot.ClientOptions{
+   client := copilot.NewClient(&copilot.ClientOptions{
        CLIPath: "/usr/local/bin/copilot",
    })
    ```
@@ -222,7 +222,7 @@ var client = new CopilotClient(new CopilotClientOptions
    <summary><strong>Go</strong></summary>
 
    ```go
-   client, _ := copilot.NewClient(copilot.ClientOptions{
+   client := copilot.NewClient(&copilot.ClientOptions{
        GithubToken: os.Getenv("GITHUB_TOKEN"),
    })
    ```

docs/getting-started.md

@@ -1020,7 +1020,7 @@ const session = await client.createSession({
 });
 ```
 
-📖 **[Full MCP documentation →](./mcp.md)** - Learn about local vs remote servers, all configuration options, and troubleshooting.
+📖 **[Full MCP documentation →](./mcp/overview.md)** - Learn about local vs remote servers, all configuration options, and troubleshooting.
 
 ### Create Custom Agents
 

docs/guides/session-persistence.md

@@ -37,7 +37,7 @@ const session = await client.createSession({
 });
 
 // Do some work...
-await session.sendPrompt({ content: "Analyze my codebase" });
+await session.sendAndWait({ prompt: "Analyze my codebase" });
 
 // Session state is automatically persisted
 // You can safely close the client
@@ -57,24 +57,24 @@ session = await client.create_session(
 )
 
 # Do some work...
-await session.send_prompt(content="Analyze my codebase")
+await session.send_and_wait({"prompt": "Analyze my codebase"})
 
 # Session state is automatically persisted
 ```
 
 ### Go
 
 ```go
-client, _ := copilot.NewClient()
+client := copilot.NewClient(nil)
 
 // Create a session with a meaningful ID
-session, _ := client.CreateSession(copilot.CreateSessionOptions{
+session, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{
     SessionID: "user-123-task-456",
     Model:     "gpt-5.2-codex",
 })
 
 // Do some work...
-session.SendPrompt(copilot.PromptOptions{Content: "Analyze my codebase"})
+session.SendAndWait(context.Background(), copilot.MessageOptions{Prompt: "Analyze my codebase"})
 
 // Session state is automatically persisted
 ```
@@ -94,7 +94,7 @@ var session = await client.CreateSessionAsync(new CreateSessionOptions
 });
 
 // Do some work...
-await session.SendPromptAsync(new PromptOptions { Content = "Analyze my codebase" });
+await session.SendAndWaitAsync(new MessageOptions { Prompt = "Analyze my codebase" });
 
 // Session state is automatically persisted
 ```
@@ -124,7 +124,7 @@ flowchart LR
 const session = await client.resumeSession("user-123-task-456");
 
 // Continue where you left off
-await session.sendPrompt({ content: "What did we discuss earlier?" });
+await session.sendAndWait({ prompt: "What did we discuss earlier?" });
 ```
 
 ### Python
@@ -134,17 +134,17 @@ await session.sendPrompt({ content: "What did we discuss earlier?" });
 session = await client.resume_session("user-123-task-456")
 
 # Continue where you left off
-await session.send_prompt(content="What did we discuss earlier?")
+await session.send_and_wait({"prompt": "What did we discuss earlier?"})
 ```
 
 ### Go
 
 ```go
 // Resume from a different client instance (or after restart)
-session, _ := client.ResumeSession("user-123-task-456", copilot.ResumeSessionOptions{})
+session, _ := client.ResumeSession(context.Background(), "user-123-task-456", nil)
 
 // Continue where you left off
-session.SendPrompt(copilot.PromptOptions{Content: "What did we discuss earlier?"})
+session.SendAndWait(context.Background(), copilot.MessageOptions{Prompt: "What did we discuss earlier?"})
 ```
 
 ### C# (.NET)
@@ -154,7 +154,7 @@ session.SendPrompt(copilot.PromptOptions{Content: "What did we discuss earlier?"
 var session = await client.ResumeSessionAsync("user-123-task-456");
 
 // Continue where you left off
-await session.SendPromptAsync(new PromptOptions { Content = "What did we discuss earlier?" });
+await session.SendAndWaitAsync(new MessageOptions { Prompt = "What did we discuss earlier?" });
 ```
 
 ## Using BYOK (Bring Your Own Key) with Resumed Sessions
@@ -290,7 +290,7 @@ When a task completes, destroy the session explicitly rather than waiting for ti
 ```typescript
 try {
   // Do work...
-  await session.sendPrompt({ content: "Complete the task" });
+  await session.sendAndWait({ prompt: "Complete the task" });
 
   // Task complete - clean up
   await session.destroy();
@@ -472,7 +472,7 @@ async function withSessionLock<T>(
 // Usage
 await withSessionLock("user-123-task-456", async () => {
   const session = await client.resumeSession("user-123-task-456");
-  await session.sendPrompt({ content: "Continue the task" });
+  await session.sendAndWait({ prompt: "Continue the task" });
 });
 ```
 

docs/hooks/error-handling.md

@@ -120,7 +120,7 @@ session = await client.create_session({
 <summary><strong>Go</strong></summary>
 
 ```go
-session, _ := client.CreateSession(ctx, copilot.SessionConfig{
+session, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{
     Hooks: &copilot.SessionHooks{
         OnErrorOccurred: func(input copilot.ErrorOccurredHookInput, inv copilot.HookInvocation) (*copilot.ErrorOccurredHookOutput, error) {
             fmt.Printf("[%s] Error: %s\n", inv.SessionID, input.Error)

docs/hooks/overview.md

@@ -87,14 +87,15 @@ async def main():
 package main
 
 import (
+    "context"
     "fmt"
     copilot "github.com/github/copilot-sdk/go"
 )
 
 func main() {
-    client, _ := copilot.NewClient(copilot.ClientOptions{})
+    client := copilot.NewClient(nil)
 
-    session, _ := client.CreateSession(ctx, copilot.SessionConfig{
+    session, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{
         Hooks: &copilot.SessionHooks{
             OnPreToolUse: func(input copilot.PreToolUseHookInput, inv copilot.HookInvocation) (*copilot.PreToolUseHookOutput, error) {
                 fmt.Printf("Tool called: %s\n", input.ToolName)
@@ -113,6 +114,7 @@ func main() {
             },
         },
     })
+    _ = session
 }
 ```
 

docs/hooks/post-tool-use.md

@@ -119,7 +119,7 @@ session = await client.create_session({
 <summary><strong>Go</strong></summary>
 
 ```go
-session, _ := client.CreateSession(ctx, copilot.SessionConfig{
+session, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{
     Hooks: &copilot.SessionHooks{
         OnPostToolUse: func(input copilot.PostToolUseHookInput, inv copilot.HookInvocation) (*copilot.PostToolUseHookOutput, error) {
             fmt.Printf("[%s] Tool: %s\n", inv.SessionID, input.ToolName)

docs/hooks/pre-tool-use.md

@@ -126,7 +126,7 @@ session = await client.create_session({
 <summary><strong>Go</strong></summary>
 
 ```go
-session, _ := client.CreateSession(ctx, copilot.SessionConfig{
+session, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{
     Hooks: &copilot.SessionHooks{
         OnPreToolUse: func(input copilot.PreToolUseHookInput, inv copilot.HookInvocation) (*copilot.PreToolUseHookOutput, error) {
             fmt.Printf("[%s] Calling %s\n", inv.SessionID, input.ToolName)

docs/hooks/user-prompt-submitted.md

@@ -113,7 +113,7 @@ session = await client.create_session({
 <summary><strong>Go</strong></summary>
 
 ```go
-session, _ := client.CreateSession(ctx, copilot.SessionConfig{
+session, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{
     Hooks: &copilot.SessionHooks{
         OnUserPromptSubmitted: func(input copilot.UserPromptSubmittedHookInput, inv copilot.HookInvocation) (*copilot.UserPromptSubmittedHookOutput, error) {
             fmt.Printf("[%s] User: %s\n", inv.SessionID, input.Prompt)