*   <li>If a new edge needs to be created, the outgoing edges of the acquired locks are traversed
 *       to check for a cycle that reaches the lock to be acquired. If no cycle is detected, a new
 *       "safe" edge is created.
 *   <li>If a cycle is detected, an "unsafe" (cyclic) edge is created to represent a potential
 *       deadlock situation, and the appropriate Policy is executed.
 * </ul>
 *

     */
    boolean isAvailable();

    // RAG workflow methods

    /**
     * Detects the intent of a user message.
     *
     * @param userMessage the user's message
     * @return the detected intent with extracted keywords
     */
    IntentDetectionResult detectIntent(String userMessage);

    /**
     * Detects the intent of a user message with conversation history context.
     *

        }
        return client;
    }

    // RAG workflow delegation methods

    /**
     * Detects the intent of a user message using the configured LLM client.
     *
     * @param userMessage the user's message
     * @return the detected intent with extracted keywords
     * @throws LlmException if LLM is not available
     */

        doc.put("content", "xyz");

        // Without a real detector, this will throw NullPointerException
        try {
            languageHelper.updateDocument(doc);
            fail("Should throw NullPointerException without detector");
        } catch (NullPointerException e) {
            // Expected since we don't have a detector
        }
    }

    @Test
    public void test_updateDocument_emptyDoc() {

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.llm;

/**
 * Represents the result of intent detection from user input.
 * Contains the detected intent type, Fess query, and other metadata.
 */
public class IntentDetectionResult {

    private final ChatIntent intent;
    private final String query;
    private final String documentUrl;

    NodeAndRemainingSuccessors(N node) {
      this.node = node;
    }
  }

  /**
   * Determines whether an edge has already been used during traversal. In the directed case a cycle
   * is always detected before reusing an edge, so no special logic is required. In the undirected
   * case, we must take care not to "backtrack" over an edge (i.e. going from A to B and then going
   * from B to A).
   */

async def stream_logs() -> AsyncIterable[ServerSentEvent]:
    logs = [
        "2025-01-01 INFO  Application started",
        "2025-01-01 DEBUG Connected to database",
        "2025-01-01 WARN  High memory usage detected",
    ]
    for log_line in logs:

            }
            if (isEmptyContentWithLengthFinish(response)) {
                logger.warn(
                        "[RAG:INTENT] Empty content with finish_reason=length detected (possible reasoning model token exhaustion). Falling back to search. userMessage={}",
                        userMessage);
                return IntentDetectionResult.fallbackSearch(userMessage);
            }

 * either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.llm;

/**
 * Represents the intent type detected from a user's chat message.
 */
public enum ChatIntent {

    /** User wants to search for documents in Fess */
    SEARCH("search"),

    /** User wants a summary of a specific document */

            "-Dorg.gradle.java.installations.auto-download=false",
            "-Porg.gradle.java.installations.auto-download=false",
            "-Dorg.gradle.java.installations.auto-detect=false",
            "-Porg.gradle.java.installations.auto-detect=false",
            "\"-Dorg.gradle.java.installations.paths=$expectedInstallationPaths\"",
            "\"-Porg.gradle.java.installations.paths=$expectedInstallationPaths\"",