LCORE-1608: updated docs for src folders

src/app/endpoints/README.md

@@ -30,6 +30,9 @@ Handler for REST API call to provide info.
 ## [mcp_auth.py](mcp_auth.py)
 Handler for REST API calls related to MCP server authentication.
 
+## [mcp_servers.py](mcp_servers.py)
+Handler for REST API calls to dynamically manage MCP servers.
+
 ## [metrics.py](metrics.py)
 Handler for REST API call to provide metrics.
 
@@ -45,6 +48,9 @@ Handler for REST API call to provide answer to query using Response API.
 ## [rags.py](rags.py)
 Handler for REST API calls to list and retrieve available RAGs.
 
+## [responses.py](responses.py)
+Handler for REST API call to provide answer using Responses API (LCORE specification).
+
 ## [rlsapi_v1.py](rlsapi_v1.py)
 Handler for RHEL Lightspeed rlsapi v1 REST API endpoints.
 
@@ -54,6 +60,9 @@ Handler for the / endpoint.
 ## [shields.py](shields.py)
 Handler for REST API call to list available shields.
 
+## [stream_interrupt.py](stream_interrupt.py)
+Endpoint for interrupting in-progress streaming query requests.
+
 ## [streaming_query.py](streaming_query.py)
 Streaming query handler using Responses API.
 

src/utils/README.md

@@ -28,7 +28,7 @@ Utilities for resolving MCP server authorization headers.
 MCP headers handling.
 
 ## [mcp_oauth_probe.py](mcp_oauth_probe.py)
-Probe MCP server for OAuth and raise 401 with WWW-Authenticate when required.
+Probe MCP servers for OAuth and raise 401 with WWW-Authenticate when required.
 
 ## [prompts.py](prompts.py)
 Utility functions for system prompts.
@@ -48,6 +48,9 @@ Function to dump the configuration schema into OpenAPI-compatible format.
 ## [shields.py](shields.py)
 Utility functions for working with Llama Stack shields.
 
+## [stream_interrupts.py](stream_interrupts.py)
+In-memory registry for interrupting active streaming requests.
+
 ## [suid.py](suid.py)
 Session ID utility functions.
 

tests/e2e/features/steps/README.md

@@ -27,9 +27,24 @@ Implementation of common test steps.
 ## [llm_query_response.py](llm_query_response.py)
 LLM query and response steps.
 
+## [models.py](models.py)
+Steps for /models endpoint.
+
+## [place_holder.py](place_holder.py)
+Implementation of placeholder test steps.
+
+## [proxy.py](proxy.py)
+Step definitions for proxy and TLS networking e2e tests.
+
 ## [rbac.py](rbac.py)
 Step definitions for RBAC E2E tests.
 
+## [responses_steps.py](responses_steps.py)
+Behave steps for POST /v1/responses (LCORE Responses API) multi-turn tests.
+
+## [rlsapi_v1.py](rlsapi_v1.py)
+rlsapi v1 endpoint test steps.
+
 ## [token_counters.py](token_counters.py)
 Step definitions for token counter validation.
 

tests/e2e/features/steps/place_holder.py

@@ -1,4 +1,4 @@
-"""Implementation of place holder test steps."""
+"""Implementation of placeholder test steps."""
 
 from behave import given  # pyright: ignore[reportAttributeAccessIssue]
 from behave.runner import Context

tests/e2e/mock_mcp_server/README.md

@@ -0,0 +1,5 @@
+# List of source files stored in `tests/e2e/mock_mcp_server` directory
+
+## [server.py](server.py)
+Minimal mock MCP server for E2E tests with OAuth support.
+

tests/e2e/proxy/README.md

@@ -0,0 +1,11 @@
+# List of source files stored in `tests/e2e/proxy` directory
+
+## [__init__.py](__init__.py)
+Test proxy infrastructure for e2e networking tests.
+
+## [interception_proxy.py](interception_proxy.py)
+Minimal TLS-intercepting (MITM) proxy for e2e testing.
+
+## [tunnel_proxy.py](tunnel_proxy.py)
+Minimal HTTP CONNECT tunnel proxy for e2e testing.
+

tests/e2e/secrets/README.md

@@ -0,0 +1,18 @@
+# List of source files stored in `tests/e2e/secrets` directory
+
+# E2E Test Secrets
+
+This directory contains mock secrets and test fixtures used for end-to-end testing.
+These are **not** production secrets and are safe to commit to version control.
+
+## Contents
+
+- Mock authentication tokens for testing
+- Test certificates and keys
+- Sample configuration files with placeholder credentials
+
+## Usage
+
+These files are automatically loaded by the E2E test suite to simulate
+secure credential handling without exposing real secrets.
+

tests/e2e/utils/README.md

@@ -1,5 +1,11 @@
 # List of source files stored in `tests/e2e/utils` directory
 
+## [llama_stack_utils.py](llama_stack_utils.py)
+E2E test utilities for Llama Stack (toolgroups and shields).
+
+## [prow_utils.py](prow_utils.py)
+Prow/OpenShift-specific utility functions for E2E tests.
+
 ## [utils.py](utils.py)
 Unsorted utility functions to be used from other sources and test step definitions.
 

tests/integration/endpoints/README.md

@@ -3,6 +3,9 @@
 ## [__init__.py](__init__.py)
 Integration tests for API endpoints.
 
+## [test_authorized_endpoint.py](test_authorized_endpoint.py)
+Integration tests for the /authorized endpoint.
+
 ## [test_config_integration.py](test_config_integration.py)
 Integration tests for the /config endpoint.
 
@@ -15,9 +18,27 @@ Integration tests for the /info endpoint.
 ## [test_model_list.py](test_model_list.py)
 Integration tests for the /models endpoint (using Responses API).
 
