Migrate events package to auto-generated SessionEvent types

Replace hand-written com.github.copilot.sdk.events package with
auto-generated com.github.copilot.sdk.generated types.

- Replace AbstractSessionEvent with SessionEvent from generated package
- Replace SessionEventParser with Jackson native polymorphic deserialization
- Update all main source and test files to use generated types
- Adapt ForwardCompatibilityTest to remove getOriginalType() tests
- Update type assertions for renamed data records (FooData -> FooEventData)
- Fix enum type comparisons in tests (elicitation mode, shutdown type, etc.)
- Update site documentation to reference generated package
- Delete old events package

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

Co-authored-by: edburns <75821+edburns@users.noreply.github.com>

Author: Copilot

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

@@ -29,16 +29,15 @@
 import com.fasterxml.jackson.annotation.JsonProperty;
 import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
-import com.github.copilot.sdk.events.AbstractSessionEvent;
-import com.github.copilot.sdk.events.AssistantMessageEvent;
-import com.github.copilot.sdk.events.CapabilitiesChangedEvent;
-import com.github.copilot.sdk.events.CommandExecuteEvent;
-import com.github.copilot.sdk.events.ElicitationRequestedEvent;
-import com.github.copilot.sdk.events.ExternalToolRequestedEvent;
-import com.github.copilot.sdk.events.PermissionRequestedEvent;
-import com.github.copilot.sdk.events.SessionErrorEvent;
-import com.github.copilot.sdk.events.SessionEventParser;
-import com.github.copilot.sdk.events.SessionIdleEvent;
+import com.github.copilot.sdk.generated.AssistantMessageEvent;
+import com.github.copilot.sdk.generated.CapabilitiesChangedEvent;
+import com.github.copilot.sdk.generated.CommandExecuteEvent;
+import com.github.copilot.sdk.generated.ElicitationRequestedEvent;
+import com.github.copilot.sdk.generated.ExternalToolRequestedEvent;
+import com.github.copilot.sdk.generated.PermissionRequestedEvent;
+import com.github.copilot.sdk.generated.SessionErrorEvent;
+import com.github.copilot.sdk.generated.SessionEvent;
+import com.github.copilot.sdk.generated.SessionIdleEvent;
 import com.github.copilot.sdk.json.AgentInfo;
 import com.github.copilot.sdk.json.CommandContext;
 import com.github.copilot.sdk.json.CommandDefinition;
@@ -116,7 +115,7 @@
  * @see CopilotClient#createSession(com.github.copilot.sdk.json.SessionConfig)
  * @see CopilotClient#resumeSession(String,
  *      com.github.copilot.sdk.json.ResumeSessionConfig)
