Expose session context, add filtering, and context_changed event

docs/guides/session-persistence.md

@@ -293,12 +293,16 @@ session_id = create_session_id("alice", "code-review")
 ### Listing Active Sessions
 
 ```typescript
+// List all sessions
 const sessions = await client.listSessions();
 console.log(`Found ${sessions.length} sessions`);
 
 for (const session of sessions) {
   console.log(`- ${session.sessionId} (created: ${session.createdAt})`);
 }
+
+// Filter sessions by repository
+const repoSessions = await client.listSessions({ repository: "owner/repo" });
 ```
 
 ### Cleaning Up Old Sessions
@@ -521,7 +525,7 @@ await withSessionLock("user-123-task-456", async () => {
 | **Create resumable session** | Provide your own `sessionId` |
 | **Resume session** | `client.resumeSession(sessionId)` |
 | **BYOK resume** | Re-provide `provider` config |
-| **List sessions** | `client.listSessions()` |
+| **List sessions** | `client.listSessions(filter?)` |
 | **Delete session** | `client.deleteSession(sessionId)` |
 | **Destroy active session** | `session.destroy()` |
 | **Containerized deployment** | Mount `~/.copilot/session-state/` to persistent storage |

dotnet/src/Client.cs

@@ -652,6 +652,7 @@ public async Task DeleteSessionAsync(string sessionId, CancellationToken cancell
     /// <summary>
     /// Lists all sessions known to the Copilot server.
     /// </summary>
+    /// <param name="filter">Optional filter to narrow down the session list by cwd, git root, repository, or branch.</param>
     /// <param name="cancellationToken">A <see cref="CancellationToken"/> that can be used to cancel the operation.</param>
     /// <returns>A task that resolves with a list of <see cref="SessionMetadata"/> for all available sessions.</returns>
     /// <exception cref="InvalidOperationException">Thrown when the client is not connected.</exception>
@@ -664,12 +665,12 @@ public async Task DeleteSessionAsync(string sessionId, CancellationToken cancell
     /// }
     /// </code>
     /// </example>
-    public async Task<List<SessionMetadata>> ListSessionsAsync(CancellationToken cancellationToken = default)
+    public async Task<List<SessionMetadata>> ListSessionsAsync(SessionListFilter? filter = null, CancellationToken cancellationToken = default)
     {
         var connection = await EnsureConnectedAsync(cancellationToken);
 
         var response = await InvokeRpcAsync<ListSessionsResponse>(
-            connection.Rpc, "session.list", [], cancellationToken);
+            connection.Rpc, "session.list", [new ListSessionsRequest(filter)], cancellationToken);
 
         return response.Sessions;
     }
@@ -1369,6 +1370,9 @@ internal record DeleteSessionResponse(
         bool Success,
         string? Error);
 
+    internal record ListSessionsRequest(
+        SessionListFilter? Filter);
+
     internal record ListSessionsResponse(
         List<SessionMetadata> Sessions);
 
@@ -1438,6 +1442,7 @@ public override void WriteLine(string? message) =>
     [JsonSerializable(typeof(DeleteSessionResponse))]
     [JsonSerializable(typeof(GetLastSessionIdResponse))]
     [JsonSerializable(typeof(HooksInvokeResponse))]
+    [JsonSerializable(typeof(ListSessionsRequest))]
     [JsonSerializable(typeof(ListSessionsResponse))]
     [JsonSerializable(typeof(PermissionRequestResponse))]
     [JsonSerializable(typeof(PermissionRequestResult))]