iatoolkit 2.3.0__tar.gz → 2.3.1__tar.gz

{iatoolkit-2.3.0/src/iatoolkit.egg-info → iatoolkit-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.3.0
+Version: 2.3.1
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/__init__.py

@@ -3,7 +3,7 @@
 #
 # IAToolkit is open source software.
 
-__version__ = "2.3.0"
+__version__ = "2.3.1"
 
 # Expose main classes and functions at the top level of the package
 

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/common/routes.py

@@ -22,6 +22,8 @@ def register_views(app):
     from iatoolkit.views.load_document_api_view import LoadDocumentApiView
     from iatoolkit.views.user_feedback_api_view import UserFeedbackApiView
     from iatoolkit.views.prompt_api_view import PromptApiView
+    from iatoolkit.views.chat_context_preview_api_view import ChatContextPreviewApiView
+    from iatoolkit.views.prompt_context_preview_api_view import PromptContextPreviewApiView
     from iatoolkit.views.prompt_resource_api_view import PromptResourceApiView
     from iatoolkit.views.history_api_view import HistoryApiView
     from iatoolkit.views.help_content_api_view import HelpContentApiView
@@ -123,6 +125,16 @@ def register_views(app):
                      view_func=prompt_view,
                      methods=['GET', 'POST','PUT', 'DELETE'])
 
