feat: 新增 session 分页查询与按 title 精确查找能力

- listSessions(search, limit, start): 服务端 search/limit/start 过滤，对齐 Hermes listSessions 分页能力
- findSessionByTitle(title): 服务端预过滤 + 客户端精确匹配，支持「先找现有 session、找不到再创建」复用场景
- 提取 checkSuccess 私有方法复用错误检查逻辑

Author: loong10k

src/main/java/io/github/hiwepy/opencode/OpenCodeClient.java

@@ -67,6 +67,16 @@ public List<Session> listSessions() {
         return httpClient.listSessions();
     }
 
+    /** 分页/过滤列出 sessions（服务端 search/limit/start 过滤）。 */
+    public List<Session> listSessions(String search, Integer limit, Integer start) {
+        return httpClient.listSessions(search, limit, start);
+    }
+
+    /** 按 title 精确查找 session，未命中返回 {@link java.util.Optional#empty()}。 */
+    public java.util.Optional<Session> findSessionByTitle(String title) {
+        return httpClient.findSessionByTitle(title);
+    }
+
     public boolean deleteSession(String sessionId) {
         return httpClient.deleteSession(sessionId);
     }

src/main/java/io/github/hiwepy/opencode/http/OpenCodeHttpClient.java

@@ -14,6 +14,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
+import java.util.Optional;
 
 /**
  * OpenCode Server HTTP 客户端，封装 REST API。
@@ -68,6 +69,42 @@ public List<Session> listSessions() {
         return getList("/session", new GenericType<List<Session>>() {});
     }
 
+    /**
+     * 分页/过滤列出 sessions，对齐 Hermes {@code listSessions(limit, offset, source, includeChildren)}。
+     * <p>OpenCode Server {@code GET /session} 支持 {@code search}、{@code limit}、{@code start} 查询参数，
+     * 避免全量拉取后再内存过滤。</p>
+     *
+     * @param search 服务端关键字过滤（匹配 title 等），为 null 则不过滤
+     * @param limit  最大返回条数，为 null 则不限制
+     * @param start  分页偏移量，为 null 则从 0 开始
+     * @return 匹配的 session 列表
+     */
+    public List<Session> listSessions(String search, Integer limit, Integer start) {
+        HttpRequest req = unirest.get(url("/session"));
+        if (search != null) req.queryString("search", search);
+        if (limit != null) req.queryString("limit", limit);
+        if (start != null) req.queryString("start", start);
+        HttpResponse<List<Session>> resp = req.asObject(new GenericType<List<Session>>() {});
+        checkSuccess(resp);
+        return resp.getBody();
+    }
+
+    /**
+     * 按 title 精确查找 session，用于「先找现有 session、找不到再创建」的复用场景。
+     * <p>先用 {@code search} 在服务端预过滤（减少传输量），再在客户端精确匹配 title。</p>
+     *
+     * @param title 期望的 session title
+     * @return 命中的第一个 session，未命中返回 {@link Optional#empty()}
+     */
+    public Optional<Session> findSessionByTitle(String title) {
+        if (title == null || title.isEmpty()) {
+            return Optional.empty();
+        }
+        return listSessions(title, 50, null).stream()
+                .filter(s -> Objects.equals(title, s.getTitle()))
+                .findFirst();
+    }
+
     public boolean deleteSession(String sessionId) {
         HttpResponse<String> resp = unirest.delete(url("/session/" + sessionId)).asString();
         return resp.isSuccess();
@@ -134,11 +171,15 @@ private <T> T get(String path, Class<T> type) {
 
     private <T> T getList(String path, GenericType<T> genericType) {
         HttpResponse<T> resp = unirest.get(url(path)).asObject(genericType);
+        checkSuccess(resp);
+        return resp.getBody();
+    }
+
+    private void checkSuccess(HttpResponse<?> resp) {
         if (!resp.isSuccess()) {
             throw new OpenCodeHttpException(resp.getStatus(),
                     resp.getBody() != null ? resp.getBody().toString() : "");
         }
-        return resp.getBody();
     }
 
     private <T> T post(String path, Object body, Class<T> type) {