- * @see AbstractSessionEvent
+ * @see SessionEvent
  * @since 1.0.0
  */
 public final class CopilotSession implements AutoCloseable {
@@ -135,7 +134,7 @@ public final class CopilotSession implements AutoCloseable {
     private volatile SessionCapabilities capabilities = new SessionCapabilities();
     private final SessionUiApi ui;
     private final JsonRpcClient rpc;
-    private final Set<Consumer<AbstractSessionEvent>> eventHandlers = ConcurrentHashMap.newKeySet();
+    private final Set<Consumer<SessionEvent>> eventHandlers = ConcurrentHashMap.newKeySet();
     private final Map<String, ToolDefinition> toolHandlers = new ConcurrentHashMap<>();
     private final Map<String, CommandHandler> commandHandlers = new ConcurrentHashMap<>();
     private final AtomicReference<PermissionHandler> permissionHandler = new AtomicReference<>();
@@ -450,7 +449,7 @@ public CompletableFuture<AssistantMessageEvent> sendAndWait(MessageOptions optio
         var future = new CompletableFuture<AssistantMessageEvent>();
         var lastAssistantMessage = new AtomicReference<AssistantMessageEvent>();
 
-        Consumer<AbstractSessionEvent> handler = evt -> {
+        Consumer<SessionEvent> handler = evt -> {
             if (evt instanceof AssistantMessageEvent msg) {
                 lastAssistantMessage.set(msg);
             } else if (evt instanceof SessionIdleEvent) {
@@ -563,7 +562,7 @@ public CompletableFuture<AssistantMessageEvent> sendAndWait(MessageOptions optio
      *
      * <pre>{@code
      * // Collect all events
-     * var events = new ArrayList<AbstractSessionEvent>();
+     * var events = new ArrayList<SessionEvent>();
      * session.on(events::add);
      * }</pre>
      *
@@ -573,10 +572,10 @@ public CompletableFuture<AssistantMessageEvent> sendAndWait(MessageOptions optio
      * @throws IllegalStateException
      *             if this session has been terminated
      * @see #on(Class, Consumer)
-     * @see AbstractSessionEvent
+     * @see SessionEvent
      * @see #setEventErrorPolicy(EventErrorPolicy)
      */
-    public Closeable on(Consumer<AbstractSessionEvent> handler) {
+    public Closeable on(Consumer<SessionEvent> handler) {
         ensureNotTerminated();
         eventHandlers.add(handler);
         return () -> eventHandlers.remove(handler);
@@ -626,11 +625,11 @@ public Closeable on(Consumer<AbstractSessionEvent> handler) {
      * @throws IllegalStateException
      *             if this session has been terminated
      * @see #on(Consumer)
-     * @see AbstractSessionEvent
+     * @see SessionEvent
      */
-    public <T extends AbstractSessionEvent> Closeable on(Class<T> eventType, Consumer<T> handler) {
+    public <T extends SessionEvent> Closeable on(Class<T> eventType, Consumer<T> handler) {
         ensureNotTerminated();
-        Consumer<AbstractSessionEvent> wrapper = event -> {
+        Consumer<SessionEvent> wrapper = event -> {
             if (eventType.isInstance(event)) {
                 handler.accept(eventType.cast(event));
             }
@@ -662,12 +661,12 @@ public <T extends AbstractSessionEvent> Closeable on(Class<T> eventType, Consume
      * @see #setEventErrorHandler(EventErrorHandler)
      * @see #setEventErrorPolicy(EventErrorPolicy)
      */
-    void dispatchEvent(AbstractSessionEvent event) {
+    void dispatchEvent(SessionEvent event) {
         // Handle broadcast request events (protocol v3) before dispatching to user
         // handlers. These are fire-and-forget: the response is sent asynchronously.
         handleBroadcastEventAsync(event);
 
-        for (Consumer<AbstractSessionEvent> handler : eventHandlers) {
+        for (Consumer<SessionEvent> handler : eventHandlers) {
             try {
                 handler.accept(event);
             } catch (Exception e) {
@@ -697,7 +696,7 @@ void dispatchEvent(AbstractSessionEvent event) {
      * @param event
      *            the event to handle
      */
-    private void handleBroadcastEventAsync(AbstractSessionEvent event) {
+    private void handleBroadcastEventAsync(SessionEvent event) {
         if (event instanceof ExternalToolRequestedEvent toolEvent) {
             var data = toolEvent.getData();
             if (data == null || data.requestId() == null || data.toolName() == null) {
@@ -721,7 +720,8 @@ private void handleBroadcastEventAsync(AbstractSessionEvent event) {
             if (handler == null) {
                 return; // This client doesn't handle permissions; another client will
             }
-            executePermissionAndRespondAsync(data.requestId(), data.permissionRequest(), handler);
+            executePermissionAndRespondAsync(data.requestId(),
+                    MAPPER.convertValue(data.permissionRequest(), PermissionRequest.class), handler);
         } else if (event instanceof CommandExecuteEvent cmdEvent) {
             var data = cmdEvent.getData();
             if (data == null || data.requestId() == null || data.commandName() == null) {
@@ -742,8 +742,8 @@ private void handleBroadcastEventAsync(AbstractSessionEvent event) {
                             .setRequired(data.requestedSchema().required());
                 }
                 var context = new ElicitationContext().setSessionId(sessionId).setMessage(data.message())
-                        .setRequestedSchema(schema).setMode(data.mode()).setElicitationSource(data.elicitationSource())
-                        .setUrl(data.url());
+                        .setRequestedSchema(schema).setMode(data.mode() != null ? data.mode().getValue() : null)
+                        .setElicitationSource(data.elicitationSource()).setUrl(data.url());
                 handleElicitationRequestAsync(context, data.requestId());
             }
         } else if (event instanceof CapabilitiesChangedEvent capEvent) {
@@ -1436,17 +1436,17 @@ CompletableFuture<Object> handleHooksInvoke(String hookType, JsonNode input) {
      * @return a future that resolves with a list of all session events
      * @throws IllegalStateException
      *             if this session has been terminated
-     * @see AbstractSessionEvent
+     * @see SessionEvent
      */
-    public CompletableFuture<List<AbstractSessionEvent>> getMessages() {
+    public CompletableFuture<List<SessionEvent>> getMessages() {
         ensureNotTerminated();
         return rpc.invoke("session.getMessages", Map.of("sessionId", sessionId), GetMessagesResponse.class)
                 .thenApply(response -> {
-                    var events = new ArrayList<AbstractSessionEvent>();
+                    var events = new ArrayList<SessionEvent>();
                     if (response.events() != null) {
                         for (JsonNode eventNode : response.events()) {
                             try {
-                                AbstractSessionEvent event = SessionEventParser.parse(eventNode);
+                                SessionEvent event = MAPPER.treeToValue(eventNode, SessionEvent.class);
                                 if (event != null) {
                                     events.add(event);
                                 }

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

@@ -4,7 +4,7 @@
 
 package com.github.copilot.sdk;
 
-import com.github.copilot.sdk.events.AbstractSessionEvent;
+import com.github.copilot.sdk.generated.SessionEvent;
 
 /**
  * A handler for errors thrown by event handlers during event dispatch.
@@ -54,5 +54,5 @@ public interface EventErrorHandler {
      * @param exception
      *            the exception thrown by the event handler
      */
-    void handleError(AbstractSessionEvent event, Exception exception);
+    void handleError(SessionEvent event, Exception exception);
 }

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

@@ -16,8 +16,7 @@
 
 import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
-import com.github.copilot.sdk.events.AbstractSessionEvent;
-import com.github.copilot.sdk.events.SessionEventParser;
+import com.github.copilot.sdk.generated.SessionEvent;
 import com.github.copilot.sdk.json.PermissionRequestResult;
 import com.github.copilot.sdk.json.PermissionRequestResultKind;
 import com.github.copilot.sdk.json.SessionLifecycleEvent;
@@ -93,7 +92,7 @@ private void handleSessionEvent(JsonNode params) {
 
             CopilotSession session = sessions.get(sessionId);
             if (session != null && eventNode != null) {
-                AbstractSessionEvent event = SessionEventParser.parse(eventNode);
+                SessionEvent event = MAPPER.treeToValue(eventNode, SessionEvent.class);
                 if (event != null) {
                     session.dispatchEvent(event);
                 }