+    app.add_url_rule(
+        '/<string:company_short_name>/api/admin/context-preview/chat',
+        view_func=ChatContextPreviewApiView.as_view('chat_context_preview_api'),
+        methods=['GET'],
+    )
+    app.add_url_rule(
+        '/<string:company_short_name>/api/admin/prompts/<string:prompt_name>/context-preview',
+        view_func=PromptContextPreviewApiView.as_view('prompt_context_preview_api'),
+        methods=['POST'],
+    )
     app.add_url_rule(
         '/<string:company_short_name>/api/admin/prompts/<string:prompt_name>/resources',
         view_func=PromptResourceApiView.as_view('prompt_resources_api'),

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/config/system_prompts_pack.yaml

@@ -22,6 +22,14 @@ prompts:
       execution_modes:
         - chat
         - agent
+  - key: memory_usage
+    filename: memory_usage.prompt
+    include:
+      execution_modes:
+        - chat
+        - agent
+      all_capabilities:
+        - can_use_memory
   - key: multimodal_basics
     filename: multimodal_basics.prompt
     include:

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/services/company_context_service.py

@@ -34,9 +34,11 @@ class CompanyContextService:
         """
         Builds the full context by aggregating three sources:
         1. Static context files (Markdown).
-        2. Static schema files (YAML files for SQL data sources).
+        2. Physical SQL schemas and enriched metadata.
+        3. Residual schema files (YAML files not already covered by SQL enrichment).
         """
         context_parts = []
+        db_tables = []
 
         # 1. Context from Markdown (context/*.md)  files
         try:
@@ -46,20 +48,24 @@ class CompanyContextService:
         except Exception as e:
             logging.warning(f"Could not load Markdown context for '{company_short_name}': {e}")
 
-        # 2. Context from company-specific SQL databases
-        db_tables = []
+        # 2. Resolve company-specific SQL databases. We collect them first so YAML
+        # context can avoid duplicating table definitions already covered by SQL.
+        sql_context = ""
         try:
             sql_context, db_tables = self._get_sql_enriched_context(company_short_name)
-            if sql_context:
-                context_parts.append(sql_context)
         except Exception as e:
             logging.warning(f"Could not generate SQL context for '{company_short_name}': {e}")
 
-        # 3. Context from yaml (schema/*.yaml) files
+        # 3. Append physical SQL context after markdown. Table-level YAML metadata
+        # is already merged inline inside the enriched SQL definitions.
+        if sql_context:
+            context_parts.append(sql_context)
+
+        # 4. Context from residual yaml (schema/*.yaml) files
         try:
             yaml_schema_context = self._get_yaml_schema_context(company_short_name, db_tables)
             if yaml_schema_context:
-                context_parts.append(yaml_schema_context)
+                context_parts.append(f"## Esquemas adicionales\n\n{yaml_schema_context.strip()}")
         except Exception as e:
             logging.warning(f"Could not load Yaml context for '{company_short_name}': {e}")
 
@@ -112,16 +118,15 @@ class CompanyContextService:
                     continue
 
                 # 2. Build Header for this Database
-                db_context = f"***Database (`database_key`)***: {db_name}\n"
+                db_context = f"### Base SQL (`database_key`): {db_name}\n"
 
                 # Optional: Add DB description from config if available (useful context)
                 db_desc = source.get('description', '')
                 if db_desc:
-                    db_context += f"**Description:** {db_desc}\n"
+                    db_context += f"- Descripcion: {db_desc}\n"
 
                 db_context += (
-                    f"IMPORTANT: To query this database you MUST use the service/tool "
-                    f"**iat_sql_query**, with `database_key='{db_name}'`.\n"
+                    f"- Usa `iat_sql_query` con `database_key='{db_name}'` para consultar esta base.\n"
                 )
 
                 # 3. Format Tables
@@ -130,11 +135,11 @@ class CompanyContextService:
                     columns = table_data.get('columns', [])
 
                     # Table Header
-                    table_str = f"\nTable: **{table_name}**"
+                    table_str = f"\n\n#### Tabla: `{table_name}`"
                     if table_desc:
-                        table_str += f"\nDescription: {table_desc}"
+                        table_str += f"\n- Descripcion: {table_desc}"
 
-                    table_str += "\nColumns:"
+                    table_str += "\n- Columnas:"
 
                     # Format Columns
                     for col in columns:
@@ -171,7 +176,11 @@ class CompanyContextService:
         if not context_output:
             return "", []
 
-        header = "These are the SQL databases you can query using the **`iat_sql_service`**. The schema below includes enriched metadata:\n"
+        header = (
+            "## Bases de datos SQL disponibles\n\n"
+            "Estas son las bases SQL que puedes consultar usando `iat_sql_query`. "
+            "El schema a continuacion incluye metadata enriquecida.\n"
+        )
         return header + "\n\n---\n\n".join(context_output), db_tables
 
 
@@ -206,7 +215,7 @@ class CompanyContextService:
                     # 4. Generate markdown description from the dict
                     if schema_dict:
                         # We use generate_schema_table which accepts a dict directly
-                        yaml_schema_context += self.generate_schema_table(schema_dict)
+                        yaml_schema_context += self.generate_schema_table(schema_dict) + "\n\n"
 
                 except Exception as e:
                     logging.warning(f"Error processing schema file {filename}: {e}")
@@ -227,25 +236,25 @@ class CompanyContextService:
 
         root_name = keys[0]
         root_data = schema[root_name]
-        output = [f"\n### Objeto: `{root_name}`"]
+        output = [f"### Objeto: `{root_name}`"]
 
         # table description
         root_description = root_data.get('description', '')
         if root_description:
             clean_desc = root_description.replace('\n', ' ').strip()
-            output.append(f"##Descripción:  {clean_desc}")
+            output.append(f"- Descripcion: {clean_desc}")
 
         # extract columns and properties from the root object
         # priority: columns > properties > fields
         properties = root_data.get('columns', root_data.get('properties', {}))
         if properties:
-            output.append("**Estructura de Datos:**")
+            output.append("#### Estructura de datos")
 
             # use indent_level 0 for the main columns
             # call recursive function to format the properties
             output.append(self._format_json_schema(properties, 0))
         else:
-            output.append("\n_Sin definición de estructura._")
+            output.append("_Sin definicion de estructura._")
 
         return "\n".join(output)
 

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/services/context_builder_service.py

@@ -190,12 +190,12 @@ class ContextBuilderService:
         # 3. Get company specific context (DB Schemas, Docs, etc.)
         company_specific_context = self.company_context_service.get_company_context(company_short_name)
         collection_context = self._build_collection_context(company_short_name)
-        memory_context = self._build_memory_context()
 
-        # 4. Merge contexts
-        final_system_context = "\n".join(
+        # 4. Merge contexts. Conversational chat sees behavior and identity first,
+        # then retrieval hints, and only then the heavier company data blocks.
+        final_system_context = "\n\n".join(
             section
-            for section in (company_specific_context, collection_context, memory_context, rendered_system_prompt)
+            for section in (rendered_system_prompt, collection_context, company_specific_context)
             if section
         )
 
@@ -224,6 +224,8 @@ class ContextBuilderService:
         capabilities: set[str] = set()
         if self.SQL_TOOL_NAME in tool_names:
             capabilities.add("can_query_sql")
+        if any(tool_name in self.MEMORY_TOOL_NAMES for tool_name in tool_names):
+            capabilities.add("can_use_memory")
         if any(tool_name in self.FILE_GENERATION_TOOL_NAMES for tool_name in tool_names):
             capabilities.add("can_generate_files")
         if self.EMAIL_TOOL_NAME in tool_names:
@@ -309,13 +311,9 @@ class ContextBuilderService:
                 collection_names=rag_collections,
             )
 
-        memory_context = ""
-        if any(tool_name in self.MEMORY_TOOL_NAMES for tool_name in enabled_tool_names):
-            memory_context = self._build_memory_context()
-
-        final_system_context = "\n".join(
+        final_system_context = "\n\n".join(
             section
-            for section in (sql_context, collection_context, memory_context, rendered_system_prompt)
+            for section in (rendered_system_prompt, collection_context, sql_context)
             if section
         )
 
@@ -351,9 +349,9 @@ class ContextBuilderService:
             return ""
 
         lines = [
-            "### Available Document Collections",
-            "Use `iat_document_search` when internal company documents may help answer the user.",
-            "Available collections:",
+            "## Colecciones documentales disponibles",
+            "Usa `iat_document_search` cuando documentos internos de la empresa puedan ayudar a responder al usuario.",
+            "### Colecciones",
         ]
 
         for name, description in selected_entries[:20]:
@@ -365,19 +363,12 @@ class ContextBuilderService:
         if len(lines) <= 3:
             return ""
 
-        lines.append("If one collection clearly matches the question, prefer that collection. If unclear, search without specifying a collection first.")
+        lines.append(
+            "Si una coleccion coincide claramente con la pregunta, prefierela. "
+            "Si no esta claro, busca primero sin especificar coleccion."
+        )
         return "\n".join(lines)
 
-    def _build_memory_context(self) -> str:
-        return "\n".join([
-            "### Personal Memory",
-            "The user may have personal memory pages built from saved notes, links, files, and chat messages.",
-            "Use `iat_memory_search` when the user is explicitly asking about saved notes, remembered items, or personal continuity across sessions.",
-            "If `iat_memory_search` returns a result with `has_native_files=true`, call `iat_memory_get_page` before answering whenever the attached file contents may matter.",
-            "Use `iat_memory_get_page` to read a specific page before answering when needed.",
-            "Prefer memory pages as compiled context; do not assume all saved content is globally relevant.",
-        ])
-
     def build_user_turn_prompt(self,
                                company: Company,
                                user_identifier: str,

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/services/query_service.py

@@ -1362,3 +1362,244 @@ class QueryService:
         except Exception as e:
             logging.exception(e)
             return {'error': True, "error_message": f"{str(e)}"}
+
+    def preview_prompt_context(self,
+                               company_short_name: str,
+                               user_identifier: str,
+                               prompt_name: str,
+                               *,
+                               client_data: dict | None = None,
+                               question: str = "") -> dict:
+        try:
+            company = self.profile_repo.get_company_by_short_name(short_name=company_short_name)
+            if not company:
+                return {
+                    "error": True,
+                    "status_code": 404,
+                    "error_message": self.i18n_service.t(
+                        'errors.company_not_found',
+                        company_short_name=company_short_name,
+                    ),
+                }
+
+            if not prompt_name:
+                return {
+                    "error": True,
+                    "status_code": 400,
+                    "error_message": "Prompt name is required.",
+                }
+
+            prompt_output_contract = self._resolve_prompt_output_contract(company, prompt_name)
+            if not prompt_output_contract:
+                return {
+                    "error": True,
+                    "status_code": 404,
+                    "error_message": "Prompt not found.",
+                }
+
+            safe_client_data = client_data if isinstance(client_data, dict) else {}
+            effective_model = self._resolve_model(company_short_name, None, prompt_output_contract)
+            output_schema = self._build_output_text_schema_payload(
+                company_short_name,
+                effective_model,
+                prompt_output_contract,
+            )
+            provider = self._get_provider(company_short_name, effective_model)
+
+            user_turn_prompt, effective_question, _images = self.context_builder.build_user_turn_prompt(
+                company=company,
+                user_identifier=user_identifier,
+                client_data=safe_client_data,
+                files=[],
+                prompt_name=prompt_name,
+                question=question or "",
+            )
+
+            if prompt_output_contract.get("schema") and (
+                not output_schema or provider in ("gemini", "deepseek", "openai_compatible")
+            ):
+                user_turn_prompt = self._append_structured_schema_instruction(
+                    user_turn_prompt=user_turn_prompt,
+                    contract=prompt_output_contract,
+                )
+
+            is_agent_execution = self._is_agentic_execution(prompt_output_contract)
+            tools = self.tool_service.get_tools_for_llm(company)
+            tools, tool_router_metrics = self._apply_prompt_tool_policy(
+                company_short_name=company_short_name,
+                prompt_output_contract=prompt_output_contract,
+                tools=tools,
+                include_forced_tools=not is_agent_execution,
+            )
+            if tool_router_metrics is None:
+                tools, tool_router_metrics = self._select_tools_for_llm_with_metrics(
+                    company_short_name=company_short_name,
+                    company=company,
+                    user_identifier=user_identifier,
+                    question=effective_question,
+                    tools=tools,
+                )
+            else:
+                user_turn_prompt = self._append_effective_tools_instruction(
+                    user_turn_prompt,
+                    tools,
+                    explicit_only=True,
+                )
+
+            memory_lookup_decision = self.memory_lookup_policy_service.resolve(
+                question=effective_question,
+                tools=tools,
+                tool_router_metrics=tool_router_metrics,
+            )
+            user_turn_prompt = self._append_memory_search_instruction(
+                user_turn_prompt,
+                memory_lookup_decision.should_suggest_memory_search,
+            )
+
+            runtime_context = ""
+            selected_system_prompt_keys: list[str] = []
+            preview_note = None
+
+            if is_agent_execution:
+                validation_error = self._validate_agent_resource_scope(prompt_output_contract, tools)
+                if validation_error:
+                    return {
+                        "error": True,
+                        "status_code": 400,
+                        "error_message": validation_error,
+                    }
+
+                runtime_context, _, selected_system_prompt_keys = self.context_builder.build_agent_system_context(
+                    company_short_name=company_short_name,
+                    user_identifier=user_identifier,
+                    prompt_name=prompt_name,
+                    enabled_tools=tools,
+                    prompt_output_contract=prompt_output_contract,
+                    query_text=effective_question,
+                )
+                final_input_preview = self._prepend_agent_runtime_context(
+                    user_turn_prompt,
+                    runtime_context,
+                )
+                history_type = "stateless"
+            else:
+                runtime_context, _, selected_system_prompt_keys = self.context_builder.build_system_context(
+                    company_short_name,
+                    user_identifier,
+                    query_text=effective_question,
+                )
+                final_input_preview = (
+                    "### Chat Runtime Context\n"
+                    f"{runtime_context}\n\n"
+                    "### Chat Turn\n"
+                    f"{user_turn_prompt}"
+                ) if runtime_context else user_turn_prompt
+                history_type = self._get_history_type(company_short_name, effective_model)
+                preview_note = (
+                    "This conversational preview shows the logical system context and turn. "
+                    "Providers with server-side history may persist the base context separately."
+                )
+
+            token_count = 0
+            try:
+                token_count = int(self.llm_client.count_tokens(final_input_preview or ""))
+            except Exception:
+                token_count = 0
+
+            selected_system_prompt_keys = self._normalize_selected_system_prompt_keys(
+                selected_system_prompt_keys
+            )
+
+            return {
+                "prompt_name": prompt_name,
+                "execution_mode": prompt_output_contract.get("execution_mode") or "conversational",
+                "visible_in_chat": bool(prompt_output_contract.get("visible_in_chat", True)),
+                "response_mode": prompt_output_contract.get("response_mode") or "chat_compatible",
+                "history_type": history_type,
+                "provider": provider,
+                "effective_model": effective_model,
+                "tool_policy": self._normalize_prompt_tool_policy(prompt_output_contract.get("tool_policy")),
+                "resource_bindings": list(prompt_output_contract.get("resource_bindings") or []),
+                "selected_system_prompt_keys": selected_system_prompt_keys,
+                "tool_names": self._get_tool_names(tools),
+                "tool_router": tool_router_metrics or {},
+                "memory_lookup": {
+                    "tool_choice_override": memory_lookup_decision.tool_choice_override,
+                    "should_suggest_memory_search": memory_lookup_decision.should_suggest_memory_search,
+                    "reason": memory_lookup_decision.reason,
+                    "confidence": memory_lookup_decision.confidence,
+                    "metadata": memory_lookup_decision.metadata,
+                },
+                "token_count": token_count,
+                "runtime_context": runtime_context or "",
+                "user_turn_prompt": user_turn_prompt,
+                "final_input_preview": final_input_preview,
+                "note": preview_note,
+            }
+        except Exception as e:
+            logging.exception(e)
+            return {'error': True, "status_code": 500, "error_message": f"{str(e)}"}
+
+    def preview_chat_context(self,
+                             company_short_name: str,
+                             user_identifier: str,
+                             *,
+                             question: str = "") -> dict:
+        try:
+            company = self.profile_repo.get_company_by_short_name(short_name=company_short_name)
+            if not company:
+                return {
+                    "error": True,
+                    "status_code": 404,
+                    "error_message": self.i18n_service.t(
+                        'errors.company_not_found',
+                        company_short_name=company_short_name,
+                    ),
+                }
+
+            effective_model = self._resolve_model(company_short_name, None, {})
+            provider = self._get_provider(company_short_name, effective_model)
+            history_type = self._get_history_type(company_short_name, effective_model)
+            tools = self.tool_service.get_tools_for_llm(company)
+            runtime_context, _user_profile, selected_system_prompt_keys = self.context_builder.build_system_context(
+                company_short_name,
+                user_identifier,
+                query_text=question or None,
+            )
+            selected_system_prompt_keys = self._normalize_selected_system_prompt_keys(
+                selected_system_prompt_keys
+            )
+
+            context_version = ""
+            cached_context_version = ""
+            if runtime_context:
+                context_version = self.context_builder.compute_context_version(runtime_context)
+            try:
+                cached_context_version = str(
+                    self.session_context.get_context_version(company_short_name, user_identifier) or ""
+                ).strip()
+            except Exception:
+                cached_context_version = ""
+            token_count = 0
+            try:
+                token_count = int(self.llm_client.count_tokens(runtime_context or ""))
+            except Exception:
+                token_count = 0
+
+            return {
+                "mode": "chat",
+                "execution_mode": "conversational",
+                "response_mode": "chat_compatible",
+                "history_type": history_type,
+                "provider": provider,
+                "effective_model": effective_model,
+                "selected_system_prompt_keys": selected_system_prompt_keys,
+                "tool_names": self._get_tool_names(tools),
+                "context_version": context_version,
+                "cached_context_version": cached_context_version,
+                "token_count": token_count,
+                "context": runtime_context or "",
+            }
+        except Exception as e:
+            logging.exception(e)
+            return {'error': True, "status_code": 500, "error_message": f"{str(e)}"}

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/services/system_prompt_catalog.py

@@ -285,7 +285,7 @@ def build_system_prompt_payload(
         selected_keys.append(key)
 
     return {
-        "content": "\n".join(content_parts),
+        "content": "\n\n".join(content_parts),
         "selected_keys": selected_keys,
     }
 

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/chat_state_rules.prompt

@@ -1,4 +1,4 @@
-Reglas obligatorias de contexto para conversaciones de chat:
+### Reglas conversacionales de chat
 
 - Si te hacen preguntas especificas sobre un cliente, asume que la pregunta se
   refiere al ultimo cliente identificado en la conversacion, salvo que el usuario

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/chat_user_profile.prompt

@@ -1,4 +1,4 @@
-### Informacion del usuario que esta consultando este chat
+### Usuario actual
 - Identificador unico de usuario: {{ user_identifier }}
 - Nombre: {{ user_fullname }}
 - Email: {{ user_email }}

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/core_identity.prompt

@@ -1,6 +1,9 @@
+## Instrucciones del asistente
+
+### Identidad del asistente
 Eres un asistente que responde preguntas o ejecuta tareas segun el contexto
 de la empresa.
 
-### Nombre de la empresa
+### Empresa
 - Nombre: {{company}}, tambien se conoce como {{ company_short_name }}
-- Idioma: el idioma en que debes responder inicialmente es {{language}}
+- Idioma inicial de respuesta: {{language}}

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/email_output.prompt

@@ -1,4 +1,4 @@
-Reglas para generacion de emails:
+### Generacion de emails
 
 - Si generas el cuerpo de un email, entregalo en HTML limpio y listo para enviar.
 - Firma con "Saludos, IAToolkit".

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/file_download_output.prompt

@@ -1,4 +1,4 @@
-HTML para descarga de archivos:
+### Descarga de archivos
 
 - Siempre que generes un archivo descargable con una tool como `iat_generate_excel`
   o `iat_generate_pdf`, retorna al usuario un bloque HTML claro con el enlace

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/html_structures.prompt

@@ -1,13 +1,13 @@
-Formatos HTML a usar cuando el prompt o la tarea lo piden explicitamente:
+### HTML estructurado
 
-Tablas:
+#### Tablas
 - Usa como base `table table-striped table-hover`.
 - Si una columna contiene RUT, fecha, id certificado o valores similares, usa
   clase `nowrap` en el `<th>` y en el `<td>` correspondiente cuando aplique.
 - Si una columna debe ir centrada o alineada a la derecha, agrega
   `class="text-center"` o `class="text-right"` tanto en `<th>` como en cada `<td>`.
 
-Listas clave-valor:
+#### Listas clave-valor
 - Cuando presentes datos como lista clave-valor, envuelve siempre la clave
   en `<strong>`.
 - Ejemplo:

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/links_documents.prompt

@@ -1,4 +1,4 @@
-Reglas obligatorias sobre links y documentos:
+### Links y documentos
 
 - Si el usuario pide "un link", "el link al documento", "el link original",
   "la fuente" o "la URL del documento", prioriza siempre `source_url`.

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/multimodal_basics.prompt

@@ -1,4 +1,4 @@
-Reglas de generacion de imagenes y contenido multimodal:
+### Contenido multimodal
 
 - Si generas imagenes, respeta el schema esperado en `answer` y no incrustes
   binarios ni base64 dentro del JSON.

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/output_basics.prompt

@@ -1,4 +1,4 @@
-Reglas generales de salida:
+### Salida general
 
 - Responde de forma directa y util para el usuario.
 - Usa secciones y titulos solo cuando la respuesta sea compleja y realmente tenga

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/presentation_formatting.prompt

@@ -1,4 +1,4 @@
-Formato y estilo de presentacion para respuestas conversacionales:
+### Presentacion conversacional
 
 - Cuando generes tablas o listas que contengan fechas, usa formato `dd-mm-aaaa`.
 - Cuando generes tablas o listas que contengan montos:

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/sql_aggregation_scope.prompt

@@ -1,4 +1,4 @@
-Reglas de agregacion y alcance:
+### SQL: agregacion y alcance
 
 - Si una consulta usa `GROUP BY`, toda columna del `SELECT` que no este agregada
   debe estar explicitamente en `GROUP BY`.

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/sql_casting.prompt

@@ -1,4 +1,4 @@
-Reglas de casting y tipos:
+### SQL: casting y tipos
 
 - Si un numero puede venir con decimales, usa `NUMERIC`, no `INTEGER`.
 - Para numeros extraidos desde JSONB que pueden venir vacios, usa

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/sql_core.prompt

@@ -1,4 +1,4 @@
-Reglas base para SQL:
+### SQL: reglas base
 
 - Trabaja siempre en PostgreSQL y genera consultas sintacticamente validas.
 - Usa solo tablas, columnas y relaciones presentes en el schema provisto.

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/sql_jsonb.prompt

@@ -1,4 +1,4 @@
-Reglas para columnas JSONB:
+### SQL: columnas JSONB
 
 - Nunca trates una clave JSONB como si fuera una columna fisica.
 - Usa `jsonb_col->>'campo'` para texto y `jsonb_col->'campo'` para objetos o arrays.

{iatoolkit-2.3.0 → iatoolkit-2.3.1}/src/iatoolkit/system_prompts/tool_html_passthrough.prompt

@@ -1,4 +1,4 @@
-Regla critica de passthrough de HTML de herramientas:
+### Passthrough de HTML de herramientas
 
 - Si una herramienta devuelve contenido HTML util para el usuario final, devuelve
   ese mismo HTML literalmente dentro del campo `answer`.