Add SessionContext, SessionListFilter, and context_changed event

Co-authored-by: brunoborges <129743+brunoborges@users.noreply.github.com>

Author: Copilot

src/main/java/com/github/copilot/sdk/CopilotClient.java

@@ -30,6 +30,7 @@
 import com.github.copilot.sdk.json.ResumeSessionResponse;
 import com.github.copilot.sdk.json.SessionConfig;
 import com.github.copilot.sdk.json.SessionLifecycleHandler;
+import com.github.copilot.sdk.json.SessionListFilter;
 import com.github.copilot.sdk.json.SessionMetadata;
 
 /**
@@ -474,9 +475,41 @@ public CompletableFuture<Void> deleteSession(String sessionId) {
      * @see #resumeSession(String)
      */
     public CompletableFuture<List<SessionMetadata>> listSessions() {
-        return ensureConnected()
-                .thenCompose(connection -> connection.rpc.invoke("session.list", Map.of(), ListSessionsResponse.class)
-                        .thenApply(ListSessionsResponse::sessions));
+        return listSessions(null);
+    }
+
+    /**
+     * Lists all available sessions with optional filtering.
+     * <p>
+     * Returns metadata about all sessions that can be resumed, including their IDs,
+     * start times, summaries, and context information. Use the filter parameter to
+     * narrow down sessions by working directory, git repository, or branch.
+     *
+     * <h2>Example Usage</h2>
+     *
+     * <pre>{@code
+     * // List all sessions
+     * var allSessions = client.listSessions().get();
+     *
+     * // Filter by repository
+     * var filter = new SessionListFilter().setRepository("owner/repo");
+     * var repoSessions = client.listSessions(filter).get();
+     * }</pre>
+     *
+     * @param filter
+     *            optional filter to narrow down sessions by context fields, or
+     *            {@code null} to list all sessions
+     * @return a future that resolves with a list of session metadata
+     * @see SessionMetadata
+     * @see SessionListFilter
+     * @see #resumeSession(String)
+     */
+    public CompletableFuture<List<SessionMetadata>> listSessions(SessionListFilter filter) {
+        return ensureConnected().thenCompose(connection -> {
+            Map<String, Object> params = filter != null ? Map.of("filter", filter) : Map.of();
+            return connection.rpc.invoke("session.list", params, ListSessionsResponse.class)
+                    .thenApply(ListSessionsResponse::sessions);
+        });
     }
 
     /**

src/main/java/com/github/copilot/sdk/events/AbstractSessionEvent.java

@@ -54,6 +54,7 @@ public abstract sealed class AbstractSessionEvent permits
         SessionStartEvent, SessionResumeEvent, SessionErrorEvent, SessionIdleEvent, SessionInfoEvent,
         SessionModelChangeEvent, SessionHandoffEvent, SessionTruncationEvent, SessionSnapshotRewindEvent,
         SessionUsageInfoEvent, SessionCompactionStartEvent, SessionCompactionCompleteEvent, SessionShutdownEvent,
+        SessionContextChangedEvent,
         // Assistant events
         AssistantTurnStartEvent, AssistantIntentEvent, AssistantReasoningEvent, AssistantReasoningDeltaEvent,
         AssistantMessageEvent, AssistantMessageDeltaEvent, AssistantTurnEndEvent, AssistantUsageEvent, AbortEvent,

src/main/java/com/github/copilot/sdk/events/SessionContextChangedEvent.java

@@ -0,0 +1,41 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.events;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Event: session.context_changed
+ * <p>
+ * Fired when the working directory context changes between turns. Contains the
+ * updated context information including cwd, git root, repository, and branch.
+ *
+ * @since 1.0.0
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+public final class SessionContextChangedEvent extends AbstractSessionEvent {
+
+    @JsonProperty("data")
+    private SessionContextChangedData data;
+
+    @Override
+    public String getType() {
+        return "session.context_changed";
+    }
+
+    public SessionContextChangedData getData() {
+        return data;
+    }
+
+    public void setData(SessionContextChangedData data) {
+        this.data = data;
+    }
+
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public record SessionContextChangedData(@JsonProperty("cwd") String cwd, @JsonProperty("gitRoot") String gitRoot,
+            @JsonProperty("repository") String repository, @JsonProperty("branch") String branch) {
+    }
+}

src/main/java/com/github/copilot/sdk/events/SessionEventParser.java

@@ -61,6 +61,7 @@ public class SessionEventParser {
         TYPE_MAP.put("session.usage_info", SessionUsageInfoEvent.class);
         TYPE_MAP.put("session.compaction_start", SessionCompactionStartEvent.class);
         TYPE_MAP.put("session.compaction_complete", SessionCompactionCompleteEvent.class);
+        TYPE_MAP.put("session.context_changed", SessionContextChangedEvent.class);
         TYPE_MAP.put("user.message", UserMessageEvent.class);
         TYPE_MAP.put("pending_messages.modified", PendingMessagesModifiedEvent.class);
         TYPE_MAP.put("assistant.turn_start", AssistantTurnStartEvent.class);

src/main/java/com/github/copilot/sdk/json/SessionContext.java

@@ -0,0 +1,108 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Working directory context for a session.
+ * <p>
+ * Contains information about the working directory where the session was
+ * created, including git repository information if applicable.
+ *
+ * @since 1.0.0
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class SessionContext {
+
+    @JsonProperty("cwd")
+    private String cwd;
+
+    @JsonProperty("gitRoot")
+    private String gitRoot;
+
+    @JsonProperty("repository")
+    private String repository;
+
+    @JsonProperty("branch")
+    private String branch;
+
+    /**
+     * Gets the working directory where the session was created.
+     *
+     * @return the current working directory path
+     */
+    public String getCwd() {
+        return cwd;
+    }
+
+    /**
+     * Sets the working directory.
+     *
+     * @param cwd
+     *            the current working directory path
+     */
+    public void setCwd(String cwd) {
+        this.cwd = cwd;
+    }
+
+    /**
+     * Gets the git repository root directory.
+     *
+     * @return the git root path, or {@code null} if not in a git repository
+     */
+    public String getGitRoot() {
+        return gitRoot;
+    }
+
+    /**
+     * Sets the git repository root directory.
+     *
+     * @param gitRoot
+     *            the git root path
+     */
+    public void setGitRoot(String gitRoot) {
+        this.gitRoot = gitRoot;
+    }
+
+    /**
+     * Gets the GitHub repository in "owner/repo" format.
+     *
+     * @return the repository identifier, or {@code null} if not available
+     */
+    public String getRepository() {
+        return repository;
+    }
+
+    /**
+     * Sets the GitHub repository.
+     *
+     * @param repository
+     *            the repository in "owner/repo" format
+     */
+    public void setRepository(String repository) {
+        this.repository = repository;
+    }
+
+    /**
+     * Gets the current git branch.
+     *
+     * @return the branch name, or {@code null} if not available
+     */
+    public String getBranch() {
+        return branch;
+    }
+
+    /**
+     * Sets the git branch.
+     *
+     * @param branch
+     *            the branch name
+     */
+    public void setBranch(String branch) {
+        this.branch = branch;
+    }
+}

