iatoolkit 2.0.2__tar.gz → 2.2.1__tar.gz

{iatoolkit-2.0.2/src/iatoolkit.egg-info → iatoolkit-2.2.1}/PKG-INFO

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

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/__init__.py

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

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/config/system_tools_pack.yaml

@@ -264,8 +264,6 @@ tools:
           description: "Opcional en la práctica. Usa null cuando no necesites filtrar por metadata. No inventes filtros ni envíes [] por defecto. Ejemplo: [{'key':'doc.type','value':'invoice'},{'key':'chunk.source_type','value':'table'}]."
       required:
         - query
-        - collection
-        - metadata_filter
   - function_name: iat_memory_search
     description: Busca páginas relevantes dentro de la Memoria personal del usuario y retorna contexto compilado. Incluye la señal `has_native_files` cuando una memoria tiene archivos fuente que pueden adjuntarse nativamente al modelo. Debe usarse antes de responder preguntas sobre cosas guardadas, notas previas, memoria del usuario, continuidad entre sesiones o "lo que hablamos/guardé antes".
     routing:

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/infra/llm_providers/anthropic_adapter.py

@@ -32,7 +32,8 @@ class AnthropicAdapter:
                         tool_choice: str = "auto",
                         images: Optional[List[Dict]] = None,
                         attachments: Optional[List[Dict]] = None,
