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.
This commit is contained in:
2026-04-05 18:45:16 +02:00
parent bd1bf2b5dc
commit 988e901066
506 changed files with 2964 additions and 0 deletions
@@ -17,6 +17,18 @@ returns:
returns_optional: false
error_type: "error_go_core"
imports: [logging, sys, os, typing]
params:
- name: text
desc: "texto fuente para extraccion de relaciones entre entidades (ej: documento OSINT, parrafo descriptivo)"
- name: entities
desc: "lista de EntityCandidate ya extraidas (ej: output de extract_entities_llm). Valida que las relaciones refieran entidades reales."
- name: relation_types
desc: "lista de nombres de relacion permitidos (ej: ['employs', 'funds', 'owns']). No permitidas se remapean a 'related_to'."
- name: llm_chat_json
desc: "callable que toma list[dict] mensajes y retorna dict con clave 'relations'. Inyeccion de dependencia del LLM."
- name: language_instruction
desc: "instruccion de lenguaje para el LLM (defecto: 'Respond in English.')"
output: "lista de RelationCandidate con from_name, to_name, relation_type, description, confidence"
tested: true
tests:
- "texto con dos entidades relacionadas"