src/main/java/com/github/copilot/sdk/json/SessionListFilter.java

@@ -0,0 +1,129 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Filter options for listing sessions.
+ * <p>
+ * Allows filtering sessions by working directory context fields such as cwd,
+ * git root, repository, or branch.
+ *
+ * <h2>Example Usage</h2>
+ *
+ * <pre>{@code
+ * // Filter sessions by repository
+ * var filter = new SessionListFilter().setRepository("owner/repo");
+ * var sessions = client.listSessions(filter).get();
+ *
+ * // Filter by working directory
+ * var filter = new SessionListFilter().setCwd("/path/to/project");
+ * var sessions = client.listSessions(filter).get();
+ * }</pre>
+ *
+ * @see com.github.copilot.sdk.CopilotClient#listSessions(SessionListFilter)
+ * @since 1.0.0
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class SessionListFilter {
+
+    @JsonProperty("cwd")
+    private String cwd;
+
+    @JsonProperty("gitRoot")
+    private String gitRoot;
+
+    @JsonProperty("repository")
+    private String repository;
+
+    @JsonProperty("branch")
+    private String branch;
+
+    /**
+     * Gets the current working directory filter.
+     *
+     * @return the cwd filter, or {@code null} if not set
+     */
+    public String getCwd() {
+        return cwd;
+    }
+
+    /**
+     * Sets the filter for exact cwd match.
+     *
+     * @param cwd
+     *            the current working directory to filter by
+     * @return this filter for method chaining
+     */
+    public SessionListFilter setCwd(String cwd) {
+        this.cwd = cwd;
+        return this;
+    }
+
+    /**
+     * Gets the git root filter.
+     *
+     * @return the git root filter, or {@code null} if not set
+     */
+    public String getGitRoot() {
+        return gitRoot;
+    }
+
+    /**
+     * Sets the filter for git root directory.
+     *
+     * @param gitRoot
+     *            the git root path to filter by
+     * @return this filter for method chaining
+     */
+    public SessionListFilter setGitRoot(String gitRoot) {
+        this.gitRoot = gitRoot;
+        return this;
+    }
+
+    /**
+     * Gets the repository filter.
+     *
+     * @return the repository filter, or {@code null} if not set
+     */
+    public String getRepository() {
+        return repository;
+    }
+
+    /**
+     * Sets the filter for repository (in "owner/repo" format).
+     *
+     * @param repository
+     *            the repository identifier to filter by
+     * @return this filter for method chaining
+     */
+    public SessionListFilter setRepository(String repository) {
+        this.repository = repository;
+        return this;
+    }
+
+    /**
+     * Gets the branch filter.
+     *
+     * @return the branch filter, or {@code null} if not set
+     */
+    public String getBranch() {
+        return branch;
+    }
+
+    /**
+     * Sets the filter for git branch.
+     *
+     * @param branch
+     *            the branch name to filter by
+     * @return this filter for method chaining
+     */
+    public SessionListFilter setBranch(String branch) {
+        this.branch = branch;
+        return this;
+    }
+}

src/main/java/com/github/copilot/sdk/json/SessionMetadata.java

@@ -49,6 +49,9 @@ public class SessionMetadata {
     @JsonProperty("isRemote")
     private boolean isRemote;
 
+    @JsonProperty("context")
+    private SessionContext context;
+
     /**
      * Gets the unique identifier for this session.
      *
@@ -146,4 +149,26 @@ public boolean isRemote() {
     public void setRemote(boolean remote) {
         isRemote = remote;
     }
+
+    /**
+     * Gets the working directory context from session creation.
+     * <p>
+     * Contains information about the working directory, git repository, and branch
+     * where the session was created.
+     *
+     * @return the session context, or {@code null} if not available
+     */
+    public SessionContext getContext() {
+        return context;
+    }
+
+    /**
+     * Sets the working directory context.
+     *
+     * @param context
+     *            the session context
+     */
+    public void setContext(SessionContext context) {
+        this.context = context;
+    }
 }