lightspeed-stack 0.7.0rc2__tar.gz → 0.7.0rc3__tar.gz

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lightspeed-stack
-Version: 0.7.0rc2
+Version: 0.7.0rc3
 Summary: LLM tooling stack
 Keywords: LLM,RAG
 Maintainer-Email: =?utf-8?b?UGF2ZWwgVGnFoW5vdnNrw70=?= <tisnik@centrum.cz>
@@ -214,7 +214,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: License :: OSI Approved :: Apache Software License
 Project-URL: Homepage, https://github.com/lightspeed-core/lightspeed-stack
 Project-URL: Issues, https://github.com/lightspeed-core/lightspeed-stack/issues
-Requires-Python: <3.14,>=3.12
+Requires-Python: <3.15,>=3.12
 Requires-Dist: fastapi>=0.115.12
 Requires-Dist: uvicorn>=0.34.3
 Requires-Dist: kubernetes>=30.1.0
@@ -387,8 +387,7 @@ Lightspeed Core Stack is based on the FastAPI framework (Uvicorn). The service i
 
 # Prerequisites
 
-* Python 3.12, or 3.13
-    - please note that currently Python 3.14 is not officially supported
+* Python 3.12, 3.13, or 3.14
     - all sources are made (backward) compatible with Python 3.12; it is checked on CI
 
 * OpenAI API Key (Recommended for Getting Started)
@@ -464,7 +463,7 @@ To quickly get hands on LCS, we can run it using the default configurations prov
    ```
 4. access LCS web UI at [http://localhost:8080/](http://localhost:8080/)
 
-**Note**: `make run` uses containerized OGX (service mode). For details on container lifecycle management, customization, and troubleshooting, see the [Container Orchestration Guide](docs/devel_doc/container_orchestration.md). To run llama-stack manually instead, see the [OGX as separate server](#ogx-as-separate-server) section below.
+**Note**: `make run` uses containerized OGX (service mode). For details on container lifecycle management, customization, and troubleshooting, see the [Container Orchestration Guide](docs/devel_doc/container_orchestration.md). To run OGX manually instead, see the [OGX as separate server](#ogx-as-separate-server) section below.
 
 ## Container Runtime Requirements
 
@@ -595,7 +594,7 @@ Kotlin, which "wraps" the REST API stack in a suitable way, which is easier for
 many applications.
 
 
-![Integration with OGX](docs/core2llama-stack_interface.png)
+![Integration with OGX](docs/devel_doc/core2ogx_interface.png)
 
 
 
@@ -612,7 +611,7 @@ service:
   workers: 1
   color_log: true
   access_log: true
-llama_stack:
+ogx:
   use_as_library_client: false
   url: http://localhost:8321
 user_data_collection:
@@ -624,7 +623,7 @@ user_data_collection:
 
 ### Degraded mode
 
-Lightspeed core is able to continue operating in a _degraded but safe_ mode if the LLS service is not started or fails to start. When degraded, the `/health` endpoint report the LLS status and any relevant impacts so operators and automation can detect and respond.
+Lightspeed core is able to continue operating in a _degraded but safe_ mode if the OGX service is not started or fails to start. When degraded, the `/health` endpoint report the OGX status and any relevant impacts so operators and automation can detect and respond.
 
 Degraded mode need to be enabled in `lightspeed-stack.yaml` configuration file:
 
@@ -878,12 +877,12 @@ To run OGX in separate process, you need to have all dependencies installed. The
 
 ```toml
 [project]
