list() {
+ return caller.invoke("session.commands.list", java.util.Map.of("sessionId", this.sessionId), SessionCommandsListResult.class);
+ }
+
+ /**
+ * Invokes {@code session.commands.invoke}.
+ *
+ * Note: the {@code sessionId} field in the params record is overridden
+ * by the session-scoped wrapper; any value provided is ignored.
+ * @since 1.0.0
+ */
+ public CompletableFuture invoke(SessionCommandsInvokeParams params) {
+ com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params);
+ _p.put("sessionId", this.sessionId);
+ return caller.invoke("session.commands.invoke", _p, Void.class);
+ }
+
/**
* Invokes {@code session.commands.handlePendingCommand}.
*
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsInvokeParams.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsInvokeParams.java
new file mode 100644
index 0000000000..141ec9524d
--- /dev/null
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsInvokeParams.java
@@ -0,0 +1,31 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.sdk.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import javax.annotation.processing.Generated;
+
+/**
+ * Request parameters for the {@code session.commands.invoke} RPC method.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionCommandsInvokeParams(
+ /** Target session identifier */
+ @JsonProperty("sessionId") String sessionId,
+ /** Command name. Leading slashes are stripped and the name is matched case-insensitively. */
+ @JsonProperty("name") String name,
+ /** Raw input after the command name */
+ @JsonProperty("input") String input
+) {
+}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsListParams.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsListParams.java
new file mode 100644
index 0000000000..dd51f0e768
--- /dev/null
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsListParams.java
@@ -0,0 +1,27 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.sdk.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import javax.annotation.processing.Generated;
+
+/**
+ * Request parameters for the {@code session.commands.list} RPC method.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionCommandsListParams(
+ /** Target session identifier */
+ @JsonProperty("sessionId") String sessionId
+) {
+}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsListResult.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsListResult.java
new file mode 100644
index 0000000000..e819ba64c1
--- /dev/null
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionCommandsListResult.java
@@ -0,0 +1,28 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.sdk.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+import javax.annotation.processing.Generated;
+
+/**
+ * Result for the {@code session.commands.list} RPC method.
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SessionCommandsListResult(
+ /** Commands available in this session */
+ @JsonProperty("commands") List commands
+) {
+}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteApi.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteApi.java
index df458acda5..790e1a7255 100644
--- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteApi.java
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteApi.java
@@ -18,6 +18,8 @@
@javax.annotation.processing.Generated("copilot-sdk-codegen")
public final class SessionRemoteApi {
+ private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE;
+
private final RpcCaller caller;
private final String sessionId;
@@ -29,12 +31,17 @@ public final class SessionRemoteApi {
/**
* Invokes {@code session.remote.enable}.
+ *
+ * Note: the {@code sessionId} field in the params record is overridden
+ * by the session-scoped wrapper; any value provided is ignored.
*
* @apiNote This method is experimental and may change in a future version.
* @since 1.0.0
*/
- public CompletableFuture enable() {
- return caller.invoke("session.remote.enable", java.util.Map.of("sessionId", this.sessionId), SessionRemoteEnableResult.class);
+ public CompletableFuture enable(SessionRemoteEnableParams params) {
+ com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params);
+ _p.put("sessionId", this.sessionId);
+ return caller.invoke("session.remote.enable", _p, SessionRemoteEnableResult.class);
}
/**
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteEnableParams.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteEnableParams.java
index d8b7917b78..aa1fff7a23 100644
--- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteEnableParams.java
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionRemoteEnableParams.java
@@ -22,6 +22,8 @@
@JsonIgnoreProperties(ignoreUnknown = true)
public record SessionRemoteEnableParams(
/** Target session identifier */
- @JsonProperty("sessionId") String sessionId
+ @JsonProperty("sessionId") String sessionId,
+ /** Per-session remote mode. "off" disables remote, "export" exports session events to Mission Control without enabling remote steering, "on" enables both export and remote steering. */
+ @JsonProperty("mode") RemoteSessionMode mode
) {
}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsApi.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsApi.java
index b32419a3e6..6f46d19d75 100644
--- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsApi.java
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsApi.java
@@ -75,8 +75,8 @@ public CompletableFuture disable(SessionSkillsDisableParams params) {
* @apiNote This method is experimental and may change in a future version.
* @since 1.0.0
*/
- public CompletableFuture reload() {
- return caller.invoke("session.skills.reload", java.util.Map.of("sessionId", this.sessionId), Void.class);
+ public CompletableFuture reload() {
+ return caller.invoke("session.skills.reload", java.util.Map.of("sessionId", this.sessionId), SessionSkillsReloadResult.class);
}
}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadResult.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadResult.java
index 1bfca46e1a..1333d57cc1 100644
--- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadResult.java
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionSkillsReloadResult.java
@@ -10,6 +10,7 @@
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
import javax.annotation.processing.Generated;
/**
@@ -20,5 +21,10 @@
@javax.annotation.processing.Generated("copilot-sdk-codegen")
@JsonInclude(JsonInclude.Include.NON_NULL)
@JsonIgnoreProperties(ignoreUnknown = true)
-public record SessionSkillsReloadResult() {
+public record SessionSkillsReloadResult(
+ /** Warnings emitted while loading skills (e.g. skills that loaded but had issues) */
+ @JsonProperty("warnings") List warnings,
+ /** Errors emitted while loading skills (e.g. skills that failed to load entirely) */
+ @JsonProperty("errors") List errors
+) {
}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkParams.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkParams.java
index 06ea46c932..644be05ee0 100644
--- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkParams.java
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkParams.java
@@ -24,6 +24,8 @@ public record SessionsForkParams(
/** Source session ID to fork from */
@JsonProperty("sessionId") String sessionId,
/** Optional event ID boundary. When provided, the fork includes only events before this ID (exclusive). When omitted, all events are included. */
- @JsonProperty("toEventId") String toEventId
+ @JsonProperty("toEventId") String toEventId,
+ /** Optional friendly name to assign to the forked session. */
+ @JsonProperty("name") String name
) {
}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkResult.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkResult.java
index 911574f568..77543916ec 100644
--- a/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkResult.java
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SessionsForkResult.java
@@ -22,6 +22,8 @@
@JsonIgnoreProperties(ignoreUnknown = true)
public record SessionsForkResult(
/** The new forked session's ID */
- @JsonProperty("sessionId") String sessionId
+ @JsonProperty("sessionId") String sessionId,
+ /** Friendly name assigned to the forked session, if any. */
+ @JsonProperty("name") String name
) {
}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInfo.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInfo.java
new file mode 100644
index 0000000000..e494f4894c
--- /dev/null
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInfo.java
@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.sdk.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+import javax.annotation.processing.Generated;
+
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SlashCommandInfo(
+ /** Canonical command name without a leading slash */
+ @JsonProperty("name") String name,
+ /** Canonical aliases without leading slashes */
+ @JsonProperty("aliases") List aliases,
+ /** Human-readable command description */
+ @JsonProperty("description") String description,
+ /** Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command */
+ @JsonProperty("kind") SlashCommandKind kind,
+ /** Optional unstructured input hint */
+ @JsonProperty("input") SlashCommandInput input,
+ /** Whether the command may run while an agent turn is active */
+ @JsonProperty("allowDuringAgentExecution") Boolean allowDuringAgentExecution,
+ /** Whether the command is experimental */
+ @JsonProperty("experimental") Boolean experimental
+) {
+}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInput.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInput.java
new file mode 100644
index 0000000000..186dec5a81
--- /dev/null
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInput.java
@@ -0,0 +1,33 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.sdk.generated.rpc;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import javax.annotation.processing.Generated;
+
+/**
+ * Optional unstructured input hint
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public record SlashCommandInput(
+ /** Hint to display when command input has not been provided */
+ @JsonProperty("hint") String hint,
+ /** When true, the command requires non-empty input; clients should render the input hint as required */
+ @JsonProperty("required") Boolean required,
+ /** Optional completion hint for the input (e.g. 'directory' for filesystem path completion) */
+ @JsonProperty("completion") SlashCommandInputCompletion completion,
+ /** When true, clients should pass the full text after the command name as a single argument rather than splitting on whitespace */
+ @JsonProperty("preserveMultilineInput") Boolean preserveMultilineInput
+) {
+}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInputCompletion.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInputCompletion.java
new file mode 100644
index 0000000000..c192fa9c0f
--- /dev/null
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandInputCompletion.java
@@ -0,0 +1,33 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.sdk.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Optional completion hint for the input (e.g. 'directory' for filesystem path completion)
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum SlashCommandInputCompletion {
+ /** The {@code directory} variant. */
+ DIRECTORY("directory");
+
+ private final String value;
+ SlashCommandInputCompletion(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static SlashCommandInputCompletion fromValue(String value) {
+ for (SlashCommandInputCompletion v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown SlashCommandInputCompletion value: " + value);
+ }
+}
diff --git a/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandKind.java b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandKind.java
new file mode 100644
index 0000000000..1f08c4efcd
--- /dev/null
+++ b/src/generated/java/com/github/copilot/sdk/generated/rpc/SlashCommandKind.java
@@ -0,0 +1,37 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from: api.schema.json
+
+package com.github.copilot.sdk.generated.rpc;
+
+import javax.annotation.processing.Generated;
+
+/**
+ * Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command
+ *
+ * @since 1.0.0
+ */
+@javax.annotation.processing.Generated("copilot-sdk-codegen")
+public enum SlashCommandKind {
+ /** The {@code builtin} variant. */
+ BUILTIN("builtin"),
+ /** The {@code skill} variant. */
+ SKILL("skill"),
+ /** The {@code client} variant. */
+ CLIENT("client");
+
+ private final String value;
+ SlashCommandKind(String value) { this.value = value; }
+ @com.fasterxml.jackson.annotation.JsonValue
+ public String getValue() { return value; }
+ @com.fasterxml.jackson.annotation.JsonCreator
+ public static SlashCommandKind fromValue(String value) {
+ for (SlashCommandKind v : values()) {
+ if (v.value.equals(value)) return v;
+ }
+ throw new IllegalArgumentException("Unknown SlashCommandKind value: " + value);
+ }
+}
diff --git a/src/main/java/com/github/copilot/sdk/json/InputOptions.java b/src/main/java/com/github/copilot/sdk/json/InputOptions.java
index 9b0b6c8dd8..43b29c53b9 100644
--- a/src/main/java/com/github/copilot/sdk/json/InputOptions.java
+++ b/src/main/java/com/github/copilot/sdk/json/InputOptions.java
@@ -4,12 +4,15 @@
package com.github.copilot.sdk.json;
+import com.fasterxml.jackson.annotation.JsonInclude;
+
/**
* Options for the {@link SessionUiApi#input(String, InputOptions)} convenience
* method.
*
* @since 1.0.0
*/
+@JsonInclude(JsonInclude.Include.NON_NULL)
public class InputOptions {
private String title;
diff --git a/src/main/java/com/github/copilot/sdk/json/SessionUiCapabilities.java b/src/main/java/com/github/copilot/sdk/json/SessionUiCapabilities.java
index 9b8e0b5872..8df70c0502 100644
--- a/src/main/java/com/github/copilot/sdk/json/SessionUiCapabilities.java
+++ b/src/main/java/com/github/copilot/sdk/json/SessionUiCapabilities.java
@@ -4,11 +4,14 @@
package com.github.copilot.sdk.json;
+import com.fasterxml.jackson.annotation.JsonInclude;
+
/**
* UI-specific capability flags for a session.
*
* @since 1.0.0
*/
+@JsonInclude(JsonInclude.Include.NON_NULL)
public class SessionUiCapabilities {
private Boolean elicitation;
diff --git a/src/main/java/com/github/copilot/sdk/json/TelemetryConfig.java b/src/main/java/com/github/copilot/sdk/json/TelemetryConfig.java
index 8407ab6098..d387128696 100644
--- a/src/main/java/com/github/copilot/sdk/json/TelemetryConfig.java
+++ b/src/main/java/com/github/copilot/sdk/json/TelemetryConfig.java
@@ -4,6 +4,8 @@
package com.github.copilot.sdk.json;
+import com.fasterxml.jackson.annotation.JsonInclude;
+
/**
* OpenTelemetry configuration for the Copilot CLI server.
*
@@ -21,6 +23,7 @@
* @see CopilotClientOptions#setTelemetry(TelemetryConfig)
* @since 1.2.0
*/
+@JsonInclude(JsonInclude.Include.NON_NULL)
public class TelemetryConfig {
private String otlpEndpoint;
diff --git a/src/main/java/com/github/copilot/sdk/json/UserInputRequest.java b/src/main/java/com/github/copilot/sdk/json/UserInputRequest.java
index 9b466f866c..85e0b26bdc 100644
--- a/src/main/java/com/github/copilot/sdk/json/UserInputRequest.java
+++ b/src/main/java/com/github/copilot/sdk/json/UserInputRequest.java
@@ -8,6 +8,7 @@
import java.util.List;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.annotation.JsonProperty;
/**
@@ -19,6 +20,7 @@
* @since 1.0.6
*/
@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
public class UserInputRequest {
@JsonProperty("question")
diff --git a/src/test/java/com/github/copilot/sdk/JsonIncludeNonNullTest.java b/src/test/java/com/github/copilot/sdk/JsonIncludeNonNullTest.java
new file mode 100644
index 0000000000..7465507f50
--- /dev/null
+++ b/src/test/java/com/github/copilot/sdk/JsonIncludeNonNullTest.java
@@ -0,0 +1,159 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+import org.junit.jupiter.api.Test;
+
+import com.github.copilot.sdk.json.CopilotClientOptions;
+import com.github.copilot.sdk.json.CustomAgentConfig;
+import com.github.copilot.sdk.json.InfiniteSessionConfig;
+import com.github.copilot.sdk.json.InputOptions;
+import com.github.copilot.sdk.json.ModelCapabilitiesOverride;
+import com.github.copilot.sdk.json.ProviderConfig;
+import com.github.copilot.sdk.json.ResumeSessionConfig;
+import com.github.copilot.sdk.json.SessionConfig;
+import com.github.copilot.sdk.json.SessionUiCapabilities;
+import com.github.copilot.sdk.json.TelemetryConfig;
+import com.github.copilot.sdk.json.UserInputRequest;
+
+/**
+ * Verifies that public DTO classes in the {@code com.github.copilot.sdk.json}
+ * package are annotated with {@code @JsonInclude(JsonInclude.Include.NON_NULL)}
+ * so that null-valued fields are omitted during JSON serialization.
+ */
+class JsonIncludeNonNullTest {
+
+ private static final ObjectMapper MAPPER = new ObjectMapper();
+
+ // --- Annotation presence checks ---
+
+ @Test
+ void copilotClientOptionsHasNonNullAnnotation() {
+ assertHasNonNullInclude(CopilotClientOptions.class);
+ }
+
+ @Test
+ void sessionConfigHasNonNullAnnotation() {
+ assertHasNonNullInclude(SessionConfig.class);
+ }
+
+ @Test
+ void resumeSessionConfigHasNonNullAnnotation() {
+ assertHasNonNullInclude(ResumeSessionConfig.class);
+ }
+
+ @Test
+ void infiniteSessionConfigHasNonNullAnnotation() {
+ assertHasNonNullInclude(InfiniteSessionConfig.class);
+ }
+
+ @Test
+ void inputOptionsHasNonNullAnnotation() {
+ assertHasNonNullInclude(InputOptions.class);
+ }
+
+ @Test
+ void modelCapabilitiesOverrideHasNonNullAnnotation() {
+ assertHasNonNullInclude(ModelCapabilitiesOverride.class);
+ }
+
+ @Test
+ void providerConfigHasNonNullAnnotation() {
+ assertHasNonNullInclude(ProviderConfig.class);
+ }
+
+ @Test
+ void telemetryConfigHasNonNullAnnotation() {
+ assertHasNonNullInclude(TelemetryConfig.class);
+ }
+
+ @Test
+ void sessionUiCapabilitiesHasNonNullAnnotation() {
+ assertHasNonNullInclude(SessionUiCapabilities.class);
+ }
+
+ @Test
+ void customAgentConfigHasNonNullAnnotation() {
+ assertHasNonNullInclude(CustomAgentConfig.class);
+ }
+
+ @Test
+ void userInputRequestHasNonNullAnnotation() {
+ assertHasNonNullInclude(UserInputRequest.class);
+ }
+
+ // --- Serialization tests: null fields are omitted ---
+
+ @Test
+ void inputOptionsOmitsNullFieldsInJson() throws JsonProcessingException {
+ var opts = new InputOptions();
+ String json = MAPPER.writeValueAsString(opts);
+ assertEquals("{}", json, "All-null InputOptions should serialize to empty JSON");
+ }
+
+ @Test
+ void telemetryConfigOmitsNullFieldsInJson() throws JsonProcessingException {
+ var config = new TelemetryConfig();
+ String json = MAPPER.writeValueAsString(config);
+ assertEquals("{}", json, "All-null TelemetryConfig should serialize to empty JSON");
+ }
+
+ @Test
+ void sessionUiCapabilitiesOmitsNullFieldsInJson() throws JsonProcessingException {
+ var caps = new SessionUiCapabilities();
+ String json = MAPPER.writeValueAsString(caps);
+ assertEquals("{}", json, "All-null SessionUiCapabilities should serialize to empty JSON");
+ }
+
+ @Test
+ void userInputRequestOmitsNullFieldsInJson() throws JsonProcessingException {
+ var req = new UserInputRequest();
+ String json = MAPPER.writeValueAsString(req);
+ assertFalse(json.contains("null"), "UserInputRequest with no fields set should not contain 'null' values");
+ }
+
+ @Test
+ void inputOptionsIncludesSetFieldsInJson() throws JsonProcessingException {
+ var opts = new InputOptions();
+ opts.setMinLength(5);
+ opts.setMaxLength(100);
+ String json = MAPPER.writeValueAsString(opts);
+ assertTrue(json.contains("\"minLength\":5"), "Set minLength should appear in JSON");
+ assertTrue(json.contains("\"maxLength\":100"), "Set maxLength should appear in JSON");
+ assertFalse(json.contains("\"title\""), "Unset title should be omitted from JSON");
+ }
+
+ @Test
+ void telemetryConfigIncludesSetFieldsInJson() throws JsonProcessingException {
+ var config = new TelemetryConfig();
+ config.setOtlpEndpoint("http://localhost:4318");
+ String json = MAPPER.writeValueAsString(config);
+ assertTrue(json.contains("\"otlpEndpoint\":\"http://localhost:4318\""),
+ "Set otlpEndpoint should appear in JSON");
+ assertFalse(json.contains("\"filePath\""), "Unset filePath should be omitted from JSON");
+ }
+
+ @Test
+ void sessionUiCapabilitiesIncludesSetFieldsInJson() throws JsonProcessingException {
+ var caps = new SessionUiCapabilities();
+ caps.setElicitation(true);
+ String json = MAPPER.writeValueAsString(caps);
+ assertTrue(json.contains("\"elicitation\":true"), "Set elicitation should appear in JSON");
+ }
+
+ private void assertHasNonNullInclude(Class clazz) {
+ JsonInclude annotation = clazz.getAnnotation(JsonInclude.class);
+ assertNotNull(annotation, clazz.getSimpleName() + " should be annotated with @JsonInclude");
+ assertEquals(JsonInclude.Include.NON_NULL, annotation.value(),
+ clazz.getSimpleName() + " @JsonInclude should use Include.NON_NULL");
+ }
+
+}