@contractspec/lib.ai-agent 1.60.0 → 1.62.0

package/dist/node/agent/index.js

@@ -12,24 +12,2119 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts/translations";
+var enMessages;
+var init_en = __esm(() => {
+  enMessages = defineTranslation({
+    meta: {
+      key: "ai-agent.messages",
+      version: "1.0.0",
+      domain: "ai-agent",
+      description: "All user-facing, LLM-facing, and developer-facing strings for the ai-agent package",
+      owners: ["platform"],
+      stability: "experimental"
+    },
+    locale: "en",
+    fallback: "en",
+    messages: {
+      "agent.json.rules.validJsonOnly": {
+        value: "You MUST output valid JSON ONLY.",
+        description: "JSON runner rule: output must be valid JSON"
+      },
+      "agent.json.rules.noMarkdownFences": {
+        value: "Do not wrap the output in markdown fences.",
+        description: "JSON runner rule: no markdown code fences"
+      },
+      "agent.json.rules.noCommentary": {
+        value: "Do not include commentary or explanation.",
+        description: "JSON runner rule: no extra text"
+      },
+      "agent.json.rules.doubleQuotes": {
+        value: "Use double quotes for all keys and string values.",
+        description: "JSON runner rule: double quotes only"
+      },
+      "agent.json.rules.noTrailingCommas": {
+        value: "Do not include trailing commas.",
+        description: "JSON runner rule: no trailing commas"
+      },
+      "agent.json.defaultDescription": {
+        value: "JSON-only agent runner for deterministic pipelines.",
+        description: "Default description for the JSON runner spec"
+      },
+      "agent.json.systemPrompt": {
+        value: "You are a precise JSON generator.",
+        description: "Default system prompt for the JSON runner"
+      },
+      "knowledge.header": {
+        value: "# Reference Knowledge",
+        description: "Header for injected knowledge section in system prompt"
+      },
+      "knowledge.description": {
+        value: "The following information is provided for your reference. Use it to inform your responses.",
+        description: "Description below the knowledge header"
+      },
+      "tool.knowledge.description": {
+        value: "Query knowledge bases for relevant information. Use this tool when you need to look up specific information that may not be in your context.",
+        description: "Description for the knowledge query tool shown to the LLM"
+      },
+      "tool.knowledge.availableSpaces": {
+        value: "Available knowledge spaces:",
+        description: "Label before listing available knowledge spaces"
+      },
+      "tool.knowledge.spaceDefault": {
+        value: "Knowledge space",
+        description: "Fallback description for unnamed knowledge spaces"
+      },
+      "tool.knowledge.param.query": {
+        value: "The question or search query to find relevant information",
+        description: "Parameter description for the query field"
+      },
+      "tool.knowledge.param.spaceKey": {
+        value: "Specific knowledge space to query. If omitted, searches all available spaces.",
+        description: "Parameter description for the spaceKey field"
+      },
+      "tool.knowledge.param.topK": {
+        value: "Maximum number of results to return",
+        description: "Parameter description for the topK field"
+      },
+      "tool.knowledge.noResults": {
+        value: "No relevant information found in the knowledge bases.",
+        description: "Message when no knowledge results are found"
+      },
+      "tool.knowledge.sourceLabel": {
+        value: "[Source {index} - {space}] (relevance: {score}%)",
+        description: "Label for each knowledge search result",
+        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" }
+        ]
+      },
+      "tool.fallbackDescription": {
+        value: "Execute {name}",
+        description: "Fallback description when a tool has no explicit description",
+        placeholders: [
+          { name: "name", type: "string", description: "Tool name" }
+        ]
+      },
+      "tool.mcp.param.message": {
+        value: "The message or query to send to the agent",
+        description: "MCP server: message parameter description"
+      },
+      "tool.mcp.param.sessionId": {
+        value: "Optional session ID to continue a conversation",
+        description: "MCP server: sessionId parameter description"
+      },
+      "tool.mcp.agentDescription": {
+        value: "Interact with {key} agent",
+        description: "MCP server: agent tool description",
+        placeholders: [
+          { name: "key", type: "string", description: "Agent spec key" }
+        ]
+      },
+      "tool.mcp.executePrompt": {
+        value: "Execute the {name} tool with the following arguments: {args}",
+        description: "MCP server: prompt sent when executing an individual tool",
+        placeholders: [
+          { name: "name", type: "string", description: "Tool name" },
+          {
+            name: "args",
+            type: "string",
+            description: "JSON-stringified arguments"
+          }
+        ]
+      },
+      "tool.mcp.toolDescription": {
+        value: "Execute {name} tool",
+        description: "MCP server: individual tool description",
+        placeholders: [
+          { name: "name", type: "string", description: "Tool name" }
+        ]
+      },
+      "interop.prompt.agentIdentity": {
+        value: "# Agent Identity",
+        description: "Section header for agent identity in LLM prompt"
+      },
+      "interop.prompt.youAre": {
+        value: "You are {key} (v{version}).",
+        description: "Agent identity statement in LLM prompt",
+        placeholders: [
+          { name: "key", type: "string" },
+          { name: "version", type: "string" }
+        ]
+      },
+      "interop.prompt.description": {
+        value: "## Description",
+        description: "Section header for description"
+      },
+      "interop.prompt.instructions": {
+        value: "## Instructions",
+        description: "Section header for instructions"
+      },
+      "interop.prompt.availableTools": {
+        value: "## Available Tools",
+        description: "Section header for available tools"
+      },
+      "interop.prompt.toolsIntro": {
+        value: "You have access to the following tools:",
+        description: "Introduction before listing tools"
+      },
+      "interop.prompt.parameters": {
+        value: "Parameters:",
+        description: "Label before tool parameters block"
+      },
+      "interop.prompt.knowledgeContext": {
+        value: "## Knowledge Context",
+        description: "Section header for knowledge context"
+      },
+      "interop.prompt.additionalContext": {
+        value: "## Additional Context",
+        description: "Section header for additional context"
+      },
+      "interop.md.toc": {
+        value: "## Table of Contents",
+        description: "TOC header"
+      },
+      "interop.md.overview": {
+        value: "## Overview",
+        description: "Overview header"
+      },
+      "interop.md.tools": { value: "## Tools", description: "Tools header" },
+      "interop.md.knowledge": {
+        value: "## Knowledge",
+        description: "Knowledge header"
+      },
+      "interop.md.policy": { value: "## Policy", description: "Policy header" },
+      "interop.md.metaKey": {
+        value: "- **Key**: `{key}`",
+        description: "Metadata line for key",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "interop.md.metaVersion": {
+        value: "- **Version**: {version}",
+        description: "Metadata line for version",
+        placeholders: [{ name: "version", type: "string" }]
+      },
+      "interop.md.metaStability": {
+        value: "- **Stability**: {stability}",
+        description: "Metadata line for stability",
+        placeholders: [{ name: "stability", type: "string" }]
+      },
+      "interop.md.metaOwners": {
+        value: "- **Owners**: {owners}",
+        description: "Metadata line for owners",
+        placeholders: [{ name: "owners", type: "string" }]
+      },
+      "interop.md.metaTags": {
+        value: "- **Tags**: {tags}",
+        description: "Metadata line for tags",
+        placeholders: [{ name: "tags", type: "string" }]
+      },
+      "interop.md.schema": { value: "**Schema:**", description: "Schema label" },
+      "interop.md.automationSafe": {
+        value: "**Automation Safe**: {value}",
+        description: "Automation safe field",
+        placeholders: [{ name: "value", type: "string" }]
+      },
+      "interop.md.required": {
+        value: "(required)",
+        description: "Required marker"
+      },
+      "interop.md.optional": {
+        value: "(optional)",
+        description: "Optional marker"
+      },
+      "interop.md.minConfidence": {
+        value: "- **Minimum Confidence**: {min}",
+        description: "Minimum confidence policy line",
+        placeholders: [{ name: "min", type: "number" }]
+      },
+      "interop.md.escalationThreshold": {
+        value: "- **Escalation Threshold**: {threshold}",
+        description: "Escalation threshold policy line",
+        placeholders: [{ name: "threshold", type: "number" }]
+      },
+      "interop.md.escalateToolFailure": {
+        value: "- **Escalate on Tool Failure**: Yes",
+        description: "Escalate on tool failure policy line"
+      },
+      "interop.md.escalateTimeout": {
+        value: "- **Escalate on Timeout**: Yes",
+        description: "Escalate on timeout policy line"
+      },
+      "interop.md.yes": { value: "Yes", description: "Yes label" },
+      "interop.md.no": { value: "No", description: "No label" },
+      "error.jsonRunner.requiresModel": {
+        value: "createAgentJsonRunner requires a model or provider config",
+        description: "Error when JSON runner has no model or provider"
+      },
+      "error.missingToolHandler": {
+        value: "Missing handler for tool: {name}",
+        description: "Error when a tool handler is not registered",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.unknownBackend": {
+        value: "Unknown backend: {backend}",
+        description: "Error when an unknown backend is specified",
+        placeholders: [{ name: "backend", type: "string" }]
+      },
+      "error.claudeSdk.notAvailable": {
+        value: "Claude Agent SDK not available. Install @anthropic-ai/claude-agent-sdk",
+        description: "Error when Claude Agent SDK is not available"
+      },
+      "error.claudeSdk.notInstalled": {
+        value: "Claude Agent SDK not installed. Run: npm install @anthropic-ai/claude-agent-sdk",
+        description: "Error when Claude Agent SDK module is not found"
+      },
+      "error.opencodeSdk.notAvailable": {
+        value: "OpenCode SDK not available. Install @opencode-ai/sdk",
+        description: "Error when OpenCode SDK is not available"
+      },
+      "error.opencodeSdk.notInstalled": {
+        value: "OpenCode SDK not installed. Run: npm install @opencode-ai/sdk",
+        description: "Error when OpenCode SDK module is not found"
+      },
+      "error.providerNotInitialized": {
+        value: "Provider not initialized",
+        description: "Error when provider has not been initialized before use"
+      },
+      "error.agentKeyRequired": {
+        value: "Agent key is required",
+        description: "Validation error: missing agent key"
+      },
+      "error.agentMissingVersion": {
+        value: "Agent {key} is missing a string version",
+        description: "Validation error: version not a string",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "error.agentRequiresInstructions": {
+        value: "Agent {key} requires instructions",
+        description: "Validation error: missing instructions",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "error.agentRequiresTool": {
+        value: "Agent {key} must expose at least one tool",
+        description: "Validation error: no tools defined",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "error.agentDuplicateTool": {
+        value: "Agent {key} has duplicate tool name: {name}",
+        description: "Validation error: duplicate tool name",
+        placeholders: [
+          { name: "key", type: "string" },
+          { name: "name", type: "string" }
+        ]
+      },
+      "error.agentSpecNotFound": {
+        value: "Agent spec not found for {name}",
+        description: "Error when agent spec is not in the registry",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.specNotFound": {
+        value: "Spec not found: {specKey}",
+        description: "Error when a spec key is not found",
+        placeholders: [{ name: "specKey", type: "string" }]
+      },
+      "error.toolNotFound": {
+        value: "Tool not found: {name}",
+        description: "Error when a tool is not found",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.noHandlerForTool": {
+        value: "No handler registered for tool: {name}",
+        description: "Error when no handler is registered for a tool",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.noToolHandler": {
+        value: "No handler for tool: {name}",
+        description: "Short error when no handler exists",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.unknownExportFormat": {
+        value: "Unknown export format: {format}",
+        description: "Error for unsupported export format",
+        placeholders: [{ name: "format", type: "string" }]
+      },
+      "error.handlerNotFoundForTool": {
+        value: "Handler not found for tool {name}",
+        description: "Error in tool bridge when handler is missing",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.toolNotFoundOrNoHandler": {
+        value: "Error: Tool '{name}' not found or has no handler",
+        description: "Error returned to LLM when tool execution fails",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.toolNoExecuteHandler": {
+        value: "Tool {name} has no execute handler",
+        description: "Error when tool lacks an execute function",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.provider.notRegistered": {
+        value: "not registered",
+        description: "Provider availability reason: not registered"
+      },
+      "error.provider.depsNotInstalled": {
+        value: "dependencies not installed or not configured",
+        description: "Provider availability reason: deps missing"
+      },
+      "error.provider.sdkNotConfigured": {
+        value: "SDK not installed or API key not configured",
+        description: "Provider availability reason: SDK or key missing"
+      },
+      "error.provider.claudeSdkMissing": {
+        value: "@anthropic-ai/claude-agent-sdk is not installed",
+        description: "Error when Claude Agent SDK require.resolve fails"
+      },
+      "error.provider.opencodeSdkMissing": {
+        value: "@opencode-ai/sdk is not installed",
+        description: "Error when OpenCode SDK require.resolve fails"
+      },
+      "error.provider.sdkNotInstalled": {
+        value: "SDK not installed",
+        description: "Generic provider error: SDK not installed"
+      },
+      "error.provider.contextCreation": {
+        value: "Failed to create context: {error}",
+        description: "Error during provider context creation",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "error.provider.executionFailed": {
+        value: "Execution failed: {error}",
+        description: "Error during provider execution",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "error.provider.streamFailed": {
+        value: "Stream failed: {error}",
+        description: "Error during provider streaming",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "export.agentConfiguration": {
+        value: "# Agent Configuration",
+        description: "Markdown heading"
+      },
+      "export.metadata": {
+        value: "## Metadata",
+        description: "Markdown heading"
+      },
+      "export.metaName": {
+        value: "- **Name**: {name}",
+        description: "Metadata line",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "export.metaVersion": {
+        value: "- **Version**: {version}",
+        description: "Metadata line",
+        placeholders: [{ name: "version", type: "string" }]
+      },
+      "export.metaOwners": {
+        value: "- **Owners**: {owners}",
+        description: "Metadata line",
+        placeholders: [{ name: "owners", type: "string" }]
+      },
+      "export.metaModel": {
+        value: "- **Model**: {model}",
+        description: "Metadata line",
+        placeholders: [{ name: "model", type: "string" }]
+      },
+      "export.instructions": {
+        value: "## Instructions",
+        description: "Markdown heading"
+      },
+      "export.availableTools": {
+        value: "## Available Tools",
+        description: "Markdown heading"
+      },
+      "export.tools": { value: "## Tools", description: "Markdown heading" },
+      "export.knowledgeSources": {
+        value: "## Knowledge Sources",
+        description: "Markdown heading"
+      },
+      "export.policy": { value: "## Policy", description: "Markdown heading" },
+      "export.additionalContext": {
+        value: "## Additional Context",
+        description: "Markdown heading"
+      },
+      "export.configuration": {
+        value: "## Configuration",
+        description: "Markdown heading"
+      },
+      "export.mcpServers": {
+        value: "## MCP Servers",
+        description: "Markdown heading"
+      },
+      "export.parameters": {
+        value: "**Parameters:**",
+        description: "Parameters label"
+      },
+      "export.requiresApproval": {
+        value: "requires approval",
+        description: "Tool flag"
+      },
+      "export.notAutomationSafe": {
+        value: "not automation safe",
+        description: "Tool flag"
+      },
+      "export.requiresApprovalMd": {
+        value: "*(requires approval)*",
+        description: "Markdown tool flag"
+      },
+      "export.notAutomationSafeMd": {
+        value: "*(not automation safe)*",
+        description: "Markdown tool flag"
+      },
+      "export.required": { value: "(required)", description: "Required marker" },
+      "export.optional": { value: "(optional)", description: "Optional marker" },
+      "export.minConfidence": {
+        value: "- Minimum confidence: {min}",
+        description: "Policy line",
+        placeholders: [{ name: "min", type: "number" }]
+      },
+      "export.escalationConfigured": {
+        value: "- Escalation policy is configured",
+        description: "Policy line for system prompt"
+      },
+      "export.escalationPolicyConfigured": {
+        value: "- Escalation policy configured",
+        description: "Policy line for markdown export"
+      },
+      "export.featureFlags": {
+        value: "- Feature flags: {flags}",
+        description: "Feature flags policy line",
+        placeholders: [{ name: "flags", type: "string" }]
+      },
+      "export.generatedFrom": {
+        value: "*Generated from ContractSpec: {key}*",
+        description: "Footer attribution line",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "export.exportedAt": {
+        value: "*Exported at: {date}*",
+        description: "Footer timestamp",
+        placeholders: [{ name: "date", type: "string" }]
+      },
+      "export.agentType": {
+        value: "> Agent type: **{type}**",
+        description: "Agent type callout",
+        placeholders: [{ name: "type", type: "string" }]
+      },
+      "export.noDescription": {
+        value: "No description",
+        description: "Fallback when tool has no description"
+      },
+      "export.validation.requiresKey": {
+        value: "Spec must have a meta.key",
+        description: "Validation error"
+      },
+      "export.validation.requiresInstructions": {
+        value: "Spec must have instructions",
+        description: "Validation error"
+      },
+      "export.validation.requiresTool": {
+        value: "Spec must have at least one tool",
+        description: "Validation error"
+      },
+      "export.validation.toolRequiresName": {
+        value: "All tools must have a name",
+        description: "Validation error"
+      },
+      "export.validation.toolRequiresDescOrName": {
+        value: "Tool must have a description or name",
+        description: "Validation error"
+      },
+      "export.validation.toolInvalidName": {
+        value: "Tool name '{name}' should be a valid identifier (letters, numbers, underscores)",
+        description: "Validation error for invalid tool name",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "export.agentType.build": {
+        value: "Primary agent with full tool access for code generation and modification.",
+        description: "Build agent type description"
+      },
+      "export.agentType.plan": {
+        value: "Restricted agent for analysis and planning. File edits and bash commands require approval.",
+        description: "Plan agent type description"
+      },
+      "export.agentType.general": {
+        value: "General-purpose subagent for complex questions and multi-step tasks.",
+        description: "General agent type description"
+      },
+      "export.agentType.explore": {
+        value: "Fast subagent optimized for codebase exploration and pattern searching.",
+        description: "Explore agent type description"
+      },
+      "export.bridge.requiresApproval": {
+        value: "(requires approval)",
+        description: "Tool permission label"
+      },
+      "export.bridge.askMode": {
+        value: "(ask mode)",
+        description: "Tool permission label"
+      },
+      "approval.toolRequiresApproval": {
+        value: 'Tool "{name}" requires approval',
+        description: "Default reason for tool approval requests",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "log.unifiedAgent.fallback": {
+        value: "[UnifiedAgent] {backend} failed, falling back to {fallback}",
+        description: "Warning when a backend fails and fallback is used",
+        placeholders: [
+          { name: "backend", type: "string" },
+          { name: "fallback", type: "string" }
+        ]
+      },
+      "log.knowledge.spaceNotAvailable": {
+        value: 'Required knowledge space "{key}" is not available',
+        description: "Warning when a required knowledge space is missing",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "log.knowledge.loadFailed": {
+        value: 'Failed to load required knowledge "{key}":',
+        description: "Warning when knowledge loading fails",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "log.knowledge.queryFailed": {
+        value: "Failed to query knowledge space {space}:",
+        description: "Warning when knowledge querying fails",
+        placeholders: [{ name: "space", type: "string" }]
+      },
+      "log.mcpServer.started": {
+        value: "[MCPToolServer] Started {name}@{version} with {count} tools",
+        description: "Log message when MCP tool server starts",
+        placeholders: [
+          { name: "name", type: "string" },
+          { name: "version", type: "string" },
+          { name: "count", type: "number" }
+        ]
+      },
+      "log.mcpServer.stopped": {
+        value: "[MCPToolServer] Stopped {name}",
+        description: "Log message when MCP tool server stops",
+        placeholders: [{ name: "name", type: "string" }]
+      }
+    }
+  });
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts/translations";
+var frMessages;
+var init_fr = __esm(() => {
+  frMessages = 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",
+      owners: ["platform"],
+      stability: "experimental"
+    },
+    locale: "fr",
+    fallback: "en",
+    messages: {
+      "agent.json.rules.validJsonOnly": {
+        value: "Vous DEVEZ produire uniquement du JSON valide.",
+        description: "JSON runner rule: output must be valid JSON"
+      },
+      "agent.json.rules.noMarkdownFences": {
+        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: "N'incluez ni commentaire ni explication.",
+        description: "JSON runner rule: no extra text"
+      },
+      "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"
+      },
+      "agent.json.rules.noTrailingCommas": {
+        value: "N'incluez pas de virgules finales.",
+        description: "JSON runner rule: no trailing commas"
+      },
+      "agent.json.defaultDescription": {
+        value: "Exécuteur d'agent JSON uniquement pour les pipelines déterministes.",
+        description: "Default description for the JSON runner spec"
+      },
+      "agent.json.systemPrompt": {
+        value: "Vous êtes un générateur JSON précis.",
+        description: "Default system prompt for the JSON runner"
+      },
+      "knowledge.header": {
+        value: "# Connaissances de référence",
+        description: "Header for injected knowledge section in system prompt"
+      },
+      "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"
+      },
+      "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"
+      },
+      "tool.knowledge.availableSpaces": {
+        value: "Espaces de connaissances disponibles :",
+        description: "Label before listing available knowledge spaces"
+      },
+      "tool.knowledge.spaceDefault": {
+        value: "Espace de connaissances",
+        description: "Fallback description for unnamed knowledge spaces"
+      },
+      "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"
+      },
+      "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"
+      },
+      "tool.knowledge.param.topK": {
+        value: "Nombre maximum de résultats à retourner",
+        description: "Parameter description for the topK field"
+      },
+      "tool.knowledge.noResults": {
+        value: "Aucune information pertinente trouvée dans les bases de connaissances.",
+        description: "Message when no knowledge results are found"
+      },
+      "tool.knowledge.sourceLabel": {
+        value: "[Source {index} - {space}] (pertinence : {score} %)",
+        description: "Label for each knowledge search result",
+        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" }
+        ]
+      },
+      "tool.fallbackDescription": {
+        value: "Exécuter {name}",
+        description: "Fallback description when a tool has no explicit description",
+        placeholders: [
+          { name: "name", type: "string", description: "Tool name" }
+        ]
+      },
+      "tool.mcp.param.message": {
+        value: "Le message ou la requête à envoyer à l'agent",
+        description: "MCP server: message parameter description"
+      },
+      "tool.mcp.param.sessionId": {
+        value: "Identifiant de session optionnel pour poursuivre une conversation",
+        description: "MCP server: sessionId parameter description"
+      },
+      "tool.mcp.agentDescription": {
+        value: "Interagir avec l'agent {key}",
+        description: "MCP server: agent tool description",
+        placeholders: [
+          { name: "key", type: "string", description: "Agent spec key" }
+        ]
+      },
+      "tool.mcp.executePrompt": {
+        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: "Tool name" },
+          {
+            name: "args",
+            type: "string",
+            description: "JSON-stringified arguments"
+          }
+        ]
+      },
+      "tool.mcp.toolDescription": {
+        value: "Exécuter l'outil {name}",
+        description: "MCP server: individual tool description",
+        placeholders: [
+          { name: "name", type: "string", description: "Tool name" }
+        ]
+      },
+      "interop.prompt.agentIdentity": {
+        value: "# Identité de l'agent",
+        description: "Section header for agent identity in LLM prompt"
+      },
+      "interop.prompt.youAre": {
+        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: "## Description",
+        description: "Section header for description"
+      },
+      "interop.prompt.instructions": {
+        value: "## Instructions",
+        description: "Section header for instructions"
+      },
+      "interop.prompt.availableTools": {
+        value: "## Outils disponibles",
+        description: "Section header for available tools"
+      },
+      "interop.prompt.toolsIntro": {
+        value: "Vous avez accès aux outils suivants :",
+        description: "Introduction before listing tools"
+      },
+      "interop.prompt.parameters": {
+        value: "Paramètres :",
+        description: "Label before tool parameters block"
+      },
+      "interop.prompt.knowledgeContext": {
+        value: "## Contexte de connaissances",
+        description: "Section header for knowledge context"
+      },
+      "interop.prompt.additionalContext": {
+        value: "## Contexte supplémentaire",
+        description: "Section header for additional context"
+      },
+      "interop.md.toc": {
+        value: "## Table des matières",
+        description: "TOC header"
+      },
+      "interop.md.overview": {
+        value: "## Aperçu",
+        description: "Overview header"
+      },
+      "interop.md.tools": { value: "## Outils", description: "Tools header" },
+      "interop.md.knowledge": {
+        value: "## Connaissances",
+        description: "Knowledge header"
+      },
+      "interop.md.policy": {
+        value: "## Politique",
+        description: "Policy header"
+      },
+      "interop.md.metaKey": {
+        value: "- **Clé** : `{key}`",
+        description: "Metadata line for key",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "interop.md.metaVersion": {
+        value: "- **Version** : {version}",
+        description: "Metadata line for version",
+        placeholders: [{ name: "version", type: "string" }]
+      },
+      "interop.md.metaStability": {
+        value: "- **Stabilité** : {stability}",
+        description: "Metadata line for stability",
+        placeholders: [{ name: "stability", type: "string" }]
+      },
+      "interop.md.metaOwners": {
+        value: "- **Propriétaires** : {owners}",
+        description: "Metadata line for owners",
+        placeholders: [{ name: "owners", type: "string" }]
+      },
+      "interop.md.metaTags": {
+        value: "- **Tags** : {tags}",
+        description: "Metadata line for tags",
+        placeholders: [{ name: "tags", type: "string" }]
+      },
+      "interop.md.schema": {
+        value: "**Schéma :**",
+        description: "Schema label"
+      },
+      "interop.md.automationSafe": {
+        value: "**Compatible avec l'automatisation** : {value}",
+        description: "Automation safe field",
+        placeholders: [{ name: "value", type: "string" }]
+      },
+      "interop.md.required": {
+        value: "(obligatoire)",
+        description: "Required marker"
+      },
+      "interop.md.optional": {
+        value: "(optionnel)",
+        description: "Optional marker"
+      },
+      "interop.md.minConfidence": {
+        value: "- **Confiance minimale** : {min}",
+        description: "Minimum confidence policy line",
+        placeholders: [{ name: "min", type: "number" }]
+      },
+      "interop.md.escalationThreshold": {
+        value: "- **Seuil d'escalade** : {threshold}",
+        description: "Escalation threshold policy line",
+        placeholders: [{ name: "threshold", type: "number" }]
+      },
+      "interop.md.escalateToolFailure": {
+        value: "- **Escalader en cas d'échec d'outil** : Oui",
+        description: "Escalate on tool failure policy line"
+      },
+      "interop.md.escalateTimeout": {
+        value: "- **Escalader en cas de délai d'attente dépassé** : Oui",
+        description: "Escalate on timeout policy line"
+      },
+      "interop.md.yes": { value: "Oui", description: "Yes label" },
+      "interop.md.no": { value: "Non", description: "No label" },
+      "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"
+      },
+      "error.missingToolHandler": {
+        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 inconnu : {backend}",
+        description: "Error when an unknown backend is specified",
+        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"
+      },
+      "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"
+      },
+      "error.opencodeSdk.notAvailable": {
+        value: "OpenCode SDK non disponible. Installez @opencode-ai/sdk",
+        description: "Error when OpenCode SDK is not available"
+      },
+      "error.opencodeSdk.notInstalled": {
+        value: "OpenCode SDK non installé. Exécutez : npm install @opencode-ai/sdk",
+        description: "Error when OpenCode SDK module is not found"
+      },
+      "error.providerNotInitialized": {
+        value: "Fournisseur non initialisé",
+        description: "Error when provider has not been initialized before use"
+      },
+      "error.agentKeyRequired": {
+        value: "La clé de l'agent est obligatoire",
+        description: "Validation error: missing agent key"
+      },
+      "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",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "error.agentRequiresInstructions": {
+        value: "L'agent {key} nécessite des instructions",
+        description: "Validation error: missing instructions",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "error.agentRequiresTool": {
+        value: "L'agent {key} doit exposer au moins un outil",
+        description: "Validation error: no tools defined",
+        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",
+        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",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.specNotFound": {
+        value: "Spécification introuvable : {specKey}",
+        description: "Error when a spec key is not found",
+        placeholders: [{ name: "specKey", type: "string" }]
+      },
+      "error.toolNotFound": {
+        value: "Outil introuvable : {name}",
+        description: "Error when a tool is not found",
+        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",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.noToolHandler": {
+        value: "Aucun gestionnaire pour l'outil : {name}",
+        description: "Short error when no handler exists",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.unknownExportFormat": {
+        value: "Format d'export inconnu : {format}",
+        description: "Error for unsupported export format",
+        placeholders: [{ name: "format", type: "string" }]
+      },
+      "error.handlerNotFoundForTool": {
+        value: "Gestionnaire introuvable pour l'outil {name}",
+        description: "Error in tool bridge when handler is missing",
+        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",
+        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",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.provider.notRegistered": {
+        value: "non enregistré",
+        description: "Provider availability reason: not registered"
+      },
+      "error.provider.depsNotInstalled": {
+        value: "dépendances non installées ou non configurées",
+        description: "Provider availability reason: deps missing"
+      },
+      "error.provider.sdkNotConfigured": {
+        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 n'est pas installé",
+        description: "Error when Claude Agent SDK require.resolve fails"
+      },
+      "error.provider.opencodeSdkMissing": {
+        value: "@opencode-ai/sdk n'est pas installé",
+        description: "Error when OpenCode SDK require.resolve fails"
+      },
+      "error.provider.sdkNotInstalled": {
+        value: "SDK non installé",
+        description: "Generic provider error: SDK not installed"
+      },
+      "error.provider.contextCreation": {
+        value: "Échec de la création du contexte : {error}",
+        description: "Error during provider context creation",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "error.provider.executionFailed": {
+        value: "Échec de l'exécution : {error}",
+        description: "Error during provider execution",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "error.provider.streamFailed": {
+        value: "Échec du flux : {error}",
+        description: "Error during provider streaming",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "export.agentConfiguration": {
+        value: "# Configuration de l'agent",
+        description: "Markdown heading"
+      },
+      "export.metadata": {
+        value: "## Métadonnées",
+        description: "Markdown heading"
+      },
+      "export.metaName": {
+        value: "- **Nom** : {name}",
+        description: "Metadata line",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "export.metaVersion": {
+        value: "- **Version** : {version}",
+        description: "Metadata line",
+        placeholders: [{ name: "version", type: "string" }]
+      },
+      "export.metaOwners": {
+        value: "- **Propriétaires** : {owners}",
+        description: "Metadata line",
+        placeholders: [{ name: "owners", type: "string" }]
+      },
+      "export.metaModel": {
+        value: "- **Modèle** : {model}",
+        description: "Metadata line",
+        placeholders: [{ name: "model", type: "string" }]
+      },
+      "export.instructions": {
+        value: "## Instructions",
+        description: "Markdown heading"
+      },
+      "export.availableTools": {
+        value: "## Outils disponibles",
+        description: "Markdown heading"
+      },
+      "export.tools": { value: "## Outils", description: "Markdown heading" },
+      "export.knowledgeSources": {
+        value: "## Sources de connaissances",
+        description: "Markdown heading"
+      },
+      "export.policy": {
+        value: "## Politique",
+        description: "Markdown heading"
+      },
+      "export.additionalContext": {
+        value: "## Contexte supplémentaire",
+        description: "Markdown heading"
+      },
+      "export.configuration": {
+        value: "## Configuration",
+        description: "Markdown heading"
+      },
+      "export.mcpServers": {
+        value: "## Serveurs MCP",
+        description: "Markdown heading"
+      },
+      "export.parameters": {
+        value: "**Paramètres :**",
+        description: "Parameters label"
+      },
+      "export.requiresApproval": {
+        value: "nécessite une approbation",
+        description: "Tool flag"
+      },
+      "export.notAutomationSafe": {
+        value: "non compatible avec l'automatisation",
+        description: "Tool flag"
+      },
+      "export.requiresApprovalMd": {
+        value: "*(nécessite une approbation)*",
+        description: "Markdown tool flag"
+      },
+      "export.notAutomationSafeMd": {
+        value: "*(non compatible avec l'automatisation)*",
+        description: "Markdown tool flag"
+      },
+      "export.required": {
+        value: "(obligatoire)",
+        description: "Required marker"
+      },
+      "export.optional": {
+        value: "(optionnel)",
+        description: "Optional marker"
+      },
+      "export.minConfidence": {
+        value: "- Confiance minimale : {min}",
+        description: "Policy line",
+        placeholders: [{ name: "min", type: "number" }]
+      },
+      "export.escalationConfigured": {
+        value: "- La politique d'escalade est configurée",
+        description: "Policy line for system prompt"
+      },
+      "export.escalationPolicyConfigured": {
+        value: "- Politique d'escalade configurée",
+        description: "Policy line for markdown export"
+      },
+      "export.featureFlags": {
+        value: "- Indicateurs de fonctionnalités : {flags}",
+        description: "Feature flags policy line",
+        placeholders: [{ name: "flags", type: "string" }]
+      },
+      "export.generatedFrom": {
+        value: "*Généré à partir de ContractSpec : {key}*",
+        description: "Footer attribution line",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "export.exportedAt": {
+        value: "*Exporté le : {date}*",
+        description: "Footer timestamp",
+        placeholders: [{ name: "date", type: "string" }]
+      },
+      "export.agentType": {
+        value: "> Type d'agent : **{type}**",
+        description: "Agent type callout",
+        placeholders: [{ name: "type", type: "string" }]
+      },
+      "export.noDescription": {
+        value: "Aucune description",
+        description: "Fallback when tool has no description"
+      },
+      "export.validation.requiresKey": {
+        value: "La spécification doit avoir une meta.key",
+        description: "Validation error"
+      },
+      "export.validation.requiresInstructions": {
+        value: "La spécification doit avoir des instructions",
+        description: "Validation error"
+      },
+      "export.validation.requiresTool": {
+        value: "La spécification doit avoir au moins un outil",
+        description: "Validation error"
+      },
+      "export.validation.toolRequiresName": {
+        value: "Tous les outils doivent avoir un nom",
+        description: "Validation error"
+      },
+      "export.validation.toolRequiresDescOrName": {
+        value: "L'outil doit avoir une description ou un nom",
+        description: "Validation error"
+      },
+      "export.validation.toolInvalidName": {
+        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: "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: "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: "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: "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: "(nécessite une approbation)",
+        description: "Tool permission label"
+      },
+      "export.bridge.askMode": {
+        value: "(mode interrogation)",
+        description: "Tool permission label"
+      },
+      "approval.toolRequiresApproval": {
+        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} 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: "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: "Échec du chargement des connaissances requises « {key} » :",
+        description: "Warning when knowledge loading fails",
+        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",
+        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",
+        placeholders: [
+          { name: "name", type: "string" },
+          { name: "version", type: "string" },
+          { name: "count", type: "number" }
+        ]
+      },
+      "log.mcpServer.stopped": {
+        value: "[MCPToolServer] {name} arrêté",
+        description: "Log message when MCP tool server stops",
+        placeholders: [{ name: "name", type: "string" }]
+      }
+    }
+  });
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts/translations";
+var esMessages;
+var init_es = __esm(() => {
+  esMessages = 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",
+      owners: ["platform"],
+      stability: "experimental"
+    },
+    locale: "es",
+    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"
+      },
+      "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"
+      },
+      "agent.json.rules.noCommentary": {
+        value: "No incluya comentarios ni explicaciones.",
+        description: "Regla del ejecutor JSON: sin texto adicional"
+      },
+      "agent.json.rules.doubleQuotes": {
+        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: "No incluya comas finales.",
+        description: "Regla del ejecutor JSON: sin comas finales"
+      },
+      "agent.json.defaultDescription": {
+        value: "Ejecutor de agentes exclusivamente JSON para pipelines deterministas.",
+        description: "Descripción predeterminada para la especificación del ejecutor JSON"
+      },
+      "agent.json.systemPrompt": {
+        value: "Usted es un generador preciso de JSON.",
+        description: "Prompt de sistema predeterminado para el ejecutor JSON"
+      },
+      "knowledge.header": {
+        value: "# Conocimiento de referencia",
+        description: "Encabezado para la sección de conocimiento inyectado en el prompt del sistema"
+      },
+      "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"
+      },
+      "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"
+      },
+      "tool.knowledge.availableSpaces": {
+        value: "Espacios de conocimiento disponibles:",
+        description: "Etiqueta antes de listar los espacios de conocimiento disponibles"
+      },
+      "tool.knowledge.spaceDefault": {
+        value: "Espacio de conocimiento",
+        description: "Descripción de respaldo para espacios de conocimiento sin nombre"
+      },
+      "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"
+      },
+      "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"
+      },
+      "tool.knowledge.param.topK": {
+        value: "Número máximo de resultados a devolver",
+        description: "Descripción del parámetro para el campo topK"
+      },
+      "tool.knowledge.noResults": {
+        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: "[Fuente {index} - {space}] (relevancia: {score}%)",
+        description: "Etiqueta para cada resultado de búsqueda de conocimiento",
+        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"
+          }
+        ]
+      },
+      "tool.fallbackDescription": {
+        value: "Ejecutar {name}",
+        description: "Descripción de respaldo cuando una herramienta no tiene descripción explícita",
+        placeholders: [
+          {
+            name: "name",
+            type: "string",
+            description: "Nombre de la herramienta"
+          }
+        ]
+      },
+      "tool.mcp.param.message": {
+        value: "El mensaje o consulta a enviar al agente",
+        description: "Servidor MCP: descripción del parámetro message"
+      },
+      "tool.mcp.param.sessionId": {
+        value: "ID de sesión opcional para continuar una conversación",
+        description: "Servidor MCP: descripción del parámetro sessionId"
+      },
+      "tool.mcp.agentDescription": {
+        value: "Interactuar con el agente {key}",
+        description: "Servidor MCP: descripción de la herramienta de agente",
+        placeholders: [
+          {
+            name: "key",
+            type: "string",
+            description: "Clave de la especificación del agente"
+          }
+        ]
+      },
+      "tool.mcp.executePrompt": {
+        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: "Nombre de la herramienta"
+          },
+          {
+            name: "args",
+            type: "string",
+            description: "Argumentos serializados como JSON"
+          }
+        ]
+      },
+      "tool.mcp.toolDescription": {
+        value: "Ejecutar la herramienta {name}",
+        description: "Servidor MCP: descripción de herramienta individual",
+        placeholders: [
+          {
+            name: "name",
+            type: "string",
+            description: "Nombre de la herramienta"
+          }
+        ]
+      },
+      "interop.prompt.agentIdentity": {
+        value: "# Identidad del agente",
+        description: "Encabezado de sección para la identidad del agente en el prompt del LLM"
+      },
+      "interop.prompt.youAre": {
+        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: "## Descripción",
+        description: "Encabezado de sección para la descripción"
+      },
+      "interop.prompt.instructions": {
+        value: "## Instrucciones",
+        description: "Encabezado de sección para las instrucciones"
+      },
+      "interop.prompt.availableTools": {
+        value: "## Herramientas disponibles",
+        description: "Encabezado de sección para las herramientas disponibles"
+      },
+      "interop.prompt.toolsIntro": {
+        value: "Usted tiene acceso a las siguientes herramientas:",
+        description: "Introducción antes de listar las herramientas"
+      },
+      "interop.prompt.parameters": {
+        value: "Parámetros:",
+        description: "Etiqueta antes del bloque de parámetros de la herramienta"
+      },
+      "interop.prompt.knowledgeContext": {
+        value: "## Contexto de conocimiento",
+        description: "Encabezado de sección para el contexto de conocimiento"
+      },
+      "interop.prompt.additionalContext": {
+        value: "## Contexto adicional",
+        description: "Encabezado de sección para el contexto adicional"
+      },
+      "interop.md.toc": {
+        value: "## Tabla de contenidos",
+        description: "Encabezado de tabla de contenidos"
+      },
+      "interop.md.overview": {
+        value: "## Resumen general",
+        description: "Encabezado de resumen general"
+      },
+      "interop.md.tools": {
+        value: "## Herramientas",
+        description: "Encabezado de herramientas"
+      },
+      "interop.md.knowledge": {
+        value: "## Conocimiento",
+        description: "Encabezado de conocimiento"
+      },
+      "interop.md.policy": {
+        value: "## Política",
+        description: "Encabezado de política"
+      },
+      "interop.md.metaKey": {
+        value: "- **Clave**: `{key}`",
+        description: "Línea de metadatos para la clave",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "interop.md.metaVersion": {
+        value: "- **Versión**: {version}",
+        description: "Línea de metadatos para la versión",
+        placeholders: [{ name: "version", type: "string" }]
+      },
+      "interop.md.metaStability": {
+        value: "- **Estabilidad**: {stability}",
+        description: "Línea de metadatos para la estabilidad",
+        placeholders: [{ name: "stability", type: "string" }]
+      },
+      "interop.md.metaOwners": {
+        value: "- **Propietarios**: {owners}",
+        description: "Línea de metadatos para los propietarios",
+        placeholders: [{ name: "owners", type: "string" }]
+      },
+      "interop.md.metaTags": {
+        value: "- **Etiquetas**: {tags}",
+        description: "Línea de metadatos para las etiquetas",
+        placeholders: [{ name: "tags", type: "string" }]
+      },
+      "interop.md.schema": {
+        value: "**Esquema:**",
+        description: "Etiqueta de esquema"
+      },
+      "interop.md.automationSafe": {
+        value: "**Seguro para automatización**: {value}",
+        description: "Campo de seguridad para automatización",
+        placeholders: [{ name: "value", type: "string" }]
+      },
+      "interop.md.required": {
+        value: "(obligatorio)",
+        description: "Marcador de obligatorio"
+      },
+      "interop.md.optional": {
+        value: "(opcional)",
+        description: "Marcador de opcional"
+      },
+      "interop.md.minConfidence": {
+        value: "- **Confianza mínima**: {min}",
+        description: "Línea de política de confianza mínima",
+        placeholders: [{ name: "min", type: "number" }]
+      },
+      "interop.md.escalationThreshold": {
+        value: "- **Umbral de escalamiento**: {threshold}",
+        description: "Línea de política de umbral de escalamiento",
+        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"
+      },
+      "interop.md.escalateTimeout": {
+        value: "- **Escalar ante tiempo de espera agotado**: Sí",
+        description: "Línea de política de escalamiento ante tiempo de espera"
+      },
+      "interop.md.yes": { value: "Sí", description: "Etiqueta de Sí" },
+      "interop.md.no": { value: "No", description: "Etiqueta de No" },
+      "error.jsonRunner.requiresModel": {
+        value: "createAgentJsonRunner requiere un modelo o configuración de proveedor",
+        description: "Error cuando el ejecutor JSON no tiene modelo ni proveedor"
+      },
+      "error.missingToolHandler": {
+        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 desconocido: {backend}",
+        description: "Error cuando se especifica un backend desconocido",
+        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"
+      },
+      "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"
+      },
+      "error.opencodeSdk.notAvailable": {
+        value: "OpenCode SDK no disponible. Instale @opencode-ai/sdk",
+        description: "Error cuando el OpenCode SDK no está disponible"
+      },
+      "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"
+      },
+      "error.providerNotInitialized": {
+        value: "Proveedor no inicializado",
+        description: "Error cuando el proveedor no ha sido inicializado antes de su uso"
+      },
+      "error.agentKeyRequired": {
+        value: "La clave del agente es obligatoria",
+        description: "Error de validación: falta la clave del agente"
+      },
+      "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",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "error.agentRequiresInstructions": {
+        value: "El agente {key} requiere instrucciones",
+        description: "Error de validación: faltan instrucciones",
+        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",
+        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",
+        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",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.specNotFound": {
+        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: "Herramienta no encontrada: {name}",
+        description: "Error cuando no se encuentra una herramienta",
+        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",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.noToolHandler": {
+        value: "Sin manejador para la herramienta: {name}",
+        description: "Error breve cuando no existe manejador",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.unknownExportFormat": {
+        value: "Formato de exportación desconocido: {format}",
+        description: "Error para formato de exportación no soportado",
+        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",
+        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",
+        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",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.provider.notRegistered": {
+        value: "no registrado",
+        description: "Razón de disponibilidad del proveedor: no registrado"
+      },
+      "error.provider.depsNotInstalled": {
+        value: "dependencias no instaladas o no configuradas",
+        description: "Razón de disponibilidad del proveedor: faltan dependencias"
+      },
+      "error.provider.sdkNotConfigured": {
+        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 no está instalado",
+        description: "Error cuando falla require.resolve del Claude Agent SDK"
+      },
+      "error.provider.opencodeSdkMissing": {
+        value: "@opencode-ai/sdk no está instalado",
+        description: "Error cuando falla require.resolve del OpenCode SDK"
+      },
+      "error.provider.sdkNotInstalled": {
+        value: "SDK no instalado",
+        description: "Error genérico del proveedor: SDK no instalado"
+      },
+      "error.provider.contextCreation": {
+        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: "La ejecución falló: {error}",
+        description: "Error durante la ejecución del proveedor",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "error.provider.streamFailed": {
+        value: "El stream falló: {error}",
+        description: "Error durante el streaming del proveedor",
+        placeholders: [{ name: "error", type: "string" }]
+      },
+      "export.agentConfiguration": {
+        value: "# Configuración del agente",
+        description: "Encabezado Markdown"
+      },
+      "export.metadata": {
+        value: "## Metadatos",
+        description: "Encabezado Markdown"
+      },
+      "export.metaName": {
+        value: "- **Nombre**: {name}",
+        description: "Línea de metadatos",
+        placeholders: [{ name: "name", type: "string" }]
+      },
+      "export.metaVersion": {
+        value: "- **Versión**: {version}",
+        description: "Línea de metadatos",
+        placeholders: [{ name: "version", type: "string" }]
+      },
+      "export.metaOwners": {
+        value: "- **Propietarios**: {owners}",
+        description: "Línea de metadatos",
+        placeholders: [{ name: "owners", type: "string" }]
+      },
+      "export.metaModel": {
+        value: "- **Modelo**: {model}",
+        description: "Línea de metadatos",
+        placeholders: [{ name: "model", type: "string" }]
+      },
+      "export.instructions": {
+        value: "## Instrucciones",
+        description: "Encabezado Markdown"
+      },
+      "export.availableTools": {
+        value: "## Herramientas disponibles",
+        description: "Encabezado Markdown"
+      },
+      "export.tools": {
+        value: "## Herramientas",
+        description: "Encabezado Markdown"
+      },
+      "export.knowledgeSources": {
+        value: "## Fuentes de conocimiento",
+        description: "Encabezado Markdown"
+      },
+      "export.policy": {
+        value: "## Política",
+        description: "Encabezado Markdown"
+      },
+      "export.additionalContext": {
+        value: "## Contexto adicional",
+        description: "Encabezado Markdown"
+      },
+      "export.configuration": {
+        value: "## Configuración",
+        description: "Encabezado Markdown"
+      },
+      "export.mcpServers": {
+        value: "## Servidores MCP",
+        description: "Encabezado Markdown"
+      },
+      "export.parameters": {
+        value: "**Parámetros:**",
+        description: "Etiqueta de parámetros"
+      },
+      "export.requiresApproval": {
+        value: "requiere aprobación",
+        description: "Indicador de herramienta"
+      },
+      "export.notAutomationSafe": {
+        value: "no es seguro para automatización",
+        description: "Indicador de herramienta"
+      },
+      "export.requiresApprovalMd": {
+        value: "*(requiere aprobación)*",
+        description: "Indicador de herramienta en Markdown"
+      },
+      "export.notAutomationSafeMd": {
+        value: "*(no es seguro para automatización)*",
+        description: "Indicador de herramienta en Markdown"
+      },
+      "export.required": {
+        value: "(obligatorio)",
+        description: "Marcador de obligatorio"
+      },
+      "export.optional": {
+        value: "(opcional)",
+        description: "Marcador de opcional"
+      },
+      "export.minConfidence": {
+        value: "- Confianza mínima: {min}",
+        description: "Línea de política",
+        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"
+      },
+      "export.escalationPolicyConfigured": {
+        value: "- Política de escalamiento configurada",
+        description: "Línea de política para la exportación en Markdown"
+      },
+      "export.featureFlags": {
+        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: "*Generado desde ContractSpec: {key}*",
+        description: "Línea de atribución en el pie",
+        placeholders: [{ name: "key", type: "string" }]
+      },
+      "export.exportedAt": {
+        value: "*Exportado el: {date}*",
+        description: "Marca de tiempo en el pie",
+        placeholders: [{ name: "date", type: "string" }]
+      },
+      "export.agentType": {
+        value: "> Tipo de agente: **{type}**",
+        description: "Llamada de tipo de agente",
+        placeholders: [{ name: "type", type: "string" }]
+      },
+      "export.noDescription": {
+        value: "Sin descripción",
+        description: "Texto de respaldo cuando la herramienta no tiene descripción"
+      },
+      "export.validation.requiresKey": {
+        value: "La especificación debe tener una meta.key",
+        description: "Error de validación"
+      },
+      "export.validation.requiresInstructions": {
+        value: "La especificación debe tener instrucciones",
+        description: "Error de validación"
+      },
+      "export.validation.requiresTool": {
+        value: "La especificación debe tener al menos una herramienta",
+        description: "Error de validación"
+      },
+      "export.validation.toolRequiresName": {
+        value: "Todas las herramientas deben tener un nombre",
+        description: "Error de validación"
+      },
+      "export.validation.toolRequiresDescOrName": {
+        value: "La herramienta debe tener una descripción o un nombre",
+        description: "Error de validación"
+      },
+      "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",
+        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"
+      },
+      "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"
+      },
+      "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"
+      },
+      "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"
+      },
+      "export.bridge.requiresApproval": {
+        value: "(requiere aprobación)",
+        description: "Etiqueta de permiso de herramienta"
+      },
+      "export.bridge.askMode": {
+        value: "(modo consulta)",
+        description: "Etiqueta de permiso de herramienta"
+      },
+      "approval.toolRequiresApproval": {
+        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} 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: '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: 'Error al cargar el conocimiento requerido "{key}":',
+        description: "Advertencia cuando falla la carga de conocimiento",
+        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",
+        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",
+        placeholders: [
+          { name: "name", type: "string" },
+          { name: "version", type: "string" },
+          { name: "count", type: "number" }
+        ]
+      },
+      "log.mcpServer.stopped": {
+        value: "[MCPToolServer] Detenido {name}",
+        description: "Mensaje de registro cuando el servidor de herramientas MCP se detiene",
+        placeholders: [{ name: "name", type: "string" }]
+      }
+    }
+  });
+});
+
+// src/i18n/locale.ts
+function resolveLocale(specLocale, runtimeLocale) {
+  const raw = runtimeLocale ?? specLocale ?? DEFAULT_LOCALE;
+  if (isSupportedLocale(raw)) {
+    return raw;
+  }
+  const base = raw.split("-")[0];
+  if (base && isSupportedLocale(base)) {
+    return base;
+  }
+  return DEFAULT_LOCALE;
+}
+function isSupportedLocale(locale) {
+  return SUPPORTED_LOCALES.includes(locale);
+}
+var DEFAULT_LOCALE = "en", SUPPORTED_LOCALES;
+var init_locale = __esm(() => {
+  SUPPORTED_LOCALES = ["en", "fr", "es"];
+});
+
+// src/i18n/messages.ts
+import { TranslationRegistry } from "@contractspec/lib.contracts/translations";
+function getRegistry() {
+  if (!sharedRegistry) {
+    sharedRegistry = new TranslationRegistry([
+      enMessages,
+      frMessages,
+      esMessages
+    ]);
+  }
+  return sharedRegistry;
+}
+function interpolate(template, params) {
+  if (!params)
+    return template;
+  return template.replace(/\{(\w+)\}/g, (match, key) => {
+    if (key in params) {
+      return String(params[key]);
+    }
+    return match;
+  });
+}
+function createAgentI18n(specLocale, runtimeLocale) {
+  const locale = resolveLocale(specLocale, runtimeLocale);
+  const registry = getRegistry();
+  return {
+    locale,
+    t(key, params) {
+      const raw = registry.getValue(SPEC_KEY, key, locale, key);
+      return interpolate(raw, params);
+    }
+  };
+}
+function getDefaultI18n() {
+  return createAgentI18n(DEFAULT_LOCALE);
+}
+function resetI18nRegistry() {
+  sharedRegistry = null;
+}
+var SPEC_KEY = "ai-agent.messages", sharedRegistry = null;
+var init_messages = __esm(() => {
+  init_en();
+  init_fr();
+  init_es();
+  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(() => {
+  AGENT_KEYS = {
+    "agent.json.rules.validJsonOnly": "agent.json.rules.validJsonOnly",
+    "agent.json.rules.noMarkdownFences": "agent.json.rules.noMarkdownFences",
+    "agent.json.rules.noCommentary": "agent.json.rules.noCommentary",
+    "agent.json.rules.doubleQuotes": "agent.json.rules.doubleQuotes",
+    "agent.json.rules.noTrailingCommas": "agent.json.rules.noTrailingCommas",
+    "agent.json.defaultDescription": "agent.json.defaultDescription",
+    "agent.json.systemPrompt": "agent.json.systemPrompt"
+  };
+  KNOWLEDGE_KEYS = {
+    "knowledge.header": "knowledge.header",
+    "knowledge.description": "knowledge.description"
+  };
+  TOOL_KEYS = {
+    "tool.knowledge.description": "tool.knowledge.description",
+    "tool.knowledge.availableSpaces": "tool.knowledge.availableSpaces",
+    "tool.knowledge.spaceDefault": "tool.knowledge.spaceDefault",
+    "tool.knowledge.param.query": "tool.knowledge.param.query",
+    "tool.knowledge.param.spaceKey": "tool.knowledge.param.spaceKey",
+    "tool.knowledge.param.topK": "tool.knowledge.param.topK",
+    "tool.knowledge.noResults": "tool.knowledge.noResults",
+    "tool.knowledge.sourceLabel": "tool.knowledge.sourceLabel",
+    "tool.fallbackDescription": "tool.fallbackDescription",
+    "tool.mcp.param.message": "tool.mcp.param.message",
+    "tool.mcp.param.sessionId": "tool.mcp.param.sessionId",
+    "tool.mcp.agentDescription": "tool.mcp.agentDescription",
+    "tool.mcp.executePrompt": "tool.mcp.executePrompt",
+    "tool.mcp.toolDescription": "tool.mcp.toolDescription"
+  };
+  INTEROP_KEYS = {
+    "interop.prompt.agentIdentity": "interop.prompt.agentIdentity",
+    "interop.prompt.youAre": "interop.prompt.youAre",
+    "interop.prompt.description": "interop.prompt.description",
+    "interop.prompt.instructions": "interop.prompt.instructions",
+    "interop.prompt.availableTools": "interop.prompt.availableTools",
+    "interop.prompt.toolsIntro": "interop.prompt.toolsIntro",
+    "interop.prompt.parameters": "interop.prompt.parameters",
+    "interop.prompt.knowledgeContext": "interop.prompt.knowledgeContext",
+    "interop.prompt.additionalContext": "interop.prompt.additionalContext",
+    "interop.md.toc": "interop.md.toc",
+    "interop.md.overview": "interop.md.overview",
+    "interop.md.tools": "interop.md.tools",
+    "interop.md.knowledge": "interop.md.knowledge",
+    "interop.md.policy": "interop.md.policy",
+    "interop.md.metaKey": "interop.md.metaKey",
+    "interop.md.metaVersion": "interop.md.metaVersion",
+    "interop.md.metaStability": "interop.md.metaStability",
+    "interop.md.metaOwners": "interop.md.metaOwners",
+    "interop.md.metaTags": "interop.md.metaTags",
+    "interop.md.schema": "interop.md.schema",
+    "interop.md.automationSafe": "interop.md.automationSafe",
+    "interop.md.required": "interop.md.required",
+    "interop.md.optional": "interop.md.optional",
+    "interop.md.minConfidence": "interop.md.minConfidence",
+    "interop.md.escalationThreshold": "interop.md.escalationThreshold",
+    "interop.md.escalateToolFailure": "interop.md.escalateToolFailure",
+    "interop.md.escalateTimeout": "interop.md.escalateTimeout",
+    "interop.md.yes": "interop.md.yes",
+    "interop.md.no": "interop.md.no"
+  };
+  ERROR_KEYS = {
+    "error.jsonRunner.requiresModel": "error.jsonRunner.requiresModel",
+    "error.missingToolHandler": "error.missingToolHandler",
+    "error.unknownBackend": "error.unknownBackend",
+    "error.claudeSdk.notAvailable": "error.claudeSdk.notAvailable",
+    "error.claudeSdk.notInstalled": "error.claudeSdk.notInstalled",
+    "error.opencodeSdk.notAvailable": "error.opencodeSdk.notAvailable",
+    "error.opencodeSdk.notInstalled": "error.opencodeSdk.notInstalled",
+    "error.providerNotInitialized": "error.providerNotInitialized",
+    "error.agentKeyRequired": "error.agentKeyRequired",
+    "error.agentMissingVersion": "error.agentMissingVersion",
+    "error.agentRequiresInstructions": "error.agentRequiresInstructions",
+    "error.agentRequiresTool": "error.agentRequiresTool",
+    "error.agentDuplicateTool": "error.agentDuplicateTool",
+    "error.agentSpecNotFound": "error.agentSpecNotFound",
+    "error.specNotFound": "error.specNotFound",
+    "error.toolNotFound": "error.toolNotFound",
+    "error.noHandlerForTool": "error.noHandlerForTool",
+    "error.noToolHandler": "error.noToolHandler",
+    "error.unknownExportFormat": "error.unknownExportFormat",
+    "error.handlerNotFoundForTool": "error.handlerNotFoundForTool",
+    "error.toolNotFoundOrNoHandler": "error.toolNotFoundOrNoHandler",
+    "error.toolNoExecuteHandler": "error.toolNoExecuteHandler",
+    "error.provider.notRegistered": "error.provider.notRegistered",
+    "error.provider.depsNotInstalled": "error.provider.depsNotInstalled",
+    "error.provider.sdkNotConfigured": "error.provider.sdkNotConfigured",
+    "error.provider.claudeSdkMissing": "error.provider.claudeSdkMissing",
+    "error.provider.opencodeSdkMissing": "error.provider.opencodeSdkMissing",
+    "error.provider.sdkNotInstalled": "error.provider.sdkNotInstalled",
+    "error.provider.contextCreation": "error.provider.contextCreation",
+    "error.provider.executionFailed": "error.provider.executionFailed",
+    "error.provider.streamFailed": "error.provider.streamFailed"
+  };
+  EXPORT_KEYS = {
+    "export.agentConfiguration": "export.agentConfiguration",
+    "export.metadata": "export.metadata",
+    "export.metaName": "export.metaName",
+    "export.metaVersion": "export.metaVersion",
+    "export.metaOwners": "export.metaOwners",
+    "export.metaModel": "export.metaModel",
+    "export.instructions": "export.instructions",
+    "export.availableTools": "export.availableTools",
+    "export.tools": "export.tools",
+    "export.knowledgeSources": "export.knowledgeSources",
+    "export.policy": "export.policy",
+    "export.additionalContext": "export.additionalContext",
+    "export.configuration": "export.configuration",
+    "export.mcpServers": "export.mcpServers",
+    "export.parameters": "export.parameters",
+    "export.requiresApproval": "export.requiresApproval",
+    "export.notAutomationSafe": "export.notAutomationSafe",
+    "export.requiresApprovalMd": "export.requiresApprovalMd",
+    "export.notAutomationSafeMd": "export.notAutomationSafeMd",
+    "export.required": "export.required",
+    "export.optional": "export.optional",
+    "export.minConfidence": "export.minConfidence",
+    "export.escalationConfigured": "export.escalationConfigured",
+    "export.escalationPolicyConfigured": "export.escalationPolicyConfigured",
+    "export.featureFlags": "export.featureFlags",
+    "export.generatedFrom": "export.generatedFrom",
+    "export.exportedAt": "export.exportedAt",
+    "export.agentType": "export.agentType",
+    "export.noDescription": "export.noDescription",
+    "export.validation.requiresKey": "export.validation.requiresKey",
+    "export.validation.requiresInstructions": "export.validation.requiresInstructions",
+    "export.validation.requiresTool": "export.validation.requiresTool",
+    "export.validation.toolRequiresName": "export.validation.toolRequiresName",
+    "export.validation.toolRequiresDescOrName": "export.validation.toolRequiresDescOrName",
+    "export.validation.toolInvalidName": "export.validation.toolInvalidName",
+    "export.agentType.build": "export.agentType.build",
+    "export.agentType.plan": "export.agentType.plan",
+    "export.agentType.general": "export.agentType.general",
+    "export.agentType.explore": "export.agentType.explore",
+    "export.bridge.requiresApproval": "export.bridge.requiresApproval",
+    "export.bridge.askMode": "export.bridge.askMode"
+  };
+  APPROVAL_KEYS = {
+    "approval.toolRequiresApproval": "approval.toolRequiresApproval"
+  };
+  LOG_KEYS = {
+    "log.unifiedAgent.fallback": "log.unifiedAgent.fallback",
+    "log.knowledge.spaceNotAvailable": "log.knowledge.spaceNotAvailable",
+    "log.knowledge.loadFailed": "log.knowledge.loadFailed",
+    "log.knowledge.queryFailed": "log.knowledge.queryFailed",
+    "log.mcpServer.started": "log.mcpServer.started",
+    "log.mcpServer.stopped": "log.mcpServer.stopped"
+  };
+  I18N_KEYS = {
+    ...AGENT_KEYS,
+    ...KNOWLEDGE_KEYS,
+    ...TOOL_KEYS,
+    ...INTEROP_KEYS,
+    ...ERROR_KEYS,
+    ...EXPORT_KEYS,
+    ...APPROVAL_KEYS,
+    ...LOG_KEYS
+  };
+});
+
+// src/i18n/index.ts
+var init_i18n = __esm(() => {
+  init_messages();
+  init_locale();
+  init_keys();
+  init_en();
+  init_fr();
+  init_es();
+});
+
 // src/spec/spec.ts
 function defineAgent(spec) {
+  const i18n = getDefaultI18n();
   if (!spec.meta?.key) {
-    throw new Error("Agent key is required");
+    throw new Error(i18n.t("error.agentKeyRequired"));
   }
   if (typeof spec.meta.version !== "string") {
-    throw new Error(`Agent ${spec.meta.key} is missing a string version`);
+    throw new Error(i18n.t("error.agentMissingVersion", { key: spec.meta.key }));
   }
   if (!spec.instructions?.trim()) {
-    throw new Error(`Agent ${spec.meta.key} requires instructions`);
+    throw new Error(i18n.t("error.agentRequiresInstructions", { key: spec.meta.key }));
   }
   if (!spec.tools?.length) {
-    throw new Error(`Agent ${spec.meta.key} must expose at least one tool`);
+    throw new Error(i18n.t("error.agentRequiresTool", { key: spec.meta.key }));
   }
   const toolNames = new Set;
   for (const tool of spec.tools) {
     if (toolNames.has(tool.name)) {
-      throw new Error(`Agent ${spec.meta.key} has duplicate tool name: ${tool.name}`);
+      throw new Error(i18n.t("error.agentDuplicateTool", {
+        key: spec.meta.key,
+        name: tool.name
+      }));
     }
     toolNames.add(tool.name);
   }
@@ -38,6 +2133,9 @@ function defineAgent(spec) {
 function agentKey(meta) {
   return `${meta.key}.v${meta.version}`;
 }
+var init_spec = __esm(() => {
+  init_i18n();
+});
 
 // src/schema/json-schema-to-zod.ts
 import { z } from "zod";
@@ -197,7 +2295,7 @@ function specToolsToAISDKTools(specTools, handlers, context = {}) {
   for (const specTool of specTools) {
     const handler = handlers.get(specTool.name);
     if (!handler) {
-      throw new Error(`Missing handler for tool: ${specTool.name}`);
+      throw new Error(getDefaultI18n().t("error.missingToolHandler", { name: specTool.name }));
     }
     tools[specTool.name] = specToolToAISDKTool(specTool, handler, context);
   }
@@ -213,27 +2311,29 @@ function buildToolHandlers(handlersObj) {
 }
 var init_tool_adapter = __esm(() => {
   init_json_schema_to_zod();
+  init_i18n();
 });
 
 // src/tools/knowledge-tool.ts
 import { tool as tool2 } from "ai";
 import * as z2 from "zod";
-function createKnowledgeQueryTool(retriever, knowledgeRefs) {
+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));
   if (optionalSpaces.length === 0) {
     return null;
   }
-  const spaceDescriptions = knowledgeRefs.filter((k) => !k.required && retriever.supportsSpace(k.key)).map((k) => `- ${k.key}: ${k.instructions ?? "Knowledge space"}`).join(`
+  const spaceDescriptions = knowledgeRefs.filter((k) => !k.required && retriever.supportsSpace(k.key)).map((k) => `- ${k.key}: ${k.instructions ?? i18n.t("tool.knowledge.spaceDefault")}`).join(`
 `);
   return tool2({
-    description: `Query knowledge bases for relevant information. Use this tool when you need to look up specific information that may not be in your context.
+    description: `${i18n.t("tool.knowledge.description")}
 
-Available knowledge spaces:
+${i18n.t("tool.knowledge.availableSpaces")}
 ${spaceDescriptions}`,
     inputSchema: z2.object({
-      query: z2.string().describe("The question or search query to find relevant information"),
-      spaceKey: z2.enum(optionalSpaces).optional().describe("Specific knowledge space to query. If omitted, searches all available spaces."),
-      topK: z2.number().optional().default(5).describe("Maximum number of results to return")
+      query: z2.string().describe(i18n.t("tool.knowledge.param.query")),
+      spaceKey: z2.enum(optionalSpaces).optional().describe(i18n.t("tool.knowledge.param.spaceKey")),
+      topK: z2.number().optional().default(5).describe(i18n.t("tool.knowledge.param.topK"))
     }),
     execute: async ({ query, spaceKey, topK }) => {
       const spacesToSearch = spaceKey ? [spaceKey] : optionalSpaces;
@@ -252,15 +2352,15 @@ ${spaceDescriptions}`,
             });
           }
         } catch (error) {
-          console.warn(`Failed to query knowledge space ${space}:`, error);
+          console.warn(i18n.t("log.knowledge.queryFailed", { space }), error);
         }
       }
       if (allResults.length === 0) {
-        return "No relevant information found in the knowledge bases.";
+        return i18n.t("tool.knowledge.noResults");
       }
       allResults.sort((a, b) => b.score - a.score);
       const topResults = allResults.slice(0, topK ?? 5);
-      return topResults.map((r, i) => `[Source ${i + 1} - ${r.space}] (relevance: ${(r.score * 100).toFixed(0)}%)
+      return topResults.map((r, i) => `${i18n.t("tool.knowledge.sourceLabel", { index: i + 1, space: r.space, score: (r.score * 100).toFixed(0) })}
 ${r.content}`).join(`
 
 ---
@@ -269,19 +2369,22 @@ ${r.content}`).join(`
     }
   });
 }
-var init_knowledge_tool = () => {};
+var init_knowledge_tool = __esm(() => {
+  init_i18n();
+});
 
 // src/knowledge/injector.ts
-async function injectStaticKnowledge(instructions, knowledgeRefs, retriever) {
+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(`Required knowledge space "${ref.key}" is not available`);
+      console.warn(i18n.t("log.knowledge.spaceNotAvailable", { key: ref.key }));
       continue;
     }
     try {
@@ -294,7 +2397,7 @@ ${ref.instructions}` : `## ${ref.key}`;
 ${content}`);
       }
     } catch (error) {
-      console.warn(`Failed to load required knowledge "${ref.key}":`, error);
+      console.warn(i18n.t("log.knowledge.loadFailed", { key: ref.key }), error);
     }
   }
   if (blocks.length === 0)
@@ -303,9 +2406,9 @@ ${content}`);
 
 ---
 
-# Reference Knowledge
+# ${i18n.t("knowledge.header")}
 
-The following information is provided for your reference. Use it to inform your responses.
+${i18n.t("knowledge.description")}
 
 ${blocks.join(`
 
@@ -313,13 +2416,16 @@ ${blocks.join(`
 
 `)}`;
 }
-function createKnowledgeInjector(retriever) {
+function createKnowledgeInjector(retriever, locale) {
   return {
-    inject: (instructions, knowledgeRefs) => injectStaticKnowledge(instructions, knowledgeRefs, retriever),
+    inject: (instructions, knowledgeRefs) => injectStaticKnowledge(instructions, knowledgeRefs, retriever, locale),
     hasSpace: (spaceKey) => retriever?.supportsSpace(spaceKey) ?? false,
     listSpaces: () => retriever?.listSpaces() ?? []
   };
 }
+var init_injector = __esm(() => {
+  init_i18n();
+});
 
 // src/session/store.ts
 class InMemorySessionStore {
@@ -457,6 +2563,118 @@ var init_adapter = __esm(() => {
   };
 });
 
+// src/telemetry/posthog.ts
+var exports_posthog = {};
+__export(exports_posthog, {
+  createPostHogTracedModel: () => createPostHogTracedModel,
+  createPostHogTelemetryCollector: () => createPostHogTelemetryCollector,
+  createCompositeTelemetryCollector: () => createCompositeTelemetryCollector,
+  PostHogTelemetryCollector: () => PostHogTelemetryCollector,
+  CompositeTelemetryCollector: () => CompositeTelemetryCollector
+});
+async function createPostHogTracedModel(model, config, overrides) {
+  const { withTracing } = await importPostHogAI();
+  const phClient = await resolvePostHogClient(config);
+  const tracingOptions = {
+    ...config.defaults,
+    ...overrides
+  };
+  return withTracing(model, phClient, tracingOptions);
+}
+
+class PostHogTelemetryCollector {
+  phClient;
+  config;
+  initPromise;
+  constructor(config) {
+    this.config = config;
+    this.phClient = config.client;
+  }
+  async collect(sample) {
+    const client = await this.getClient();
+    const distinctId = this.config.defaults?.posthogDistinctId ?? sample.metadata?.["actorId"] ?? "system";
+    client.capture({
+      distinctId,
+      event: "$ai_generation",
+      properties: {
+        $ai_model: sample.operation.name,
+        $ai_provider: "contractspec",
+        $ai_latency: sample.durationMs / 1000,
+        $ai_is_error: !sample.success,
+        $ai_trace_id: this.config.defaults?.posthogTraceId,
+        ...sample.metadata?.["tokenUsage"] ? mapTokenUsage(sample.metadata["tokenUsage"]) : {},
+        ...this.config.defaults?.posthogProperties,
+        contractspec_operation: sample.operation.name,
+        contractspec_version: sample.operation.version,
+        contractspec_agent_id: sample.metadata?.["agentId"],
+        contractspec_finish_reason: sample.metadata?.["finishReason"],
+        contractspec_tool_count: sample.metadata?.["toolCallCount"]
+      },
+      groups: this.config.defaults?.posthogGroups
+    });
+  }
+  async shutdown() {
+    if (this.phClient?.shutdown) {
+      await this.phClient.shutdown();
+    }
+  }
+  async getClient() {
+    if (this.phClient)
+      return this.phClient;
+    if (!this.initPromise) {
+      this.initPromise = resolvePostHogClient(this.config).then((client) => {
+        this.phClient = client;
+        return client;
+      });
+    }
+    return this.initPromise;
+  }
+}
+function createPostHogTelemetryCollector(config) {
+  return new PostHogTelemetryCollector(config);
+}
+
+class CompositeTelemetryCollector {
+  collectors;
+  constructor(collectors) {
+    this.collectors = collectors;
+  }
+  async collect(sample) {
+    await Promise.all(this.collectors.map((c) => c.collect(sample)));
+  }
+}
+function createCompositeTelemetryCollector(collectors) {
+  return new CompositeTelemetryCollector(collectors);
+}
+async function importPostHogAI() {
+  try {
+    return await import("@posthog/ai");
+  } catch {
+    throw new Error("PostHog LLM Analytics requires @posthog/ai to be installed. Run: npm install @posthog/ai posthog-node");
+  }
+}
+async function resolvePostHogClient(config) {
+  if (config.client)
+    return config.client;
+  if (!config.apiKey) {
+    throw new Error("PostHog LLM Analytics requires either a client instance or an apiKey.");
+  }
+  try {
+    const { PostHog } = await import("posthog-node");
+    return new PostHog(config.apiKey, {
+      host: config.host ?? "https://us.i.posthog.com"
+    });
+  } catch {
+    throw new Error("PostHog LLM Analytics requires posthog-node to be installed. Run: npm install posthog-node");
+  }
+}
+function mapTokenUsage(usage) {
+  return {
+    $ai_input_tokens: usage["promptTokens"],
+    $ai_output_tokens: usage["completionTokens"]
+  };
+}
+
 // src/agent/contract-spec-agent.ts
 var exports_contract_spec_agent = {};
 __export(exports_contract_spec_agent, {
@@ -494,15 +2712,21 @@ class ContractSpecAgent {
     });
   }
   static async create(config) {
-    const instructions = await injectStaticKnowledge(config.spec.instructions, config.spec.knowledge ?? [], config.knowledgeRetriever);
-    const specTools = specToolsToAISDKTools(config.spec.tools, config.toolHandlers, { agentId: agentKey(config.spec.meta) });
-    const knowledgeTool = config.knowledgeRetriever ? createKnowledgeQueryTool(config.knowledgeRetriever, config.spec.knowledge ?? []) : null;
+    let effectiveConfig = config;
+    if (config.posthogConfig) {
+      const { createPostHogTracedModel: createPostHogTracedModel2 } = await Promise.resolve().then(() => exports_posthog);
+      const tracedModel = await createPostHogTracedModel2(config.model, config.posthogConfig, config.posthogConfig.tracingOptions);
+      effectiveConfig = { ...config, model: tracedModel };
+    }
+    const instructions = await injectStaticKnowledge(effectiveConfig.spec.instructions, effectiveConfig.spec.knowledge ?? [], effectiveConfig.knowledgeRetriever);
+    const specTools = specToolsToAISDKTools(effectiveConfig.spec.tools, effectiveConfig.toolHandlers, { agentId: agentKey(effectiveConfig.spec.meta) });
+    const knowledgeTool = effectiveConfig.knowledgeRetriever ? createKnowledgeQueryTool(effectiveConfig.knowledgeRetriever, effectiveConfig.spec.knowledge ?? []) : null;
     const tools = {
       ...specTools,
       ...knowledgeTool ? { query_knowledge: knowledgeTool } : {},
-      ...config.additionalTools ?? {}
+      ...effectiveConfig.additionalTools ?? {}
     };
-    return new ContractSpecAgent(config, instructions, tools);
+    return new ContractSpecAgent(effectiveConfig, instructions, tools);
   }
   async generate(params) {
     const sessionId = params.options?.sessionId ?? generateSessionId();
@@ -590,8 +2814,10 @@ ${params.prompt}` : params.prompt;
 }
 var ContractSpecCallOptionsSchema;
 var init_contract_spec_agent = __esm(() => {
+  init_spec();
   init_tool_adapter();
   init_knowledge_tool();
+  init_injector();
   init_adapter();
   ContractSpecCallOptionsSchema = z3.object({
     tenantId: z3.string().optional(),
@@ -640,7 +2866,7 @@ var init_types = __esm(() => {
 function specToolToClaudeAgentTool(tool3, handler, context) {
   return {
     name: tool3.name,
-    description: tool3.description ?? `Execute ${tool3.name}`,
+    description: tool3.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool3.name }),
     input_schema: normalizeSchema(tool3.schema),
     requires_confirmation: tool3.requiresApproval ?? !tool3.automationSafe,
     execute: async (input) => {
@@ -660,7 +2886,9 @@ function specToolsToClaudeAgentTools(tools, handlers, context) {
   return tools.filter((tool3) => handlers.has(tool3.name)).map((tool3) => {
     const handler = handlers.get(tool3.name);
     if (!handler) {
-      throw new Error(`Handler not found for tool ${tool3.name}`);
+      throw new Error(getDefaultI18n().t("error.handlerNotFoundForTool", {
+        name: tool3.name
+      }));
     }
     return specToolToClaudeAgentTool(tool3, handler, context);
   });
@@ -691,7 +2919,7 @@ function claudeAgentToolsToSpecTools(claudeTools) {
 function specToolToExternalTool(tool3, handler, context) {
   return {
     name: tool3.name,
-    description: tool3.description ?? `Execute ${tool3.name}`,
+    description: tool3.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool3.name }),
     inputSchema: tool3.schema ?? { type: "object" },
     requiresApproval: tool3.requiresApproval ?? !tool3.automationSafe,
     execute: handler ? async (input) => {
@@ -732,6 +2960,9 @@ function extractToolCalls(response) {
     args: block.input
   }));
 }
+var init_tool_bridge = __esm(() => {
+  init_i18n();
+});
 
 // src/providers/claude-agent-sdk/session-bridge.ts
 function toClaudeAgentSession(state) {
@@ -884,7 +3115,7 @@ class ClaudeAgentSDKProvider {
   }
   async createContext(spec) {
     if (!this.isAvailable()) {
-      throw new ProviderNotAvailableError(this.name, "SDK not installed or API key not configured");
+      throw new ProviderNotAvailableError(this.name, getDefaultI18n().t("error.provider.sdkNotConfigured"));
     }
     try {
       const toolSet = {};
@@ -909,7 +3140,9 @@ class ClaudeAgentSDKProvider {
         cleanup: async () => {}
       };
     } catch (error) {
-      throw new ContextCreationError(this.name, `Failed to create context: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+      throw new ContextCreationError(this.name, getDefaultI18n().t("error.provider.contextCreation", {
+        error: error instanceof Error ? error.message : String(error)
+      }), error instanceof Error ? error : undefined);
     }
   }
   async execute(context, params) {
@@ -965,7 +3198,9 @@ ${params.systemOverride}` : context.spec.instructions;
         }
       };
     } catch (error) {
-      throw new ProviderExecutionError(this.name, `Execution failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+      throw new ProviderExecutionError(this.name, getDefaultI18n().t("error.provider.executionFailed", {
+        error: error instanceof Error ? error.message : String(error)
+      }), error instanceof Error ? error : undefined);
     }
   }
   async* stream(context, params) {
@@ -1045,7 +3280,9 @@ ${params.systemOverride}` : context.spec.instructions;
         }
       };
     } catch (error) {
-      throw new ProviderExecutionError(this.name, `Stream failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+      throw new ProviderExecutionError(this.name, getDefaultI18n().t("error.provider.streamFailed", {
+        error: error instanceof Error ? error.message : String(error)
+      }), error instanceof Error ? error : undefined);
     }
   }
   async loadSDK() {
@@ -1053,7 +3290,7 @@ ${params.systemOverride}` : context.spec.instructions;
       const module = __require("@anthropic-ai/claude-agent-sdk");
       return module.default ?? module;
     } catch {
-      throw new ProviderNotAvailableError(this.name, "@anthropic-ai/claude-agent-sdk is not installed");
+      throw new ProviderNotAvailableError(this.name, getDefaultI18n().t("error.provider.claudeSdkMissing"));
     }
   }
   prepareToolsForSDK(context, params) {
@@ -1063,7 +3300,9 @@ ${params.systemOverride}` : context.spec.instructions;
       if (externalTool?.execute) {
         handlers.set(tool3.name, async (input) => {
           if (!externalTool.execute) {
-            throw new Error(`Tool ${tool3.name} has no execute handler`);
+            throw new Error(getDefaultI18n().t("error.toolNoExecuteHandler", {
+              name: tool3.name
+            }));
           }
           const result = await externalTool.execute(input);
           return typeof result === "string" ? result : JSON.stringify(result);
@@ -1085,7 +3324,9 @@ ${params.systemOverride}` : context.spec.instructions;
       return {
         toolCallId: toolCall.toolCallId,
         toolName: toolCall.toolName,
-        output: `Error: Tool '${toolCall.toolName}' not found or has no handler`
+        output: getDefaultI18n().t("error.toolNotFoundOrNoHandler", {
+          name: toolCall.toolName
+        })
       };
     }
     try {
@@ -1127,7 +3368,11 @@ ${params.systemOverride}` : context.spec.instructions;
   }
 }
 var init_adapter2 = __esm(() => {
+  init_spec();
   init_types();
+  init_tool_bridge();
+  init_injector();
+  init_i18n();
 });
 
 // src/providers/claude-agent-sdk/index.ts
@@ -1157,13 +3402,14 @@ __export(exports_claude_agent_sdk, {
 });
 var init_claude_agent_sdk = __esm(() => {
   init_adapter2();
+  init_tool_bridge();
 });
 
 // src/providers/opencode-sdk/tool-bridge.ts
 function specToolToOpenCodeTool(tool3) {
   return {
     name: tool3.name,
-    description: tool3.description ?? `Execute ${tool3.name}`,
+    description: tool3.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool3.name }),
     parameters: normalizeToOpenCodeParameters(tool3.schema),
     permission: getPermissionLevel(tool3)
   };
@@ -1195,7 +3441,7 @@ function openCodeToolsToSpecTools(openCodeTools) {
 function specToolToExternalToolForOpenCode(tool3, handler, context) {
   return {
     name: tool3.name,
-    description: tool3.description ?? `Execute ${tool3.name}`,
+    description: tool3.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool3.name }),
     inputSchema: tool3.schema ?? { type: "object" },
     requiresApproval: tool3.requiresApproval ?? !tool3.automationSafe,
     execute: handler ? async (input) => {
@@ -1259,7 +3505,9 @@ async function executeToolCall(toolCall, handlers) {
   if (!handler) {
     return {
       tool_call_id: toolCall.id,
-      output: `Error: Tool '${toolCall.name}' not found`,
+      output: getDefaultI18n().t("error.toolNotFoundOrNoHandler", {
+        name: toolCall.name
+      }),
       is_error: true
     };
   }
@@ -1277,6 +3525,9 @@ async function executeToolCall(toolCall, handlers) {
     };
   }
 }
+var init_tool_bridge2 = __esm(() => {
+  init_i18n();
+});
 
 // src/providers/opencode-sdk/agent-bridge.ts
 function inferAgentType(spec) {
@@ -1351,6 +3602,7 @@ function specToOpenCodeMarkdown(spec, options) {
   };
 }
 function buildMarkdownBody(spec) {
+  const i18n = getDefaultI18n();
   const lines = [];
   lines.push(`# ${spec.meta.key}`);
   lines.push("");
@@ -1358,24 +3610,24 @@ function buildMarkdownBody(spec) {
     lines.push(spec.description ?? spec.meta.description ?? "");
     lines.push("");
   }
-  lines.push("## Instructions");
+  lines.push(i18n.t("export.instructions"));
   lines.push("");
   lines.push(spec.instructions);
   lines.push("");
   if (spec.tools.length > 0) {
-    lines.push("## Tools");
+    lines.push(i18n.t("export.tools"));
     lines.push("");
     for (const tool3 of spec.tools) {
-      const permission = tool3.requiresApproval ? "(requires approval)" : tool3.automationSafe === false ? "(ask mode)" : "";
-      lines.push(`- **${tool3.name}**: ${tool3.description ?? "No description"} ${permission}`.trim());
+      const permission = tool3.requiresApproval ? i18n.t("export.bridge.requiresApproval") : tool3.automationSafe === false ? i18n.t("export.bridge.askMode") : "";
+      lines.push(`- **${tool3.name}**: ${tool3.description ?? i18n.t("export.noDescription")} ${permission}`.trim());
     }
     lines.push("");
   }
   if (spec.knowledge && spec.knowledge.length > 0) {
-    lines.push("## Knowledge Sources");
+    lines.push(i18n.t("export.knowledgeSources"));
     lines.push("");
     for (const k of spec.knowledge) {
-      const required = k.required ? "(required)" : "(optional)";
+      const required = k.required ? i18n.t("export.required") : i18n.t("export.optional");
       lines.push(`- ${k.key} ${required}`);
     }
     lines.push("");
@@ -1434,7 +3686,10 @@ function openCodeConfigToSpec(config) {
     maxSteps: config.config?.max_steps ?? 10
   };
 }
-var init_agent_bridge = () => {};
+var init_agent_bridge = __esm(() => {
+  init_tool_bridge2();
+  init_i18n();
+});
 
 // src/providers/opencode-sdk/adapter.ts
 class OpenCodeSDKProvider {
@@ -1469,7 +3724,7 @@ class OpenCodeSDKProvider {
   }
   async createContext(spec) {
     if (!this.isAvailable()) {
-      throw new ProviderNotAvailableError(this.name, "SDK not installed");
+      throw new ProviderNotAvailableError(this.name, getDefaultI18n().t("error.provider.sdkNotInstalled"));
     }
     try {
       const sdk = await this.loadSDK();
@@ -1508,7 +3763,9 @@ class OpenCodeSDKProvider {
         }
       };
     } catch (error) {
-      throw new ContextCreationError(this.name, `Failed to create context: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+      throw new ContextCreationError(this.name, getDefaultI18n().t("error.provider.contextCreation", {
+        error: error instanceof Error ? error.message : String(error)
+      }), error instanceof Error ? error : undefined);
     }
   }
   async execute(context, params) {
@@ -1556,7 +3813,9 @@ ${params.systemOverride}` : context.spec.instructions;
         }
       };
     } catch (error) {
-      throw new ProviderExecutionError(this.name, `Execution failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+      throw new ProviderExecutionError(this.name, getDefaultI18n().t("error.provider.executionFailed", {
+        error: error instanceof Error ? error.message : String(error)
+      }), error instanceof Error ? error : undefined);
     }
   }
   async* stream(context, params) {
@@ -1642,7 +3901,9 @@ ${params.systemOverride}` : context.spec.instructions;
         }
       };
     } catch (error) {
-      throw new ProviderExecutionError(this.name, `Stream failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+      throw new ProviderExecutionError(this.name, getDefaultI18n().t("error.provider.streamFailed", {
+        error: error instanceof Error ? error.message : String(error)
+      }), error instanceof Error ? error : undefined);
     }
   }
   async loadSDK() {
@@ -1650,7 +3911,7 @@ ${params.systemOverride}` : context.spec.instructions;
       const module = __require("@opencode-ai/sdk");
       return module;
     } catch {
-      throw new ProviderNotAvailableError(this.name, "@opencode-ai/sdk is not installed");
+      throw new ProviderNotAvailableError(this.name, getDefaultI18n().t("error.provider.opencodeSdkMissing"));
     }
   }
   getHostname() {
@@ -1694,8 +3955,12 @@ ${params.systemOverride}` : context.spec.instructions;
   }
 }
 var init_adapter3 = __esm(() => {
+  init_spec();
   init_types();
+  init_tool_bridge2();
   init_agent_bridge();
+  init_injector();
+  init_i18n();
 });
 
 // src/providers/opencode-sdk/index.ts
@@ -1717,40 +3982,48 @@ __export(exports_opencode_sdk, {
 });
 var init_opencode_sdk = __esm(() => {
   init_adapter3();
+  init_tool_bridge2();
   init_agent_bridge();
 });
 
 // src/agent/json-runner.ts
+init_i18n();
 init_contract_spec_agent();
 import { createProvider } from "@contractspec/lib.ai-providers/factory";
 import { StabilityEnum } from "@contractspec/lib.contracts/ownership";
-var JSON_ONLY_RULES = [
-  "You MUST output valid JSON ONLY.",
-  "Do not wrap the output in markdown fences.",
-  "Do not include commentary or explanation.",
-  "Use double quotes for all keys and string values.",
-  "Do not include trailing commas."
-].join(`
+function getJsonOnlyRules(locale) {
+  const i18n = createAgentI18n(locale);
+  return [
+    i18n.t("agent.json.rules.validJsonOnly"),
+    i18n.t("agent.json.rules.noMarkdownFences"),
+    i18n.t("agent.json.rules.noCommentary"),
+    i18n.t("agent.json.rules.doubleQuotes"),
+    i18n.t("agent.json.rules.noTrailingCommas")
+  ].join(`
 `);
-var DEFAULT_SPEC = {
-  meta: {
-    key: "agent.json-runner",
-    version: "1.0.0",
-    description: "JSON-only agent runner for deterministic pipelines.",
-    stability: StabilityEnum.Experimental,
-    owners: ["platform.core"],
-    tags: ["json", "agent"]
-  },
-  instructions: "You are a precise JSON generator.",
-  tools: []
-};
+}
+function getDefaultSpec(locale) {
+  const i18n = createAgentI18n(locale);
+  return {
+    meta: {
+      key: "agent.json-runner",
+      version: "1.0.0",
+      description: i18n.t("agent.json.defaultDescription"),
+      stability: StabilityEnum.Experimental,
+      owners: ["platform.core"],
+      tags: ["json", "agent"]
+    },
+    instructions: i18n.t("agent.json.systemPrompt"),
+    tools: []
+  };
+}
 function resolveModel(options) {
   if (options.model)
     return options.model;
   if (options.provider) {
     return createProvider(options.provider).getModel();
   }
-  throw new Error("createAgentJsonRunner requires a model or provider config");
+  throw new Error(getDefaultI18n().t("error.jsonRunner.requiresModel"));
 }
 function applyModelSettings(model, settings) {
   const { temperature } = settings;
@@ -1762,15 +4035,15 @@ function applyModelSettings(model, settings) {
   }
   return model;
 }
-function buildInstructions(base, system) {
-  return [base, JSON_ONLY_RULES, system].filter(Boolean).join(`
+function buildInstructions(base, locale, system) {
+  return [base, getJsonOnlyRules(locale), system].filter(Boolean).join(`
 
 `);
 }
 function ensureToolHandlers(spec, handlers) {
   for (const tool3 of spec.tools) {
     if (!handlers.has(tool3.name)) {
-      throw new Error(`Missing handler for tool: ${tool3.name}`);
+      throw new Error(getDefaultI18n().t("error.missingToolHandler", { name: tool3.name }));
     }
   }
 }
@@ -1778,10 +4051,11 @@ async function createAgentJsonRunner(options) {
   const model = applyModelSettings(resolveModel(options), {
     temperature: options.temperature ?? 0
   });
-  const baseSpec = options.spec ?? DEFAULT_SPEC;
+  const baseSpec = options.spec ?? getDefaultSpec(options.locale);
   const spec = {
     ...baseSpec,
-    instructions: buildInstructions(baseSpec.instructions, options.system),
+    locale: options.spec?.locale ?? options.locale,
+    instructions: buildInstructions(baseSpec.instructions, options.locale, options.system),
     maxSteps: options.maxSteps ?? baseSpec.maxSteps
   };
   const toolHandlers = options.toolHandlers ?? new Map;
@@ -1800,6 +4074,7 @@ async function createAgentJsonRunner(options) {
 }
 
 // src/agent/unified-agent.ts
+init_i18n();
 import { createProvider as createProvider2 } from "@contractspec/lib.ai-providers/factory";
 
 class UnifiedAgent {
@@ -1833,12 +4108,17 @@ class UnifiedAgent {
           await this.initializeOpenCodeSDK();
           break;
         default:
-          throw new Error(`Unknown backend: ${backend}`);
+          throw new Error(getDefaultI18n().t("error.unknownBackend", {
+            backend: String(backend)
+          }));
       }
     } catch (error) {
       this.state.lastError = error instanceof Error ? error : new Error(String(error));
       if (this.config.fallbackBackend && this.config.fallbackBackend !== backend) {
-        console.warn(`[UnifiedAgent] ${backend} failed, falling back to ${this.config.fallbackBackend}`);
+        console.warn(getDefaultI18n().t("log.unifiedAgent.fallback", {
+          backend: String(backend),
+          fallback: String(this.config.fallbackBackend)
+        }));
         this.state.backend = this.config.fallbackBackend;
         await this.initialize();
       } else {
@@ -1852,13 +4132,13 @@ class UnifiedAgent {
       const config = this.config.config;
       this.provider = new ClaudeAgentSDKProvider2(config ?? {});
       if (!this.provider.isAvailable()) {
-        throw new Error("Claude Agent SDK not available. Install @anthropic-ai/claude-agent-sdk");
+        throw new Error(getDefaultI18n().t("error.claudeSdk.notAvailable"));
       }
       this.context = await this.provider.createContext(this.spec);
       this.state.isReady = true;
     } catch (error) {
       if (error.code === "MODULE_NOT_FOUND") {
-        throw new Error("Claude Agent SDK not installed. Run: npm install @anthropic-ai/claude-agent-sdk");
+        throw new Error(getDefaultI18n().t("error.claudeSdk.notInstalled"));
       }
       throw error;
     }
@@ -1869,13 +4149,13 @@ class UnifiedAgent {
       const config = this.config.config;
       this.provider = new OpenCodeSDKProvider2(config ?? {});
       if (!this.provider.isAvailable()) {
-        throw new Error("OpenCode SDK not available. Install @opencode-ai/sdk");
+        throw new Error(getDefaultI18n().t("error.opencodeSdk.notAvailable"));
       }
       this.context = await this.provider.createContext(this.spec);
       this.state.isReady = true;
     } catch (error) {
       if (error.code === "MODULE_NOT_FOUND") {
-        throw new Error("OpenCode SDK not installed. Run: npm install @opencode-ai/sdk");
+        throw new Error(getDefaultI18n().t("error.opencodeSdk.notInstalled"));
       }
       throw error;
     }
@@ -1894,7 +4174,9 @@ class UnifiedAgent {
         case "opencode-sdk":
           return await this.runWithExternalProvider(message, options);
         default:
-          throw new Error(`Unknown backend: ${backend}`);
+          throw new Error(getDefaultI18n().t("error.unknownBackend", {
+            backend: String(backend)
+          }));
       }
     } catch (error) {
       this.state.lastError = error instanceof Error ? error : new Error(String(error));
@@ -1916,7 +4198,7 @@ class UnifiedAgent {
   }
   async runWithExternalProvider(message, options) {
     if (!this.provider || !this.context) {
-      throw new Error("Provider not initialized");
+      throw new Error(getDefaultI18n().t("error.providerNotInitialized"));
     }
     const result = await this.provider.execute(this.context, {
       prompt: message,