-name = "llama-stack-runner"
+name = "ogx-runner"
 version = "0.1.0"
 description = "OGX runner"
 authors = []
 dependencies = [
-    "llama-stack==0.2.22",
+    "ogx==1.2.5",
     "fastapi>=0.115.12",
     "opentelemetry-sdk>=1.34.0",
     "opentelemetry-exporter-otlp>=1.34.0",
@@ -917,7 +916,7 @@ To run OGX perform these two commands:
 ```
 export OPENAI_API_KEY="sk-{YOUR-KEY}"
 
-uv run llama stack run run.yaml
+uv run ogx stack run run.yaml
 ```
 
 ### Check connection to OGX
@@ -941,14 +940,14 @@ service:
   workers: 1
   color_log: true
   access_log: true
-llama_stack:
+ogx:
   use_as_library_client: true
   # Unified mode (recommended): LCORE synthesizes the OGX run.yaml.
   # Point profile at a run.yaml-shaped file you author, or omit the config
   # block and drive everything from the top-level inference.providers
   # section over the built-in default baseline.
   config:
-    profile: <path-to-llama-stack-run.yaml-file>
+    profile: <path-to-ogx-run.yaml-file>
 user_data_collection:
   feedback_enabled: true
   feedback_storage: "/tmp/data/feedback"
@@ -964,7 +963,7 @@ user_data_collection:
 
 ## OGX version check
 
-During Lightspeed Core Stack service startup, the OGX version is retrieved. The version is tested against two constants `MINIMAL_SUPPORTED_LLAMA_STACK_VERSION` and `MAXIMAL_SUPPORTED_LLAMA_STACK_VERSION` which are defined in `src/constants.py`. If the actual OGX version is outside the range defined by these two constants, the service won't start and administrator will be informed about this problem.
+During Lightspeed Core Stack service startup, the OGX version is retrieved. The version is tested against two constants `MINIMAL_SUPPORTED_OGX_VERSION` and `MAXIMAL_SUPPORTED_OGX_VERSION` which are defined in `src/constants.py`. If the actual OGX version is outside the range defined by these two constants, the service won't start and administrator will be informed about this problem.
 
 
 
@@ -1146,7 +1145,7 @@ options:
                         path where the synthesized OGX run.yaml is written in unified library mode (overwritten each boot,
                         mode 0600; default: ./.generated/run.yaml)
   --migrate-config      migrate a legacy two-file config to a unified single file and exit. Lifts the run.yaml given by --run-yaml
-                        into the llama_stack.config.native_override of the -c lightspeed-stack.yaml and writes the result to
+                        into the ogx.config.native_override of the -c lightspeed-stack.yaml and writes the result to
                         --migrate-output. Replace literal secrets with ${env.VAR} references before or after migrating.
   --run-yaml RUN_YAML   path to the legacy OGX run.yaml to migrate (used with --migrate-config)
   --migrate-output MIGRATE_OUTPUT
@@ -1176,15 +1175,15 @@ Usage: make <OPTIONS> ... <TARGETS>
 
 Available targets are:
 
-run-stack                         Run lightspeed-stack directly, without building dependent service/s
+run-ogx                         Run lightspeed-stack directly, without building dependent service/s
 run                               Run the service locally with dependent services
-build-llama-stack-image           Build OGX container image
-stop-llama-stack-container        Gracefully stop OGX container
-remove-llama-stack-container      Remove OGX container (saves logs first)
-start-llama-stack-container       Start OGX container
-wait-for-llama-stack-health       Wait for OGX container to be healthy
-clean-llama-stack                 Remove container and image
-run-llama-stack                   Start OGX with enriched config (for local service mode)
+build-ogx-image           Build OGX container image
+stop-ogx-container        Gracefully stop OGX container
+remove-ogx-container      Remove OGX container (saves logs first)
+start-ogx-container       Start OGX container
+wait-for-ogx-health       Wait for OGX container to be healthy
+clean-ogx                 Remove container and image
+run-ogx-local                   Start OGX with enriched config (for local service mode)
 test-unit                         Run the unit tests
 test-integration                  Run integration tests tests
 test-e2e                          Run end to end tests for the service
@@ -1276,9 +1275,9 @@ When using OGX as a separate service, the existing `docker-compose.yaml` provide
 
 **Configuration** (`lightspeed-stack.yaml`):
 ```yaml
-llama_stack:
+ogx:
   use_as_library_client: false
-  url: http://llama-stack:8321  # container name from docker-compose.yaml
+  url: http://ogx:8321  # service name from docker-compose.yaml
   api_key: xyzzy
 ```
 
@@ -1315,7 +1314,7 @@ When embedding OGX directly in the container, use the existing `deploy/lightspee
 
 **Configuration** (`lightspeed-stack.yaml`):
 ```yaml
-llama_stack:
+ogx:
   use_as_library_client: true
   # Unified mode: the mounted run.yaml is the synthesis profile. (The
   # legacy library_client_config_path equivalent is deprecated, removed

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/README.md

@@ -129,8 +129,7 @@ Lightspeed Core Stack is based on the FastAPI framework (Uvicorn). The service i
 
 # Prerequisites
 
-* Python 3.12, or 3.13
-    - please note that currently Python 3.14 is not officially supported
+* Python 3.12, 3.13, or 3.14
     - all sources are made (backward) compatible with Python 3.12; it is checked on CI
 
 * OpenAI API Key (Recommended for Getting Started)
@@ -206,7 +205,7 @@ To quickly get hands on LCS, we can run it using the default configurations prov
    ```
 4. access LCS web UI at [http://localhost:8080/](http://localhost:8080/)
 
-**Note**: `make run` uses containerized OGX (service mode). For details on container lifecycle management, customization, and troubleshooting, see the [Container Orchestration Guide](docs/devel_doc/container_orchestration.md). To run llama-stack manually instead, see the [OGX as separate server](#ogx-as-separate-server) section below.
+**Note**: `make run` uses containerized OGX (service mode). For details on container lifecycle management, customization, and troubleshooting, see the [Container Orchestration Guide](docs/devel_doc/container_orchestration.md). To run OGX manually instead, see the [OGX as separate server](#ogx-as-separate-server) section below.
 
 ## Container Runtime Requirements
 
@@ -337,7 +336,7 @@ Kotlin, which "wraps" the REST API stack in a suitable way, which is easier for
 many applications.
 
 
-![Integration with OGX](docs/core2llama-stack_interface.png)
+![Integration with OGX](docs/devel_doc/core2ogx_interface.png)
 
 
 
@@ -354,7 +353,7 @@ service:
   workers: 1
   color_log: true
   access_log: true
-llama_stack:
+ogx:
   use_as_library_client: false
   url: http://localhost:8321
 user_data_collection:
@@ -366,7 +365,7 @@ user_data_collection:
 
 ### Degraded mode
 
-Lightspeed core is able to continue operating in a _degraded but safe_ mode if the LLS service is not started or fails to start. When degraded, the `/health` endpoint report the LLS status and any relevant impacts so operators and automation can detect and respond.
+Lightspeed core is able to continue operating in a _degraded but safe_ mode if the OGX service is not started or fails to start. When degraded, the `/health` endpoint report the OGX status and any relevant impacts so operators and automation can detect and respond.
 
 Degraded mode need to be enabled in `lightspeed-stack.yaml` configuration file:
 
@@ -620,12 +619,12 @@ To run OGX in separate process, you need to have all dependencies installed. The
 
 ```toml
 [project]
-name = "llama-stack-runner"
+name = "ogx-runner"
 version = "0.1.0"
 description = "OGX runner"
 authors = []
 dependencies = [
-    "llama-stack==0.2.22",
+    "ogx==1.2.5",
     "fastapi>=0.115.12",
     "opentelemetry-sdk>=1.34.0",
     "opentelemetry-exporter-otlp>=1.34.0",
@@ -659,7 +658,7 @@ To run OGX perform these two commands:
 ```
 export OPENAI_API_KEY="sk-{YOUR-KEY}"
 
-uv run llama stack run run.yaml
+uv run ogx stack run run.yaml
 ```
 
 ### Check connection to OGX
@@ -683,14 +682,14 @@ service:
   workers: 1
   color_log: true
   access_log: true
-llama_stack:
+ogx:
   use_as_library_client: true
   # Unified mode (recommended): LCORE synthesizes the OGX run.yaml.
   # Point profile at a run.yaml-shaped file you author, or omit the config
   # block and drive everything from the top-level inference.providers
   # section over the built-in default baseline.
   config:
-    profile: <path-to-llama-stack-run.yaml-file>
+    profile: <path-to-ogx-run.yaml-file>
 user_data_collection:
   feedback_enabled: true
   feedback_storage: "/tmp/data/feedback"
@@ -706,7 +705,7 @@ user_data_collection:
 
 ## OGX version check
 
-During Lightspeed Core Stack service startup, the OGX version is retrieved. The version is tested against two constants `MINIMAL_SUPPORTED_LLAMA_STACK_VERSION` and `MAXIMAL_SUPPORTED_LLAMA_STACK_VERSION` which are defined in `src/constants.py`. If the actual OGX version is outside the range defined by these two constants, the service won't start and administrator will be informed about this problem.
+During Lightspeed Core Stack service startup, the OGX version is retrieved. The version is tested against two constants `MINIMAL_SUPPORTED_OGX_VERSION` and `MAXIMAL_SUPPORTED_OGX_VERSION` which are defined in `src/constants.py`. If the actual OGX version is outside the range defined by these two constants, the service won't start and administrator will be informed about this problem.
 
 
 
@@ -888,7 +887,7 @@ options:
                         path where the synthesized OGX run.yaml is written in unified library mode (overwritten each boot,
                         mode 0600; default: ./.generated/run.yaml)
   --migrate-config      migrate a legacy two-file config to a unified single file and exit. Lifts the run.yaml given by --run-yaml
-                        into the llama_stack.config.native_override of the -c lightspeed-stack.yaml and writes the result to
+                        into the ogx.config.native_override of the -c lightspeed-stack.yaml and writes the result to
                         --migrate-output. Replace literal secrets with ${env.VAR} references before or after migrating.
   --run-yaml RUN_YAML   path to the legacy OGX run.yaml to migrate (used with --migrate-config)
   --migrate-output MIGRATE_OUTPUT
@@ -918,15 +917,15 @@ Usage: make <OPTIONS> ... <TARGETS>
 
 Available targets are:
 
-run-stack                         Run lightspeed-stack directly, without building dependent service/s
+run-ogx                         Run lightspeed-stack directly, without building dependent service/s
 run                               Run the service locally with dependent services
-build-llama-stack-image           Build OGX container image
-stop-llama-stack-container        Gracefully stop OGX container
-remove-llama-stack-container      Remove OGX container (saves logs first)
-start-llama-stack-container       Start OGX container
-wait-for-llama-stack-health       Wait for OGX container to be healthy
-clean-llama-stack                 Remove container and image
-run-llama-stack                   Start OGX with enriched config (for local service mode)
+build-ogx-image           Build OGX container image
+stop-ogx-container        Gracefully stop OGX container
+remove-ogx-container      Remove OGX container (saves logs first)
+start-ogx-container       Start OGX container
+wait-for-ogx-health       Wait for OGX container to be healthy
+clean-ogx                 Remove container and image
+run-ogx-local                   Start OGX with enriched config (for local service mode)
 test-unit                         Run the unit tests
 test-integration                  Run integration tests tests
 test-e2e                          Run end to end tests for the service
@@ -1018,9 +1017,9 @@ When using OGX as a separate service, the existing `docker-compose.yaml` provide
 
 **Configuration** (`lightspeed-stack.yaml`):
 ```yaml
-llama_stack:
+ogx:
   use_as_library_client: false
-  url: http://llama-stack:8321  # container name from docker-compose.yaml
+  url: http://ogx:8321  # service name from docker-compose.yaml
   api_key: xyzzy
 ```
 
@@ -1057,7 +1056,7 @@ When embedding OGX directly in the container, use the existing `deploy/lightspee
 
 **Configuration** (`lightspeed-stack.yaml`):
 ```yaml
-llama_stack:
+ogx:
   use_as_library_client: true
   # Unified mode: the mounted run.yaml is the synthesis profile. (The
   # legacy library_client_config_path equivalent is deprecated, removed

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/pyproject.toml

@@ -18,7 +18,7 @@ keywords = [
     "LLM",
     "RAG",
 ]
-requires-python = ">=3.12,<3.14"
+requires-python = ">=3.12,<3.15"
 readme = "README.md"
 dependencies = [
     "fastapi>=0.115.12",
@@ -61,7 +61,7 @@ dependencies = [
     "opentelemetry-exporter-otlp>=1.34.1",
     "opentelemetry-instrumentation-fastapi>=0.49b0",
 ]
-version = "0.7.0rc2"
+version = "0.7.0rc3"
 
 [project.license]
 file = "LICENSE"
@@ -147,6 +147,7 @@ extend-select = [
     "RUF100",
     "B009",
     "B010",
+    "B011",
     "DTZ005",
     "D202",
     "I001",
@@ -221,6 +222,8 @@ dev = [
     "pytest-benchmark>=5.2.3",
     "pyroscope-io>=0.8.7",
     "memray>=1.13.0",
+    "pygal>=3.1.3",
+    "pygaljs>=1.0.2",
 ]
 ogxlibdev = [
     "tree_sitter>=0.24.0",
@@ -232,6 +235,7 @@ ogxlibdev = [
     "faiss-cpu>=1.11.0",
     "chardet>=5.2.0",
     "psycopg2-binary>=2.9.10",
+    "pgvector>=0.3.6",
     "pypdf>=6.10.2",
     "requests>=2.33.0",
     "aiosqlite>=0.21.0",

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/a2a.py

@@ -68,7 +68,7 @@ from utils.conversation_compaction import (
     apply_compaction_blocking,
     store_compacted_turn,
 )
-from utils.mcp_headers import McpHeaders, mcp_headers_dependency
+from utils.mcp.mcp_headers import McpHeaders, mcp_headers_dependency
 from utils.otel_tracing import (
     SpanAttributes,
     SpanEvents,

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/a2a_openapi.py

@@ -1,11 +1,12 @@
 """OpenAPI-only metadata for A2A JSON-RPC routes."""
 
-from typing import Any, Final
+from typing import Final
 
 from constants import MEDIA_TYPE_EVENT_STREAM, MEDIA_TYPE_JSON
+from utils.types import Responses
 
 # 200 may be buffered JSON-RPC (application/json) or SSE (text/event-stream).
-a2a_jsonrpc_responses: Final[dict[int | str, dict[str, Any]]] = {
+a2a_jsonrpc_responses: Final[Responses] = {
     200: {
         "description": "Successful response",
         "content": {

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/authorized.py

@@ -1,6 +1,6 @@
 """Handler for REST API call to authorized endpoint."""
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from fastapi import APIRouter, Depends
 from opentelemetry import trace
@@ -16,12 +16,13 @@ from models.api.responses.error import (
 )
 from models.api.responses.successful import AuthorizedResponse
 from utils.otel_tracing import SpanAttributes, anonymize_value, set_span_attributes
+from utils.types import Responses
 
 logger = get_logger(__name__)
 tracer = trace.get_tracer(__name__)
 router = APIRouter(tags=["authorized"])
 
-authorized_responses: dict[int | str, dict[str, Any]] = {
+authorized_responses: Responses = {
     200: AuthorizedResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/config.py

@@ -1,6 +1,6 @@
 """Handler for REST API call to retrieve service configuration."""
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from fastapi import APIRouter, Depends, Request
 from opentelemetry import trace
@@ -20,13 +20,14 @@ from models.api.responses.error import (
 from models.api.responses.successful import ConfigurationResponse
 from models.config import Action
 from utils.endpoints import check_configuration_loaded
+from utils.types import Responses
 
 logger = get_logger(__name__)
 tracer = trace.get_tracer(__name__)
 router = APIRouter(tags=["config"])
 
 
-get_config_responses: dict[int | str, dict[str, Any]] = {
+get_config_responses: Responses = {
     200: ConfigurationResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/conversations_v1.py

@@ -52,12 +52,13 @@ from utils.suid import (
     normalize_conversation_id,
     to_ogx_conversation_id,
 )
+from utils.types import Responses
 
 logger = get_logger(__name__)
 tracer = trace.get_tracer(__name__)
 router = APIRouter(tags=["conversations_v1"])
 
-conversation_get_responses: dict[int | str, dict[str, Any]] = {
+conversation_get_responses: Responses = {
     200: ConversationResponse.openapi_response(),
     400: BadRequestResponse.openapi_response(examples=["conversation_id"]),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
@@ -71,7 +72,7 @@ conversation_get_responses: dict[int | str, dict[str, Any]] = {
     ),
 }
 
-conversation_delete_responses: dict[int | str, dict[str, Any]] = {
+conversation_delete_responses: Responses = {
     200: ConversationDeleteResponse.openapi_response(),
     400: BadRequestResponse.openapi_response(examples=["conversation_id"]),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
@@ -86,7 +87,7 @@ conversation_delete_responses: dict[int | str, dict[str, Any]] = {
     ),
 }
 
-conversations_list_responses: dict[int | str, dict[str, Any]] = {
+conversations_list_responses: Responses = {
     200: ConversationsListResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),
@@ -98,7 +99,7 @@ conversations_list_responses: dict[int | str, dict[str, Any]] = {
     ),
 }
 
-conversation_update_responses: dict[int | str, dict[str, Any]] = {
+conversation_update_responses: Responses = {
     200: ConversationUpdateResponse.openapi_response(),
     400: BadRequestResponse.openapi_response(examples=["conversation_id"]),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/conversations_v2.py

@@ -33,13 +33,14 @@ from models.common import (
 from models.config import Action
 from utils.endpoints import check_configuration_loaded
 from utils.suid import check_suid
+from utils.types import Responses
 
 logger = get_logger(__name__)
 tracer = trace.get_tracer(__name__)
 router = APIRouter(tags=["conversations_v2"])
 
 
-conversation_get_responses: dict[int | str, dict[str, Any]] = {
+conversation_get_responses: Responses = {
     200: ConversationResponse.openapi_response(),
     400: BadRequestResponse.openapi_response(examples=["conversation_id"]),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
@@ -51,7 +52,7 @@ conversation_get_responses: dict[int | str, dict[str, Any]] = {
     503: ServiceUnavailableResponse.openapi_response(examples=["kubernetes api"]),
 }
 
-conversation_delete_responses: dict[int | str, dict[str, Any]] = {
+conversation_delete_responses: Responses = {
     200: ConversationDeleteResponse.openapi_response(),
     400: BadRequestResponse.openapi_response(examples=["conversation_id"]),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
@@ -62,7 +63,7 @@ conversation_delete_responses: dict[int | str, dict[str, Any]] = {
     503: ServiceUnavailableResponse.openapi_response(examples=["kubernetes api"]),
 }
 
-conversations_list_responses: dict[int | str, dict[str, Any]] = {
+conversations_list_responses: Responses = {
     200: ConversationsListResponseV2.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),
@@ -72,7 +73,7 @@ conversations_list_responses: dict[int | str, dict[str, Any]] = {
     503: ServiceUnavailableResponse.openapi_response(examples=["kubernetes api"]),
 }
 
-conversation_update_responses: dict[int | str, dict[str, Any]] = {
+conversation_update_responses: Responses = {
     200: ConversationUpdateResponse.openapi_response(),
     400: BadRequestResponse.openapi_response(examples=["conversation_id"]),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/feedback.py

@@ -38,6 +38,7 @@ from utils.otel_tracing import (
     set_span_attributes,
 )
 from utils.suid import get_suid
+from utils.types import Responses
 
 logger = get_logger(__name__)
 tracer = trace.get_tracer(__name__)
@@ -45,7 +46,7 @@ router = APIRouter(prefix="/feedback", tags=["feedback"])
 feedback_status_lock = threading.Lock()
 
 
-feedback_post_response: dict[int | str, dict[str, Any]] = {
+feedback_post_response: Responses = {
     200: FeedbackResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint", "feedback"]),
@@ -56,7 +57,7 @@ feedback_post_response: dict[int | str, dict[str, Any]] = {
     503: ServiceUnavailableResponse.openapi_response(examples=["kubernetes api"]),
 }
 
-feedback_put_response: dict[int | str, dict[str, Any]] = {
+feedback_put_response: Responses = {
     200: FeedbackStatusUpdateResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),
@@ -64,7 +65,7 @@ feedback_put_response: dict[int | str, dict[str, Any]] = {
     503: ServiceUnavailableResponse.openapi_response(examples=["kubernetes api"]),
 }
 
-feedback_get_response: dict[int | str, dict[str, Any]] = {
+feedback_get_response: Responses = {
     200: StatusResponse.openapi_response(),
 }
 

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/health.py

@@ -5,7 +5,7 @@ requests. Note that these endpoints can be accessed using GET or HEAD HTTP
 methods. For HEAD HTTP method, just the HTTP response code is used.
 """
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from fastapi import APIRouter, Depends, Response, status
 from ogx_client import ApiException
@@ -33,13 +33,14 @@ from models.common import (
 )
 from models.config import Action
 from utils.degraded_mode import DegradedModeTracker
+from utils.types import Responses
 
 logger = get_logger(__name__)
 tracer = trace.get_tracer(__name__)
 router = APIRouter(tags=["health"])
 
 
-get_readiness_responses: dict[int | str, dict[str, Any]] = {
+get_readiness_responses: Responses = {
     200: ReadinessResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),
@@ -48,7 +49,7 @@ get_readiness_responses: dict[int | str, dict[str, Any]] = {
     ),
 }
 
-get_liveness_responses: dict[int | str, dict[str, Any]] = {
+get_liveness_responses: Responses = {
     200: LivenessResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/info.py

@@ -1,6 +1,6 @@
 """Handler for REST API call to provide info."""
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from fastapi import APIRouter, Depends, HTTPException, Request
 from ogx_client import ApiException
@@ -21,6 +21,7 @@ from models.api.responses.error import (
 from models.api.responses.successful import InfoResponse
 from models.config import Action
 from utils.otel_tracing import set_span_attributes
+from utils.types import Responses
 from version import __version__
 
 logger = get_logger(__name__)
@@ -28,7 +29,7 @@ tracer = trace.get_tracer(__name__)
 router = APIRouter(tags=["info"])
 
 
-get_info_responses: dict[int | str, dict[str, Any]] = {
+get_info_responses: Responses = {
     200: InfoResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),

{lightspeed_stack-0.7.0rc2 → lightspeed_stack-0.7.0rc3}/src/app/endpoints/mcp_auth.py

@@ -1,6 +1,6 @@
 """Handler for REST API calls related to MCP server authentication."""
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from fastapi import APIRouter, Depends, Request
 from opentelemetry import trace
@@ -23,13 +23,14 @@ from models.common import MCPServerAuthInfo
 from models.config import Action
 from utils.endpoints import check_configuration_loaded
 from utils.otel_tracing import SpanAttributes, set_span_attributes
+from utils.types import Responses
 
 logger = get_logger(__name__)
 tracer = trace.get_tracer(__name__)
 router = APIRouter(prefix="/mcp-auth", tags=["mcp-auth"])
 
 
-mcp_auth_responses: dict[int | str, dict[str, Any]] = {
+mcp_auth_responses: Responses = {
     200: MCPClientAuthOptionsResponse.openapi_response(),
     401: UnauthorizedResponse.openapi_response(examples=UNAUTHORIZED_OPENAPI_EXAMPLES),
     403: ForbiddenResponse.openapi_response(examples=["endpoint"]),