Merge branch 'main' into devin/1773929518-custom-python-docs

Author: MonikaFeigler

.gitignore

@@ -7,3 +7,4 @@ Gemfile
 Gemfile.lock
 /.vscode
 .playwright-mcp
+.env

_data/navigation.yml

@@ -89,6 +89,9 @@ items:
       - url: /kai/security-and-privacy/
         title: Security & Privacy
 
+      - url: /kai/python-client/
+        title: Python Client
+
   - url: /flows/
     title: Flows
     items:
@@ -165,12 +168,12 @@ items:
             title: UA and GA4 Comparison
 
   - url: /data-apps/
-    title: Data Apps
+    title: Apps
     items:
       - url: /data-apps/streamlit/
-        title: Streamlit Data Apps
+        title: Streamlit Apps
       - url: /data-apps/python-js/
-        title: Python/JS Data Apps
+        title: Python/JS Apps
       - url: /data-apps/authentication/
         title: Authentication
         items:

_data/telemetry_tables.yml

@@ -0,0 +1,55 @@
+{%- comment -%}
+  Renders a single telemetry table's documentation from YAML data.
+  Data source: _data/telemetry_tables.yml
+  Usage: {% include telemetry-table.html table=table %}
+{%- endcomment -%}
+
+{%- assign t = include.table -%}
+
+### {{ t.id }}
+
+{{ t.description }}
+
+{%- if t.is_full_load %}
+
+*Note: The table is always extracted in full.*
+{%- endif -%}
+
+{%- if t.org_mode_note %}
+
+***Note:** {{ t.org_mode_note }}*
+{%- endif -%}
+
+{%- if t.usage_breakdown %}
+
+`usage_breakdown` data sources (which tables serve as sources for the results):
+{% for item in t.usage_breakdown %}
+* `{{ item.name }}` - {% if item.source %}`{{ item.source }}`{% endif %} ({{ item.detail }})
+{%- endfor -%}
+{%- endif %}
+
+| **Column** | **Description** | **Example** |
+|---|---|---|
+{%- for col in t.columns %}
+| `{{ col.name }}`{% if col.pk %} (PK){% endif %} | {{ col.description }} | `{{ col.example }}` |
+{%- endfor %}
+
+{%- if t.note %}
+
+{{ t.note }}
+{%- endif -%}
+
+{%- if t.security_operations %}
+
+#### Security event operations
+
+{% for op in t.security_operations %}
+|`{{ op }}`
+{%- endfor %}
+
+#### Operation parameters
+
+{% for param in t.operation_parameters %}
+| {{ param.condition }}: | {{ param.values }} |
+{%- endfor %}
+{%- endif %}

_includes/telemetry-table.html

@@ -17,6 +17,9 @@ Keboola integrates artificial intelligence throughout the platform to enhance pr
 Keboola's embedded AI assistant that serves as a comprehensive data engineering co-pilot within the platform. Kai is context-aware of your specific project and can both explore and modify your Keboola environment through natural conversation.
 [Learn more about Kai →](/kai/)
 
+A [Python client library](https://github.com/keboola/kai-client) is also available for programmatic access to the Kai API, enabling scripting, automation, and integration into custom workflows.
+[Learn more about the Python Client →](/kai/python-client/)
+
 ### MCP Server
 
 Model Context Protocol server integration for seamless communication between AI agents and your data infrastructure on Keboola.

ai/index.md

@@ -138,6 +138,12 @@ table {
   code.td-break-code {
     word-break: break-all;
   }
+
+  // Force long code examples (JSON, URLs) to wrap instead of overflowing
+  td code {
+    word-break: break-all;
+    overflow-wrap: break-word;
+  }
 }
 
 .root {
@@ -324,3 +330,4 @@ blockquote {
     border-radius: 3px;
   }
 }
+