diff --git a/src/app/endpoints/README.md b/src/app/endpoints/README.md index 99d8651c8..c33c051e7 100644 --- a/src/app/endpoints/README.md +++ b/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. diff --git a/src/utils/README.md b/src/utils/README.md index 2082b2abc..f35a7665b 100644 --- a/src/utils/README.md +++ b/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. diff --git a/tests/e2e/features/steps/README.md b/tests/e2e/features/steps/README.md index 4038c1b68..d433313b4 100644 --- a/tests/e2e/features/steps/README.md +++ b/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. diff --git a/tests/e2e/features/steps/place_holder.py b/tests/e2e/features/steps/place_holder.py index 34c1d0d65..6167fe68a 100644 --- a/tests/e2e/features/steps/place_holder.py +++ b/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 diff --git a/tests/e2e/mock_mcp_server/README.md b/tests/e2e/mock_mcp_server/README.md new file mode 100644 index 000000000..4236f7a14 --- /dev/null +++ b/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. + diff --git a/tests/e2e/proxy/README.md b/tests/e2e/proxy/README.md new file mode 100644 index 000000000..b3d88d75d --- /dev/null +++ b/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. + diff --git a/tests/e2e/secrets/README.md b/tests/e2e/secrets/README.md new file mode 100644 index 000000000..84f7e6486 --- /dev/null +++ b/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. + diff --git a/tests/e2e/utils/README.md b/tests/e2e/utils/README.md index 55f6e87de..da67f8159 100644 --- a/tests/e2e/utils/README.md +++ b/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. diff --git a/tests/integration/endpoints/README.md b/tests/integration/endpoints/README.md index 654623696..b777b30ca 100644 --- a/tests/integration/endpoints/README.md +++ b/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. + diff --git a/tests/integration/endpoints/test_query_byok_integration.py b/tests/integration/endpoints/test_query_byok_integration.py index 37214a20e..34676341b 100644 --- a/tests/integration/endpoints/test_query_byok_integration.py +++ b/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 diff --git a/tests/integration/endpoints/test_streaming_query_byok_integration.py b/tests/integration/endpoints/test_streaming_query_byok_integration.py index 47c7589ee..17b1c8c6c 100644 --- a/tests/integration/endpoints/test_streaming_query_byok_integration.py +++ b/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 diff --git a/tests/unit/app/README.md b/tests/unit/app/README.md index d729f2265..f06dc9fb7 100644 --- a/tests/unit/app/README.md +++ b/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. diff --git a/tests/unit/app/endpoints/README.md b/tests/unit/app/endpoints/README.md index 655aba92c..2317d8ea3 100644 --- a/tests/unit/app/endpoints/README.md +++ b/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. diff --git a/tests/unit/models/config/README.md b/tests/unit/models/config/README.md index 0333682be..3628f60b2 100644 --- a/tests/unit/models/config/README.md +++ b/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. diff --git a/tests/unit/models/responses/README.md b/tests/unit/models/responses/README.md index b76b1b253..d196a6b39 100644 --- a/tests/unit/models/responses/README.md +++ b/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. diff --git a/tests/unit/utils/README.md b/tests/unit/utils/README.md index 22e9d2899..f5feae3f4 100644 --- a/tests/unit/utils/README.md +++ b/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. +