docs: params/output semántico en 506 funciones para composabilidad

Añade campos params y output al frontmatter YAML de las 506 funciones del registry.
Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico)
y cada función describe qué produce su output. Permite a agentes razonar sobre
cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.

python/functions/metabase/metabase_add_database.md

@@ -14,6 +14,16 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: name
+    desc: "nombre descriptivo de la base de datos en Metabase"
+  - name: engine
+    desc: "tipo de base de datos (sqlite, postgres, mysql, etc.)"
+  - name: details
+    desc: "dict con parámetros de conexión específicos del engine"
+output: "dict: objeto database creado con id asignado por Metabase"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_auth.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: base_url
+    desc: "URL base de Metabase (ej: http://localhost:3000)"
+  - name: email
+    desc: "correo del usuario para autenticar"
+  - name: password
+    desc: "contraseña del usuario"
+output: "MetabaseClient: cliente autenticado con token válido por 14 días"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_create_card.md

@@ -14,6 +14,20 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: name
+    desc: "nombre descriptivo de la pregunta/card"
+  - name: dataset_query
+    desc: "dict con configuración de query (SQL nativa o MBQL)"
+  - name: display
+    desc: "tipo de visualización (table, scalar, bar, etc.)"
+  - name: collection_id
+    desc: "ID de colección donde guardar la card (0=root)"
+  - name: description
+    desc: "descripción opcional de la card"
+output: "dict: objeto card creado con id y toda su configuración"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_create_dashboard.md

@@ -14,6 +14,16 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: name
+    desc: "nombre del dashboard"
+  - name: description
+    desc: "descripción opcional del dashboard"
+  - name: collection_id
+    desc: "ID de colección donde guardar el dashboard (0=root)"
+output: "dict: objeto dashboard vacío con id asignado"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_create_user.md

@@ -14,6 +14,20 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: first_name
+    desc: "nombre del usuario"
+  - name: last_name
+    desc: "apellido del usuario"
+  - name: email
+    desc: "correo único del usuario"
+  - name: password
+    desc: "contraseña (vacío envía invitación por email)"
+  - name: group_ids
+    desc: "lista de IDs de grupos a los que agregar el usuario"
+output: "dict: objeto usuario creado con id y metadata"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_deactivate_user.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: user_id
+    desc: "ID del usuario a desactivar"
+output: "None"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_delete_card.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: card_id
+    desc: "ID de la card a eliminar permanentemente"
+output: "None"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_delete_dashboard.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: dashboard_id
+    desc: "ID del dashboard a eliminar permanentemente"
+output: "None"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_execute_card.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: card_id
+    desc: "ID de la card guardada a ejecutar"
+  - name: parameters
+    desc: "lista de parámetros para la query (filtros dinámicos)"
+output: "dict: resultados con status, row_count, running_time, data.columns, data.rows"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_execute_query.md

@@ -14,6 +14,16 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: database_id
+    desc: "ID de la base de datos contra la que ejecutar la query"
+  - name: sql
+    desc: "sentencia SQL a ejecutar (sin guardar como card)"
+  - name: max_results
+    desc: "límite de filas a retornar (0=default 2000)"
+output: "dict: resultados con status, row_count, running_time, data.columns, data.rows"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_get_card.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: card_id
+    desc: "ID de la card a obtener"
+output: "dict: objeto card completo con query, visualización y metadata"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_get_dashboard.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: dashboard_id
+    desc: "ID del dashboard a obtener"
+output: "dict: objeto dashboard completo con dashcards, tabs y parámetros"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_get_database.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: database_id
+    desc: "ID de la base de datos a obtener"
+output: "dict: objeto database con id, name, engine, details, features y metadata"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_get_user.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: user_id
+    desc: "ID del usuario a obtener"
+output: "dict: objeto usuario con email, nombre, permisos y metadata"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_list_cards.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: filter
+    desc: "filtro: all, mine, fav, archived, recent, popular, database, table"
+  - name: model_id
+    desc: "ID de modelo para filtros database/table"
+output: "list[dict]: lista de cards que coinciden con el filtro"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_list_dashboards.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: filter
+    desc: "filtro: all, mine, archived"
+output: "list[dict]: lista de dashboards en resumen (sin dashcards)"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_list_databases.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: include_tables
+    desc: "incluir lista de tablas en cada database"
+output: "list[dict]: lista de databases configuradas con id, name, engine y opcionalmente tables"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_list_users.md

@@ -14,6 +14,18 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: status
+    desc: "filtro por estado de usuario (active, deactivated, etc.)"
+  - name: query
+    desc: "búsqueda por nombre o email"
+  - name: limit
+    desc: "límite de resultados por página"
+  - name: offset
+    desc: "desplazamiento para paginación"
+output: "dict: objeto paginado con data (usuarios), total, limit, offset"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_setup.md

@@ -14,6 +14,22 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: base_url
+    desc: "URL base de Metabase a configurar"
+  - name: admin_email
+    desc: "correo del usuario administrador a crear"
+  - name: admin_password
+    desc: "contraseña del administrador"
+  - name: admin_first_name
+    desc: "nombre del administrador"
+  - name: admin_last_name
+    desc: "apellido del administrador"
+  - name: site_name
+    desc: "nombre del sitio Metabase"
+  - name: site_locale
+    desc: "código de idioma (ej: es, en, fr)"
+output: "dict: resultado del setup con session token de administrador"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_update_card.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: card_id
+    desc: "ID de la card a actualizar"
+  - name: fields
+    desc: "kwargs con campos a actualizar (name, description, display, dataset_query, collection_id, archived)"
+output: "dict: objeto card actualizado"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_update_dashboard.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: dashboard_id
+    desc: "ID del dashboard a actualizar"
+  - name: fields
+    desc: "kwargs con campos a actualizar (name, description, archived, dashcards, tabs, parameters, collection_id)"
+output: "dict: objeto dashboard actualizado"
 tested: false
 tests: []
 test_file_path: ""

python/functions/metabase/metabase_update_user.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [httpx]
+params:
+  - name: client
+    desc: "instancia autenticada de MetabaseClient"
+  - name: user_id
+    desc: "ID del usuario a actualizar"
+  - name: fields
+    desc: "kwargs con campos a actualizar (first_name, last_name, email, is_superuser, group_ids, locale)"
+output: "dict: objeto usuario actualizado"
 tested: false
 tests: []
 test_file_path: ""