Add session lifecycle types and foreground session response types

Author: brunoborges

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

@@ -0,0 +1,52 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Response from session.getForeground RPC call.
+ * <p>
+ * This is only available when connecting to a server running in TUI+server mode
+ * (--ui-server).
+ *
+ * @since 1.0.0
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class GetForegroundSessionResponse {
+
+    @JsonProperty("sessionId")
+    private String sessionId;
+
+    @JsonProperty("workspacePath")
+    private String workspacePath;
+
+    /**
+     * Gets the session ID currently displayed in the TUI.
+     *
+     * @return the session ID, or null if no foreground session
+     */
+    public String getSessionId() {
+        return sessionId;
+    }
+
+    public void setSessionId(String sessionId) {
+        this.sessionId = sessionId;
+    }
+
+    /**
+     * Gets the workspace path of the foreground session.
+     *
+     * @return the workspace path, or null
+     */
+    public String getWorkspacePath() {
+        return workspacePath;
+    }
+
+    public void setWorkspacePath(String workspacePath) {
+        this.workspacePath = workspacePath;
+    }
+}

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

@@ -0,0 +1,53 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Session lifecycle event notification.
+ * <p>
+ * Lifecycle events are emitted when sessions are created, deleted, updated, or
+ * change foreground/background state (in TUI+server mode).
+ *
+ * @since 1.0.0
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class SessionLifecycleEvent {
+
+    @JsonProperty("type")
+    private String type;
+
+    @JsonProperty("sessionId")
+    private String sessionId;
+
+    @JsonProperty("metadata")
+    private SessionLifecycleEventMetadata metadata;
+
+    public String getType() {
+        return type;
+    }
+
+    public void setType(String type) {
+        this.type = type;
+    }
+
+    public String getSessionId() {
+        return sessionId;
+    }
+
+    public void setSessionId(String sessionId) {
+        this.sessionId = sessionId;
+    }
+
+    public SessionLifecycleEventMetadata getMetadata() {
+        return metadata;
+    }
+
+    public void setMetadata(SessionLifecycleEventMetadata metadata) {
+        this.metadata = metadata;
+    }
+}

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

@@ -0,0 +1,50 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Metadata for session lifecycle events.
+ *
+ * @since 1.0.0
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class SessionLifecycleEventMetadata {
+
+    @JsonProperty("startTime")
+    private String startTime;
+
+    @JsonProperty("modifiedTime")
+    private String modifiedTime;
+
+    @JsonProperty("summary")
+    private String summary;
+
+    public String getStartTime() {
+        return startTime;
+    }
+
+    public void setStartTime(String startTime) {
+        this.startTime = startTime;
+    }
+
+    public String getModifiedTime() {
+        return modifiedTime;
+    }
+
+    public void setModifiedTime(String modifiedTime) {
+        this.modifiedTime = modifiedTime;
+    }
+
+    public String getSummary() {
+        return summary;
+    }
+
+    public void setSummary(String summary) {
+        this.summary = summary;
+    }
+}

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

@@ -0,0 +1,45 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+/**
+ * Types of session lifecycle events.
+ * <p>
+ * Constants for session lifecycle event types used with
+ * {@link com.github.copilot.sdk.CopilotClient#onLifecycle(String, SessionLifecycleHandler)}.
+ *
+ * @since 1.0.0
+ */
+public final class SessionLifecycleEventTypes {
+
+    /**
+     * Event fired when a session is created.
+     */
+    public static final String CREATED = "session.created";
+
+    /**
+     * Event fired when a session is deleted.
+     */
+    public static final String DELETED = "session.deleted";
+
+    /**
+     * Event fired when a session is updated.
+     */
+    public static final String UPDATED = "session.updated";
+
+    /**
+     * Event fired when a session moves to foreground (TUI+server mode).
+     */
+    public static final String FOREGROUND = "session.foreground";
+
+    /**
+     * Event fired when a session moves to background (TUI+server mode).
+     */
+    public static final String BACKGROUND = "session.background";
+
+    private SessionLifecycleEventTypes() {
+        // Utility class
+    }
+}

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

@@ -0,0 +1,25 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+/**
+ * Handler for session lifecycle events.
+ * <p>
+ * Implement this interface to receive notifications when sessions are created,
+ * deleted, updated, or change foreground/background state.
+ *
+ * @since 1.0.0
+ */
+@FunctionalInterface
+public interface SessionLifecycleHandler {
+
+    /**
+     * Called when a session lifecycle event occurs.
+     *
+     * @param event
+     *            the lifecycle event
+     */
+    void onLifecycleEvent(SessionLifecycleEvent event);
+}

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

@@ -0,0 +1,52 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.json;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Response from session.setForeground RPC call.
+ * <p>
+ * This is only available when connecting to a server running in TUI+server mode
+ * (--ui-server).
+ *
+ * @since 1.0.0
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class SetForegroundSessionResponse {
+
+    @JsonProperty("success")
+    private boolean success;
+
+    @JsonProperty("error")
+    private String error;
+
+    /**
+     * Whether the operation was successful.
+     *
+     * @return true if successful
+     */
+    public boolean isSuccess() {
+        return success;
+    }
+
+    public void setSuccess(boolean success) {
+        this.success = success;
+    }
+
+    /**
+     * Gets the error message if the operation failed.
+     *
+     * @return the error message, or null if successful
+     */
+    public String getError() {
+        return error;
+    }
+
+    public void setError(String error) {
+        this.error = error;
+    }
+}