-                        store: Optional[bool] = None) -> LLMResponse:
+                        store: Optional[bool] = None,
+                        metadata: Optional[Dict[str, str]] = None) -> LLMResponse:
         """
         Calls Anthropic Messages API and maps the response to common LLMResponse.
 
@@ -44,6 +45,7 @@ class AnthropicAdapter:
         _ = reasoning
         _ = attachments
         _ = store
+        _ = metadata
 
         try:
             full_input = (context_history or []) + input

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/infra/llm_providers/gemini_adapter.py

@@ -52,9 +52,11 @@ class GeminiAdapter:
                         images: Optional[List[Dict]] = None,
                         attachments: Optional[List[Dict]] = None,
                         store: Optional[bool] = None,
+                        metadata: Optional[Dict[str, str]] = None,
                         ) -> LLMResponse:
         try:
             _ = store
+            _ = metadata
 
             # Separamos las instrucciones del sistema del resto del contenido
             system_instruction, filtered_input = self._extract_system_and_filter_input(

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/infra/llm_providers/openai_adapter.py

@@ -30,7 +30,8 @@ class OpenAIAdapter:
                         tool_choice: str = "auto",
                         images: Optional[List[Dict]] = None,
                         attachments: Optional[List[Dict]] = None,
-                        store: Optional[bool] = None) -> LLMResponse:
+                        store: Optional[bool] = None,
+                        metadata: Optional[Dict[str, str]] = None) -> LLMResponse:
         """Llamada a la API de OpenAI y mapeo a estructura común"""
         try:
             # Handle multimodal input if images are present
@@ -57,6 +58,8 @@ class OpenAIAdapter:
                 params['reasoning'] = reasoning
             if store is not None:
                 params['store'] = store
+            if metadata:
+                params['metadata'] = metadata
             tool_choice_payload = self._map_tool_choice(tool_choice, tools or [])
             if tool_choice_payload is not None:
                 params['tool_choice'] = tool_choice_payload

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/infra/llm_providers/openai_compatible_chat_adapter.py

@@ -60,6 +60,8 @@ class OpenAICompatibleChatAdapter:
             )
 
             tools_payload = self._build_tools_payload(tools)
+            if not tools_payload:
+                tool_choice = None
 
             if has_function_outputs and tool_choice == "auto":
                 logging.debug(

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/locales/en.yaml

@@ -32,6 +32,8 @@ ui:
     latency_p95: "Latency (Avg)"
     error_rate: "Error Rate (1h)"
     queue: "Pending Tasks"
+    running: "Running"
+    waiting: "Waiting"
     tab_chats: "Live Chats"
     tab_agents: "Agents"
     tab_logs: "Access Logs"
@@ -43,6 +45,13 @@ ui:
     tool_router_top_n: "Top N"
     tool_router_min_confidence: "Min confidence"
     tool_router_rebuild_profiles: "Rebuild Profiles"
+    task_reconciliation_eyebrow: "Task Reconciliation"
+    task_reconciliation_title: "Automatic recovery signals (24h)"
+    task_reconciliation_note: "Derived from worker reconciliation"
+    task_reconciliation_total: "Reconciled"
+    task_reconciliation_requeued: "Requeued"
+    task_reconciliation_normalized: "Normalized"
+    task_reconciliation_failed: "Recovered As Failed"
 
     inspector:
       title: "Interaction Inspector"
@@ -201,6 +210,107 @@ ui:
     unsaved_changes_message: "You have unsaved changes. Do you want to save them before proceeding?"
     discard_changes: "Discard Changes"
     description: "Description"
+    skills: "Skills"
+
+  skills:
+    title: "Skills"
+    search_placeholder: "Search skills"
+    search_tools_placeholder: "Search tools"
+    search_prompts_placeholder: "Search prompts and agents"
+    status_filter_all: "All statuses"
+    status_active: "Active"
+    status_draft: "Draft"
+    status_archived: "Archived"
+    select_skill: "Select a skill"
+    archive: "Archive"
+    tab_editor: "Editor"
+    tab_resources: "Resources"
+    tab_prompt_bindings: "Prompts & Agents"
+    tab_versions: "Versions"
+    name_label: "Name"
+    name_placeholder: "Research Briefing"
+    key_label: "Key"
+    key_help: "Stable identifier used by prompts, agents, and bundles."
+    status_label: "Status"
+    activation_label: "Activation"
+    activation_explicit: "Explicit"
+    owner_label: "Owner"
+    description_placeholder: "What this skill is for and when to use it."
+    tags_label: "Tags"
+    tags_placeholder: "research, compliance, onboarding"
+    tags_help: "Comma-separated tags."
+    tool_policy_title: "Tool Policy"
+    tool_policy_help: "Skills can contribute an explicit tool subset to prompts and agents."
+    mode_label: "Mode"
+    mode_inherit: "Inherit"
+    mode_explicit: "Explicit"
+    body_label: "Body"
+    body_placeholder: "Reusable instructions, constraints, examples, and conventions shared across agents."
+    resource_bindings_title: "Resource Bindings"
+    resource_bindings_help: "Attach config, static text, SQL, RAG, and tools as referenced resources for this skill."
+    resource_bindings_empty: "No resource bindings yet."
+    add_resource: "Add resource"
+    prompt_bindings_title: "Prompt & Agent Bindings"
+    prompt_bindings_help: "Choose which prompts and agent prompts will consume this skill at runtime."
+    prompt_library_help: "Attach reusable skills that enrich prompt runtime with shared behavior, tools, and context."
+    prompt_bindings_summary: "{count} prompts/agents use this skill."
+    prompt_bindings_runtime_help: "Only active skills are resolved at runtime. Draft or archived bindings stay visible here for maintenance."
+    prompt_bindings_missing: "Missing skills: {names}"
+    version_history_title: "Version History"
+    select_skill_versions: "Select a skill to load versions."
+    snapshot_detail_title: "Snapshot Detail"
+    summary_label: "Summary"
+    raw_snapshot_label: "Raw Snapshot"
+    restore_selected_version: "Restore selected version"
+    workspace_placeholder: "Skills package reusable behavior, tools, and resources for prompts and agents."
+    new_skill_title: "New Skill"
+    new_skill_description_placeholder: "Reusable guidance for research-oriented prompts and agents."
+    create_skill: "Create skill"
+    open_library: "Open Skills Library"
+    loading: "Loading skills..."
+    empty: "No skills found."
+    load_failed: "Failed to load skills."
+    prompt_bindings_load_failed: "Failed to load prompt skills."
+    prompts_save_failed: "Failed to save prompt bindings."
+    discard_confirm: "You have unsaved changes. Discard them?"
+    name_required: "Name and key are required."
+    create_failed: "Failed to create skill."
+    create_ok: "Skill created."
+    usage_summary: "{prompts} prompts/agents · {resources} resources"
+    tools_loading: "Loading tools..."
+    no_tools: "No tools available."
+    tools_summary_inherit: "This skill inherits tool selection from the prompt."
+    tools_summary_explicit: "{count} explicit tools selected."
+    no_prompts: "No prompts available."
+    no_versions: "No saved versions yet."
+    unknown_user: "Unknown user"
+    invalid_payload: "Invalid skill payload."
+    save_failed: "Failed to save skill."
+    resources_save_failed: "Failed to save resource bindings."
+    save_ok: "Skill saved successfully."
+    archive_confirm: "Archive this skill?"
+    archive_failed: "Failed to archive skill."
+    archive_ok: "Skill archived."
+    restore_confirm: "Restore this version? Current edits will be replaced."
+    restore_failed: "Failed to restore skill version."
+    restore_ok: "Skill version restored."
+    readonly_message: "Skill editing requires admin or owner role."
+    uncategorized: "Uncategorized"
+    binding_label: "Binding {number}"
+    resource_type_label: "Resource type"
+    resource_key_label: "Resource key"
+    resource_key_placeholder: "routing.yaml or collection name"
+    metadata_json_label: "Metadata JSON"
+    prompt_type_agent: "Agent"
+    prompt_type_prompt: "Prompt"
+    resource_type_tool: "Tool"
+    resource_type_rag_collection: "RAG collection"
+    resource_type_sql_source: "SQL source"
+    resource_type_sql_dataset: "SQL dataset"
+    resource_type_config: "Config"
+    resource_type_static_text: "Static text"
+    version_detail_meta: "v{version} · {created_at} · {created_by}"
+    saving: "Saving..."
 
   ops_mobile:
     title: "Ops Mobile"
@@ -343,6 +453,15 @@ ui:
     error_deleting_profile: "Error deleting processing profile"
     profile_deleted: "Processing profile deleted."
     refresh_runs: "Refresh Runs"
+    filter_status_all: "All statuses"
+    filter_status_active: "Active"
+    filter_status_attention: "Needs attention"
+    time_filter: "Time"
+    filter_time_3h: "Last 3 hours"
+    filter_time_24h: "Last 24 hours"
+    filter_time_7d: "Last 7 days"
+    filter_time_all: "All time"
+    default_view: "Default view"
     run_id: "Run"
     run_profile: "Profile"
     run_status: "Status"
@@ -362,8 +481,10 @@ ui:
     run_completed_short: "C"
     run_failed_short: "F"
     no_runs: "No pipeline runs yet."
+    no_runs_match_filters: "No pipeline runs match the current filters."
     error_loading_runs: "Error loading pipeline runs"
     error_loading_run_detail: "Error loading pipeline run details"
+    showing_runs: "Showing"
     view_run: "View run"
     view_result: "View result"
     run_detail_title: "Pipeline Run"
@@ -392,11 +513,15 @@ ui:
     artifact_rows: "Rows"
     download_artifact: "Download"
     progress_label: "Progress"
+    progress_pending_discovery: "Global progress will appear after discovery completes."
+    progress_pending_discovery_short: "Pending discovery"
     auto_refresh_on: "Live refresh on"
     auto_refresh_paused: "Live refresh paused"
     task_progress: "Task progress"
     files_counter: "Files"
     items_counter: "Items"
+    submitted_label: "submitted"
+    run_phase: "Run phase"
     task_stage_pending: "Pending"
     task_stage_started: "Started"
     task_stage_preprocessing_attachments: "Pre-processing attachments"
@@ -830,6 +955,7 @@ ui:
     save_btn: "Save"
     tab_editor: "Editor"
     tab_output: "Output"
+    tab_tools: "Tools"
     tab_playground: "Playground"
     config_title: "Config"
     desc_label: "Description"
@@ -882,6 +1008,26 @@ ui:
     store_response_default: "Provider default"
     store_response_true: "Yes"
     store_response_false: "No"
+    tools_title: "Tool Selection"
+    tools_mode_label: "Tools Mode"
+    tools_mode_inherit: "Automatic"
+    tools_mode_explicit: "Explicit"
+    tools_mode_help: "In explicit mode, the prompt sends only the selected tools and skips the router."
+    tools_search_placeholder: "Search tools..."
+    tools_summary_inherit: "This prompt uses automatic tool selection."
+    tools_summary_explicit: "This prompt will send {count} selected tools."
+    tools_empty_state: "No tools available to select."
+    tools_loading: "Loading tools..."
+    tools_load_failed: "Tools could not be loaded."
+    tools_selection_required: "Select at least one tool when using explicit mode."
+    tools_missing_warning: "These tools no longer exist for the company: {names}"
+    tools_inactive_warning: "These tools are inactive and will not be sent: {names}"
+    tools_source_system: "SYSTEM"
+    tools_source_pack: "PACK"
+    tools_source_user: "USER"
+    tools_type_http: "HTTP"
+    tools_type_native: "NATIVE"
+    tools_type_system: "SYSTEM"
     run_btn: "Run"
     copy_html_btn: "Copy HTML"
     copy_json_btn: "Copy JSON"

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/locales/es.yaml

@@ -33,6 +33,8 @@ ui:
     latency_p95: "Latencia (Prom)"
     error_rate: "Tasa Error (1h)"
     queue: "Tareas Pendientes"
+    running: "En ejecución"
+    waiting: "Esperando"
     tab_chats: "Chats en Vivo"
     tab_agents: "Agentes"
     tab_logs: "Logs de Acceso"
@@ -44,6 +46,13 @@ ui:
     tool_router_top_n: "Top N"
     tool_router_min_confidence: "Confianza mínima"
     tool_router_rebuild_profiles: "Reconstruir perfiles"
+    task_reconciliation_eyebrow: "Conciliación de Tareas"
+    task_reconciliation_title: "Señales automáticas de recuperación (24h)"
+    task_reconciliation_note: "Derivado de la conciliación del worker"
+    task_reconciliation_total: "Conciliadas"
+    task_reconciliation_requeued: "Reencoladas"
+    task_reconciliation_normalized: "Normalizadas"
+    task_reconciliation_failed: "Recuperadas como fallidas"
 
     inspector:
       title: "Inspector de Interacción"
@@ -201,6 +210,107 @@ ui:
     discard_changes: "Descartar cambios"
     loading: "Cargando..."
     description: "Descripción"
+    skills: "Skills"
+
+  skills:
+    title: "Skills"
+    search_placeholder: "Buscar skills"
+    search_tools_placeholder: "Buscar tools"
+    search_prompts_placeholder: "Buscar prompts y agentes"
+    status_filter_all: "Todos los estados"
+    status_active: "Activo"
+    status_draft: "Borrador"
+    status_archived: "Archivado"
+    select_skill: "Selecciona una skill"
+    archive: "Archivar"
+    tab_editor: "Editor"
+    tab_resources: "Recursos"
+    tab_prompt_bindings: "Prompts y Agentes"
+    tab_versions: "Versiones"
+    name_label: "Nombre"
+    name_placeholder: "Research Briefing"
+    key_label: "Key"
+    key_help: "Identificador estable usado por prompts, agentes y bundles."
+    status_label: "Estado"
+    activation_label: "Activación"
+    activation_explicit: "Explícita"
+    owner_label: "Owner"
+    description_placeholder: "Para qué sirve esta skill y cuándo conviene usarla."
+    tags_label: "Tags"
+    tags_placeholder: "research, compliance, onboarding"
+    tags_help: "Tags separadas por coma."
+    tool_policy_title: "Política de Tools"
+    tool_policy_help: "Las skills pueden aportar un subconjunto explícito de tools a prompts y agentes."
+    mode_label: "Modo"
+    mode_inherit: "Heredar"
+    mode_explicit: "Explícito"
+    body_label: "Body"
+    body_placeholder: "Instrucciones reutilizables, restricciones, ejemplos y convenciones compartidas entre agentes."
+    resource_bindings_title: "Bindings de Recursos"
+    resource_bindings_help: "Asocia config, static text, SQL, RAG y tools como recursos referenciados por esta skill."
+    resource_bindings_empty: "Todavía no hay bindings de recursos."
+    add_resource: "Agregar recurso"
+    prompt_bindings_title: "Bindings de Prompts y Agentes"
+    prompt_bindings_help: "Elige qué prompts y prompts tipo agent consumirán esta skill en runtime."
+    prompt_library_help: "Asocia skills reutilizables que enriquecen el runtime del prompt con comportamiento, tools y contexto compartidos."
+    prompt_bindings_summary: "{count} prompts/agentes usan esta skill."
+    prompt_bindings_runtime_help: "Solo las skills activas se resuelven en runtime. Los bindings draft o archived siguen visibles aquí para mantenimiento."
+    prompt_bindings_missing: "Skills faltantes: {names}"
+    version_history_title: "Historial de Versiones"
+    select_skill_versions: "Selecciona una skill para cargar versiones."
+    snapshot_detail_title: "Detalle del Snapshot"
+    summary_label: "Resumen"
+    raw_snapshot_label: "Snapshot crudo"
+    restore_selected_version: "Restaurar versión seleccionada"
+    workspace_placeholder: "Las skills empaquetan comportamiento reutilizable, tools y recursos para prompts y agentes."
+    new_skill_title: "Nueva Skill"
+    new_skill_description_placeholder: "Guía reutilizable para prompts y agentes orientados a research."
+    create_skill: "Crear skill"
+    open_library: "Abrir librería de Skills"
+    loading: "Cargando skills..."
+    empty: "No se encontraron skills."
+    load_failed: "No se pudieron cargar las skills."
+    prompt_bindings_load_failed: "No se pudieron cargar las skills del prompt."
+    prompts_save_failed: "No se pudieron guardar los bindings de prompts."
+    discard_confirm: "Tienes cambios sin guardar. ¿Quieres descartarlos?"
+    name_required: "Nombre y key son obligatorios."
+    create_failed: "No se pudo crear la skill."
+    create_ok: "Skill creada."
+    usage_summary: "{prompts} prompts/agentes · {resources} recursos"
+    tools_loading: "Cargando tools..."
+    no_tools: "No hay tools disponibles."
+    tools_summary_inherit: "Esta skill hereda la selección de tools desde el prompt."
+    tools_summary_explicit: "{count} tools explícitas seleccionadas."
+    no_prompts: "No hay prompts disponibles."
+    no_versions: "Todavía no hay versiones guardadas."
+    unknown_user: "Usuario desconocido"
+    invalid_payload: "Payload de skill inválido."
+    save_failed: "No se pudo guardar la skill."
+    resources_save_failed: "No se pudieron guardar los bindings de recursos."
+    save_ok: "Skill guardada correctamente."
+    archive_confirm: "¿Archivar esta skill?"
+    archive_failed: "No se pudo archivar la skill."
+    archive_ok: "Skill archivada."
+    restore_confirm: "¿Restaurar esta versión? Los cambios actuales serán reemplazados."
+    restore_failed: "No se pudo restaurar la versión de la skill."
+    restore_ok: "Versión de skill restaurada."
+    readonly_message: "La edición de skills requiere rol admin u owner."
+    uncategorized: "Sin categoría"
+    binding_label: "Binding {number}"
+    resource_type_label: "Tipo de recurso"
+    resource_key_label: "Key del recurso"
+    resource_key_placeholder: "routing.yaml o nombre de colección"
+    metadata_json_label: "Metadata JSON"
+    prompt_type_agent: "Agente"
+    prompt_type_prompt: "Prompt"
+    resource_type_tool: "Tool"
+    resource_type_rag_collection: "Colección RAG"
+    resource_type_sql_source: "Fuente SQL"
+    resource_type_sql_dataset: "Dataset SQL"
+    resource_type_config: "Config"
+    resource_type_static_text: "Texto estático"
+    version_detail_meta: "v{version} · {created_at} · {created_by}"
+    saving: "Guardando..."
 
   ops_mobile:
     title: "Ops Mobile"
@@ -344,6 +454,15 @@ ui:
     error_deleting_profile: "Error al eliminar el perfil de procesamiento"
     profile_deleted: "Perfil de procesamiento eliminado."
     refresh_runs: "Actualizar ejecuciones"
+    filter_status_all: "Todos los estados"
+    filter_status_active: "Activas"
+    filter_status_attention: "Requieren atención"
+    time_filter: "Tiempo"
+    filter_time_3h: "Últimas 3 horas"
+    filter_time_24h: "Últimas 24 horas"
+    filter_time_7d: "Últimos 7 días"
+    filter_time_all: "Todo el historial"
+    default_view: "Vista por defecto"
     run_id: "Ejecución"
     run_profile: "Perfil"
     run_status: "Estado"
@@ -363,8 +482,10 @@ ui:
     run_completed_short: "C"
     run_failed_short: "F"
     no_runs: "Todavía no hay ejecuciones."
+    no_runs_match_filters: "No hay ejecuciones que coincidan con los filtros actuales."
     error_loading_runs: "Error al cargar ejecuciones"
     error_loading_run_detail: "Error al cargar el detalle de la ejecución"
+    showing_runs: "Mostrando"
     view_run: "Ver ejecución"
     view_result: "Ver resultado"
     run_detail_title: "Ejecución del pipeline"
@@ -393,11 +514,15 @@ ui:
     artifact_rows: "Filas"
     download_artifact: "Descargar"
     progress_label: "Progreso"
+    progress_pending_discovery: "El progreso global aparecerá cuando termine el descubrimiento."
+    progress_pending_discovery_short: "Descubrimiento pendiente"
     auto_refresh_on: "Actualización en vivo activa"
     auto_refresh_paused: "Actualización en vivo pausada"
     task_progress: "Progreso de la task"
     files_counter: "Archivos"
     items_counter: "Items"
+    submitted_label: "encolados"
+    run_phase: "Fase de la ejecución"
     task_stage_pending: "Pendiente"
     task_stage_started: "Iniciada"
     task_stage_preprocessing_attachments: "Preprocesando adjuntos"
@@ -833,6 +958,7 @@ ui:
     save_btn: "Guardar"
     tab_editor: "Editor"
     tab_output: "Salida"
+    tab_tools: "Tools"
     tab_playground: "Playground"
     config_title: "Configuración"
     desc_label: "Descripción"
@@ -885,6 +1011,26 @@ ui:
     store_response_default: "Por defecto del provider"
     store_response_true: "Sí"
     store_response_false: "No"
+    tools_title: "Selección de Tools"
+    tools_mode_label: "Modo de Tools"
+    tools_mode_inherit: "Automático"
+    tools_mode_explicit: "Explícito"
+    tools_mode_help: "En modo explícito, el prompt enviará solo las tools seleccionadas y saltará el router."
+    tools_search_placeholder: "Buscar tools..."
+    tools_summary_inherit: "Este prompt usa la selección automática de tools."
+    tools_summary_explicit: "Este prompt enviará {count} tools seleccionadas."
+    tools_empty_state: "No hay tools disponibles para seleccionar."
+    tools_loading: "Cargando tools..."
+    tools_load_failed: "No se pudieron cargar las tools."
+    tools_selection_required: "Selecciona al menos una tool cuando uses el modo explícito."
+    tools_missing_warning: "Estas tools ya no existen en la compañía: {names}"
+    tools_inactive_warning: "Estas tools están inactivas y no se enviarán: {names}"
+    tools_source_system: "SYSTEM"
+    tools_source_pack: "PACK"
+    tools_source_user: "USER"
+    tools_type_http: "HTTP"
+    tools_type_native: "NATIVE"
+    tools_type_system: "SYSTEM"
     run_btn: "Ejecutar"
     copy_html_btn: "Copiar HTML"
     copy_json_btn: "Copiar JSON"

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/repositories/llm_query_repo.py

@@ -187,6 +187,7 @@ class LLMQueryRepo:
             prompt.attachment_fallback = new_prompt.attachment_fallback or prompt.attachment_fallback or "extract"
             prompt.llm_model = new_prompt.llm_model
             prompt.llm_request_options = dict(new_prompt.llm_request_options or {})
+            prompt.tool_policy = dict(new_prompt.tool_policy or {})
         else:
             if not new_prompt.output_schema_mode:
                 new_prompt.output_schema_mode = "best_effort"
@@ -200,6 +201,8 @@ class LLMQueryRepo:
                 new_prompt.attachment_fallback = "extract"
             if new_prompt.llm_request_options is None:
                 new_prompt.llm_request_options = {}
+            if new_prompt.tool_policy is None:
+                new_prompt.tool_policy = {}
             self.session.add(new_prompt)
             prompt = new_prompt
 

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/repositories/models.py

@@ -558,6 +558,7 @@ class Prompt(Base):
     attachment_fallback = Column(String, nullable=False, default="extract")
     llm_model = Column(String, nullable=True, default=None)
     llm_request_options = Column(JSON_NATIVE, nullable=False, default=dict)
+    tool_policy = Column(JSON_NATIVE, nullable=False, default=dict)
     created_at = Column(DateTime, default=datetime.now)
     def to_dict(self):
         return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/repositories/vs_repo.py

@@ -3,6 +3,7 @@
 #
 # IAToolkit is open source software.
 
+import ast
 import json
 import logging
 import re
@@ -396,10 +397,13 @@ class VSRepo:
                 return None
             try:
                 decoded = json.loads(candidate)
-            except Exception as exc:
-                raise ValueError(
-                    "metadata_filter string must be empty/null or valid JSON representing a dictionary or a list of {key, value}"
-                ) from exc
+            except Exception:
+                try:
+                    decoded = ast.literal_eval(candidate)
+                except Exception as exc:
+                    raise ValueError(
+                        "metadata_filter string must be empty/null or valid JSON representing a dictionary or a list of {key, value}"
+                    ) from exc
             return VSRepo._normalize_metadata_filter_input(decoded)
 
         if isinstance(metadata_filter, dict):

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/services/configuration_service.py

@@ -551,7 +551,13 @@ class ConfigurationService:
                 if not isinstance(llm_request_options, dict):
                     add_error(f"prompts[{i}].llm_request_options", "Must be an object.")
                 else:
-                    allowed_option_keys = {"reasoning_effort", "store", "text_verbosity"}
+                    allowed_option_keys = {
+                        "reasoning_effort",
+                        "store",
+                        "text_verbosity",
+                        "prompt_version",
+                        "prompt_variant",
+                    }
                     unknown_option_keys = sorted(
                         key for key in llm_request_options.keys() if key not in allowed_option_keys
                     )
@@ -581,6 +587,61 @@ class ConfigurationService:
                             f"Unsupported value '{text_verbosity}'. Must be one of: {sorted(allowed_text_verbosity)}.",
                         )
 
+                    if "prompt_version" in llm_request_options:
+                        prompt_version = str(llm_request_options.get("prompt_version") or "").strip()
+                        if not prompt_version:
+                            add_error(
+                                f"prompts[{i}].llm_request_options.prompt_version",
+                                "Must be a non-empty string.",
+                            )
+
+                    if "prompt_variant" in llm_request_options:
+                        prompt_variant = str(llm_request_options.get("prompt_variant") or "").strip()
+                        if not prompt_variant:
+                            add_error(
+                                f"prompts[{i}].llm_request_options.prompt_variant",
+                                "Must be a non-empty string.",
+                            )
+
+            tool_policy = prompt.get("tool_policy")
+            if tool_policy is not None:
+                if not isinstance(tool_policy, dict):
+                    add_error(f"prompts[{i}].tool_policy", "Must be an object.")
+                else:
+                    allowed_tool_policy_keys = {"mode", "tool_names"}
+                    unknown_tool_policy_keys = sorted(
+                        key for key in tool_policy.keys() if key not in allowed_tool_policy_keys
+                    )
+                    if unknown_tool_policy_keys:
+                        add_error(
+                            f"prompts[{i}].tool_policy",
+                            f"Unsupported keys: {unknown_tool_policy_keys}.",
+                        )
+
+                    tool_policy_mode = str(tool_policy.get("mode") or "inherit").strip().lower()
+                    if tool_policy_mode not in {"inherit", "explicit"}:
+                        add_error(
+                            f"prompts[{i}].tool_policy.mode",
+                            "Unsupported value "
+                            f"'{tool_policy_mode}'. Must be one of: {sorted(['explicit', 'inherit'])}.",
+                        )
+
+                    tool_names = tool_policy.get("tool_names", [])
+                    if tool_names is None:
+                        tool_names = []
+                    if not isinstance(tool_names, list):
+                        add_error(f"prompts[{i}].tool_policy.tool_names", "Must be a list.")
+                    else:
+                        normalized_tool_names = []
+                        for tool_name_index, tool_name in enumerate(tool_names):
+                            if not isinstance(tool_name, str) or not tool_name.strip():
+                                add_error(
+                                    f"prompts[{i}].tool_policy.tool_names[{tool_name_index}]",
+                                    "Must be a non-empty string.",
+                                )
+                            else:
+                                normalized_tool_names.append(tool_name.strip())
+
             output_schema = prompt.get("output_schema")
             if output_schema is not None:
                 if not isinstance(output_schema, dict):

{iatoolkit-2.0.2 → iatoolkit-2.2.1}/src/iatoolkit/services/context_builder_service.py

@@ -107,6 +107,9 @@ class ContextBuilderService:
             "attachment_fallback": getattr(prompt_obj, "attachment_fallback", None),
             "llm_model": getattr(prompt_obj, "llm_model", None),
             "llm_request_options": dict(getattr(prompt_obj, "llm_request_options", None) or {}),
+            "tool_policy": self.prompt_service.normalize_tool_policy(
+                getattr(prompt_obj, "tool_policy", None)
+            ),
         }
 
     def build_system_context(