Merge branch 'main' into provider-info

Author: patniko

.github/workflows/copilot-setup-steps.yml

@@ -1,11 +1,15 @@
 name: "Copilot Setup Steps"
 
-# This workflow configures the environment for GitHub Copilot Agent with gh-aw MCP server
+# This workflow configures the environment for GitHub Copilot Agent
+# Automatically run the setup steps when they are changed to allow for easy validation
 on:
   workflow_dispatch:
   push:
     paths:
       - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
 
 jobs:
   # The job MUST be called 'copilot-setup-steps' to be recognized by GitHub Copilot Agent
@@ -18,8 +22,89 @@ jobs:
       contents: read
 
     steps:
+      # Checkout the repository to install dependencies
+      - name: Checkout code
+        uses: actions/checkout@v6.0.2
+
+      # Setup Node.js (for TypeScript/JavaScript SDK and tooling)
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: |
+            ./nodejs/package-lock.json
+            ./test/harness/package-lock.json
+
+      # Setup Python (for Python SDK)
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      # Setup uv (Python package manager used in this repo)
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      # Setup Go (for Go SDK)
+      - name: Set up Go
+        uses: actions/setup-go@v6
+        with:
+          go-version: "1.23"
+
+      # Setup .NET (for .NET SDK)
+      - name: Set up .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "8.0.x"
+
+      # Install just command runner
+      - name: Install just
+        uses: extractions/setup-just@v3
+
+      # Install gh-aw extension for advanced GitHub CLI features
       - name: Install gh-aw extension
         run: |
           curl -fsSL https://raw.githubusercontent.com/githubnext/gh-aw/refs/heads/main/install-gh-aw.sh | bash
-      - name: Verify gh-aw installation
-        run: gh aw version
+
+      # Install JavaScript dependencies
+      - name: Install Node.js dependencies
+        working-directory: ./nodejs
+        run: npm ci --ignore-scripts
+
+      # Install Python dependencies
+      - name: Install Python dependencies
+        working-directory: ./python
+        run: uv sync --locked --all-extras --dev
+
+      # Install Go dependencies
+      - name: Install Go dependencies
+        working-directory: ./go
+        run: go mod download
+
+      # Restore .NET dependencies
+      - name: Restore .NET dependencies
+        working-directory: ./dotnet
+        run: dotnet restore
+
+      # Install test harness dependencies
+      - name: Install test harness dependencies
+        working-directory: ./test/harness
+        run: npm ci --ignore-scripts
+
+      # Verify installations
+      - name: Verify tool installations
+        run: |
+          echo "=== Verifying installations ==="
+          node --version
+          npm --version
+          python --version
+          uv --version
+          go version
+          dotnet --version
+          just --version
+          gh --version
+          gh aw version
+          echo "✅ All tools installed successfully"

cookbook/README.md

@@ -49,30 +49,30 @@ This cookbook collects small, focused recipes showing how to accomplish common t
 ### .NET
 
 ```bash
-cd dotnet/cookbook/recipe
+cd cookbook/dotnet/recipe
 dotnet run <filename>.cs
 ```
 
 ### Node.js
 
 ```bash
-cd nodejs/cookbook/recipe
+cd cookbook/nodejs/recipe
 npm install
 npx tsx <filename>.ts
 ```
 
 ### Python
 
 ```bash
-cd python/cookbook/recipe
+cd cookbook/python/recipe
 pip install -r requirements.txt
 python <filename>.py
 ```
 
 ### Go
 
 ```bash
-cd go/cookbook/recipe
+cd cookbook/go/recipe
 go run <filename>.go
 ```
 
@@ -83,4 +83,5 @@ go run <filename>.go
 
 ## Status
 
-Cookbook structure is complete with 4 recipes across all 4 supported languages. Each recipe includes both markdown documentation and runnable examples.
+Cookbook structure is complete with 5 recipes across all 4 supported languages. Each recipe includes both markdown documentation and runnable examples.
+

docs/getting-started.md

@@ -1033,7 +1033,8 @@ using GitHub.Copilot.SDK;
 
 using var client = new CopilotClient(new CopilotClientOptions
 {
-    CliUrl = "localhost:4321"
+    CliUrl = "localhost:4321",
+    UseStdio = false
 });
 
 // Use the client normally

dotnet/src/Client.cs

@@ -70,7 +70,7 @@ public partial class CopilotClient : IDisposable, IAsyncDisposable
     /// var client = new CopilotClient();
     ///
     /// // Connect to an existing server
-    /// var client = new CopilotClient(new CopilotClientOptions { CliUrl = "localhost:3000" });
+    /// var client = new CopilotClient(new CopilotClientOptions { CliUrl = "localhost:3000", UseStdio = false });
     ///
     /// // Custom CLI path with specific log level
     /// var client = new CopilotClient(new CopilotClientOptions

go/README.md

@@ -392,7 +392,6 @@ session, err := client.CreateSession(&copilot.SessionConfig{
     },
 })
 ```
-
 > **Important notes:**
 > - When using a custom provider, the `Model` parameter is **required**. The SDK will return an error if no model is specified.
 > - For Azure OpenAI endpoints (`*.openai.azure.com`), you **must** use `Type: "azure"`, not `Type: "openai"`.

python/copilot/__init__.py

@@ -24,11 +24,13 @@
     PermissionHandler,
     PermissionRequest,
     PermissionRequestResult,
+    PingResponse,
     ProviderConfig,
     ResumeSessionConfig,
     SessionConfig,
     SessionEvent,
     SessionMetadata,
+    StopError,
     Tool,
     ToolHandler,
     ToolInvocation,
@@ -56,11 +58,13 @@
     "PermissionHandler",
     "PermissionRequest",
     "PermissionRequestResult",
+    "PingResponse",
     "ProviderConfig",
     "ResumeSessionConfig",
     "SessionConfig",
     "SessionEvent",
     "SessionMetadata",
+    "StopError",
     "Tool",
     "ToolHandler",
     "ToolInvocation",