LCORE-1170: Updated configuration documentation

Author: tisnik

docs/config.html

@@ -176,6 +176,43 @@ <h1 class="title"> </h1>
     <h1 id="lightspeed-core-stack">Lightspeed Core Stack</h1>
     <hr/>
     <h1 id="configuration-schema">&#x1F4CB; Configuration schema</h1>
+    <h2 id="a2astateconfiguration">A2AStateConfiguration</h2>
+    <p>A2A protocol persistent state configuration.</p>
+    <p>Configures how A2A task state and context-to-conversation mappings
+are stored. For multi-worker deployments, use SQLite or PostgreSQL to
+ensure state is shared across all workers.</p>
+    <p>If no configuration is provided, in-memory storage is used (default).
+This is suitable for single-worker deployments but state will be lost on
+restarts and not shared across workers.</p>
+    <p>Attributes: sqlite: SQLite database configuration for A2A state
+storage. postgres: PostgreSQL database configuration for A2A state
+storage.</p>
+    <table>
+      <colgroup>
+        <col style="width: 26%"/>
+        <col style="width: 23%"/>
+        <col style="width: 50%"/>
+      </colgroup>
+      <thead>
+        <tr class="header">
+          <th>Field</th>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr class="odd">
+          <td>sqlite</td>
+          <td/>
+          <td>SQLite database configuration for A2A state storage.</td>
+        </tr>
+        <tr class="even">
+          <td>postgres</td>
+          <td/>
+          <td>PostgreSQL database configuration for A2A state storage.</td>
+        </tr>
+      </tbody>
+    </table>
     <h2 id="apikeytokenconfiguration">APIKeyTokenConfiguration</h2>
     <p>API Key Token configuration.</p>
     <table>
@@ -491,6 +528,11 @@ <h2 id="configuration">Configuration</h2>
 reconfigure Llama Stack through its run.yaml configuration file</td>
         </tr>
         <tr class="odd">
+          <td>a2a_state</td>
+          <td/>
+          <td>Configuration for A2A protocol persistent state storage.</td>
+        </tr>
+        <tr class="even">
           <td>quota_handlers</td>
           <td/>
           <td>Quota handlers configuration</td>
@@ -590,6 +632,16 @@ <h2 id="customization">Customization</h2>
           <td>string</td>
           <td/>
         </tr>
+        <tr class="odd">
+          <td>agent_card_path</td>
+          <td>string</td>
+          <td/>
+        </tr>
+        <tr class="even">
+          <td>agent_card_config</td>
+          <td>object</td>
+          <td/>
+        </tr>
         <tr class="odd">
           <td>custom_profile</td>
           <td/>
@@ -1217,31 +1269,37 @@ <h2 id="serviceconfiguration">ServiceConfiguration</h2>
           <td>Service port</td>
         </tr>
         <tr class="odd">
+          <td>base_url</td>
+          <td>string</td>
+          <td>Externally reachable base URL for the service; needed for A2A
+support.</td>
+        </tr>
+        <tr class="even">
           <td>auth_enabled</td>
           <td>boolean</td>
           <td>Enables the authentication subsystem</td>
         </tr>
-        <tr class="even">
+        <tr class="odd">
           <td>workers</td>
           <td>integer</td>
           <td>Number of Uvicorn worker processes to start</td>
         </tr>
-        <tr class="odd">
+        <tr class="even">
           <td>color_log</td>
           <td>boolean</td>
           <td>Enables colorized logging</td>
         </tr>
-        <tr class="even">
+        <tr class="odd">
           <td>access_log</td>
           <td>boolean</td>
           <td>Enables logging of all access information</td>
         </tr>
-        <tr class="odd">
+        <tr class="even">
           <td>tls_config</td>
           <td/>
           <td>Transport Layer Security configuration for HTTPS support</td>
         </tr>
-        <tr class="even">
+        <tr class="odd">
           <td>cors</td>
           <td/>
           <td>Cross-Origin Resource Sharing configuration for cross-domain

docs/config.md

@@ -5,6 +5,28 @@
 
 # 📋 Configuration schema
 
+## A2AStateConfiguration
+
+
+A2A protocol persistent state configuration.
+
+Configures how A2A task state and context-to-conversation mappings are
+stored. For multi-worker deployments, use SQLite or PostgreSQL to ensure
+state is shared across all workers.
+
+If no configuration is provided, in-memory storage is used (default).
+This is suitable for single-worker deployments but state will be lost
+on restarts and not shared across workers.
+
+Attributes:
+    sqlite: SQLite database configuration for A2A state storage.
+    postgres: PostgreSQL database configuration for A2A state storage.
+
+
+| Field | Type | Description |
+|-------|------|-------------|
+| sqlite |  | SQLite database configuration for A2A state storage. |
+| postgres |  | PostgreSQL database configuration for A2A state storage. |
 
 
 ## APIKeyTokenConfiguration
@@ -128,6 +150,7 @@ Global service configuration.
 | inference |  | One LLM provider and one its model might be selected as default ones. When no provider+model pair is specified in REST API calls (query endpoints), the default provider and model are used. |
 | conversation_cache |  |  |
 | byok_rag | array | BYOK RAG configuration. This configuration can be used to reconfigure Llama Stack through its run.yaml configuration file |
+| a2a_state |  | Configuration for A2A protocol persistent state storage. |
 | quota_handlers |  | Quota handlers configuration |
 
 
@@ -169,6 +192,8 @@ Service customization.
 | disable_query_system_prompt | boolean |  |
 | system_prompt_path | string |  |
 | system_prompt | string |  |
+| agent_card_path | string |  |
+| agent_card_config | object |  |
 | custom_profile |  |  |
 
 
@@ -461,6 +486,7 @@ the service can handle requests concurrently.
 |-------|------|-------------|
 | host | string | Service hostname |
 | port | integer | Service port |
+| base_url | string | Externally reachable base URL for the service; needed for A2A support. |
 | auth_enabled | boolean | Enables the authentication subsystem |
 | workers | integer | Number of Uvicorn worker processes to start |
 | color_log | boolean | Enables colorized logging |