*
     * @param reasoning the detection reasoning
     * @return the unclear intent result
     */
    public static IntentDetectionResult unclear(final String reasoning) {
        return new IntentDetectionResult(ChatIntent.UNCLEAR, null, null, reasoning);
    }

    /**
     * Creates a fallback search intent when intent detection fails.
     *
     * @param originalMessage the original user message

### Helpers

- **RobotsTxtHelper**: RFC 9309 parsing, user-agent matching, crawl-delay, sitemaps
- **SitemapsHelper**: Sitemap XML parsing, index handling
- **MimeTypeHelper**: MIME detection via Tika
- **EncodingHelper**: Charset detection with BOM
- **UrlConvertHelper**: URL normalization
- **ContentLengthHelper**: Content length limits per MIME type

---

## Development Workflow

### Build Commands

```bash

      }
    },

    /**
     * Disables cycle detection. This option causes the factory to return unmodified lock
     * implementations provided by the JDK, and is provided to allow applications to easily
     * parameterize when cycle detection is enabled.
     *
     * <p>Note that locks created by a factory with this policy will not participate the
     * cycle detection performed by locks created by other factories.
     */

            throw new LlmException("systemPrompt is not configured for " + getName());
        }
        return systemPrompt;
    }

    /**
     * Gets the intent detection prompt template.
     *
     * @return the intent detection prompt
     */
    protected String getIntentDetectionPrompt() {
        if (intentDetectionPrompt == null) {

### Application Discovery { #application-discovery }

By default, the extension will automatically discover FastAPI applications in your workspace by scanning for files that instantiate `FastAPI()`. If auto-detection doesn't work for your project structure, you can specify an entrypoint via `[tool.fastapi]` in `pyproject.toml` or the `fastapi.entryPoint` VS Code setting using module notation (e.g. `myapp.main:app`).

## Features { #features }

    }

    /**
     * Checks if the given URL is a file path protocol that requires directory and permission handling.
     * Used for incremental crawling directory detection and file permission processing.
     *
     * @param url the URL to check
     * @return true if the URL uses a file path protocol (smb, smb1, file, ftp, s3, gcs)
     */

        webApiRequest = new WebApiRequest(mockRequest, customPath);

        assertEquals(originalPath, webApiRequest.getServletPath());
    }

    // Test edge cases for SAStruts.method detection
    @Test
    public void test_getServletPath_withSAStrutsMethodSubstring_returnsSuperPath() {
        final String originalPath = "/original/path";
        final String customPath = "/api/v1/search";

        final ChatMessage userChatMessage = ChatMessage.userMessage(userMessage);
        session.addMessage(userChatMessage);

        try {
            // Intent detection
            final IntentDetectionResult intentResult = llmClientManager.detectIntent(userMessage, history);
            if (logger.isDebugEnabled()) {

    assertThat(expected.getCause()).isEqualTo(firstException.getCause());
    // lockA should work after lockB is released.
    lockB.unlock();
    lockA.lock();
  }

  // Tests transitive deadlock detection.
  public void testDeadlock_threeLocks() {
    // Establish an ordering from lockA -> lockB.
    lockA.lock();
    lockB.lock();
    lockB.unlock();
    lockA.unlock();

    assertThat(expected.getCause()).isEqualTo(firstException.getCause());
    // lockA should work after lockB is released.
    lockB.unlock();
    lockA.lock();
  }

  // Tests transitive deadlock detection.
  public void testDeadlock_threeLocks() {
    // Establish an ordering from lockA -> lockB.
    lockA.lock();
    lockB.lock();
    lockB.unlock();
    lockA.unlock();