refactor: standardize chat streaming API

Author: loong10k

src/main/java/io/github/easy4j/openclaw/OpenClawClient.java

@@ -239,10 +239,10 @@ public OpenClawClient(OpenClawHttpClientConfig httpConfig,
      */
     private void runStartupChecks(OpenClawHttpClientConfig httpConfig, OpenClawCliConfig cliConfig) {
         if (httpConfig.isEnabled() && httpConfig.isStartupCheckEnabled()
-                && OpenClawStrings.isNotBlank(httpConfig.getGatewayBaseUrl())) {
+                && OpenClawStrings.isNotBlank(httpConfig.getBaseUrl())) {
             try {
                 chatClient.health();
-                log.info("OpenClaw HTTP health check passed: {}", httpConfig.getGatewayBaseUrl());
+                log.info("OpenClaw HTTP health check passed: {}", httpConfig.getBaseUrl());
             } catch (Exception e) {
                 if (httpConfig.isFailFastOnUnavailable()) {
                     throw new IllegalStateException(

src/main/java/io/github/easy4j/openclaw/OpenClawHttpClientConfig.java

@@ -51,7 +51,7 @@ public class OpenClawHttpClientConfig {
     /**
  * Gateway HTTP root URL(Webhooks HTTP ), {@code http://localhost:18789}.
      */
-    private String gatewayBaseUrl = "http://localhost:18789";
+    private String baseUrl = "http://localhost:18789";
 
     /**
  * Gateway control planetoken( {@code gateway.auth.token} {@code OPENCLAW_GATEWAY_TOKEN}).
@@ -107,54 +107,6 @@ public class OpenClawHttpClientConfig {
     /** 遇到失效连接等传输故障时是否允许 OkHttp 自动恢复 */
     private boolean retryOnConnectionFailure = true;
 
-    /** @deprecated 使用 {@link #getStreamCorePoolSize()}。 */
-    @Deprecated
-    public int getSseCorePoolSize() {
-        return streamCorePoolSize;
-    }
-
-    /** @deprecated 使用 {@link #setStreamCorePoolSize(int)}。 */
-    @Deprecated
-    public void setSseCorePoolSize(int value) {
-        this.streamCorePoolSize = value;
-    }
-
-    /** @deprecated 使用 {@link #getStreamMaxPoolSize()}。 */
-    @Deprecated
-    public int getSseMaxPoolSize() {
-        return streamMaxPoolSize;
-    }
-
-    /** @deprecated 使用 {@link #setStreamMaxPoolSize(int)}。 */
-    @Deprecated
-    public void setSseMaxPoolSize(int value) {
-        this.streamMaxPoolSize = value;
-    }
-
-    /** @deprecated 使用 {@link #getStreamQueueCapacity()}。 */
-    @Deprecated
-    public int getSseQueueCapacity() {
-        return streamQueueCapacity;
-    }
-
-    /** @deprecated 使用 {@link #setStreamQueueCapacity(int)}。 */
-    @Deprecated
-    public void setSseQueueCapacity(int value) {
-        this.streamQueueCapacity = value;
-    }
-
-    /** @deprecated 使用 {@link #getStreamKeepAliveMillis()}。 */
-    @Deprecated
-    public long getSseKeepAliveMillis() {
-        return streamKeepAliveMillis;
-    }
-
-    /** @deprecated 使用 {@link #setStreamKeepAliveMillis(long)}。 */
-    @Deprecated
-    public void setSseKeepAliveMillis(long value) {
-        this.streamKeepAliveMillis = value;
-    }
-
     /**
  * Gateway HTTP Webhooks base path,Corresponds to {@code hooks.path}, {@code /hooks}.
      */

src/main/java/io/github/easy4j/openclaw/api/OpenClawHttpClient.java

@@ -225,7 +225,7 @@ protected <T> T parse(String json, Class<T> type, String label) {
  * Resolves the URL.
      */
     protected String resolveUrl(String path) {
-        String base = config.getGatewayBaseUrl();
+        String base = config.getBaseUrl();
         if (OpenClawStrings.isBlank(base)) {
             throw new OpenClawHttpException("gatewayBaseUrl is empty", null);
         }

src/main/java/io/github/easy4j/openclaw/api/OpenClawWebhookClient.java

@@ -115,7 +115,7 @@ private String resolveHooksSubPath(String subPath) {
     }
 
     private HttpResult postWebhook(String hookPath, Map<String, Object> body) {
-        String base = config.getGatewayBaseUrl();
+        String base = config.getBaseUrl();
         if (OpenClawStrings.isBlank(base)) throw new OpenClawHttpException("OpenClaw gatewayBaseUrl is empty", null);
         String url = base.replaceAll("/+$", "") + hookPath;
         String token = config.resolveHooksBearerToken();

src/main/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClient.java

@@ -33,7 +33,7 @@
  * <h3>example</h3>
  * <pre>{@code
  * OpenClawClientConfig config = new OpenClawClientConfig();
- * config.setGatewayBaseUrl("http://localhost:18789");
+ * config.setBaseUrl("http://localhost:18789");
  * config.setGatewayAuthToken("my-gateway-token");
  *
  * OpenClawGatewayWsClient ws = new OpenClawGatewayWsClient(config);
@@ -114,7 +114,7 @@ public OpenClawGatewayWsClient(OpenClawHttpClientConfig config, URI serverUri) {
     }
 
     private static URI buildWsUri(OpenClawHttpClientConfig config) {
-        String base = config.getGatewayBaseUrl();
+        String base = config.getBaseUrl();
         if (OpenClawStrings.isBlank(base)) {
             throw new IllegalArgumentException("gatewayBaseUrl is required for WebSocket connection");
         }

src/test/java/io/github/easy4j/openclaw/OpenClawHttpApiCoverageTest.java

@@ -52,7 +52,7 @@ class OpenClawHttpApiCoverageTest {
     @BeforeEach
     void setUp() {
         config = new OpenClawHttpClientConfig();
-        config.setGatewayBaseUrl("http://localhost:18789");
+        config.setBaseUrl("http://localhost:18789");
         config.setGatewayAuthToken("gateway-token");
         config.setHooksToken("hook-token");
         client = new OkHttpClient.Builder().addInterceptor(chain -> {
@@ -154,7 +154,7 @@ void shouldCoverResponsesEmbeddingsToolsAndBaseHttpErrors() {
         }
 
         OpenClawHttpClientConfig empty = new OpenClawHttpClientConfig();
-        empty.setGatewayBaseUrl(" ");
+        empty.setBaseUrl(" ");
         try (OpenClawChatClient chat = new OpenClawChatClient(empty, null, client)) {
             assertThrows(OpenClawHttpException.class, chat::health);
         }

src/test/java/io/github/easy4j/openclaw/OpenClawHttpClientConfigTest.java

@@ -11,10 +11,10 @@ void shouldExposeUnifiedStreamPropertiesAndLegacyAliases() {
         OpenClawHttpClientConfig config = new OpenClawHttpClientConfig();
         assertEquals(HttpResponseMode.BLOCKING, config.getMode());
 
-        config.setSseCorePoolSize(7);
-        config.setSseMaxPoolSize(9);
-        config.setSseQueueCapacity(11);
-        config.setSseKeepAliveMillis(13L);
+        config.setStreamCorePoolSize(7);
+        config.setStreamMaxPoolSize(9);
+        config.setStreamQueueCapacity(11);
+        config.setStreamKeepAliveMillis(13L);
 
         assertEquals(7, config.getStreamCorePoolSize());
         assertEquals(9, config.getStreamMaxPoolSize());

src/test/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClientIntegrationTest.java

@@ -46,7 +46,7 @@ void setUp() throws Exception {
         gateway.start();
         assertTrue(gateway.started.await(3, TimeUnit.SECONDS));
         OpenClawHttpClientConfig config = new OpenClawHttpClientConfig();
-        config.setGatewayBaseUrl("http://127.0.0.1:" + gateway.getPort());
+        config.setBaseUrl("http://127.0.0.1:" + gateway.getPort());
         config.setGatewayAuthToken("token");
         client = new OpenClawGatewayWsClient(config, URI.create("ws://127.0.0.1:" + gateway.getPort()));
     }

src/test/java/io/github/easy4j/openclaw/ws/OpenClawWsProtocolTest.java

@@ -186,7 +186,7 @@ void testSessionsListResultDeserialization() throws Exception {
     @Test
     void testWsUriBuilding() {
         OpenClawHttpClientConfig config = new OpenClawHttpClientConfig();
-        config.setGatewayBaseUrl("http://localhost:18789");
+        config.setBaseUrl("http://localhost:18789");
 
         OpenClawGatewayWsClient client = new OpenClawGatewayWsClient(config);
         assertEquals("ws://localhost:18789", client.getURI().toString());
@@ -195,7 +195,7 @@ void testWsUriBuilding() {
     @Test
     void testWsUriBuildingHttps() {
         OpenClawHttpClientConfig config = new OpenClawHttpClientConfig();
-        config.setGatewayBaseUrl("https://my-gateway.example.com");
+        config.setBaseUrl("https://my-gateway.example.com");
 
         OpenClawGatewayWsClient client = new OpenClawGatewayWsClient(config);
         assertEquals("wss://my-gateway.example.com", client.getURI().toString());
@@ -204,7 +204,7 @@ void testWsUriBuildingHttps() {
     @Test
     void testWsUriBuildingTrailingSlash() {
         OpenClawHttpClientConfig config = new OpenClawHttpClientConfig();
-        config.setGatewayBaseUrl("http://localhost:18789/");
+        config.setBaseUrl("http://localhost:18789/");
 
         OpenClawGatewayWsClient client = new OpenClawGatewayWsClient(config);
         assertEquals("ws://localhost:18789", client.getURI().toString());