@contractspec/lib.ai-agent 7.0.6 → 7.0.10

package/dist/node/agent/agent-factory.js

@@ -632,602 +632,636 @@ var init_en = __esm(() => {
   });
 });
 
-// src/i18n/catalogs/fr.ts
+// src/i18n/catalogs/es.ts
 import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
-var frMessages;
-var init_fr = __esm(() => {
-  frMessages = defineTranslation2({
+var esMessages;
+var init_es = __esm(() => {
+  esMessages = defineTranslation2({
     meta: {
       key: "ai-agent.messages",
       version: "1.0.0",
       domain: "ai-agent",
-      description: "Toutes les chaînes destinées aux utilisateurs, aux LLM et aux développeurs pour le package ai-agent",
+      description: "Todas las cadenas de texto orientadas al usuario, al LLM y al desarrollador del paquete ai-agent",
       owners: ["platform"],
       stability: "experimental"
     },
-    locale: "fr",
+    locale: "es",
     fallback: "en",
     messages: {
       "agent.json.rules.validJsonOnly": {
-        value: "Vous DEVEZ produire uniquement du JSON valide.",
-        description: "JSON runner rule: output must be valid JSON"
+        value: "Usted DEBE generar ÚNICAMENTE JSON válido.",
+        description: "Regla del ejecutor JSON: la salida debe ser JSON válido"
       },
       "agent.json.rules.noMarkdownFences": {
-        value: "N'encapsulez pas la sortie dans des blocs de code markdown.",
-        description: "JSON runner rule: no markdown code fences"
+        value: "No envuelva la salida en bloques de código markdown.",
+        description: "Regla del ejecutor JSON: sin bloques de código markdown"
       },
       "agent.json.rules.noCommentary": {
-        value: "N'incluez ni commentaire ni explication.",
-        description: "JSON runner rule: no extra text"
+        value: "No incluya comentarios ni explicaciones.",
+        description: "Regla del ejecutor JSON: sin texto adicional"
       },
       "agent.json.rules.doubleQuotes": {
-        value: "Utilisez des guillemets doubles pour toutes les clés et valeurs de type chaîne.",
-        description: "JSON runner rule: double quotes only"
+        value: "Utilice comillas dobles para todas las claves y valores de cadena.",
+        description: "Regla del ejecutor JSON: solo comillas dobles"
       },
       "agent.json.rules.noTrailingCommas": {
-        value: "N'incluez pas de virgules finales.",
-        description: "JSON runner rule: no trailing commas"
+        value: "No incluya comas finales.",
+        description: "Regla del ejecutor JSON: sin comas finales"
       },
       "agent.json.defaultDescription": {
-        value: "Exécuteur d'agent JSON uniquement pour les pipelines déterministes.",
-        description: "Default description for the JSON runner spec"
+        value: "Ejecutor de agentes exclusivamente JSON para pipelines deterministas.",
+        description: "Descripción predeterminada para la especificación del ejecutor JSON"
       },
       "agent.json.systemPrompt": {
-        value: "Vous êtes un générateur JSON précis.",
-        description: "Default system prompt for the JSON runner"
+        value: "Usted es un generador preciso de JSON.",
+        description: "Prompt de sistema predeterminado para el ejecutor JSON"
       },
       "knowledge.header": {
-        value: "# Connaissances de référence",
-        description: "Header for injected knowledge section in system prompt"
+        value: "# Conocimiento de referencia",
+        description: "Encabezado para la sección de conocimiento inyectado en el prompt del sistema"
       },
       "knowledge.description": {
-        value: "Les informations suivantes sont fournies à titre de référence. Utilisez-les pour éclairer vos réponses.",
-        description: "Description below the knowledge header"
+        value: "La siguiente información se proporciona como referencia. Utilícela para fundamentar sus respuestas.",
+        description: "Descripción debajo del encabezado de conocimiento"
       },
       "tool.knowledge.description": {
-        value: "Interrogez les bases de connaissances pour obtenir des informations pertinentes. Utilisez cet outil lorsque vous avez besoin de rechercher des informations spécifiques qui ne sont pas dans votre contexte.",
-        description: "Description for the knowledge query tool shown to the LLM"
+        value: "Consultar bases de conocimiento para obtener información relevante. Utilice esta herramienta cuando necesite buscar información específica que pueda no estar en su contexto.",
+        description: "Descripción de la herramienta de consulta de conocimiento mostrada al LLM"
       },
       "tool.knowledge.availableSpaces": {
-        value: "Espaces de connaissances disponibles :",
-        description: "Label before listing available knowledge spaces"
+        value: "Espacios de conocimiento disponibles:",
+        description: "Etiqueta antes de listar los espacios de conocimiento disponibles"
       },
       "tool.knowledge.spaceDefault": {
-        value: "Espace de connaissances",
-        description: "Fallback description for unnamed knowledge spaces"
+        value: "Espacio de conocimiento",
+        description: "Descripción de respaldo para espacios de conocimiento sin nombre"
       },
       "tool.knowledge.param.query": {
-        value: "La question ou la requête de recherche pour trouver des informations pertinentes",
-        description: "Parameter description for the query field"
+        value: "La pregunta o consulta de búsqueda para encontrar información relevante",
+        description: "Descripción del parámetro para el campo de consulta"
       },
       "tool.knowledge.param.spaceKey": {
-        value: "Espace de connaissances spécifique à interroger. Si omis, recherche dans tous les espaces disponibles.",
-        description: "Parameter description for the spaceKey field"
+        value: "Espacio de conocimiento específico a consultar. Si se omite, busca en todos los espacios disponibles.",
+        description: "Descripción del parámetro para el campo spaceKey"
       },
       "tool.knowledge.param.topK": {
-        value: "Nombre maximum de résultats à retourner",
-        description: "Parameter description for the topK field"
+        value: "Número máximo de resultados a devolver",
+        description: "Descripción del parámetro para el campo topK"
       },
       "tool.knowledge.noResults": {
-        value: "Aucune information pertinente trouvée dans les bases de connaissances.",
-        description: "Message when no knowledge results are found"
+        value: "No se encontró información relevante en las bases de conocimiento.",
+        description: "Mensaje cuando no se encuentran resultados de conocimiento"
       },
       "tool.knowledge.sourceLabel": {
-        value: "[Source {index} - {space}] (pertinence : {score} %)",
-        description: "Label for each knowledge search result",
+        value: "[Fuente {index} - {space}] (relevancia: {score}%)",
+        description: "Etiqueta para cada resultado de búsqueda de conocimiento",
         placeholders: [
-          { name: "index", type: "number", description: "1-based source index" },
-          { name: "space", type: "string", description: "Knowledge space name" },
-          { name: "score", type: "number", description: "Relevance percentage" }
+          {
+            name: "index",
+            type: "number",
+            description: "Índice de fuente basado en 1"
+          },
+          {
+            name: "space",
+            type: "string",
+            description: "Nombre del espacio de conocimiento"
+          },
+          {
+            name: "score",
+            type: "number",
+            description: "Porcentaje de relevancia"
+          }
         ]
       },
       "tool.fallbackDescription": {
-        value: "Exécuter {name}",
-        description: "Fallback description when a tool has no explicit description",
+        value: "Ejecutar {name}",
+        description: "Descripción de respaldo cuando una herramienta no tiene descripción explícita",
         placeholders: [
-          { name: "name", type: "string", description: "Tool name" }
+          {
+            name: "name",
+            type: "string",
+            description: "Nombre de la herramienta"
+          }
         ]
       },
       "tool.mcp.param.message": {
-        value: "Le message ou la requête à envoyer à l'agent",
-        description: "MCP server: message parameter description"
+        value: "El mensaje o consulta a enviar al agente",
+        description: "Servidor MCP: descripción del parámetro message"
       },
       "tool.mcp.param.sessionId": {
-        value: "Identifiant de session optionnel pour poursuivre une conversation",
-        description: "MCP server: sessionId parameter description"
+        value: "ID de sesión opcional para continuar una conversación",
+        description: "Servidor MCP: descripción del parámetro sessionId"
       },
       "tool.mcp.agentDescription": {
-        value: "Interagir avec l'agent {key}",
-        description: "MCP server: agent tool description",
+        value: "Interactuar con el agente {key}",
+        description: "Servidor MCP: descripción de la herramienta de agente",
         placeholders: [
-          { name: "key", type: "string", description: "Agent spec key" }
+          {
+            name: "key",
+            type: "string",
+            description: "Clave de la especificación del agente"
+          }
         ]
       },
       "tool.mcp.executePrompt": {
-        value: "Exécutez l'outil {name} avec les arguments suivants : {args}",
-        description: "MCP server: prompt sent when executing an individual tool",
+        value: "Ejecute la herramienta {name} con los siguientes argumentos: {args}",
+        description: "Servidor MCP: prompt enviado al ejecutar una herramienta individual",
         placeholders: [
-          { name: "name", type: "string", description: "Tool name" },
+          {
+            name: "name",
+            type: "string",
+            description: "Nombre de la herramienta"
+          },
           {
             name: "args",
             type: "string",
-            description: "JSON-stringified arguments"
+            description: "Argumentos serializados como JSON"
           }
         ]
       },
       "tool.mcp.toolDescription": {
-        value: "Exécuter l'outil {name}",
-        description: "MCP server: individual tool description",
+        value: "Ejecutar la herramienta {name}",
+        description: "Servidor MCP: descripción de herramienta individual",
         placeholders: [
-          { name: "name", type: "string", description: "Tool name" }
+          {
+            name: "name",
+            type: "string",
+            description: "Nombre de la herramienta"
+          }
         ]
       },
       "interop.prompt.agentIdentity": {
-        value: "# Identité de l'agent",
-        description: "Section header for agent identity in LLM prompt"
+        value: "# Identidad del agente",
+        description: "Encabezado de sección para la identidad del agente en el prompt del LLM"
       },
       "interop.prompt.youAre": {
-        value: "Vous êtes {key} (v{version}).",
-        description: "Agent identity statement in LLM prompt",
+        value: "Usted es {key} (v{version}).",
+        description: "Declaración de identidad del agente en el prompt del LLM",
         placeholders: [
           { name: "key", type: "string" },
           { name: "version", type: "string" }
         ]
       },
       "interop.prompt.description": {
-        value: "## Description",
-        description: "Section header for description"
+        value: "## Descripción",
+        description: "Encabezado de sección para la descripción"
       },
       "interop.prompt.instructions": {
-        value: "## Instructions",
-        description: "Section header for instructions"
+        value: "## Instrucciones",
+        description: "Encabezado de sección para las instrucciones"
       },
       "interop.prompt.availableTools": {
-        value: "## Outils disponibles",
-        description: "Section header for available tools"
+        value: "## Herramientas disponibles",
+        description: "Encabezado de sección para las herramientas disponibles"
       },
       "interop.prompt.toolsIntro": {
-        value: "Vous avez accès aux outils suivants :",
-        description: "Introduction before listing tools"
+        value: "Usted tiene acceso a las siguientes herramientas:",
+        description: "Introducción antes de listar las herramientas"
       },
       "interop.prompt.parameters": {
-        value: "Paramètres :",
-        description: "Label before tool parameters block"
+        value: "Parámetros:",
+        description: "Etiqueta antes del bloque de parámetros de la herramienta"
       },
       "interop.prompt.knowledgeContext": {
-        value: "## Contexte de connaissances",
-        description: "Section header for knowledge context"
+        value: "## Contexto de conocimiento",
+        description: "Encabezado de sección para el contexto de conocimiento"
       },
       "interop.prompt.additionalContext": {
-        value: "## Contexte supplémentaire",
-        description: "Section header for additional context"
+        value: "## Contexto adicional",
+        description: "Encabezado de sección para el contexto adicional"
       },
       "interop.md.toc": {
-        value: "## Table des matières",
-        description: "TOC header"
+        value: "## Tabla de contenidos",
+        description: "Encabezado de tabla de contenidos"
       },
       "interop.md.overview": {
-        value: "## Aperçu",
-        description: "Overview header"
+        value: "## Resumen general",
+        description: "Encabezado de resumen general"
+      },
+      "interop.md.tools": {
+        value: "## Herramientas",
+        description: "Encabezado de herramientas"
       },
-      "interop.md.tools": { value: "## Outils", description: "Tools header" },
       "interop.md.knowledge": {
-        value: "## Connaissances",
-        description: "Knowledge header"
+        value: "## Conocimiento",
+        description: "Encabezado de conocimiento"
       },
       "interop.md.policy": {
-        value: "## Politique",
-        description: "Policy header"
+        value: "## Política",
+        description: "Encabezado de política"
       },
       "interop.md.metaKey": {
-        value: "- **Clé** : `{key}`",
-        description: "Metadata line for key",
+        value: "- **Clave**: `{key}`",
+        description: "Línea de metadatos para la clave",
         placeholders: [{ name: "key", type: "string" }]
       },
       "interop.md.metaVersion": {
-        value: "- **Version** : {version}",
-        description: "Metadata line for version",
+        value: "- **Versión**: {version}",
+        description: "Línea de metadatos para la versión",
         placeholders: [{ name: "version", type: "string" }]
       },
       "interop.md.metaStability": {
-        value: "- **Stabilité** : {stability}",
-        description: "Metadata line for stability",
+        value: "- **Estabilidad**: {stability}",
+        description: "Línea de metadatos para la estabilidad",
         placeholders: [{ name: "stability", type: "string" }]
       },
       "interop.md.metaOwners": {
-        value: "- **Propriétaires** : {owners}",
-        description: "Metadata line for owners",
+        value: "- **Propietarios**: {owners}",
+        description: "Línea de metadatos para los propietarios",
         placeholders: [{ name: "owners", type: "string" }]
       },
       "interop.md.metaTags": {
-        value: "- **Tags** : {tags}",
-        description: "Metadata line for tags",
+        value: "- **Etiquetas**: {tags}",
+        description: "Línea de metadatos para las etiquetas",
         placeholders: [{ name: "tags", type: "string" }]
       },
       "interop.md.schema": {
-        value: "**Schéma :**",
-        description: "Schema label"
+        value: "**Esquema:**",
+        description: "Etiqueta de esquema"
       },
       "interop.md.automationSafe": {
-        value: "**Compatible avec l'automatisation** : {value}",
-        description: "Automation safe field",
+        value: "**Seguro para automatización**: {value}",
+        description: "Campo de seguridad para automatización",
         placeholders: [{ name: "value", type: "string" }]
       },
       "interop.md.required": {
-        value: "(obligatoire)",
-        description: "Required marker"
+        value: "(obligatorio)",
+        description: "Marcador de obligatorio"
       },
       "interop.md.optional": {
-        value: "(optionnel)",
-        description: "Optional marker"
+        value: "(opcional)",
+        description: "Marcador de opcional"
       },
       "interop.md.minConfidence": {
-        value: "- **Confiance minimale** : {min}",
-        description: "Minimum confidence policy line",
+        value: "- **Confianza mínima**: {min}",
+        description: "Línea de política de confianza mínima",
         placeholders: [{ name: "min", type: "number" }]
       },
       "interop.md.escalationThreshold": {
-        value: "- **Seuil d'escalade** : {threshold}",
-        description: "Escalation threshold policy line",
+        value: "- **Umbral de escalamiento**: {threshold}",
+        description: "Línea de política de umbral de escalamiento",
         placeholders: [{ name: "threshold", type: "number" }]
       },
       "interop.md.escalateToolFailure": {
-        value: "- **Escalader en cas d'échec d'outil** : Oui",
-        description: "Escalate on tool failure policy line"
+        value: "- **Escalar ante fallo de herramienta**: Sí",
+        description: "Línea de política de escalamiento ante fallo de herramienta"
       },
       "interop.md.escalateTimeout": {
-        value: "- **Escalader en cas de délai d'attente dépassé** : Oui",
-        description: "Escalate on timeout policy line"
+        value: "- **Escalar ante tiempo de espera agotado**: Sí",
+        description: "Línea de política de escalamiento ante tiempo de espera"
       },
-      "interop.md.yes": { value: "Oui", description: "Yes label" },
-      "interop.md.no": { value: "Non", description: "No label" },
+      "interop.md.yes": { value: "Sí", description: "Etiqueta de Sí" },
+      "interop.md.no": { value: "No", description: "Etiqueta de No" },
       "error.jsonRunner.requiresModel": {
-        value: "createAgentJsonRunner nécessite un modèle ou une configuration de fournisseur",
-        description: "Error when JSON runner has no model or provider"
+        value: "createAgentJsonRunner requiere un modelo o configuración de proveedor",
+        description: "Error cuando el ejecutor JSON no tiene modelo ni proveedor"
       },
       "error.missingToolHandler": {
-        value: "Gestionnaire manquant pour l'outil : {name}",
-        description: "Error when a tool handler is not registered",
+        value: "Falta el manejador para la herramienta: {name}",
+        description: "Error cuando un manejador de herramienta no está registrado",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.unknownBackend": {
-        value: "Backend inconnu : {backend}",
-        description: "Error when an unknown backend is specified",
+        value: "Backend desconocido: {backend}",
+        description: "Error cuando se especifica un backend desconocido",
         placeholders: [{ name: "backend", type: "string" }]
       },
       "error.claudeSdk.notAvailable": {
-        value: "Claude Agent SDK non disponible. Installez @anthropic-ai/claude-agent-sdk",
-        description: "Error when Claude Agent SDK is not available"
+        value: "Claude Agent SDK no disponible. Instale @anthropic-ai/claude-agent-sdk",
+        description: "Error cuando el Claude Agent SDK no está disponible"
       },
       "error.claudeSdk.notInstalled": {
-        value: "Claude Agent SDK non installé. Exécutez : npm install @anthropic-ai/claude-agent-sdk",
-        description: "Error when Claude Agent SDK module is not found"
+        value: "Claude Agent SDK no instalado. Ejecute: npm install @anthropic-ai/claude-agent-sdk",
+        description: "Error cuando no se encuentra el módulo del Claude Agent SDK"
       },
       "error.opencodeSdk.notAvailable": {
-        value: "OpenCode SDK non disponible. Installez @opencode-ai/sdk",
-        description: "Error when OpenCode SDK is not available"
+        value: "OpenCode SDK no disponible. Instale @opencode-ai/sdk",
+        description: "Error cuando el OpenCode SDK no está disponible"
       },
       "error.opencodeSdk.notInstalled": {
-        value: "OpenCode SDK non installé. Exécutez : npm install @opencode-ai/sdk",
-        description: "Error when OpenCode SDK module is not found"
+        value: "OpenCode SDK no instalado. Ejecute: npm install @opencode-ai/sdk",
+        description: "Error cuando no se encuentra el módulo del OpenCode SDK"
       },
       "error.providerNotInitialized": {
-        value: "Fournisseur non initialisé",
-        description: "Error when provider has not been initialized before use"
+        value: "Proveedor no inicializado",
+        description: "Error cuando el proveedor no ha sido inicializado antes de su uso"
       },
       "error.agentKeyRequired": {
-        value: "La clé de l'agent est obligatoire",
-        description: "Validation error: missing agent key"
+        value: "La clave del agente es obligatoria",
+        description: "Error de validación: falta la clave del agente"
       },
       "error.agentMissingVersion": {
-        value: "L'agent {key} n'a pas de version sous forme de chaîne de caractères",
-        description: "Validation error: version not a string",
+        value: "Al agente {key} le falta una versión de tipo cadena",
+        description: "Error de validación: la versión no es una cadena de texto",
         placeholders: [{ name: "key", type: "string" }]
       },
       "error.agentRequiresInstructions": {
-        value: "L'agent {key} nécessite des instructions",
-        description: "Validation error: missing instructions",
+        value: "El agente {key} requiere instrucciones",
+        description: "Error de validación: faltan instrucciones",
         placeholders: [{ name: "key", type: "string" }]
       },
       "error.agentRequiresTool": {
-        value: "L'agent {key} doit exposer au moins un outil",
-        description: "Validation error: no tools defined",
+        value: "El agente {key} debe exponer al menos una herramienta",
+        description: "Error de validación: no hay herramientas definidas",
         placeholders: [{ name: "key", type: "string" }]
       },
       "error.agentDuplicateTool": {
-        value: "L'agent {key} a un nom d'outil en double : {name}",
-        description: "Validation error: duplicate tool name",
+        value: "El agente {key} tiene un nombre de herramienta duplicado: {name}",
+        description: "Error de validación: nombre de herramienta duplicado",
         placeholders: [
           { name: "key", type: "string" },
           { name: "name", type: "string" }
         ]
       },
       "error.agentSpecNotFound": {
-        value: "Spécification d'agent introuvable pour {name}",
-        description: "Error when agent spec is not in the registry",
+        value: "Especificación de agente no encontrada para {name}",
+        description: "Error cuando la especificación del agente no está en el registro",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.specNotFound": {
-        value: "Spécification introuvable : {specKey}",
-        description: "Error when a spec key is not found",
+        value: "Especificación no encontrada: {specKey}",
+        description: "Error cuando no se encuentra una clave de especificación",
         placeholders: [{ name: "specKey", type: "string" }]
       },
       "error.toolNotFound": {
-        value: "Outil introuvable : {name}",
-        description: "Error when a tool is not found",
+        value: "Herramienta no encontrada: {name}",
+        description: "Error cuando no se encuentra una herramienta",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.noHandlerForTool": {
-        value: "Aucun gestionnaire enregistré pour l'outil : {name}",
-        description: "Error when no handler is registered for a tool",
+        value: "No hay manejador registrado para la herramienta: {name}",
+        description: "Error cuando no hay manejador registrado para una herramienta",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.noToolHandler": {
-        value: "Aucun gestionnaire pour l'outil : {name}",
-        description: "Short error when no handler exists",
+        value: "Sin manejador para la herramienta: {name}",
+        description: "Error breve cuando no existe manejador",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.unknownExportFormat": {
-        value: "Format d'export inconnu : {format}",
-        description: "Error for unsupported export format",
+        value: "Formato de exportación desconocido: {format}",
+        description: "Error para formato de exportación no soportado",
         placeholders: [{ name: "format", type: "string" }]
       },
       "error.handlerNotFoundForTool": {
-        value: "Gestionnaire introuvable pour l'outil {name}",
-        description: "Error in tool bridge when handler is missing",
+        value: "Manejador no encontrado para la herramienta {name}",
+        description: "Error en el puente de herramientas cuando falta el manejador",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.toolNotFoundOrNoHandler": {
-        value: "Erreur : L'outil « {name} » est introuvable ou n'a pas de gestionnaire",
-        description: "Error returned to LLM when tool execution fails",
+        value: "Error: La herramienta '{name}' no fue encontrada o no tiene manejador",
+        description: "Error devuelto al LLM cuando la ejecución de la herramienta falla",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.toolNoExecuteHandler": {
-        value: "L'outil {name} n'a pas de gestionnaire d'exécution",
-        description: "Error when tool lacks an execute function",
+        value: "La herramienta {name} no tiene manejador de ejecución",
+        description: "Error cuando la herramienta carece de una función de ejecución",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.provider.notRegistered": {
-        value: "non enregistré",
-        description: "Provider availability reason: not registered"
+        value: "no registrado",
+        description: "Razón de disponibilidad del proveedor: no registrado"
       },
       "error.provider.depsNotInstalled": {
-        value: "dépendances non installées ou non configurées",
-        description: "Provider availability reason: deps missing"
+        value: "dependencias no instaladas o no configuradas",
+        description: "Razón de disponibilidad del proveedor: faltan dependencias"
       },
       "error.provider.sdkNotConfigured": {
-        value: "SDK non installé ou clé d'API non configurée",
-        description: "Provider availability reason: SDK or key missing"
+        value: "SDK no instalado o clave de API no configurada",
+        description: "Razón de disponibilidad del proveedor: falta SDK o clave"
       },
       "error.provider.claudeSdkMissing": {
-        value: "@anthropic-ai/claude-agent-sdk n'est pas installé",
-        description: "Error when Claude Agent SDK require.resolve fails"
+        value: "@anthropic-ai/claude-agent-sdk no está instalado",
+        description: "Error cuando falla require.resolve del Claude Agent SDK"
       },
       "error.provider.opencodeSdkMissing": {
-        value: "@opencode-ai/sdk n'est pas installé",
-        description: "Error when OpenCode SDK require.resolve fails"
+        value: "@opencode-ai/sdk no está instalado",
+        description: "Error cuando falla require.resolve del OpenCode SDK"
       },
       "error.provider.sdkNotInstalled": {
-        value: "SDK non installé",
-        description: "Generic provider error: SDK not installed"
+        value: "SDK no instalado",
+        description: "Error genérico del proveedor: SDK no instalado"
       },
       "error.provider.contextCreation": {
-        value: "Échec de la création du contexte : {error}",
-        description: "Error during provider context creation",
+        value: "Error al crear el contexto: {error}",
+        description: "Error durante la creación del contexto del proveedor",
         placeholders: [{ name: "error", type: "string" }]
       },
       "error.provider.executionFailed": {
-        value: "Échec de l'exécution : {error}",
-        description: "Error during provider execution",
+        value: "La ejecución falló: {error}",
+        description: "Error durante la ejecución del proveedor",
         placeholders: [{ name: "error", type: "string" }]
       },
       "error.provider.streamFailed": {
-        value: "Échec du flux : {error}",
-        description: "Error during provider streaming",
+        value: "El stream falló: {error}",
+        description: "Error durante el streaming del proveedor",
         placeholders: [{ name: "error", type: "string" }]
       },
       "export.agentConfiguration": {
-        value: "# Configuration de l'agent",
-        description: "Markdown heading"
+        value: "# Configuración del agente",
+        description: "Encabezado Markdown"
       },
       "export.metadata": {
-        value: "## Métadonnées",
-        description: "Markdown heading"
+        value: "## Metadatos",
+        description: "Encabezado Markdown"
       },
       "export.metaName": {
-        value: "- **Nom** : {name}",
-        description: "Metadata line",
+        value: "- **Nombre**: {name}",
+        description: "Línea de metadatos",
         placeholders: [{ name: "name", type: "string" }]
       },
       "export.metaVersion": {
-        value: "- **Version** : {version}",
-        description: "Metadata line",
+        value: "- **Versión**: {version}",
+        description: "Línea de metadatos",
         placeholders: [{ name: "version", type: "string" }]
       },
       "export.metaOwners": {
-        value: "- **Propriétaires** : {owners}",
-        description: "Metadata line",
+        value: "- **Propietarios**: {owners}",
+        description: "Línea de metadatos",
         placeholders: [{ name: "owners", type: "string" }]
       },
       "export.metaModel": {
-        value: "- **Modèle** : {model}",
-        description: "Metadata line",
+        value: "- **Modelo**: {model}",
+        description: "Línea de metadatos",
         placeholders: [{ name: "model", type: "string" }]
       },
       "export.instructions": {
-        value: "## Instructions",
-        description: "Markdown heading"
+        value: "## Instrucciones",
+        description: "Encabezado Markdown"
       },
       "export.availableTools": {
-        value: "## Outils disponibles",
-        description: "Markdown heading"
+        value: "## Herramientas disponibles",
+        description: "Encabezado Markdown"
+      },
+      "export.tools": {
+        value: "## Herramientas",
+        description: "Encabezado Markdown"
       },
-      "export.tools": { value: "## Outils", description: "Markdown heading" },
       "export.knowledgeSources": {
-        value: "## Sources de connaissances",
-        description: "Markdown heading"
+        value: "## Fuentes de conocimiento",
+        description: "Encabezado Markdown"
       },
       "export.policy": {
-        value: "## Politique",
-        description: "Markdown heading"
+        value: "## Política",
+        description: "Encabezado Markdown"
       },
       "export.additionalContext": {
-        value: "## Contexte supplémentaire",
-        description: "Markdown heading"
+        value: "## Contexto adicional",
+        description: "Encabezado Markdown"
       },
       "export.configuration": {
-        value: "## Configuration",
-        description: "Markdown heading"
+        value: "## Configuración",
+        description: "Encabezado Markdown"
       },
       "export.mcpServers": {
-        value: "## Serveurs MCP",
-        description: "Markdown heading"
+        value: "## Servidores MCP",
+        description: "Encabezado Markdown"
       },
       "export.parameters": {
-        value: "**Paramètres :**",
-        description: "Parameters label"
+        value: "**Parámetros:**",
+        description: "Etiqueta de parámetros"
       },
       "export.requiresApproval": {
-        value: "nécessite une approbation",
-        description: "Tool flag"
+        value: "requiere aprobación",
+        description: "Indicador de herramienta"
       },
       "export.notAutomationSafe": {
-        value: "non compatible avec l'automatisation",
-        description: "Tool flag"
+        value: "no es seguro para automatización",
+        description: "Indicador de herramienta"
       },
       "export.requiresApprovalMd": {
-        value: "*(nécessite une approbation)*",
-        description: "Markdown tool flag"
+        value: "*(requiere aprobación)*",
+        description: "Indicador de herramienta en Markdown"
       },
       "export.notAutomationSafeMd": {
-        value: "*(non compatible avec l'automatisation)*",
-        description: "Markdown tool flag"
+        value: "*(no es seguro para automatización)*",
+        description: "Indicador de herramienta en Markdown"
       },
       "export.required": {
-        value: "(obligatoire)",
-        description: "Required marker"
+        value: "(obligatorio)",
+        description: "Marcador de obligatorio"
       },
       "export.optional": {
-        value: "(optionnel)",
-        description: "Optional marker"
+        value: "(opcional)",
+        description: "Marcador de opcional"
       },
       "export.minConfidence": {
-        value: "- Confiance minimale : {min}",
-        description: "Policy line",
+        value: "- Confianza mínima: {min}",
+        description: "Línea de política",
         placeholders: [{ name: "min", type: "number" }]
       },
       "export.escalationConfigured": {
-        value: "- La politique d'escalade est configurée",
-        description: "Policy line for system prompt"
+        value: "- La política de escalamiento está configurada",
+        description: "Línea de política para el prompt del sistema"
       },
       "export.escalationPolicyConfigured": {
-        value: "- Politique d'escalade configurée",
-        description: "Policy line for markdown export"
+        value: "- Política de escalamiento configurada",
+        description: "Línea de política para la exportación en Markdown"
       },
       "export.featureFlags": {
-        value: "- Indicateurs de fonctionnalités : {flags}",
-        description: "Feature flags policy line",
+        value: "- Indicadores de características: {flags}",
+        description: "Línea de política de indicadores de características",
         placeholders: [{ name: "flags", type: "string" }]
       },
       "export.generatedFrom": {
-        value: "*Généré à partir de ContractSpec : {key}*",
-        description: "Footer attribution line",
+        value: "*Generado desde ContractSpec: {key}*",
+        description: "Línea de atribución en el pie",
         placeholders: [{ name: "key", type: "string" }]
       },
       "export.exportedAt": {
-        value: "*Exporté le : {date}*",
-        description: "Footer timestamp",
+        value: "*Exportado el: {date}*",
+        description: "Marca de tiempo en el pie",
         placeholders: [{ name: "date", type: "string" }]
       },
       "export.agentType": {
-        value: "> Type d'agent : **{type}**",
-        description: "Agent type callout",
+        value: "> Tipo de agente: **{type}**",
+        description: "Llamada de tipo de agente",
         placeholders: [{ name: "type", type: "string" }]
       },
       "export.noDescription": {
-        value: "Aucune description",
-        description: "Fallback when tool has no description"
+        value: "Sin descripción",
+        description: "Texto de respaldo cuando la herramienta no tiene descripción"
       },
       "export.validation.requiresKey": {
-        value: "La spécification doit avoir une meta.key",
-        description: "Validation error"
+        value: "La especificación debe tener una meta.key",
+        description: "Error de validación"
       },
       "export.validation.requiresInstructions": {
-        value: "La spécification doit avoir des instructions",
-        description: "Validation error"
+        value: "La especificación debe tener instrucciones",
+        description: "Error de validación"
       },
       "export.validation.requiresTool": {
-        value: "La spécification doit avoir au moins un outil",
-        description: "Validation error"
+        value: "La especificación debe tener al menos una herramienta",
+        description: "Error de validación"
       },
       "export.validation.toolRequiresName": {
-        value: "Tous les outils doivent avoir un nom",
-        description: "Validation error"
+        value: "Todas las herramientas deben tener un nombre",
+        description: "Error de validación"
       },
       "export.validation.toolRequiresDescOrName": {
-        value: "L'outil doit avoir une description ou un nom",
-        description: "Validation error"
+        value: "La herramienta debe tener una descripción o un nombre",
+        description: "Error de validación"
       },
       "export.validation.toolInvalidName": {
-        value: "Le nom d'outil « {name} » doit être un identifiant valide (lettres, chiffres, underscores)",
-        description: "Validation error for invalid tool name",
+        value: "El nombre de herramienta '{name}' debe ser un identificador válido (letras, números, guiones bajos)",
+        description: "Error de validación para nombre de herramienta inválido",
         placeholders: [{ name: "name", type: "string" }]
       },
       "export.agentType.build": {
-        value: "Agent principal avec accès complet aux outils pour la génération et la modification de code.",
-        description: "Build agent type description"
+        value: "Agente principal con acceso completo a herramientas para la generación y modificación de código.",
+        description: "Descripción del tipo de agente de construcción"
       },
       "export.agentType.plan": {
-        value: "Agent restreint pour l'analyse et la planification. Les modifications de fichiers et les commandes bash nécessitent une approbation.",
-        description: "Plan agent type description"
+        value: "Agente restringido para análisis y planificación. Las ediciones de archivos y los comandos bash requieren aprobación.",
+        description: "Descripción del tipo de agente de planificación"
       },
       "export.agentType.general": {
-        value: "Sous-agent généraliste pour les questions complexes et les tâches en plusieurs étapes.",
-        description: "General agent type description"
+        value: "Subagente de propósito general para preguntas complejas y tareas de múltiples pasos.",
+        description: "Descripción del tipo de agente general"
       },
       "export.agentType.explore": {
-        value: "Sous-agent rapide optimisé pour l'exploration de la base de code et la recherche de motifs.",
-        description: "Explore agent type description"
+        value: "Subagente rápido optimizado para exploración de código y búsqueda de patrones.",
+        description: "Descripción del tipo de agente de exploración"
       },
       "export.bridge.requiresApproval": {
-        value: "(nécessite une approbation)",
-        description: "Tool permission label"
+        value: "(requiere aprobación)",
+        description: "Etiqueta de permiso de herramienta"
       },
       "export.bridge.askMode": {
-        value: "(mode interrogation)",
-        description: "Tool permission label"
+        value: "(modo consulta)",
+        description: "Etiqueta de permiso de herramienta"
       },
       "approval.toolRequiresApproval": {
-        value: "L'outil « {name} » nécessite une approbation",
-        description: "Default reason for tool approval requests",
+        value: 'La herramienta "{name}" requiere aprobación',
+        description: "Razón predeterminada para solicitudes de aprobación de herramientas",
         placeholders: [{ name: "name", type: "string" }]
       },
       "log.unifiedAgent.fallback": {
-        value: "[UnifiedAgent] {backend} a échoué, repli sur {fallback}",
-        description: "Warning when a backend fails and fallback is used",
+        value: "[UnifiedAgent] {backend} falló, recurriendo a {fallback}",
+        description: "Advertencia cuando un backend falla y se utiliza el respaldo",
         placeholders: [
           { name: "backend", type: "string" },
           { name: "fallback", type: "string" }
         ]
       },
       "log.knowledge.spaceNotAvailable": {
-        value: "L'espace de connaissances requis « {key} » n'est pas disponible",
-        description: "Warning when a required knowledge space is missing",
+        value: 'El espacio de conocimiento requerido "{key}" no está disponible',
+        description: "Advertencia cuando un espacio de conocimiento requerido no existe",
         placeholders: [{ name: "key", type: "string" }]
       },
       "log.knowledge.loadFailed": {
-        value: "Échec du chargement des connaissances requises « {key} » :",
-        description: "Warning when knowledge loading fails",
+        value: 'Error al cargar el conocimiento requerido "{key}":',
+        description: "Advertencia cuando falla la carga de conocimiento",
         placeholders: [{ name: "key", type: "string" }]
       },
       "log.knowledge.queryFailed": {
-        value: "Échec de l'interrogation de l'espace de connaissances {space} :",
-        description: "Warning when knowledge querying fails",
+        value: "Error al consultar el espacio de conocimiento {space}:",
+        description: "Advertencia cuando falla la consulta de conocimiento",
         placeholders: [{ name: "space", type: "string" }]
       },
       "log.mcpServer.started": {
-        value: "[MCPToolServer] {name}@{version} démarré avec {count} outils",
-        description: "Log message when MCP tool server starts",
+        value: "[MCPToolServer] Iniciado {name}@{version} con {count} herramientas",
+        description: "Mensaje de registro cuando el servidor de herramientas MCP se inicia",
         placeholders: [
           { name: "name", type: "string" },
           { name: "version", type: "string" },
@@ -1235,24 +1269,24 @@ var init_fr = __esm(() => {
         ]
       },
       "log.mcpServer.stopped": {
-        value: "[MCPToolServer] {name} arrêté",
-        description: "Log message when MCP tool server stops",
+        value: "[MCPToolServer] Detenido {name}",
+        description: "Mensaje de registro cuando el servidor de herramientas MCP se detiene",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.telemetry.posthogAiRequired": {
-        value: "PostHog LLM Analytics nécessite l'installation de @posthog/ai. Exécutez : npm install @posthog/ai posthog-node",
+        value: "PostHog LLM Analytics requiere que @posthog/ai esté instalado. Ejecute: npm install @posthog/ai posthog-node",
         description: "Error when PostHog AI dependency is missing"
       },
       "error.telemetry.posthogClientOrKeyRequired": {
-        value: "PostHog LLM Analytics nécessite soit une instance client, soit une apiKey.",
+        value: "PostHog LLM Analytics requiere una instancia de cliente o una apiKey.",
         description: "Error when PostHog client or API key is not configured"
       },
       "error.telemetry.posthogNodeRequired": {
-        value: "PostHog LLM Analytics nécessite l'installation de posthog-node. Exécutez : npm install posthog-node",
+        value: "PostHog LLM Analytics requiere que posthog-node esté instalado. Ejecute: npm install posthog-node",
         description: "Error when posthog-node dependency is missing"
       },
       "error.provider.notAvailable": {
-        value: "Le fournisseur « {provider} » n'est pas disponible{reason}",
+        value: "El proveedor '{provider}' no está disponible{reason}",
         description: "Error when a provider is unavailable",
         placeholders: [
           { name: "provider", type: "string" },
@@ -1263,636 +1297,602 @@ var init_fr = __esm(() => {
   });
 });
 
-// src/i18n/catalogs/es.ts
+// src/i18n/catalogs/fr.ts
 import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
-var esMessages;
-var init_es = __esm(() => {
-  esMessages = defineTranslation3({
+var frMessages;
+var init_fr = __esm(() => {
+  frMessages = defineTranslation3({
     meta: {
       key: "ai-agent.messages",
       version: "1.0.0",
       domain: "ai-agent",
-      description: "Todas las cadenas de texto orientadas al usuario, al LLM y al desarrollador del paquete ai-agent",
+      description: "Toutes les chaînes destinées aux utilisateurs, aux LLM et aux développeurs pour le package ai-agent",
       owners: ["platform"],
       stability: "experimental"
     },
-    locale: "es",
+    locale: "fr",
     fallback: "en",
     messages: {
       "agent.json.rules.validJsonOnly": {
-        value: "Usted DEBE generar ÚNICAMENTE JSON válido.",
-        description: "Regla del ejecutor JSON: la salida debe ser JSON válido"
+        value: "Vous DEVEZ produire uniquement du JSON valide.",
+        description: "JSON runner rule: output must be valid JSON"
       },
       "agent.json.rules.noMarkdownFences": {
-        value: "No envuelva la salida en bloques de código markdown.",
-        description: "Regla del ejecutor JSON: sin bloques de código markdown"
+        value: "N'encapsulez pas la sortie dans des blocs de code markdown.",
+        description: "JSON runner rule: no markdown code fences"
       },
       "agent.json.rules.noCommentary": {
-        value: "No incluya comentarios ni explicaciones.",
-        description: "Regla del ejecutor JSON: sin texto adicional"
+        value: "N'incluez ni commentaire ni explication.",
+        description: "JSON runner rule: no extra text"
       },
       "agent.json.rules.doubleQuotes": {
-        value: "Utilice comillas dobles para todas las claves y valores de cadena.",
-        description: "Regla del ejecutor JSON: solo comillas dobles"
+        value: "Utilisez des guillemets doubles pour toutes les clés et valeurs de type chaîne.",
+        description: "JSON runner rule: double quotes only"
       },
       "agent.json.rules.noTrailingCommas": {
-        value: "No incluya comas finales.",
-        description: "Regla del ejecutor JSON: sin comas finales"
+        value: "N'incluez pas de virgules finales.",
+        description: "JSON runner rule: no trailing commas"
       },
       "agent.json.defaultDescription": {
-        value: "Ejecutor de agentes exclusivamente JSON para pipelines deterministas.",
-        description: "Descripción predeterminada para la especificación del ejecutor JSON"
+        value: "Exécuteur d'agent JSON uniquement pour les pipelines déterministes.",
+        description: "Default description for the JSON runner spec"
       },
       "agent.json.systemPrompt": {
-        value: "Usted es un generador preciso de JSON.",
-        description: "Prompt de sistema predeterminado para el ejecutor JSON"
+        value: "Vous êtes un générateur JSON précis.",
+        description: "Default system prompt for the JSON runner"
       },
       "knowledge.header": {
-        value: "# Conocimiento de referencia",
-        description: "Encabezado para la sección de conocimiento inyectado en el prompt del sistema"
+        value: "# Connaissances de référence",
+        description: "Header for injected knowledge section in system prompt"
       },
       "knowledge.description": {
-        value: "La siguiente información se proporciona como referencia. Utilícela para fundamentar sus respuestas.",
-        description: "Descripción debajo del encabezado de conocimiento"
+        value: "Les informations suivantes sont fournies à titre de référence. Utilisez-les pour éclairer vos réponses.",
+        description: "Description below the knowledge header"
       },
       "tool.knowledge.description": {
-        value: "Consultar bases de conocimiento para obtener información relevante. Utilice esta herramienta cuando necesite buscar información específica que pueda no estar en su contexto.",
-        description: "Descripción de la herramienta de consulta de conocimiento mostrada al LLM"
+        value: "Interrogez les bases de connaissances pour obtenir des informations pertinentes. Utilisez cet outil lorsque vous avez besoin de rechercher des informations spécifiques qui ne sont pas dans votre contexte.",
+        description: "Description for the knowledge query tool shown to the LLM"
       },
       "tool.knowledge.availableSpaces": {
-        value: "Espacios de conocimiento disponibles:",
-        description: "Etiqueta antes de listar los espacios de conocimiento disponibles"
+        value: "Espaces de connaissances disponibles :",
+        description: "Label before listing available knowledge spaces"
       },
       "tool.knowledge.spaceDefault": {
-        value: "Espacio de conocimiento",
-        description: "Descripción de respaldo para espacios de conocimiento sin nombre"
+        value: "Espace de connaissances",
+        description: "Fallback description for unnamed knowledge spaces"
       },
       "tool.knowledge.param.query": {
-        value: "La pregunta o consulta de búsqueda para encontrar información relevante",
-        description: "Descripción del parámetro para el campo de consulta"
+        value: "La question ou la requête de recherche pour trouver des informations pertinentes",
+        description: "Parameter description for the query field"
       },
       "tool.knowledge.param.spaceKey": {
-        value: "Espacio de conocimiento específico a consultar. Si se omite, busca en todos los espacios disponibles.",
-        description: "Descripción del parámetro para el campo spaceKey"
+        value: "Espace de connaissances spécifique à interroger. Si omis, recherche dans tous les espaces disponibles.",
+        description: "Parameter description for the spaceKey field"
       },
       "tool.knowledge.param.topK": {
-        value: "Número máximo de resultados a devolver",
-        description: "Descripción del parámetro para el campo topK"
+        value: "Nombre maximum de résultats à retourner",
+        description: "Parameter description for the topK field"
       },
       "tool.knowledge.noResults": {
-        value: "No se encontró información relevante en las bases de conocimiento.",
-        description: "Mensaje cuando no se encuentran resultados de conocimiento"
+        value: "Aucune information pertinente trouvée dans les bases de connaissances.",
+        description: "Message when no knowledge results are found"
       },
       "tool.knowledge.sourceLabel": {
-        value: "[Fuente {index} - {space}] (relevancia: {score}%)",
-        description: "Etiqueta para cada resultado de búsqueda de conocimiento",
+        value: "[Source {index} - {space}] (pertinence : {score} %)",
+        description: "Label for each knowledge search result",
         placeholders: [
-          {
-            name: "index",
-            type: "number",
-            description: "Índice de fuente basado en 1"
-          },
-          {
-            name: "space",
-            type: "string",
-            description: "Nombre del espacio de conocimiento"
-          },
-          {
-            name: "score",
-            type: "number",
-            description: "Porcentaje de relevancia"
-          }
+          { name: "index", type: "number", description: "1-based source index" },
+          { name: "space", type: "string", description: "Knowledge space name" },
+          { name: "score", type: "number", description: "Relevance percentage" }
         ]
       },
       "tool.fallbackDescription": {
-        value: "Ejecutar {name}",
-        description: "Descripción de respaldo cuando una herramienta no tiene descripción explícita",
+        value: "Exécuter {name}",
+        description: "Fallback description when a tool has no explicit description",
         placeholders: [
-          {
-            name: "name",
-            type: "string",
-            description: "Nombre de la herramienta"
-          }
+          { name: "name", type: "string", description: "Tool name" }
         ]
       },
       "tool.mcp.param.message": {
-        value: "El mensaje o consulta a enviar al agente",
-        description: "Servidor MCP: descripción del parámetro message"
+        value: "Le message ou la requête à envoyer à l'agent",
+        description: "MCP server: message parameter description"
       },
       "tool.mcp.param.sessionId": {
-        value: "ID de sesión opcional para continuar una conversación",
-        description: "Servidor MCP: descripción del parámetro sessionId"
+        value: "Identifiant de session optionnel pour poursuivre une conversation",
+        description: "MCP server: sessionId parameter description"
       },
       "tool.mcp.agentDescription": {
-        value: "Interactuar con el agente {key}",
-        description: "Servidor MCP: descripción de la herramienta de agente",
+        value: "Interagir avec l'agent {key}",
+        description: "MCP server: agent tool description",
         placeholders: [
-          {
-            name: "key",
-            type: "string",
-            description: "Clave de la especificación del agente"
-          }
+          { name: "key", type: "string", description: "Agent spec key" }
         ]
       },
       "tool.mcp.executePrompt": {
-        value: "Ejecute la herramienta {name} con los siguientes argumentos: {args}",
-        description: "Servidor MCP: prompt enviado al ejecutar una herramienta individual",
+        value: "Exécutez l'outil {name} avec les arguments suivants : {args}",
+        description: "MCP server: prompt sent when executing an individual tool",
         placeholders: [
-          {
-            name: "name",
-            type: "string",
-            description: "Nombre de la herramienta"
-          },
+          { name: "name", type: "string", description: "Tool name" },
           {
             name: "args",
             type: "string",
-            description: "Argumentos serializados como JSON"
+            description: "JSON-stringified arguments"
           }
         ]
       },
       "tool.mcp.toolDescription": {
-        value: "Ejecutar la herramienta {name}",
-        description: "Servidor MCP: descripción de herramienta individual",
+        value: "Exécuter l'outil {name}",
+        description: "MCP server: individual tool description",
         placeholders: [
-          {
-            name: "name",
-            type: "string",
-            description: "Nombre de la herramienta"
-          }
+          { name: "name", type: "string", description: "Tool name" }
         ]
       },
       "interop.prompt.agentIdentity": {
-        value: "# Identidad del agente",
-        description: "Encabezado de sección para la identidad del agente en el prompt del LLM"
+        value: "# Identité de l'agent",
+        description: "Section header for agent identity in LLM prompt"
       },
       "interop.prompt.youAre": {
-        value: "Usted es {key} (v{version}).",
-        description: "Declaración de identidad del agente en el prompt del LLM",
+        value: "Vous êtes {key} (v{version}).",
+        description: "Agent identity statement in LLM prompt",
         placeholders: [
           { name: "key", type: "string" },
           { name: "version", type: "string" }
         ]
       },
       "interop.prompt.description": {
-        value: "## Descripción",
-        description: "Encabezado de sección para la descripción"
+        value: "## Description",
+        description: "Section header for description"
       },
       "interop.prompt.instructions": {
-        value: "## Instrucciones",
-        description: "Encabezado de sección para las instrucciones"
+        value: "## Instructions",
+        description: "Section header for instructions"
       },
       "interop.prompt.availableTools": {
-        value: "## Herramientas disponibles",
-        description: "Encabezado de sección para las herramientas disponibles"
+        value: "## Outils disponibles",
+        description: "Section header for available tools"
       },
       "interop.prompt.toolsIntro": {
-        value: "Usted tiene acceso a las siguientes herramientas:",
-        description: "Introducción antes de listar las herramientas"
+        value: "Vous avez accès aux outils suivants :",
+        description: "Introduction before listing tools"
       },
       "interop.prompt.parameters": {
-        value: "Parámetros:",
-        description: "Etiqueta antes del bloque de parámetros de la herramienta"
+        value: "Paramètres :",
+        description: "Label before tool parameters block"
       },
       "interop.prompt.knowledgeContext": {
-        value: "## Contexto de conocimiento",
-        description: "Encabezado de sección para el contexto de conocimiento"
+        value: "## Contexte de connaissances",
+        description: "Section header for knowledge context"
       },
       "interop.prompt.additionalContext": {
-        value: "## Contexto adicional",
-        description: "Encabezado de sección para el contexto adicional"
+        value: "## Contexte supplémentaire",
+        description: "Section header for additional context"
       },
       "interop.md.toc": {
-        value: "## Tabla de contenidos",
-        description: "Encabezado de tabla de contenidos"
+        value: "## Table des matières",
+        description: "TOC header"
       },
       "interop.md.overview": {
-        value: "## Resumen general",
-        description: "Encabezado de resumen general"
-      },
-      "interop.md.tools": {
-        value: "## Herramientas",
-        description: "Encabezado de herramientas"
+        value: "## Aperçu",
+        description: "Overview header"
       },
+      "interop.md.tools": { value: "## Outils", description: "Tools header" },
       "interop.md.knowledge": {
-        value: "## Conocimiento",
-        description: "Encabezado de conocimiento"
+        value: "## Connaissances",
+        description: "Knowledge header"
       },
       "interop.md.policy": {
-        value: "## Política",
-        description: "Encabezado de política"
+        value: "## Politique",
+        description: "Policy header"
       },
       "interop.md.metaKey": {
-        value: "- **Clave**: `{key}`",
-        description: "Línea de metadatos para la clave",
+        value: "- **Clé** : `{key}`",
+        description: "Metadata line for key",
         placeholders: [{ name: "key", type: "string" }]
       },
       "interop.md.metaVersion": {
-        value: "- **Versión**: {version}",
-        description: "Línea de metadatos para la versión",
+        value: "- **Version** : {version}",
+        description: "Metadata line for version",
         placeholders: [{ name: "version", type: "string" }]
       },
       "interop.md.metaStability": {
-        value: "- **Estabilidad**: {stability}",
-        description: "Línea de metadatos para la estabilidad",
+        value: "- **Stabilité** : {stability}",
+        description: "Metadata line for stability",
         placeholders: [{ name: "stability", type: "string" }]
       },
       "interop.md.metaOwners": {
-        value: "- **Propietarios**: {owners}",
-        description: "Línea de metadatos para los propietarios",
+        value: "- **Propriétaires** : {owners}",
+        description: "Metadata line for owners",
         placeholders: [{ name: "owners", type: "string" }]
       },
       "interop.md.metaTags": {
-        value: "- **Etiquetas**: {tags}",
-        description: "Línea de metadatos para las etiquetas",
+        value: "- **Tags** : {tags}",
+        description: "Metadata line for tags",
         placeholders: [{ name: "tags", type: "string" }]
       },
       "interop.md.schema": {
-        value: "**Esquema:**",
-        description: "Etiqueta de esquema"
+        value: "**Schéma :**",
+        description: "Schema label"
       },
       "interop.md.automationSafe": {
-        value: "**Seguro para automatización**: {value}",
-        description: "Campo de seguridad para automatización",
+        value: "**Compatible avec l'automatisation** : {value}",
+        description: "Automation safe field",
         placeholders: [{ name: "value", type: "string" }]
       },
       "interop.md.required": {
-        value: "(obligatorio)",
-        description: "Marcador de obligatorio"
+        value: "(obligatoire)",
+        description: "Required marker"
       },
       "interop.md.optional": {
-        value: "(opcional)",
-        description: "Marcador de opcional"
+        value: "(optionnel)",
+        description: "Optional marker"
       },
       "interop.md.minConfidence": {
-        value: "- **Confianza mínima**: {min}",
-        description: "Línea de política de confianza mínima",
+        value: "- **Confiance minimale** : {min}",
+        description: "Minimum confidence policy line",
         placeholders: [{ name: "min", type: "number" }]
       },
       "interop.md.escalationThreshold": {
-        value: "- **Umbral de escalamiento**: {threshold}",
-        description: "Línea de política de umbral de escalamiento",
+        value: "- **Seuil d'escalade** : {threshold}",
+        description: "Escalation threshold policy line",
         placeholders: [{ name: "threshold", type: "number" }]
       },
       "interop.md.escalateToolFailure": {
-        value: "- **Escalar ante fallo de herramienta**: Sí",
-        description: "Línea de política de escalamiento ante fallo de herramienta"
+        value: "- **Escalader en cas d'échec d'outil** : Oui",
+        description: "Escalate on tool failure policy line"
       },
       "interop.md.escalateTimeout": {
-        value: "- **Escalar ante tiempo de espera agotado**: Sí",
-        description: "Línea de política de escalamiento ante tiempo de espera"
+        value: "- **Escalader en cas de délai d'attente dépassé** : Oui",
+        description: "Escalate on timeout policy line"
       },
-      "interop.md.yes": { value: "Sí", description: "Etiqueta de Sí" },
-      "interop.md.no": { value: "No", description: "Etiqueta de No" },
+      "interop.md.yes": { value: "Oui", description: "Yes label" },
+      "interop.md.no": { value: "Non", description: "No label" },
       "error.jsonRunner.requiresModel": {
-        value: "createAgentJsonRunner requiere un modelo o configuración de proveedor",
-        description: "Error cuando el ejecutor JSON no tiene modelo ni proveedor"
+        value: "createAgentJsonRunner nécessite un modèle ou une configuration de fournisseur",
+        description: "Error when JSON runner has no model or provider"
       },
       "error.missingToolHandler": {
-        value: "Falta el manejador para la herramienta: {name}",
-        description: "Error cuando un manejador de herramienta no está registrado",
+        value: "Gestionnaire manquant pour l'outil : {name}",
+        description: "Error when a tool handler is not registered",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.unknownBackend": {
-        value: "Backend desconocido: {backend}",
-        description: "Error cuando se especifica un backend desconocido",
+        value: "Backend inconnu : {backend}",
+        description: "Error when an unknown backend is specified",
         placeholders: [{ name: "backend", type: "string" }]
       },
       "error.claudeSdk.notAvailable": {
-        value: "Claude Agent SDK no disponible. Instale @anthropic-ai/claude-agent-sdk",
-        description: "Error cuando el Claude Agent SDK no está disponible"
+        value: "Claude Agent SDK non disponible. Installez @anthropic-ai/claude-agent-sdk",
+        description: "Error when Claude Agent SDK is not available"
       },
       "error.claudeSdk.notInstalled": {
-        value: "Claude Agent SDK no instalado. Ejecute: npm install @anthropic-ai/claude-agent-sdk",
-        description: "Error cuando no se encuentra el módulo del Claude Agent SDK"
+        value: "Claude Agent SDK non installé. Exécutez : npm install @anthropic-ai/claude-agent-sdk",
+        description: "Error when Claude Agent SDK module is not found"
       },
       "error.opencodeSdk.notAvailable": {
-        value: "OpenCode SDK no disponible. Instale @opencode-ai/sdk",
-        description: "Error cuando el OpenCode SDK no está disponible"
+        value: "OpenCode SDK non disponible. Installez @opencode-ai/sdk",
+        description: "Error when OpenCode SDK is not available"
       },
       "error.opencodeSdk.notInstalled": {
-        value: "OpenCode SDK no instalado. Ejecute: npm install @opencode-ai/sdk",
-        description: "Error cuando no se encuentra el módulo del OpenCode SDK"
+        value: "OpenCode SDK non installé. Exécutez : npm install @opencode-ai/sdk",
+        description: "Error when OpenCode SDK module is not found"
       },
       "error.providerNotInitialized": {
-        value: "Proveedor no inicializado",
-        description: "Error cuando el proveedor no ha sido inicializado antes de su uso"
+        value: "Fournisseur non initialisé",
+        description: "Error when provider has not been initialized before use"
       },
       "error.agentKeyRequired": {
-        value: "La clave del agente es obligatoria",
-        description: "Error de validación: falta la clave del agente"
+        value: "La clé de l'agent est obligatoire",
+        description: "Validation error: missing agent key"
       },
       "error.agentMissingVersion": {
-        value: "Al agente {key} le falta una versión de tipo cadena",
-        description: "Error de validación: la versión no es una cadena de texto",
+        value: "L'agent {key} n'a pas de version sous forme de chaîne de caractères",
+        description: "Validation error: version not a string",
         placeholders: [{ name: "key", type: "string" }]
       },
       "error.agentRequiresInstructions": {
-        value: "El agente {key} requiere instrucciones",
-        description: "Error de validación: faltan instrucciones",
+        value: "L'agent {key} nécessite des instructions",
+        description: "Validation error: missing instructions",
         placeholders: [{ name: "key", type: "string" }]
       },
       "error.agentRequiresTool": {
-        value: "El agente {key} debe exponer al menos una herramienta",
-        description: "Error de validación: no hay herramientas definidas",
+        value: "L'agent {key} doit exposer au moins un outil",
+        description: "Validation error: no tools defined",
         placeholders: [{ name: "key", type: "string" }]
       },
       "error.agentDuplicateTool": {
-        value: "El agente {key} tiene un nombre de herramienta duplicado: {name}",
-        description: "Error de validación: nombre de herramienta duplicado",
+        value: "L'agent {key} a un nom d'outil en double : {name}",
+        description: "Validation error: duplicate tool name",
         placeholders: [
           { name: "key", type: "string" },
           { name: "name", type: "string" }
         ]
       },
       "error.agentSpecNotFound": {
-        value: "Especificación de agente no encontrada para {name}",
-        description: "Error cuando la especificación del agente no está en el registro",
+        value: "Spécification d'agent introuvable pour {name}",
+        description: "Error when agent spec is not in the registry",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.specNotFound": {
-        value: "Especificación no encontrada: {specKey}",
-        description: "Error cuando no se encuentra una clave de especificación",
+        value: "Spécification introuvable : {specKey}",
+        description: "Error when a spec key is not found",
         placeholders: [{ name: "specKey", type: "string" }]
       },
       "error.toolNotFound": {
-        value: "Herramienta no encontrada: {name}",
-        description: "Error cuando no se encuentra una herramienta",
+        value: "Outil introuvable : {name}",
+        description: "Error when a tool is not found",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.noHandlerForTool": {
-        value: "No hay manejador registrado para la herramienta: {name}",
-        description: "Error cuando no hay manejador registrado para una herramienta",
+        value: "Aucun gestionnaire enregistré pour l'outil : {name}",
+        description: "Error when no handler is registered for a tool",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.noToolHandler": {
-        value: "Sin manejador para la herramienta: {name}",
-        description: "Error breve cuando no existe manejador",
+        value: "Aucun gestionnaire pour l'outil : {name}",
+        description: "Short error when no handler exists",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.unknownExportFormat": {
-        value: "Formato de exportación desconocido: {format}",
-        description: "Error para formato de exportación no soportado",
+        value: "Format d'export inconnu : {format}",
+        description: "Error for unsupported export format",
         placeholders: [{ name: "format", type: "string" }]
       },
       "error.handlerNotFoundForTool": {
-        value: "Manejador no encontrado para la herramienta {name}",
-        description: "Error en el puente de herramientas cuando falta el manejador",
+        value: "Gestionnaire introuvable pour l'outil {name}",
+        description: "Error in tool bridge when handler is missing",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.toolNotFoundOrNoHandler": {
-        value: "Error: La herramienta '{name}' no fue encontrada o no tiene manejador",
-        description: "Error devuelto al LLM cuando la ejecución de la herramienta falla",
+        value: "Erreur : L'outil « {name} » est introuvable ou n'a pas de gestionnaire",
+        description: "Error returned to LLM when tool execution fails",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.toolNoExecuteHandler": {
-        value: "La herramienta {name} no tiene manejador de ejecución",
-        description: "Error cuando la herramienta carece de una función de ejecución",
+        value: "L'outil {name} n'a pas de gestionnaire d'exécution",
+        description: "Error when tool lacks an execute function",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.provider.notRegistered": {
-        value: "no registrado",
-        description: "Razón de disponibilidad del proveedor: no registrado"
+        value: "non enregistré",
+        description: "Provider availability reason: not registered"
       },
       "error.provider.depsNotInstalled": {
-        value: "dependencias no instaladas o no configuradas",
-        description: "Razón de disponibilidad del proveedor: faltan dependencias"
+        value: "dépendances non installées ou non configurées",
+        description: "Provider availability reason: deps missing"
       },
       "error.provider.sdkNotConfigured": {
-        value: "SDK no instalado o clave de API no configurada",
-        description: "Razón de disponibilidad del proveedor: falta SDK o clave"
+        value: "SDK non installé ou clé d'API non configurée",
+        description: "Provider availability reason: SDK or key missing"
       },
       "error.provider.claudeSdkMissing": {
-        value: "@anthropic-ai/claude-agent-sdk no está instalado",
-        description: "Error cuando falla require.resolve del Claude Agent SDK"
+        value: "@anthropic-ai/claude-agent-sdk n'est pas installé",
+        description: "Error when Claude Agent SDK require.resolve fails"
       },
       "error.provider.opencodeSdkMissing": {
-        value: "@opencode-ai/sdk no está instalado",
-        description: "Error cuando falla require.resolve del OpenCode SDK"
+        value: "@opencode-ai/sdk n'est pas installé",
+        description: "Error when OpenCode SDK require.resolve fails"
       },
       "error.provider.sdkNotInstalled": {
-        value: "SDK no instalado",
-        description: "Error genérico del proveedor: SDK no instalado"
+        value: "SDK non installé",
+        description: "Generic provider error: SDK not installed"
       },
       "error.provider.contextCreation": {
-        value: "Error al crear el contexto: {error}",
-        description: "Error durante la creación del contexto del proveedor",
+        value: "Échec de la création du contexte : {error}",
+        description: "Error during provider context creation",
         placeholders: [{ name: "error", type: "string" }]
       },
       "error.provider.executionFailed": {
-        value: "La ejecución falló: {error}",
-        description: "Error durante la ejecución del proveedor",
+        value: "Échec de l'exécution : {error}",
+        description: "Error during provider execution",
         placeholders: [{ name: "error", type: "string" }]
       },
       "error.provider.streamFailed": {
-        value: "El stream falló: {error}",
-        description: "Error durante el streaming del proveedor",
+        value: "Échec du flux : {error}",
+        description: "Error during provider streaming",
         placeholders: [{ name: "error", type: "string" }]
       },
       "export.agentConfiguration": {
-        value: "# Configuración del agente",
-        description: "Encabezado Markdown"
+        value: "# Configuration de l'agent",
+        description: "Markdown heading"
       },
       "export.metadata": {
-        value: "## Metadatos",
-        description: "Encabezado Markdown"
+        value: "## Métadonnées",
+        description: "Markdown heading"
       },
       "export.metaName": {
-        value: "- **Nombre**: {name}",
-        description: "Línea de metadatos",
+        value: "- **Nom** : {name}",
+        description: "Metadata line",
         placeholders: [{ name: "name", type: "string" }]
       },
       "export.metaVersion": {
-        value: "- **Versión**: {version}",
-        description: "Línea de metadatos",
+        value: "- **Version** : {version}",
+        description: "Metadata line",
         placeholders: [{ name: "version", type: "string" }]
       },
       "export.metaOwners": {
-        value: "- **Propietarios**: {owners}",
-        description: "Línea de metadatos",
+        value: "- **Propriétaires** : {owners}",
+        description: "Metadata line",
         placeholders: [{ name: "owners", type: "string" }]
       },
       "export.metaModel": {
-        value: "- **Modelo**: {model}",
-        description: "Línea de metadatos",
+        value: "- **Modèle** : {model}",
+        description: "Metadata line",
         placeholders: [{ name: "model", type: "string" }]
       },
       "export.instructions": {
-        value: "## Instrucciones",
-        description: "Encabezado Markdown"
+        value: "## Instructions",
+        description: "Markdown heading"
       },
       "export.availableTools": {
-        value: "## Herramientas disponibles",
-        description: "Encabezado Markdown"
-      },
-      "export.tools": {
-        value: "## Herramientas",
-        description: "Encabezado Markdown"
+        value: "## Outils disponibles",
+        description: "Markdown heading"
       },
+      "export.tools": { value: "## Outils", description: "Markdown heading" },
       "export.knowledgeSources": {
-        value: "## Fuentes de conocimiento",
-        description: "Encabezado Markdown"
+        value: "## Sources de connaissances",
+        description: "Markdown heading"
       },
       "export.policy": {
-        value: "## Política",
-        description: "Encabezado Markdown"
+        value: "## Politique",
+        description: "Markdown heading"
       },
       "export.additionalContext": {
-        value: "## Contexto adicional",
-        description: "Encabezado Markdown"
+        value: "## Contexte supplémentaire",
+        description: "Markdown heading"
       },
       "export.configuration": {
-        value: "## Configuración",
-        description: "Encabezado Markdown"
+        value: "## Configuration",
+        description: "Markdown heading"
       },
       "export.mcpServers": {
-        value: "## Servidores MCP",
-        description: "Encabezado Markdown"
+        value: "## Serveurs MCP",
+        description: "Markdown heading"
       },
       "export.parameters": {
-        value: "**Parámetros:**",
-        description: "Etiqueta de parámetros"
+        value: "**Paramètres :**",
+        description: "Parameters label"
       },
       "export.requiresApproval": {
-        value: "requiere aprobación",
-        description: "Indicador de herramienta"
+        value: "nécessite une approbation",
+        description: "Tool flag"
       },
       "export.notAutomationSafe": {
-        value: "no es seguro para automatización",
-        description: "Indicador de herramienta"
+        value: "non compatible avec l'automatisation",
+        description: "Tool flag"
       },
       "export.requiresApprovalMd": {
-        value: "*(requiere aprobación)*",
-        description: "Indicador de herramienta en Markdown"
+        value: "*(nécessite une approbation)*",
+        description: "Markdown tool flag"
       },
       "export.notAutomationSafeMd": {
-        value: "*(no es seguro para automatización)*",
-        description: "Indicador de herramienta en Markdown"
+        value: "*(non compatible avec l'automatisation)*",
+        description: "Markdown tool flag"
       },
       "export.required": {
-        value: "(obligatorio)",
-        description: "Marcador de obligatorio"
+        value: "(obligatoire)",
+        description: "Required marker"
       },
       "export.optional": {
-        value: "(opcional)",
-        description: "Marcador de opcional"
+        value: "(optionnel)",
+        description: "Optional marker"
       },
       "export.minConfidence": {
-        value: "- Confianza mínima: {min}",
-        description: "Línea de política",
+        value: "- Confiance minimale : {min}",
+        description: "Policy line",
         placeholders: [{ name: "min", type: "number" }]
       },
       "export.escalationConfigured": {
-        value: "- La política de escalamiento está configurada",
-        description: "Línea de política para el prompt del sistema"
+        value: "- La politique d'escalade est configurée",
+        description: "Policy line for system prompt"
       },
       "export.escalationPolicyConfigured": {
-        value: "- Política de escalamiento configurada",
-        description: "Línea de política para la exportación en Markdown"
+        value: "- Politique d'escalade configurée",
+        description: "Policy line for markdown export"
       },
       "export.featureFlags": {
-        value: "- Indicadores de características: {flags}",
-        description: "Línea de política de indicadores de características",
+        value: "- Indicateurs de fonctionnalités : {flags}",
+        description: "Feature flags policy line",
         placeholders: [{ name: "flags", type: "string" }]
       },
       "export.generatedFrom": {
-        value: "*Generado desde ContractSpec: {key}*",
-        description: "Línea de atribución en el pie",
+        value: "*Généré à partir de ContractSpec : {key}*",
+        description: "Footer attribution line",
         placeholders: [{ name: "key", type: "string" }]
       },
       "export.exportedAt": {
-        value: "*Exportado el: {date}*",
-        description: "Marca de tiempo en el pie",
+        value: "*Exporté le : {date}*",
+        description: "Footer timestamp",
         placeholders: [{ name: "date", type: "string" }]
       },
       "export.agentType": {
-        value: "> Tipo de agente: **{type}**",
-        description: "Llamada de tipo de agente",
+        value: "> Type d'agent : **{type}**",
+        description: "Agent type callout",
         placeholders: [{ name: "type", type: "string" }]
       },
       "export.noDescription": {
-        value: "Sin descripción",
-        description: "Texto de respaldo cuando la herramienta no tiene descripción"
+        value: "Aucune description",
+        description: "Fallback when tool has no description"
       },
       "export.validation.requiresKey": {
-        value: "La especificación debe tener una meta.key",
-        description: "Error de validación"
+        value: "La spécification doit avoir une meta.key",
+        description: "Validation error"
       },
       "export.validation.requiresInstructions": {
-        value: "La especificación debe tener instrucciones",
-        description: "Error de validación"
+        value: "La spécification doit avoir des instructions",
+        description: "Validation error"
       },
       "export.validation.requiresTool": {
-        value: "La especificación debe tener al menos una herramienta",
-        description: "Error de validación"
+        value: "La spécification doit avoir au moins un outil",
+        description: "Validation error"
       },
       "export.validation.toolRequiresName": {
-        value: "Todas las herramientas deben tener un nombre",
-        description: "Error de validación"
+        value: "Tous les outils doivent avoir un nom",
+        description: "Validation error"
       },
       "export.validation.toolRequiresDescOrName": {
-        value: "La herramienta debe tener una descripción o un nombre",
-        description: "Error de validación"
+        value: "L'outil doit avoir une description ou un nom",
+        description: "Validation error"
       },
       "export.validation.toolInvalidName": {
-        value: "El nombre de herramienta '{name}' debe ser un identificador válido (letras, números, guiones bajos)",
-        description: "Error de validación para nombre de herramienta inválido",
+        value: "Le nom d'outil « {name} » doit être un identifiant valide (lettres, chiffres, underscores)",
+        description: "Validation error for invalid tool name",
         placeholders: [{ name: "name", type: "string" }]
       },
       "export.agentType.build": {
-        value: "Agente principal con acceso completo a herramientas para la generación y modificación de código.",
-        description: "Descripción del tipo de agente de construcción"
+        value: "Agent principal avec accès complet aux outils pour la génération et la modification de code.",
+        description: "Build agent type description"
       },
       "export.agentType.plan": {
-        value: "Agente restringido para análisis y planificación. Las ediciones de archivos y los comandos bash requieren aprobación.",
-        description: "Descripción del tipo de agente de planificación"
+        value: "Agent restreint pour l'analyse et la planification. Les modifications de fichiers et les commandes bash nécessitent une approbation.",
+        description: "Plan agent type description"
       },
       "export.agentType.general": {
-        value: "Subagente de propósito general para preguntas complejas y tareas de múltiples pasos.",
-        description: "Descripción del tipo de agente general"
+        value: "Sous-agent généraliste pour les questions complexes et les tâches en plusieurs étapes.",
+        description: "General agent type description"
       },
       "export.agentType.explore": {
-        value: "Subagente rápido optimizado para exploración de código y búsqueda de patrones.",
-        description: "Descripción del tipo de agente de exploración"
+        value: "Sous-agent rapide optimisé pour l'exploration de la base de code et la recherche de motifs.",
+        description: "Explore agent type description"
       },
       "export.bridge.requiresApproval": {
-        value: "(requiere aprobación)",
-        description: "Etiqueta de permiso de herramienta"
+        value: "(nécessite une approbation)",
+        description: "Tool permission label"
       },
       "export.bridge.askMode": {
-        value: "(modo consulta)",
-        description: "Etiqueta de permiso de herramienta"
+        value: "(mode interrogation)",
+        description: "Tool permission label"
       },
       "approval.toolRequiresApproval": {
-        value: 'La herramienta "{name}" requiere aprobación',
-        description: "Razón predeterminada para solicitudes de aprobación de herramientas",
+        value: "L'outil « {name} » nécessite une approbation",
+        description: "Default reason for tool approval requests",
         placeholders: [{ name: "name", type: "string" }]
       },
       "log.unifiedAgent.fallback": {
-        value: "[UnifiedAgent] {backend} falló, recurriendo a {fallback}",
-        description: "Advertencia cuando un backend falla y se utiliza el respaldo",
+        value: "[UnifiedAgent] {backend} a échoué, repli sur {fallback}",
+        description: "Warning when a backend fails and fallback is used",
         placeholders: [
           { name: "backend", type: "string" },
           { name: "fallback", type: "string" }
         ]
       },
       "log.knowledge.spaceNotAvailable": {
-        value: 'El espacio de conocimiento requerido "{key}" no está disponible',
-        description: "Advertencia cuando un espacio de conocimiento requerido no existe",
+        value: "L'espace de connaissances requis « {key} » n'est pas disponible",
+        description: "Warning when a required knowledge space is missing",
         placeholders: [{ name: "key", type: "string" }]
       },
       "log.knowledge.loadFailed": {
-        value: 'Error al cargar el conocimiento requerido "{key}":',
-        description: "Advertencia cuando falla la carga de conocimiento",
+        value: "Échec du chargement des connaissances requises « {key} » :",
+        description: "Warning when knowledge loading fails",
         placeholders: [{ name: "key", type: "string" }]
       },
       "log.knowledge.queryFailed": {
-        value: "Error al consultar el espacio de conocimiento {space}:",
-        description: "Advertencia cuando falla la consulta de conocimiento",
+        value: "Échec de l'interrogation de l'espace de connaissances {space} :",
+        description: "Warning when knowledge querying fails",
         placeholders: [{ name: "space", type: "string" }]
       },
       "log.mcpServer.started": {
-        value: "[MCPToolServer] Iniciado {name}@{version} con {count} herramientas",
-        description: "Mensaje de registro cuando el servidor de herramientas MCP se inicia",
+        value: "[MCPToolServer] {name}@{version} démarré avec {count} outils",
+        description: "Log message when MCP tool server starts",
         placeholders: [
           { name: "name", type: "string" },
           { name: "version", type: "string" },
@@ -1900,24 +1900,24 @@ var init_es = __esm(() => {
         ]
       },
       "log.mcpServer.stopped": {
-        value: "[MCPToolServer] Detenido {name}",
-        description: "Mensaje de registro cuando el servidor de herramientas MCP se detiene",
+        value: "[MCPToolServer] {name} arrêté",
+        description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
       },
       "error.telemetry.posthogAiRequired": {
-        value: "PostHog LLM Analytics requiere que @posthog/ai esté instalado. Ejecute: npm install @posthog/ai posthog-node",
+        value: "PostHog LLM Analytics nécessite l'installation de @posthog/ai. Exécutez : npm install @posthog/ai posthog-node",
         description: "Error when PostHog AI dependency is missing"
       },
       "error.telemetry.posthogClientOrKeyRequired": {
-        value: "PostHog LLM Analytics requiere una instancia de cliente o una apiKey.",
+        value: "PostHog LLM Analytics nécessite soit une instance client, soit une apiKey.",
         description: "Error when PostHog client or API key is not configured"
       },
       "error.telemetry.posthogNodeRequired": {
-        value: "PostHog LLM Analytics requiere que posthog-node esté instalado. Ejecute: npm install posthog-node",
+        value: "PostHog LLM Analytics nécessite l'installation de posthog-node. Exécutez : npm install posthog-node",
         description: "Error when posthog-node dependency is missing"
       },
       "error.provider.notAvailable": {
-        value: "El proveedor '{provider}' no está disponible{reason}",
+        value: "Le fournisseur « {provider} » n'est pas disponible{reason}",
         description: "Error when a provider is unavailable",
         placeholders: [
           { name: "provider", type: "string" },
@@ -1928,33 +1928,6 @@ var init_es = __esm(() => {
   });
 });
 
-// src/i18n/messages.ts
-import {
-  createI18nFactory
-} from "@contractspec/lib.contracts-spec/translations";
-var factory, createAgentI18n, getDefaultI18n, resetI18nRegistry;
-var init_messages = __esm(() => {
-  init_en();
-  init_fr();
-  init_es();
-  factory = createI18nFactory({
-    specKey: "ai-agent.messages",
-    catalogs: [enMessages, frMessages, esMessages]
-  });
-  createAgentI18n = factory.create;
-  getDefaultI18n = factory.getDefault;
-  resetI18nRegistry = factory.resetRegistry;
-});
-
-// src/i18n/locale.ts
-import {
-  DEFAULT_LOCALE,
-  SUPPORTED_LOCALES,
-  resolveLocale,
-  isSupportedLocale
-} from "@contractspec/lib.contracts-spec/translations";
-var init_locale = () => {};
-
 // src/i18n/keys.ts
 var AGENT_KEYS, KNOWLEDGE_KEYS, TOOL_KEYS, INTEROP_KEYS, ERROR_KEYS, EXPORT_KEYS, APPROVAL_KEYS, LOG_KEYS, I18N_KEYS;
 var init_keys = __esm(() => {
@@ -2121,492 +2094,426 @@ var init_keys = __esm(() => {
   };
 });
 
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  isSupportedLocale,
+  resolveLocale,
+  SUPPORTED_LOCALES
+} from "@contractspec/lib.contracts-spec/translations";
+var init_locale = () => {};
+
+// src/i18n/messages.ts
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+var factory, createAgentI18n, getDefaultI18n, resetI18nRegistry;
+var init_messages = __esm(() => {
+  init_en();
+  init_es();
+  init_fr();
+  factory = createI18nFactory({
+    specKey: "ai-agent.messages",
+    catalogs: [enMessages, frMessages, esMessages]
+  });
+  createAgentI18n = factory.create;
+  getDefaultI18n = factory.getDefault;
+  resetI18nRegistry = factory.resetRegistry;
+});
+
 // src/i18n/index.ts
 var init_i18n = __esm(() => {
-  init_messages();
-  init_locale();
-  init_keys();
   init_en();
-  init_fr();
   init_es();
+  init_fr();
+  init_keys();
+  init_locale();
+  init_messages();
 });
 
-// src/spec/spec.ts
-function defineAgent(spec) {
-  const i18n = createAgentI18n(spec.locale);
-  if (!spec.meta?.key) {
-    throw new Error(i18n.t("error.agentKeyRequired"));
-  }
-  if (typeof spec.meta.version !== "string") {
-    throw new Error(i18n.t("error.agentMissingVersion", { key: spec.meta.key }));
-  }
-  if (!spec.instructions?.trim()) {
-    throw new Error(i18n.t("error.agentRequiresInstructions", { key: spec.meta.key }));
-  }
-  if (!spec.tools?.length) {
-    throw new Error(i18n.t("error.agentRequiresTool", { key: spec.meta.key }));
-  }
-  for (const [portName, portRef] of Object.entries(spec.runtime?.ports ?? {})) {
-    if (portRef !== undefined && portRef.trim().length === 0) {
-      throw new Error(`Agent ${spec.meta.key} has invalid runtime config: port "${portName}" must not be empty`);
-    }
-  }
-  const toolNames = new Set;
-  for (const tool of spec.tools) {
-    if (toolNames.has(tool.name)) {
-      throw new Error(i18n.t("error.agentDuplicateTool", {
-        key: spec.meta.key,
-        name: tool.name
-      }));
+// src/knowledge/injector.ts
+async function injectStaticKnowledge(instructions, knowledgeRefs, retriever, locale) {
+  if (!retriever)
+    return instructions;
+  const requiredRefs = knowledgeRefs.filter((ref) => ref.required);
+  if (requiredRefs.length === 0)
+    return instructions;
+  const i18n = createAgentI18n(locale);
+  const blocks = [];
+  for (const ref of requiredRefs) {
+    if (!retriever.supportsSpace(ref.key)) {
+      console.warn(i18n.t("log.knowledge.spaceNotAvailable", { key: ref.key }));
+      continue;
     }
-    toolNames.add(tool.name);
-    if (tool.subagentRef && tool.operationRef) {
-      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
-    }
-    const outputRefCount = [
-      tool.outputPresentation,
-      tool.outputForm,
-      tool.outputDataView
-    ].filter(Boolean).length;
-    if (outputRefCount > 1) {
-      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    try {
+      const content = await retriever.getStatic(ref.key);
+      if (content) {
+        const header = ref.instructions ? `## ${ref.key}
+${ref.instructions}` : `## ${ref.key}`;
+        blocks.push(`${header}
+
+${content}`);
+      }
+    } catch (error) {
+      console.warn(i18n.t("log.knowledge.loadFailed", { key: ref.key }), error);
     }
   }
-  return Object.freeze(spec);
+  if (blocks.length === 0)
+    return instructions;
+  return `${instructions}
+
+---
+
+# ${i18n.t("knowledge.header")}
+
+${i18n.t("knowledge.description")}
+
+${blocks.join(`
+
+---
+
+`)}`;
 }
-function agentKey(meta) {
-  return `${meta.key}.v${meta.version}`;
+function createKnowledgeInjector(retriever, locale) {
+  return {
+    inject: (instructions, knowledgeRefs) => injectStaticKnowledge(instructions, knowledgeRefs, retriever, locale),
+    hasSpace: (spaceKey) => retriever?.supportsSpace(spaceKey) ?? false,
+    listSpaces: () => retriever?.listSpaces() ?? []
+  };
 }
-var init_spec = __esm(() => {
+var init_injector = __esm(() => {
   init_i18n();
 });
 
-// src/schema/json-schema-to-zod.ts
-import { z } from "zod";
-function jsonSchemaToZod(schema) {
-  const s = schema;
-  const makeNullable = (zodSchema) => {
-    return s.nullable ? z.union([zodSchema, z.null()]) : zodSchema;
-  };
-  if (s.const !== undefined) {
-    return z.literal(s.const);
+// src/session/store.ts
+class InMemorySessionStore {
+  sessions = new Map;
+  maxSessions;
+  maxMessagesPerSession;
+  maxStepsPerSession;
+  constructor(options = {}) {
+    this.maxSessions = options.maxSessions ?? 500;
+    this.maxMessagesPerSession = options.maxMessagesPerSession ?? 200;
+    this.maxStepsPerSession = options.maxStepsPerSession ?? 200;
   }
-  if (s.enum) {
-    const values = s.enum;
-    return makeNullable(z.enum(values.map(String)));
+  async get(sessionId) {
+    return this.sessions.get(sessionId) ?? null;
   }
-  if (s.anyOf && s.anyOf.length > 0) {
-    const schemas = s.anyOf.map((sub) => jsonSchemaToZod(sub));
-    if (schemas.length === 1)
-      return schemas[0] ?? z.unknown();
-    return z.union([
-      schemas[0] ?? z.unknown(),
-      schemas[1] ?? z.unknown(),
-      ...schemas.slice(2)
-    ]);
+  async create(session) {
+    this.evictIfNeeded();
+    const now = new Date;
+    const fullSession = {
+      ...session,
+      createdAt: now,
+      updatedAt: now
+    };
+    this.sessions.set(session.sessionId, fullSession);
+    return fullSession;
   }
-  if (s.oneOf && s.oneOf.length > 0) {
-    const schemas = s.oneOf.map((sub) => jsonSchemaToZod(sub));
-    if (schemas.length === 1)
-      return schemas[0] ?? z.unknown();
-    return z.union([
-      schemas[0] ?? z.unknown(),
-      schemas[1] ?? z.unknown(),
-      ...schemas.slice(2)
-    ]);
+  async appendStep(sessionId, step) {
+    const session = this.sessions.get(sessionId);
+    if (session) {
+      session.steps.push(step);
+      this.trimArray(session.steps, this.maxStepsPerSession);
+      session.updatedAt = new Date;
+    }
   }
-  if (s.allOf && s.allOf.length > 0) {
-    const schemas = s.allOf.map((sub) => jsonSchemaToZod(sub));
-    return schemas.reduce((acc, curr) => z.intersection(acc, curr));
+  async appendMessage(sessionId, message) {
+    const session = this.sessions.get(sessionId);
+    if (session) {
+      session.messages.push(message);
+      this.trimArray(session.messages, this.maxMessagesPerSession);
+      session.updatedAt = new Date;
+    }
   }
-  switch (s.type) {
-    case "string":
-      return makeNullable(buildStringSchema(s));
-    case "number":
-    case "integer":
-      return makeNullable(buildNumberSchema(s));
-    case "boolean":
-      return makeNullable(z.boolean());
-    case "null":
-      return z.null();
-    case "array":
-      return makeNullable(buildArraySchema(s));
-    case "object":
-      return makeNullable(buildObjectSchema(s));
-    default:
-      return z.unknown();
+  async update(sessionId, updates) {
+    const session = this.sessions.get(sessionId);
+    if (session) {
+      Object.assign(session, updates, { updatedAt: new Date });
+    }
   }
-}
-function buildStringSchema(schema) {
-  let zodSchema = z.string();
-  if (schema.description) {
-    zodSchema = zodSchema.describe(schema.description);
+  async delete(sessionId) {
+    return this.sessions.delete(sessionId);
   }
-  switch (schema.format) {
-    case "email":
-      zodSchema = zodSchema.email();
-      break;
-    case "uri":
-    case "url":
-      zodSchema = zodSchema.url();
-      break;
-    case "uuid":
-      zodSchema = zodSchema.uuid();
-      break;
-    case "date-time":
-      zodSchema = zodSchema.datetime();
-      break;
-    case "date":
-      zodSchema = zodSchema.date();
-      break;
+  async listByAgent(agentId, limit = 100) {
+    const results = [];
+    for (const session of this.sessions.values()) {
+      if (session.agentId === agentId) {
+        results.push(session);
+        if (results.length >= limit)
+          break;
+      }
+    }
+    return results.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
   }
-  if (schema.minLength !== undefined) {
-    zodSchema = zodSchema.min(schema.minLength);
+  async listByTenant(tenantId, limit = 100) {
+    const results = [];
+    for (const session of this.sessions.values()) {
+      if (session.tenantId === tenantId) {
+        results.push(session);
+        if (results.length >= limit)
+          break;
+      }
+    }
+    return results.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
   }
-  if (schema.maxLength !== undefined) {
-    zodSchema = zodSchema.max(schema.maxLength);
+  clear() {
+    this.sessions.clear();
   }
-  if (schema.pattern) {
-    zodSchema = zodSchema.regex(new RegExp(schema.pattern));
+  evictIfNeeded() {
+    if (this.sessions.size < this.maxSessions) {
+      return;
+    }
+    let oldestSessionId = null;
+    let oldestUpdatedAt = Number.POSITIVE_INFINITY;
+    for (const [sessionId, session] of this.sessions.entries()) {
+      const updatedAt = session.updatedAt.getTime();
+      if (updatedAt < oldestUpdatedAt) {
+        oldestUpdatedAt = updatedAt;
+        oldestSessionId = sessionId;
+      }
+    }
+    if (oldestSessionId) {
+      this.sessions.delete(oldestSessionId);
+    }
   }
-  return zodSchema;
-}
-function buildNumberSchema(schema) {
-  let zodSchema = schema.type === "integer" ? z.number().int() : z.number();
-  if (schema.description) {
-    zodSchema = zodSchema.describe(schema.description);
+  trimArray(items, maxItems) {
+    if (items.length <= maxItems) {
+      return;
+    }
+    const overflow = items.length - maxItems;
+    items.splice(0, overflow);
   }
-  if (schema.minimum !== undefined) {
-    zodSchema = zodSchema.min(schema.minimum);
+}
+function createInMemorySessionStore(options) {
+  return new InMemorySessionStore(options);
+}
+function createSecureSessionToken() {
+  const cryptoApi = globalThis.crypto;
+  if (typeof cryptoApi?.randomUUID === "function") {
+    return cryptoApi.randomUUID();
+  }
+  if (typeof cryptoApi?.getRandomValues === "function") {
+    const bytes = cryptoApi.getRandomValues(new Uint8Array(16));
+    const versionByte = bytes.at(6);
+    const variantByte = bytes.at(8);
+    if (versionByte === undefined || variantByte === undefined) {
+      throw new Error("Secure session token generation requires 16 random bytes.");
+    }
+    bytes[6] = versionByte & 15 | 64;
+    bytes[8] = variantByte & 63 | 128;
+    const hex = [...bytes].map((byte) => byte.toString(16).padStart(2, "0"));
+    return [
+      hex.slice(0, 4).join(""),
+      hex.slice(4, 6).join(""),
+      hex.slice(6, 8).join(""),
+      hex.slice(8, 10).join(""),
+      hex.slice(10, 16).join("")
+    ].join("-");
+  }
+  throw new Error("Secure session IDs require Web Crypto support.");
+}
+function generateSessionId() {
+  return `sess_${createSecureSessionToken()}`;
+}
+
+// src/spec/spec.ts
+function defineAgent(spec) {
+  const i18n = createAgentI18n(spec.locale);
+  if (!spec.meta?.key) {
+    throw new Error(i18n.t("error.agentKeyRequired"));
   }
-  if (schema.maximum !== undefined) {
-    zodSchema = zodSchema.max(schema.maximum);
+  if (typeof spec.meta.version !== "string") {
+    throw new Error(i18n.t("error.agentMissingVersion", { key: spec.meta.key }));
   }
-  return zodSchema;
-}
-function buildArraySchema(schema) {
-  const itemsSchema = schema.items ? jsonSchemaToZod(schema.items) : z.unknown();
-  let zodSchema = z.array(itemsSchema);
-  if (schema.description) {
-    zodSchema = zodSchema.describe(schema.description);
+  if (!spec.instructions?.trim()) {
+    throw new Error(i18n.t("error.agentRequiresInstructions", { key: spec.meta.key }));
   }
-  return zodSchema;
-}
-function buildObjectSchema(schema) {
-  const properties = schema.properties ?? {};
-  const required = new Set(schema.required ?? []);
-  const shape = {};
-  for (const [key, propSchema] of Object.entries(properties)) {
-    const zodProp = jsonSchemaToZod(propSchema);
-    shape[key] = required.has(key) ? zodProp : zodProp.optional();
+  if (!spec.tools?.length) {
+    throw new Error(i18n.t("error.agentRequiresTool", { key: spec.meta.key }));
   }
-  let zodSchema = z.object(shape);
-  if (schema.description) {
-    zodSchema = zodSchema.describe(schema.description);
+  for (const [portName, portRef] of Object.entries(spec.runtime?.ports ?? {})) {
+    if (portRef !== undefined && portRef.trim().length === 0) {
+      throw new Error(`Agent ${spec.meta.key} has invalid runtime config: port "${portName}" must not be empty`);
+    }
   }
-  return zodSchema;
-}
-function jsonSchemaToZodSafe(schema) {
-  if (!schema || Object.keys(schema).length === 0) {
-    return z.object({});
+  const toolNames = new Set;
+  for (const tool of spec.tools) {
+    if (toolNames.has(tool.name)) {
+      throw new Error(i18n.t("error.agentDuplicateTool", {
+        key: spec.meta.key,
+        name: tool.name
+      }));
+    }
+    toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
-  return jsonSchemaToZod(schema);
+  return Object.freeze(spec);
 }
-var init_json_schema_to_zod = () => {};
-
-// src/tools/operation-tool-handler.ts
-function toolCtxToHandlerCtx(ctx) {
-  return {
-    traceId: ctx.metadata?.traceId,
-    organizationId: ctx.tenantId ?? null,
-    userId: ctx.actorId ?? null,
-    actor: ctx.actorId ? "user" : "anonymous",
-    channel: "agent",
-    roles: []
-  };
-}
-function createOperationToolHandler(registry, operationRef) {
-  return async (input, context) => {
-    const handlerCtx = toolCtxToHandlerCtx(context);
-    const result = await registry.execute(operationRef.key, operationRef.version, input ?? {}, handlerCtx);
-    return result;
-  };
+function agentKey(meta) {
+  return `${meta.key}.v${meta.version}`;
 }
+var init_spec = __esm(() => {
+  init_i18n();
+});
 
-// src/tools/subagent-tool.ts
-import { readUIMessageStream, tool } from "ai";
-import { z as z2 } from "zod";
-function toReadableStream(iterable) {
-  if (iterable instanceof ReadableStream) {
-    return iterable;
+// src/telemetry/adapter.ts
+function parseAgentId(agentId) {
+  const match = agentId.match(/^(.+)\.v(\d+)$/);
+  if (match) {
+    return { name: match[1], version: match[2] };
   }
-  return new ReadableStream({
-    async start(controller) {
-      try {
-        for await (const chunk of iterable) {
-          controller.enqueue(chunk);
-        }
-      } finally {
-        controller.close();
-      }
-    }
-  });
+  return { name: agentId, version: "1.0.0" };
 }
-function createSubagentTool(options) {
-  const {
-    subagent,
-    description = "Research a topic or question in depth.",
-    taskParam = "task",
-    toModelSummary = true,
-    passConversationHistory = false
-  } = options;
-  const inputSchema = z2.object({
-    [taskParam]: z2.string().describe("The research task to complete")
-  });
-  const execute = async function* (input, options2) {
-    const task = String(input[taskParam] ?? input.task ?? "");
-    const { abortSignal, messages } = options2 ?? {};
-    if (passConversationHistory && messages && messages.length > 0 && typeof subagent.generate === "function") {
-      const result2 = await subagent.generate({
-        messages: [...messages, { role: "user", content: task }],
-        abortSignal
-      });
-      yield { parts: [{ type: "text", text: result2.text }] };
-      return;
-    }
-    const result = await subagent.stream({
-      prompt: task,
-      abortSignal
-    });
-    const uiStream = result.toUIMessageStream();
-    const stream = toReadableStream(uiStream);
-    for await (const message of readUIMessageStream({
-      stream
-    })) {
-      yield message;
-    }
-  };
-  const toolOptions = {
-    description,
-    inputSchema,
-    execute,
-    ...toModelSummary && {
-      toModelOutput: ({
-        output
-      }) => {
-        const parts = output?.parts;
-        if (!Array.isArray(parts)) {
-          return { type: "text", value: "Task completed." };
-        }
-        const lastTextPart = [...parts].reverse().find((p) => p?.type === "text");
-        return {
-          type: "text",
-          value: lastTextPart?.text ?? "Task completed."
-        };
-      }
-    }
-  };
-  return tool(toolOptions);
+function getRecord(value) {
+  return value && typeof value === "object" ? value : undefined;
 }
-var init_subagent_tool = () => {};
-
-// src/tools/tool-adapter.ts
-import { tool as tool2 } from "ai";
-function isAsyncGenerator(value) {
-  return typeof value === "object" && value !== null && typeof value.next === "function" && typeof value[Symbol.asyncIterator] === "function";
+function getStepResponse(step) {
+  const response = getRecord(step.response);
+  if (!response)
+    return;
+  return {
+    id: response["id"],
+    modelId: response["modelId"],
+    timestamp: response["timestamp"],
+    headers: response["headers"],
+    body: response["body"],
+    messages: response["messages"]
+  };
 }
-function specToolToAISDKTool(specTool, handler, context = {}, effectiveInputSchema, operationSpec) {
-  let lastInvocationAt;
-  const inputSchema = effectiveInputSchema ?? jsonSchemaToZodSafe(specTool.schema);
-  const buildContext = (signal) => ({
-    agentId: context.agentId ?? "unknown",
-    sessionId: context.sessionId ?? "unknown",
-    tenantId: context.tenantId,
-    actorId: context.actorId,
-    locale: context.locale,
-    metadata: context.metadata,
-    signal
-  });
-  return tool2({
-    description: specTool.description ?? specTool.name,
-    inputSchema,
-    needsApproval: specTool.requiresApproval ?? !specTool.automationSafe,
-    execute: async function* (input, options) {
-      const now = Date.now();
-      const cooldownMs = normalizeDuration(specTool.cooldownMs);
-      if (cooldownMs && lastInvocationAt !== undefined) {
-        const elapsed = now - lastInvocationAt;
-        if (elapsed < cooldownMs) {
-          const retryAfterMs = cooldownMs - elapsed;
-          throw createToolExecutionError(`Tool "${specTool.name}" is cooling down. Retry in ${retryAfterMs}ms.`, "TOOL_COOLDOWN_ACTIVE", retryAfterMs);
-        }
-      }
-      const timeoutMs = normalizeDuration(specTool.timeoutMs);
-      const signal = options?.abortSignal ?? context.signal;
-      const { signal: timeoutSignal, dispose } = createTimeoutSignal(signal, timeoutMs);
-      try {
-        const execution = handler(input, buildContext(timeoutSignal));
-        if (isAsyncGenerator(execution)) {
-          for await (const raw of execution) {
-            const wrapped = wrapToolOutputForRendering(specTool, raw, operationSpec);
-            yield typeof wrapped === "string" ? wrapped : wrapped;
-          }
-        } else {
-          const raw = timeoutMs ? await withTimeout(Promise.resolve(execution), timeoutMs, specTool.name) : await Promise.resolve(execution);
-          const wrapped = wrapToolOutputForRendering(specTool, raw, operationSpec);
-          yield typeof wrapped === "string" ? wrapped : wrapped;
-        }
-      } finally {
-        dispose();
-        lastInvocationAt = Date.now();
-      }
+function getRequestBodyValue(request, key) {
+  const body = request?.["body"];
+  if (!body)
+    return;
+  if (typeof body === "string") {
+    try {
+      const parsed = JSON.parse(body);
+      return typeof parsed[key] === "string" ? parsed[key] : undefined;
+    } catch {
+      return;
     }
-  });
+  }
+  const record = getRecord(body);
+  return typeof record?.[key] === "string" ? record[key] : undefined;
 }
-function specToolsToAISDKTools(specTools, handlers, context = {}, options) {
-  const tools = {};
-  for (const specTool of specTools) {
-    if (specTool.subagentRef && options?.subagentRegistry) {
-      const subagent = options.subagentRegistry.get(specTool.subagentRef.agentId);
-      if (!subagent) {
-        throw new Error(`Subagent not found: ${specTool.subagentRef.agentId}. Register it in subagentRegistry.`);
-      }
-      if (specTool.requiresApproval === true || specTool.automationSafe === false) {
-        console.warn(`[ContractSpec] Subagent tool "${specTool.name}" cannot use needsApproval. ` + `requiresApproval and automationSafe are ignored for subagent tools (AI SDK limitation). ` + `See https://ai-sdk.dev/docs/agents/subagents#no-tool-approvals-in-subagents`);
-      }
-      tools[specTool.name] = createSubagentTool({
-        subagent,
-        description: specTool.description ?? specTool.name,
-        toModelSummary: specTool.subagentRef.toModelSummary ?? true,
-        passConversationHistory: specTool.subagentRef.passConversationHistory
-      });
-      continue;
-    }
-    let handler;
-    let effectiveInputSchema;
-    let op;
-    if (specTool.operationRef && options?.operationRegistry) {
-      op = options.operationRegistry.get(specTool.operationRef.key, specTool.operationRef.version);
-      if (!op) {
-        throw new Error(`Operation not found: ${specTool.operationRef.key}${specTool.operationRef.version ? `.v${specTool.operationRef.version}` : ""}`);
-      }
-      handler = createOperationToolHandler(options.operationRegistry, specTool.operationRef);
-      effectiveInputSchema = op.io.input?.getZod?.();
-    } else {
-      const manualHandler = handlers.get(specTool.name);
-      if (!manualHandler) {
-        if (specTool.subagentRef) {
-          throw new Error(`Subagent tool "${specTool.name}" requires subagentRegistry. Pass subagentRegistry in ContractSpecAgentConfig.`);
-        }
-        throw new Error(createAgentI18n(context.locale).t("error.missingToolHandler", {
-          name: specTool.name
-        }));
+async function trackAgentStep(collector, agentId, step, durationMs, context) {
+  const { name, version } = parseAgentId(agentId);
+  const response = getStepResponse(step);
+  const providerMetadata = step.providerMetadata;
+  const warnings = step.warnings;
+  const rawFinishReason = step.rawFinishReason;
+  const request = getRecord(step.request);
+  const traceId = context?.traceId ?? getRequestBodyValue(request, "$ai_trace_id");
+  const sessionId = context?.sessionId ?? getRequestBodyValue(request, "$ai_session_id");
+  const parentSpanId = response?.id;
+  for (const toolCall of step.toolCalls ?? []) {
+    const toolResult = step.toolResults?.find((r) => r.toolCallId === toolCall.toolCallId);
+    const toolError = getRecord(toolResult?.output)?.["error"];
+    const toolSample = {
+      operation: { name: `${name}.${toolCall.toolName}`, version },
+      durationMs: durationMs ?? 0,
+      success: step.toolResults?.some((r) => r.toolCallId === toolCall.toolCallId && r.output !== undefined) ?? false,
+      timestamp: new Date,
+      metadata: {
+        telemetryEvent: "span",
+        traceId,
+        sessionId,
+        spanId: toolCall.toolCallId,
+        parentSpanId,
+        spanName: `tool.${toolCall.toolName}`,
+        agentId,
+        actorId: context?.actorId,
+        tenantId: context?.tenantId,
+        stepIndex: context?.stepIndex,
+        toolName: toolCall.toolName,
+        toolCallArgs: toolCall.input,
+        toolResultOutput: toolResult?.output,
+        errorMessage: typeof toolError === "string" ? toolError : typeof toolResult?.output === "string" ? toolResult.output : undefined,
+        finishReason: step.finishReason,
+        rawFinishReason
       }
-      handler = manualHandler;
-    }
-    tools[specTool.name] = specToolToAISDKTool(specTool, handler, context, effectiveInputSchema, op);
+    };
+    await collector.collect(toolSample);
   }
-  return tools;
-}
-function createToolHandler(handler) {
-  return (input, context) => {
-    return handler(input, context);
+  const stepSample = {
+    operation: { name, version },
+    durationMs: durationMs ?? 0,
+    success: step.finishReason !== "error",
+    timestamp: new Date,
+    metadata: {
+      telemetryEvent: "generation",
+      traceId,
+      sessionId,
+      spanId: response?.id,
+      spanName: `agent.${name}.step`,
+      agentId,
+      actorId: context?.actorId,
+      tenantId: context?.tenantId,
+      stepIndex: context?.stepIndex,
+      stepStartedAt: context?.stepStartedAt,
+      finishReason: step.finishReason,
+      rawFinishReason,
+      tokenUsage: step.usage,
+      totalUsage: step.totalUsage,
+      providerMetadata,
+      warnings,
+      stepText: step.text,
+      stepReasoningText: step.reasoningText,
+      responseId: response?.id,
+      responseModelId: response?.modelId,
+      responseTimestamp: response?.timestamp,
+      responseHeaders: response?.headers,
+      responseBody: response?.body,
+      responseMessages: response?.messages,
+      requestBody: request?.["body"],
+      requestHeaders: request?.["headers"],
+      toolCallCount: step.toolCalls?.length ?? 0,
+      toolCalls: step.toolCalls,
+      toolResults: step.toolResults,
+      errorMessage: step.finishReason === "error" ? step.text : undefined
+    }
   };
+  await collector.collect(stepSample);
 }
-function buildToolHandlers(handlersObj) {
-  return new Map(Object.entries(handlersObj));
-}
-function wrapToolOutputForRendering(specTool, result, operationSpec) {
-  const presentation = specTool.outputPresentation ?? operationSpec?.outputPresentation;
-  const form = specTool.outputForm ?? operationSpec?.outputForm;
-  const dataView = specTool.outputDataView ?? operationSpec?.outputDataView;
-  if (presentation) {
-    return {
-      presentationKey: presentation.key,
-      data: result
-    };
-  }
-  if (form) {
-    return {
-      formKey: form.key,
-      defaultValues: typeof result === "object" && result !== null ? result : {}
-    };
-  }
-  if (dataView) {
-    return {
-      dataViewKey: dataView.key,
-      items: Array.isArray(result) ? result : result != null ? [result] : []
-    };
+
+class InMemoryTelemetryCollector {
+  samples = [];
+  async collect(sample) {
+    this.samples.push(sample);
   }
-  return result;
-}
-function normalizeDuration(value) {
-  if (value === undefined) {
-    return;
+  getSamples() {
+    return [...this.samples];
   }
-  if (!Number.isFinite(value)) {
-    return;
+  getSamplesForOperation(operationName) {
+    return this.samples.filter((s) => s.operation.name === operationName);
   }
-  if (value <= 0) {
-    return;
+  clear() {
+    this.samples.length = 0;
   }
-  return Math.round(value);
 }
-function withTimeout(execution, timeoutMs, toolName) {
-  return new Promise((resolve, reject) => {
-    const timeoutHandle = setTimeout(() => {
-      reject(createToolExecutionError(`Tool "${toolName}" timed out after ${timeoutMs}ms.`, "TOOL_EXECUTION_TIMEOUT"));
-    }, timeoutMs);
-    execution.then((result) => {
-      clearTimeout(timeoutHandle);
-      resolve(result);
-    }).catch((error) => {
-      clearTimeout(timeoutHandle);
-      reject(error);
-    });
-  });
+function createInMemoryTelemetryCollector() {
+  return new InMemoryTelemetryCollector;
 }
-function createTimeoutSignal(signal, timeoutMs) {
-  const controller = new AbortController;
-  const abortFromSource = () => controller.abort();
-  if (signal) {
-    if (signal.aborted) {
-      controller.abort();
-    } else {
-      signal.addEventListener("abort", abortFromSource);
-    }
-  }
-  const timeoutHandle = timeoutMs !== undefined ? setTimeout(() => {
-    controller.abort();
-  }, timeoutMs) : undefined;
-  return {
-    signal: controller.signal,
-    dispose: () => {
-      if (timeoutHandle !== undefined) {
-        clearTimeout(timeoutHandle);
-      }
-      if (signal) {
-        signal.removeEventListener("abort", abortFromSource);
-      }
-    }
+var noopTelemetryCollector;
+var init_adapter = __esm(() => {
+  noopTelemetryCollector = {
+    collect: async () => {}
   };
-}
-function createToolExecutionError(message, code, retryAfterMs) {
-  return Object.assign(new Error(message), {
-    code,
-    kind: "retryable",
-    retryAfterMs
-  });
-}
-var init_tool_adapter = __esm(() => {
-  init_json_schema_to_zod();
-  init_i18n();
-  init_subagent_tool();
 });
 
 // src/tools/knowledge-tool.ts
-import { tool as tool3 } from "ai";
-import * as z3 from "zod";
+import { tool } from "ai";
+import * as z from "zod";
 function createKnowledgeQueryTool(retriever, knowledgeRefs, locale) {
   const i18n = createAgentI18n(locale);
   const optionalSpaces = knowledgeRefs.filter((k) => !k.required).map((k) => k.key).filter((key) => retriever.supportsSpace(key));
@@ -2615,15 +2522,15 @@ function createKnowledgeQueryTool(retriever, knowledgeRefs, locale) {
   }
   const spaceDescriptions = knowledgeRefs.filter((k) => !k.required && retriever.supportsSpace(k.key)).map((k) => `- ${k.key}: ${k.instructions ?? i18n.t("tool.knowledge.spaceDefault")}`).join(`
 `);
-  return tool3({
+  return tool({
     description: `${i18n.t("tool.knowledge.description")}
 
 ${i18n.t("tool.knowledge.availableSpaces")}
 ${spaceDescriptions}`,
-    inputSchema: z3.object({
-      query: z3.string().describe(i18n.t("tool.knowledge.param.query")),
-      spaceKey: z3.enum(optionalSpaces).optional().describe(i18n.t("tool.knowledge.param.spaceKey")),
-      topK: z3.number().optional().default(5).describe(i18n.t("tool.knowledge.param.topK"))
+    inputSchema: z.object({
+      query: z.string().describe(i18n.t("tool.knowledge.param.query")),
+      spaceKey: z.enum(optionalSpaces).optional().describe(i18n.t("tool.knowledge.param.spaceKey")),
+      topK: z.number().optional().default(5).describe(i18n.t("tool.knowledge.param.topK"))
     }),
     execute: async ({ query, spaceKey, topK }) => {
       const spacesToSearch = spaceKey ? [spaceKey] : optionalSpaces;
@@ -2663,33 +2570,6 @@ var init_knowledge_tool = __esm(() => {
   init_i18n();
 });
 
-// src/tools/memory-tools.ts
-import { anthropic } from "@ai-sdk/anthropic";
-function createAnthropicMemoryTool(store) {
-  const memory = anthropic.tools.memory_20250818({
-    execute: async (action) => {
-      switch (action.command) {
-        case "view":
-          return store.view(action.path ?? "/memories", action.view_range);
-        case "create":
-          return store.create(action.path ?? "/memories/untitled", action.file_text ?? "");
-        case "str_replace":
-          return store.strReplace(action.path ?? "/memories", action.old_str ?? "", action.new_str ?? "");
-        case "insert":
-          return store.insert(action.path ?? "/memories", action.insert_line ?? 0, action.insert_text ?? "");
-        case "delete":
-          return store.delete(action.path ?? "/memories");
-        case "rename":
-          return store.rename(action.old_path ?? "/memories", action.new_path ?? "/memories");
-        default:
-          return `Unknown command: ${action.command}`;
-      }
-    }
-  });
-  return memory;
-}
-var init_memory_tools = () => {};
-
 // src/tools/mcp-client-helpers.ts
 import {
   Experimental_StdioMCPTransport as StdioClientTransport
@@ -2720,8 +2600,8 @@ function prefixToolNames(config, tools) {
     return tools;
   }
   const prefixedTools = {};
-  for (const [toolName, tool4] of Object.entries(tools)) {
-    prefixedTools[`${prefix}_${toolName}`] = tool4;
+  for (const [toolName, tool2] of Object.entries(tools)) {
+    prefixedTools[`${prefix}_${toolName}`] = tool2;
   }
   return prefixedTools;
 }
@@ -2827,12 +2707,12 @@ async function createMcpToolsets(configs, options = {}) {
       for (const [serverName, toolNames] of Object.entries(result.serverToolNames)) {
         serverToolNames[serverName] = toolNames;
       }
-      for (const [toolName, tool4] of Object.entries(result.tools)) {
+      for (const [toolName, tool2] of Object.entries(result.tools)) {
         const hasCollision = combinedTools[toolName] !== undefined;
         if (hasCollision && collisionStrategy === "error") {
           throw new Error(`Duplicate MCP tool name "${toolName}" detected. Use "toolPrefix" or set onNameCollision to "overwrite".`);
         }
-        combinedTools[toolName] = tool4;
+        combinedTools[toolName] = tool2;
       }
     }
   } catch (error) {
@@ -2855,309 +2735,454 @@ var init_mcp_client = __esm(() => {
   init_mcp_client_helpers();
 });
 
-// src/knowledge/injector.ts
-async function injectStaticKnowledge(instructions, knowledgeRefs, retriever, locale) {
-  if (!retriever)
-    return instructions;
-  const requiredRefs = knowledgeRefs.filter((ref) => ref.required);
-  if (requiredRefs.length === 0)
-    return instructions;
-  const i18n = createAgentI18n(locale);
-  const blocks = [];
-  for (const ref of requiredRefs) {
-    if (!retriever.supportsSpace(ref.key)) {
-      console.warn(i18n.t("log.knowledge.spaceNotAvailable", { key: ref.key }));
-      continue;
-    }
-    try {
-      const content = await retriever.getStatic(ref.key);
-      if (content) {
-        const header = ref.instructions ? `## ${ref.key}
-${ref.instructions}` : `## ${ref.key}`;
-        blocks.push(`${header}
-
-${content}`);
+// src/tools/memory-tools.ts
+import { anthropic } from "@ai-sdk/anthropic";
+function createAnthropicMemoryTool(store) {
+  const memory = anthropic.tools.memory_20250818({
+    execute: async (action) => {
+      switch (action.command) {
+        case "view":
+          return store.view(action.path ?? "/memories", action.view_range);
+        case "create":
+          return store.create(action.path ?? "/memories/untitled", action.file_text ?? "");
+        case "str_replace":
+          return store.strReplace(action.path ?? "/memories", action.old_str ?? "", action.new_str ?? "");
+        case "insert":
+          return store.insert(action.path ?? "/memories", action.insert_line ?? 0, action.insert_text ?? "");
+        case "delete":
+          return store.delete(action.path ?? "/memories");
+        case "rename":
+          return store.rename(action.old_path ?? "/memories", action.new_path ?? "/memories");
+        default:
+          return `Unknown command: ${action.command}`;
       }
-    } catch (error) {
-      console.warn(i18n.t("log.knowledge.loadFailed", { key: ref.key }), error);
     }
+  });
+  return memory;
+}
+var init_memory_tools = () => {};
+
+// src/schema/json-schema-to-zod.ts
+import { z as z2 } from "zod";
+function jsonSchemaToZod(schema) {
+  const s = schema;
+  const makeNullable = (zodSchema) => {
+    return s.nullable ? z2.union([zodSchema, z2.null()]) : zodSchema;
+  };
+  if (s.const !== undefined) {
+    return z2.literal(s.const);
+  }
+  if (s.enum) {
+    const values = s.enum;
+    return makeNullable(z2.enum(values.map(String)));
+  }
+  if (s.anyOf && s.anyOf.length > 0) {
+    const schemas = s.anyOf.map((sub) => jsonSchemaToZod(sub));
+    if (schemas.length === 1)
+      return schemas[0] ?? z2.unknown();
+    return z2.union([
+      schemas[0] ?? z2.unknown(),
+      schemas[1] ?? z2.unknown(),
+      ...schemas.slice(2)
+    ]);
+  }
+  if (s.oneOf && s.oneOf.length > 0) {
+    const schemas = s.oneOf.map((sub) => jsonSchemaToZod(sub));
+    if (schemas.length === 1)
+      return schemas[0] ?? z2.unknown();
+    return z2.union([
+      schemas[0] ?? z2.unknown(),
+      schemas[1] ?? z2.unknown(),
+      ...schemas.slice(2)
+    ]);
+  }
+  if (s.allOf && s.allOf.length > 0) {
+    const schemas = s.allOf.map((sub) => jsonSchemaToZod(sub));
+    return schemas.reduce((acc, curr) => z2.intersection(acc, curr));
+  }
+  switch (s.type) {
+    case "string":
+      return makeNullable(buildStringSchema(s));
+    case "number":
+    case "integer":
+      return makeNullable(buildNumberSchema(s));
+    case "boolean":
+      return makeNullable(z2.boolean());
+    case "null":
+      return z2.null();
+    case "array":
+      return makeNullable(buildArraySchema(s));
+    case "object":
+      return makeNullable(buildObjectSchema(s));
+    default:
+      return z2.unknown();
+  }
+}
+function buildStringSchema(schema) {
+  let zodSchema = z2.string();
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  switch (schema.format) {
+    case "email":
+      zodSchema = zodSchema.email();
+      break;
+    case "uri":
+    case "url":
+      zodSchema = zodSchema.url();
+      break;
+    case "uuid":
+      zodSchema = zodSchema.uuid();
+      break;
+    case "date-time":
+      zodSchema = zodSchema.datetime();
+      break;
+    case "date":
+      zodSchema = zodSchema.date();
+      break;
+  }
+  if (schema.minLength !== undefined) {
+    zodSchema = zodSchema.min(schema.minLength);
+  }
+  if (schema.maxLength !== undefined) {
+    zodSchema = zodSchema.max(schema.maxLength);
+  }
+  if (schema.pattern) {
+    zodSchema = zodSchema.regex(new RegExp(schema.pattern));
+  }
+  return zodSchema;
+}
+function buildNumberSchema(schema) {
+  let zodSchema = schema.type === "integer" ? z2.number().int() : z2.number();
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  if (schema.minimum !== undefined) {
+    zodSchema = zodSchema.min(schema.minimum);
+  }
+  if (schema.maximum !== undefined) {
+    zodSchema = zodSchema.max(schema.maximum);
+  }
+  return zodSchema;
+}
+function buildArraySchema(schema) {
+  const itemsSchema = schema.items ? jsonSchemaToZod(schema.items) : z2.unknown();
+  let zodSchema = z2.array(itemsSchema);
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  return zodSchema;
+}
+function buildObjectSchema(schema) {
+  const properties = schema.properties ?? {};
+  const required = new Set(schema.required ?? []);
+  const shape = {};
+  for (const [key, propSchema] of Object.entries(properties)) {
+    const zodProp = jsonSchemaToZod(propSchema);
+    shape[key] = required.has(key) ? zodProp : zodProp.optional();
+  }
+  let zodSchema = z2.object(shape);
+  if (schema.description) {
+    zodSchema = zodSchema.describe(schema.description);
+  }
+  return zodSchema;
+}
+function jsonSchemaToZodSafe(schema) {
+  if (!schema || Object.keys(schema).length === 0) {
+    return z2.object({});
   }
-  if (blocks.length === 0)
-    return instructions;
-  return `${instructions}
-
----
-
-# ${i18n.t("knowledge.header")}
-
-${i18n.t("knowledge.description")}
-
-${blocks.join(`
-
----
-
-`)}`;
+  return jsonSchemaToZod(schema);
 }
-function createKnowledgeInjector(retriever, locale) {
+var init_json_schema_to_zod = () => {};
+
+// src/tools/operation-tool-handler.ts
+function toolCtxToHandlerCtx(ctx) {
   return {
-    inject: (instructions, knowledgeRefs) => injectStaticKnowledge(instructions, knowledgeRefs, retriever, locale),
-    hasSpace: (spaceKey) => retriever?.supportsSpace(spaceKey) ?? false,
-    listSpaces: () => retriever?.listSpaces() ?? []
+    traceId: ctx.metadata?.traceId,
+    organizationId: ctx.tenantId ?? null,
+    userId: ctx.actorId ?? null,
+    actor: ctx.actorId ? "user" : "anonymous",
+    channel: "agent",
+    roles: []
+  };
+}
+function createOperationToolHandler(registry, operationRef) {
+  return async (input, context) => {
+    const handlerCtx = toolCtxToHandlerCtx(context);
+    const result = await registry.execute(operationRef.key, operationRef.version, input ?? {}, handlerCtx);
+    return result;
   };
 }
-var init_injector = __esm(() => {
-  init_i18n();
-});
 
-// src/session/store.ts
-class InMemorySessionStore {
-  sessions = new Map;
-  maxSessions;
-  maxMessagesPerSession;
-  maxStepsPerSession;
-  constructor(options = {}) {
-    this.maxSessions = options.maxSessions ?? 500;
-    this.maxMessagesPerSession = options.maxMessagesPerSession ?? 200;
-    this.maxStepsPerSession = options.maxStepsPerSession ?? 200;
-  }
-  async get(sessionId) {
-    return this.sessions.get(sessionId) ?? null;
-  }
-  async create(session) {
-    this.evictIfNeeded();
-    const now = new Date;
-    const fullSession = {
-      ...session,
-      createdAt: now,
-      updatedAt: now
-    };
-    this.sessions.set(session.sessionId, fullSession);
-    return fullSession;
+// src/tools/subagent-tool.ts
+import { readUIMessageStream, tool as tool2 } from "ai";
+import { z as z3 } from "zod";
+function toReadableStream(iterable) {
+  if (iterable instanceof ReadableStream) {
+    return iterable;
   }
-  async appendStep(sessionId, step) {
-    const session = this.sessions.get(sessionId);
-    if (session) {
-      session.steps.push(step);
-      this.trimArray(session.steps, this.maxStepsPerSession);
-      session.updatedAt = new Date;
+  return new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const chunk of iterable) {
+          controller.enqueue(chunk);
+        }
+      } finally {
+        controller.close();
+      }
     }
-  }
-  async appendMessage(sessionId, message) {
-    const session = this.sessions.get(sessionId);
-    if (session) {
-      session.messages.push(message);
-      this.trimArray(session.messages, this.maxMessagesPerSession);
-      session.updatedAt = new Date;
+  });
+}
+function createSubagentTool(options) {
+  const {
+    subagent,
+    description = "Research a topic or question in depth.",
+    taskParam = "task",
+    toModelSummary = true,
+    passConversationHistory = false
+  } = options;
+  const inputSchema = z3.object({
+    [taskParam]: z3.string().describe("The research task to complete")
+  });
+  const execute = async function* (input, options2) {
+    const task = String(input[taskParam] ?? input.task ?? "");
+    const { abortSignal, messages } = options2 ?? {};
+    if (passConversationHistory && messages && messages.length > 0 && typeof subagent.generate === "function") {
+      const result2 = await subagent.generate({
+        messages: [...messages, { role: "user", content: task }],
+        abortSignal
+      });
+      yield { parts: [{ type: "text", text: result2.text }] };
+      return;
     }
-  }
-  async update(sessionId, updates) {
-    const session = this.sessions.get(sessionId);
-    if (session) {
-      Object.assign(session, updates, { updatedAt: new Date });
+    const result = await subagent.stream({
+      prompt: task,
+      abortSignal
+    });
+    const uiStream = result.toUIMessageStream();
+    const stream = toReadableStream(uiStream);
+    for await (const message of readUIMessageStream({
+      stream
+    })) {
+      yield message;
     }
-  }
-  async delete(sessionId) {
-    return this.sessions.delete(sessionId);
-  }
-  async listByAgent(agentId, limit = 100) {
-    const results = [];
-    for (const session of this.sessions.values()) {
-      if (session.agentId === agentId) {
-        results.push(session);
-        if (results.length >= limit)
-          break;
+  };
+  const toolOptions = {
+    description,
+    inputSchema,
+    execute,
+    ...toModelSummary && {
+      toModelOutput: ({
+        output
+      }) => {
+        const parts = output?.parts;
+        if (!Array.isArray(parts)) {
+          return { type: "text", value: "Task completed." };
+        }
+        const lastTextPart = [...parts].reverse().find((p) => p?.type === "text");
+        return {
+          type: "text",
+          value: lastTextPart?.text ?? "Task completed."
+        };
       }
     }
-    return results.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
-  }
-  async listByTenant(tenantId, limit = 100) {
-    const results = [];
-    for (const session of this.sessions.values()) {
-      if (session.tenantId === tenantId) {
-        results.push(session);
-        if (results.length >= limit)
-          break;
+  };
+  return tool2(toolOptions);
+}
+var init_subagent_tool = () => {};
+
+// src/tools/tool-adapter.ts
+import { tool as tool3 } from "ai";
+function isAsyncGenerator(value) {
+  return typeof value === "object" && value !== null && typeof value.next === "function" && typeof value[Symbol.asyncIterator] === "function";
+}
+function specToolToAISDKTool(specTool, handler, context = {}, effectiveInputSchema, operationSpec) {
+  let lastInvocationAt;
+  const inputSchema = effectiveInputSchema ?? jsonSchemaToZodSafe(specTool.schema);
+  const buildContext = (signal) => ({
+    agentId: context.agentId ?? "unknown",
+    sessionId: context.sessionId ?? "unknown",
+    tenantId: context.tenantId,
+    actorId: context.actorId,
+    locale: context.locale,
+    metadata: context.metadata,
+    signal
+  });
+  return tool3({
+    description: specTool.description ?? specTool.name,
+    inputSchema,
+    needsApproval: specTool.requiresApproval ?? !specTool.automationSafe,
+    execute: async function* (input, options) {
+      const now = Date.now();
+      const cooldownMs = normalizeDuration(specTool.cooldownMs);
+      if (cooldownMs && lastInvocationAt !== undefined) {
+        const elapsed = now - lastInvocationAt;
+        if (elapsed < cooldownMs) {
+          const retryAfterMs = cooldownMs - elapsed;
+          throw createToolExecutionError(`Tool "${specTool.name}" is cooling down. Retry in ${retryAfterMs}ms.`, "TOOL_COOLDOWN_ACTIVE", retryAfterMs);
+        }
       }
-    }
-    return results.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
-  }
-  clear() {
-    this.sessions.clear();
-  }
-  evictIfNeeded() {
-    if (this.sessions.size < this.maxSessions) {
-      return;
-    }
-    let oldestSessionId = null;
-    let oldestUpdatedAt = Number.POSITIVE_INFINITY;
-    for (const [sessionId, session] of this.sessions.entries()) {
-      const updatedAt = session.updatedAt.getTime();
-      if (updatedAt < oldestUpdatedAt) {
-        oldestUpdatedAt = updatedAt;
-        oldestSessionId = sessionId;
+      const timeoutMs = normalizeDuration(specTool.timeoutMs);
+      const signal = options?.abortSignal ?? context.signal;
+      const { signal: timeoutSignal, dispose } = createTimeoutSignal(signal, timeoutMs);
+      try {
+        const execution = handler(input, buildContext(timeoutSignal));
+        if (isAsyncGenerator(execution)) {
+          for await (const raw of execution) {
+            const wrapped = wrapToolOutputForRendering(specTool, raw, operationSpec);
+            yield typeof wrapped === "string" ? wrapped : wrapped;
+          }
+        } else {
+          const raw = timeoutMs ? await withTimeout(Promise.resolve(execution), timeoutMs, specTool.name) : await Promise.resolve(execution);
+          const wrapped = wrapToolOutputForRendering(specTool, raw, operationSpec);
+          yield typeof wrapped === "string" ? wrapped : wrapped;
+        }
+      } finally {
+        dispose();
+        lastInvocationAt = Date.now();
       }
     }
-    if (oldestSessionId) {
-      this.sessions.delete(oldestSessionId);
+  });
+}
+function specToolsToAISDKTools(specTools, handlers, context = {}, options) {
+  const tools = {};
+  for (const specTool of specTools) {
+    if (specTool.subagentRef && options?.subagentRegistry) {
+      const subagent = options.subagentRegistry.get(specTool.subagentRef.agentId);
+      if (!subagent) {
+        throw new Error(`Subagent not found: ${specTool.subagentRef.agentId}. Register it in subagentRegistry.`);
+      }
+      if (specTool.requiresApproval === true || specTool.automationSafe === false) {
+        console.warn(`[ContractSpec] Subagent tool "${specTool.name}" cannot use needsApproval. ` + `requiresApproval and automationSafe are ignored for subagent tools (AI SDK limitation). ` + `See https://ai-sdk.dev/docs/agents/subagents#no-tool-approvals-in-subagents`);
+      }
+      tools[specTool.name] = createSubagentTool({
+        subagent,
+        description: specTool.description ?? specTool.name,
+        toModelSummary: specTool.subagentRef.toModelSummary ?? true,
+        passConversationHistory: specTool.subagentRef.passConversationHistory
+      });
+      continue;
     }
-  }
-  trimArray(items, maxItems) {
-    if (items.length <= maxItems) {
-      return;
+    let handler;
+    let effectiveInputSchema;
+    let op;
+    if (specTool.operationRef && options?.operationRegistry) {
+      op = options.operationRegistry.get(specTool.operationRef.key, specTool.operationRef.version);
+      if (!op) {
+        throw new Error(`Operation not found: ${specTool.operationRef.key}${specTool.operationRef.version ? `.v${specTool.operationRef.version}` : ""}`);
+      }
+      handler = createOperationToolHandler(options.operationRegistry, specTool.operationRef);
+      effectiveInputSchema = op.io.input?.getZod?.();
+    } else {
+      const manualHandler = handlers.get(specTool.name);
+      if (!manualHandler) {
+        if (specTool.subagentRef) {
+          throw new Error(`Subagent tool "${specTool.name}" requires subagentRegistry. Pass subagentRegistry in ContractSpecAgentConfig.`);
+        }
+        throw new Error(createAgentI18n(context.locale).t("error.missingToolHandler", {
+          name: specTool.name
+        }));
+      }
+      handler = manualHandler;
     }
-    const overflow = items.length - maxItems;
-    items.splice(0, overflow);
+    tools[specTool.name] = specToolToAISDKTool(specTool, handler, context, effectiveInputSchema, op);
   }
+  return tools;
 }
-function createInMemorySessionStore(options) {
-  return new InMemorySessionStore(options);
+function createToolHandler(handler) {
+  return (input, context) => {
+    return handler(input, context);
+  };
 }
-function generateSessionId() {
-  return `sess_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+function buildToolHandlers(handlersObj) {
+  return new Map(Object.entries(handlersObj));
 }
-
-// src/telemetry/adapter.ts
-function parseAgentId(agentId) {
-  const match = agentId.match(/^(.+)\.v(\d+)$/);
-  if (match) {
-    return { name: match[1], version: match[2] };
+function wrapToolOutputForRendering(specTool, result, operationSpec) {
+  const presentation = specTool.outputPresentation ?? operationSpec?.outputPresentation;
+  const form = specTool.outputForm ?? operationSpec?.outputForm;
+  const dataView = specTool.outputDataView ?? operationSpec?.outputDataView;
+  if (presentation) {
+    return {
+      presentationKey: presentation.key,
+      data: result
+    };
   }
-  return { name: agentId, version: "1.0.0" };
-}
-function getRecord(value) {
-  return value && typeof value === "object" ? value : undefined;
-}
-function getStepResponse(step) {
-  const response = getRecord(step.response);
-  if (!response)
-    return;
-  return {
-    id: response["id"],
-    modelId: response["modelId"],
-    timestamp: response["timestamp"],
-    headers: response["headers"],
-    body: response["body"],
-    messages: response["messages"]
-  };
-}
-function getRequestBodyValue(request, key) {
-  const body = request?.["body"];
-  if (!body)
-    return;
-  if (typeof body === "string") {
-    try {
-      const parsed = JSON.parse(body);
-      return typeof parsed[key] === "string" ? parsed[key] : undefined;
-    } catch {
-      return;
-    }
+  if (form) {
+    return {
+      formKey: form.key,
+      defaultValues: typeof result === "object" && result !== null ? result : {}
+    };
   }
-  const record = getRecord(body);
-  return typeof record?.[key] === "string" ? record[key] : undefined;
-}
-async function trackAgentStep(collector, agentId, step, durationMs, context) {
-  const { name, version } = parseAgentId(agentId);
-  const response = getStepResponse(step);
-  const providerMetadata = step.providerMetadata;
-  const warnings = step.warnings;
-  const rawFinishReason = step.rawFinishReason;
-  const request = getRecord(step.request);
-  const traceId = context?.traceId ?? getRequestBodyValue(request, "$ai_trace_id");
-  const sessionId = context?.sessionId ?? getRequestBodyValue(request, "$ai_session_id");
-  const parentSpanId = response?.id;
-  for (const toolCall of step.toolCalls ?? []) {
-    const toolResult = step.toolResults?.find((r) => r.toolCallId === toolCall.toolCallId);
-    const toolError = getRecord(toolResult?.output)?.["error"];
-    const toolSample = {
-      operation: { name: `${name}.${toolCall.toolName}`, version },
-      durationMs: durationMs ?? 0,
-      success: step.toolResults?.some((r) => r.toolCallId === toolCall.toolCallId && r.output !== undefined) ?? false,
-      timestamp: new Date,
-      metadata: {
-        telemetryEvent: "span",
-        traceId,
-        sessionId,
-        spanId: toolCall.toolCallId,
-        parentSpanId,
-        spanName: `tool.${toolCall.toolName}`,
-        agentId,
-        actorId: context?.actorId,
-        tenantId: context?.tenantId,
-        stepIndex: context?.stepIndex,
-        toolName: toolCall.toolName,
-        toolCallArgs: toolCall.input,
-        toolResultOutput: toolResult?.output,
-        errorMessage: typeof toolError === "string" ? toolError : typeof toolResult?.output === "string" ? toolResult.output : undefined,
-        finishReason: step.finishReason,
-        rawFinishReason
-      }
+  if (dataView) {
+    return {
+      dataViewKey: dataView.key,
+      items: Array.isArray(result) ? result : result != null ? [result] : []
     };
-    await collector.collect(toolSample);
   }
-  const stepSample = {
-    operation: { name, version },
-    durationMs: durationMs ?? 0,
-    success: step.finishReason !== "error",
-    timestamp: new Date,
-    metadata: {
-      telemetryEvent: "generation",
-      traceId,
-      sessionId,
-      spanId: response?.id,
-      spanName: `agent.${name}.step`,
-      agentId,
-      actorId: context?.actorId,
-      tenantId: context?.tenantId,
-      stepIndex: context?.stepIndex,
-      stepStartedAt: context?.stepStartedAt,
-      finishReason: step.finishReason,
-      rawFinishReason,
-      tokenUsage: step.usage,
-      totalUsage: step.totalUsage,
-      providerMetadata,
-      warnings,
-      stepText: step.text,
-      stepReasoningText: step.reasoningText,
-      responseId: response?.id,
-      responseModelId: response?.modelId,
-      responseTimestamp: response?.timestamp,
-      responseHeaders: response?.headers,
-      responseBody: response?.body,
-      responseMessages: response?.messages,
-      requestBody: request?.["body"],
-      requestHeaders: request?.["headers"],
-      toolCallCount: step.toolCalls?.length ?? 0,
-      toolCalls: step.toolCalls,
-      toolResults: step.toolResults,
-      errorMessage: step.finishReason === "error" ? step.text : undefined
-    }
-  };
-  await collector.collect(stepSample);
+  return result;
 }
-
-class InMemoryTelemetryCollector {
-  samples = [];
-  async collect(sample) {
-    this.samples.push(sample);
-  }
-  getSamples() {
-    return [...this.samples];
+function normalizeDuration(value) {
+  if (value === undefined) {
+    return;
   }
-  getSamplesForOperation(operationName) {
-    return this.samples.filter((s) => s.operation.name === operationName);
+  if (!Number.isFinite(value)) {
+    return;
   }
-  clear() {
-    this.samples.length = 0;
+  if (value <= 0) {
+    return;
   }
+  return Math.round(value);
 }
-function createInMemoryTelemetryCollector() {
-  return new InMemoryTelemetryCollector;
+function withTimeout(execution, timeoutMs, toolName) {
+  return new Promise((resolve, reject) => {
+    const timeoutHandle = setTimeout(() => {
+      reject(createToolExecutionError(`Tool "${toolName}" timed out after ${timeoutMs}ms.`, "TOOL_EXECUTION_TIMEOUT"));
+    }, timeoutMs);
+    execution.then((result) => {
+      clearTimeout(timeoutHandle);
+      resolve(result);
+    }).catch((error) => {
+      clearTimeout(timeoutHandle);
+      reject(error);
+    });
+  });
 }
-var noopTelemetryCollector;
-var init_adapter = __esm(() => {
-  noopTelemetryCollector = {
-    collect: async () => {}
+function createTimeoutSignal(signal, timeoutMs) {
+  const controller = new AbortController;
+  const abortFromSource = () => controller.abort();
+  if (signal) {
+    if (signal.aborted) {
+      controller.abort();
+    } else {
+      signal.addEventListener("abort", abortFromSource);
+    }
+  }
+  const timeoutHandle = timeoutMs !== undefined ? setTimeout(() => {
+    controller.abort();
+  }, timeoutMs) : undefined;
+  return {
+    signal: controller.signal,
+    dispose: () => {
+      if (timeoutHandle !== undefined) {
+        clearTimeout(timeoutHandle);
+      }
+      if (signal) {
+        signal.removeEventListener("abort", abortFromSource);
+      }
+    }
   };
+}
+function createToolExecutionError(message, code, retryAfterMs) {
+  return Object.assign(new Error(message), {
+    code,
+    kind: "retryable",
+    retryAfterMs
+  });
+}
+var init_tool_adapter = __esm(() => {
+  init_i18n();
+  init_json_schema_to_zod();
+  init_subagent_tool();
 });
 
 // src/telemetry/posthog.ts
@@ -3282,7 +3307,7 @@ function createCompositeTelemetryCollector(collectors) {
 }
 async function importPostHogAI() {
   try {
-    return await import("@posthog/ai");
+    return await runtimeImport("@posthog/ai");
   } catch {
     throw new Error(createAgentI18n().t("error.telemetry.posthogAiRequired"));
   }
@@ -3294,7 +3319,7 @@ async function resolvePostHogClient(config) {
     throw new Error(createAgentI18n().t("error.telemetry.posthogClientOrKeyRequired"));
   }
   try {
-    const { PostHog } = await import("posthog-node");
+    const { PostHog } = await runtimeImport("posthog-node");
     return new PostHog(config.apiKey, {
       host: config.host ?? "https://us.i.posthog.com"
     });
@@ -3341,8 +3366,10 @@ function asDateIso(value) {
     return value.toISOString();
   return;
 }
+var runtimeImport;
 var init_posthog = __esm(() => {
   init_i18n();
+  runtimeImport = new Function("specifier", "return import(specifier)");
 });
 
 // src/agent/contract-spec-agent.ts
@@ -3350,11 +3377,11 @@ var exports_contract_spec_agent = {};
 __export(exports_contract_spec_agent, {
   ContractSpecAgent: () => ContractSpecAgent
 });
+import { randomUUID } from "node:crypto";
 import {
-  Experimental_Agent as ToolLoopAgent,
-  stepCountIs
+  stepCountIs,
+  Experimental_Agent as ToolLoopAgent
 } from "ai";
-import { randomUUID } from "node:crypto";
 import * as z4 from "zod";
 
 class ContractSpecAgent {
@@ -3706,13 +3733,13 @@ function resolveEscalationError(spec, finishReason) {
 }
 var ContractSpecCallOptionsSchema;
 var init_contract_spec_agent = __esm(() => {
+  init_injector();
   init_spec();
-  init_tool_adapter();
+  init_adapter();
   init_knowledge_tool();
-  init_memory_tools();
   init_mcp_client();
-  init_injector();
-  init_adapter();
+  init_memory_tools();
+  init_tool_adapter();
   ContractSpecCallOptionsSchema = z4.object({
     tenantId: z4.string().optional(),
     actorId: z4.string().optional(),