package org.codelibs.fess.llm;

import org.codelibs.fess.exception.FessSystemException;

/**
 * Exception thrown when an error occurs during LLM operations.
 *
 * @author FessProject
 */
public class LlmException extends FessSystemException {

    private static final long serialVersionUID = 1L;

    /** Error code for rate limit (HTTP 429). */
    public static final String ERROR_RATE_LIMIT = "rate_limit";

    public void test_defaultMaxGroupDepth() {
        EntraIdAuthenticator authenticator = new EntraIdAuthenticator();

        // Test that default max depth (10) prevents deep recursion
        // Depth 100 should exceed default and return empty
        Pair<String[], String[]> result = authenticator.getParentGroup(null, "test-id", 100);
        assertNotNull(result);
        assertEquals(0, result.getFirst().length);

     */
    @Nonnull
    static <P extends BuilderProblem> ProblemCollector<P> create(int maxCountLimit) {
        return create(maxCountLimit, p -> true);
    }

    /**
     * Default implementation of the ProblemCollector interface.
     *
     * @param <P> the type of problem
     */
    class Impl<P extends BuilderProblem> implements ProblemCollector<P> {

      @Override
      void performAction(Random random, Iterable<? extends PrimitiveSink> sinks) {
        boolean value = random.nextBoolean();
        for (PrimitiveSink sink : sinks) {
          sink.putBoolean(value);
        }
      }
    },
    PUT_BYTE() {
      @Override
      void performAction(Random random, Iterable<? extends PrimitiveSink> sinks) {
        int value = random.nextInt();

 * This job extends ExecJob to provide Python-specific functionality for running
 * Python scripts with proper environment setup and argument passing.
 *
 * <p>Python scripts are executed in the WEB-INF/env/python/resources directory
 * and have access to the Fess system environment including OpenSearch URL and session ID.</p>
 */
public class PythonJob extends ExecJob {
    /** Logger instance for this class */

        }

        @Override
        public <T extends java.util.EventListener> void addListener(T t) {
        }

        @Override
        public void addListener(Class<? extends java.util.EventListener> listenerClass) {
        }

        @Override
        public <T extends java.util.EventListener> T createListener(Class<T> clazz) {
            return null;
        }

   *     previously called
   * @since 11.0
   */
  @GwtIncompatible // To be supported
  @CanIgnoreReturnValue // TODO(b/27479612): consider removing this
  public <K1 extends K, V1 extends V> CacheBuilder<K1, V1> weigher(
      Weigher<? super K1, ? super V1> weigher) {
    checkState(this.weigher == null);
    if (strictParsing) {
      checkState(
          this.maximumSize == UNSET_INT,

### I/O Layer

- **`ContentCache`**: In-memory or file-based caching. Implements `Closeable` and auto-deletes file cache on close.

- **`ContentOutputStream`**: Extends `DeferredFileOutputStream`. Writes to memory until threshold (default 1MB) exceeded, then spills to temp file.

## Technical Details

- **Java Version**: 17+
- **Dependencies**: Apache Commons IO (runtime), JUnit 4 (test)
- **Module Name**: `org.codelibs.curl4j`

   * @return the previous count of the element before the operation; possibly zero
   * @throws IllegalArgumentException if {@code occurrences} is negative, or if the resulting amount
   *     would exceed {@link Integer#MAX_VALUE}
   */
  @CanIgnoreReturnValue
  @Override
  public int add(E element, int occurrences) {
    checkNotNull(element);
    if (occurrences == 0) {
      return count(element);
    }

   * @return the previous count of the element before the operation; possibly zero
   * @throws IllegalArgumentException if {@code occurrences} is negative, or if the resulting amount
   *     would exceed {@link Integer#MAX_VALUE}
   */
  @CanIgnoreReturnValue
  @Override
  public int add(E element, int occurrences) {
    checkNotNull(element);
    if (occurrences == 0) {
      return count(element);
    }