Improve Javadoc for findSessionWithHooks and findSessionWithPermissionHandler

Agent-Logs-Url: https://github.com/github/copilot-sdk-java/sessions/868c6fed-c57d-4d9f-806c-eca509096672

Co-authored-by: brunoborges <129743+brunoborges@users.noreply.github.com>

Author: Copilot

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

@@ -337,6 +337,10 @@ private void handleHooksInvoke(JsonRpcClient rpc, String requestId, JsonNode par
      * When the CLI creates sub-agent sessions internally, their session IDs are not
      * in the SDK's session map. This method searches all registered sessions to
      * find one with hooks, enabling hook handlers to fire for sub-agent tool calls.
+     * <p>
+     * If multiple sessions have hooks registered, the first one found is returned.
+     * In practice, SDK users typically register hooks on a single session that
+     * covers all sub-agent activity.
      *
      * @return a session with hooks, or {@code null} if none found
      */
@@ -354,6 +358,10 @@ private CopilotSession findSessionWithHooks() {
      * <p>
      * Similar to {@link #findSessionWithHooks()}, this enables permission handlers
      * to fire for sub-agent sessions whose IDs are not tracked by the SDK.
+     * <p>
+     * If multiple sessions have permission handlers, the first one found is
+     * returned. In practice, SDK users typically register a single permission
+     * handler that covers all sub-agent activity.
      *
      * @return a session with a permission handler, or {@code null} if none found
      */