-## [test_query_v2_integration.py](test_query_v2_integration.py)
+## [test_query_byok_integration.py](test_query_byok_integration.py)
+Integration tests for /query endpoint BYOK inline and tool RAG functionality.
+
+## [test_query_integration.py](test_query_integration.py)
 Integration tests for the /query endpoint (using Responses API).
 
 ## [test_rlsapi_v1_integration.py](test_rlsapi_v1_integration.py)
 Integration tests for the rlsapi v1 /infer endpoint.
 
+## [test_root_endpoint.py](test_root_endpoint.py)
+Integration tests for the /root endpoint.
+
+## [test_stream_interrupt_integration.py](test_stream_interrupt_integration.py)
+Integration tests for the streaming query interrupt lifecycle.
+
+## [test_streaming_query_byok_integration.py](test_streaming_query_byok_integration.py)
+Integration tests for /streaming_query endpoint BYOK inline and tool RAG functionality.
+
+## [test_streaming_query_integration.py](test_streaming_query_integration.py)
+Integration tests for the /streaming_query endpoint (using Responses API).
+
+## [test_tools_integration.py](test_tools_integration.py)
+Integration tests for the /tools endpoint.
+

tests/integration/endpoints/test_query_byok_integration.py

@@ -1,4 +1,4 @@
-"""Integration tests for /query endpoint BYOK inline and tool RAG functionality."""
+"""Integration tests for the /query endpoint BYOK inline and tool RAG functionality."""
 
 # pylint: disable=too-many-lines
 

tests/integration/endpoints/test_streaming_query_byok_integration.py

@@ -1,4 +1,4 @@
-"""Integration tests for /streaming_query endpoint BYOK inline and tool RAG functionality."""
+"""Integration tests for the /streaming_query endpoint BYOK inline and tool RAG functionality."""
 
 # pylint: disable=too-many-lines
 

tests/unit/app/README.md

@@ -7,7 +7,7 @@ Init of tests/unit/app.
 Unit tests for app.database module.
 
 ## [test_main_middleware.py](test_main_middleware.py)
-Unit tests for the global exception middleware in main.py.
+Unit tests for the pure ASGI middlewares in main.py.
 
 ## [test_routers.py](test_routers.py)
 Unit tests for routers.py.

tests/unit/app/endpoints/README.md

@@ -3,6 +3,9 @@
 ## [__init__.py](__init__.py)
 Unit tests for endpoints implementations.
 
+## [conftest.py](conftest.py)
+Shared pytest fixtures for endpoint unit tests.
+
 ## [test_a2a.py](test_a2a.py)
 Unit tests for the A2A (Agent-to-Agent) protocol endpoints.
 
@@ -30,6 +33,9 @@ Unit tests for the /info REST API endpoint.
 ## [test_mcp_auth.py](test_mcp_auth.py)
 Unit tests for MCP auth endpoint.
 
+## [test_mcp_servers.py](test_mcp_servers.py)
+Unit tests for the MCP servers dynamic registration endpoint.
+
 ## [test_metrics.py](test_metrics.py)
 Unit tests for the /metrics REST API endpoint.
 
@@ -45,6 +51,9 @@ Unit tests for the /query (v2) REST API endpoint using Responses API.
 ## [test_rags.py](test_rags.py)
 Unit tests for the /rags REST API endpoints.
 
+## [test_responses.py](test_responses.py)
+Unit tests for the /responses REST API endpoint (LCORE Responses API).
+
 ## [test_rlsapi_v1.py](test_rlsapi_v1.py)
 Unit tests for the rlsapi v1 /infer REST API endpoint.
 
@@ -54,6 +63,9 @@ Unit tests for the / endpoint handler.
 ## [test_shields.py](test_shields.py)
 Unit tests for the /shields REST API endpoint.
 
+## [test_stream_interrupt.py](test_stream_interrupt.py)
+Unit tests for streaming query interrupt endpoint.
+
 ## [test_streaming_query.py](test_streaming_query.py)
 Unit tests for the /streaming_query (v2) endpoint using Responses API.
 

tests/unit/models/config/README.md

@@ -51,6 +51,9 @@ Unit tests for QuotaLimiterConfig model.
 ## [test_quota_scheduler_config.py](test_quota_scheduler_config.py)
 Unit tests for QuotaSchedulerConfig model.
 
+## [test_rag_configuration.py](test_rag_configuration.py)
+Unit tests for RAG and OKP configuration models.
+
 ## [test_service_configuration.py](test_service_configuration.py)
 Unit tests for ServiceConfiguration model.
 

tests/unit/models/responses/README.md

@@ -13,7 +13,7 @@ Unit tests for all error response models.
 Unit tests for QueryResponse model.
 
 ## [test_rag_chunk.py](test_rag_chunk.py)
-Unit tests for RAGChunk model.
+Unit tests for RAGChunk and RAGContext models.
 
 ## [test_response_types.py](test_response_types.py)
 Unit tests for response-related type models defined in models/responses.py.

tests/unit/utils/README.md

@@ -45,9 +45,15 @@ Unit tests for utils/shields.py functions.
 ## [test_suid.py](test_suid.py)
 Unit tests for functions defined in utils.suid module.
 
+## [test_tool_formatter.py](test_tool_formatter.py)
+Unit tests for tool_formatter utilities.
+
 ## [test_transcripts.py](test_transcripts.py)
 Unit tests for functions defined in utils.transcripts module.
 
 ## [test_types.py](test_types.py)
 Unit tests for functions and types defined in utils/types.py.
 
+## [test_vector_search.py](test_vector_search.py)
+Unit tests for vector search utilities.
+