@contractspec/lib.ai-agent 1.60.0 → 1.62.0

package/dist/node/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,
@@ -2093,6 +4375,7 @@ async function getAvailableBackends() {
 init_contract_spec_agent();
 
 // src/approval/workflow.ts
+init_i18n();
 import { randomUUID } from "node:crypto";
 
 class InMemoryApprovalStore {
@@ -2165,7 +4448,9 @@ class ApprovalWorkflow {
       toolName: toolCall.toolName,
       toolCallId: toolCall.toolCallId,
       toolArgs: toolCall.args,
-      reason: context.reason ?? `Tool "${toolCall.toolName}" requires approval`
+      reason: context.reason ?? getDefaultI18n().t("approval.toolRequiresApproval", {
+        name: toolCall.toolName
+      })
     });
   }
   async approve(id, reviewer, notes) {
@@ -2203,6 +4488,9 @@ function createApprovalWorkflow(store) {
   return new ApprovalWorkflow(store);
 }
 // src/exporters/claude-agent-exporter.ts
+init_spec();
+init_i18n();
+
 class ClaudeAgentExporter {
   format = "claude-agent";
   export(spec, options = {}) {
@@ -2221,22 +4509,23 @@ class ClaudeAgentExporter {
     return specs.map((spec) => this.export(spec, options));
   }
   validate(spec) {
+    const i18n = getDefaultI18n();
     const errors = [];
     if (!spec.meta?.key) {
-      errors.push("Spec must have a meta.key");
+      errors.push(i18n.t("export.validation.requiresKey"));
     }
     if (!spec.instructions) {
-      errors.push("Spec must have instructions");
+      errors.push(i18n.t("export.validation.requiresInstructions"));
     }
     if (!spec.tools || spec.tools.length === 0) {
-      errors.push("Spec must have at least one tool");
+      errors.push(i18n.t("export.validation.requiresTool"));
     }
     for (const tool3 of spec.tools ?? []) {
       if (!tool3.name) {
-        errors.push("All tools must have a name");
+        errors.push(i18n.t("export.validation.toolRequiresName"));
       }
       if (!tool3.description && !tool3.name) {
-        errors.push(`Tool must have a description or name`);
+        errors.push(i18n.t("export.validation.toolRequiresDescOrName"));
       }
     }
     return { valid: errors.length === 0, errors };
@@ -2260,11 +4549,12 @@ class ClaudeAgentExporter {
     return config;
   }
   buildSystemPrompt(spec, options) {
+    const i18n = getDefaultI18n();
     const parts = [];
     parts.push(spec.instructions);
     if (spec.knowledge && spec.knowledge.length > 0) {
       parts.push("");
-      parts.push("## Knowledge Sources");
+      parts.push(i18n.t("export.knowledgeSources"));
       for (const k of spec.knowledge) {
         if (k.instructions) {
           parts.push(`- ${k.key}: ${k.instructions}`);
@@ -2273,17 +4563,17 @@ class ClaudeAgentExporter {
     }
     if (spec.policy) {
       parts.push("");
-      parts.push("## Policy");
+      parts.push(i18n.t("export.policy"));
       if (spec.policy.confidence?.min) {
-        parts.push(`- Minimum confidence: ${spec.policy.confidence.min}`);
+        parts.push(i18n.t("export.minConfidence", { min: spec.policy.confidence.min }));
       }
       if (spec.policy.escalation) {
-        parts.push("- Escalation policy is configured");
+        parts.push(i18n.t("export.escalationConfigured"));
       }
     }
     if (options.metadata) {
       parts.push("");
-      parts.push("## Additional Context");
+      parts.push(i18n.t("export.additionalContext"));
       for (const [key, value] of Object.entries(options.metadata)) {
         parts.push(`- ${key}: ${String(value)}`);
       }
@@ -2292,9 +4582,10 @@ class ClaudeAgentExporter {
 `);
   }
   exportTools(spec) {
+    const i18n = getDefaultI18n();
     return spec.tools.map((tool3) => ({
       name: tool3.name,
-      description: tool3.description ?? `Execute ${tool3.name}`,
+      description: tool3.description ?? i18n.t("tool.fallbackDescription", { name: tool3.name }),
       input_schema: this.normalizeSchema(tool3.schema),
       requires_confirmation: tool3.requiresApproval ?? !tool3.automationSafe
     }));
@@ -2317,38 +4608,41 @@ class ClaudeAgentExporter {
     };
   }
   generateClaudeMd(spec, options) {
+    const i18n = getDefaultI18n();
     const lines = [];
-    lines.push("# Agent Configuration");
+    lines.push(i18n.t("export.agentConfiguration"));
     lines.push("");
     if (spec.description) {
       lines.push(`> ${spec.description}`);
       lines.push("");
     }
-    lines.push("## Metadata");
+    lines.push(i18n.t("export.metadata"));
     lines.push("");
-    lines.push(`- **Name**: ${spec.meta.key}`);
-    lines.push(`- **Version**: ${spec.meta.version}`);
+    lines.push(i18n.t("export.metaName", { name: spec.meta.key }));
+    lines.push(i18n.t("export.metaVersion", { version: spec.meta.version }));
     if (spec.meta.owners && spec.meta.owners.length > 0) {
-      lines.push(`- **Owners**: ${spec.meta.owners.join(", ")}`);
+      lines.push(i18n.t("export.metaOwners", {
+        owners: spec.meta.owners.join(", ")
+      }));
     }
     if (options.model) {
-      lines.push(`- **Model**: ${options.model}`);
+      lines.push(i18n.t("export.metaModel", { model: options.model }));
     }
     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("## Available Tools");
+      lines.push(i18n.t("export.availableTools"));
       lines.push("");
       for (const tool3 of spec.tools) {
         const flags = [];
         if (tool3.requiresApproval) {
-          flags.push("requires approval");
+          flags.push(i18n.t("export.requiresApproval"));
         }
         if (tool3.automationSafe === false) {
-          flags.push("not automation safe");
+          flags.push(i18n.t("export.notAutomationSafe"));
         }
         const flagStr = flags.length > 0 ? ` (${flags.join(", ")})` : "";
         lines.push(`### ${tool3.name}${flagStr}`);
@@ -2358,7 +4652,7 @@ class ClaudeAgentExporter {
           lines.push("");
         }
         if (tool3.schema) {
-          lines.push("**Parameters:**");
+          lines.push(i18n.t("export.parameters"));
           lines.push("```json");
           lines.push(JSON.stringify(tool3.schema, null, 2));
           lines.push("```");
@@ -2367,10 +4661,10 @@ class ClaudeAgentExporter {
       }
     }
     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}`);
         if (k.instructions) {
           lines.push(`  - ${k.instructions}`);
@@ -2379,21 +4673,23 @@ class ClaudeAgentExporter {
       lines.push("");
     }
     if (spec.policy) {
-      lines.push("## Policy");
+      lines.push(i18n.t("export.policy"));
       lines.push("");
       if (spec.policy.confidence?.min) {
-        lines.push(`- Minimum confidence: ${spec.policy.confidence.min}`);
+        lines.push(i18n.t("export.minConfidence", { min: spec.policy.confidence.min }));
       }
       if (spec.policy.escalation) {
-        lines.push("- Escalation policy configured");
+        lines.push(i18n.t("export.escalationPolicyConfigured"));
       }
       if (spec.policy.flags && spec.policy.flags.length > 0) {
-        lines.push(`- Feature flags: ${spec.policy.flags.join(", ")}`);
+        lines.push(i18n.t("export.featureFlags", {
+          flags: spec.policy.flags.join(", ")
+        }));
       }
       lines.push("");
     }
     if (options.mcpServers && options.mcpServers.length > 0) {
-      lines.push("## MCP Servers");
+      lines.push(i18n.t("export.mcpServers"));
       lines.push("");
       for (const server of options.mcpServers) {
         lines.push(`- **${server.name}**: \`${server.command}${server.args ? " " + server.args.join(" ") : ""}\``);
@@ -2402,7 +4698,7 @@ class ClaudeAgentExporter {
     }
     lines.push("---");
     lines.push("");
-    lines.push(`*Generated from ContractSpec: ${agentKey(spec.meta)}*`);
+    lines.push(i18n.t("export.generatedFrom", { key: agentKey(spec.meta) }));
     return lines.join(`
 `);
   }
@@ -2421,7 +4717,9 @@ function validateForClaudeAgent(spec) {
   return exporter.validate(spec);
 }
 // src/exporters/opencode-exporter.ts
+init_spec();
 init_agent_bridge();
+init_i18n();
 
 class OpenCodeExporter {
   format = "opencode";
@@ -2439,19 +4737,20 @@ class OpenCodeExporter {
     return specs.map((spec) => this.export(spec, options));
   }
   validate(spec) {
+    const i18n = getDefaultI18n();
     const errors = [];
     if (!spec.meta?.key) {
-      errors.push("Spec must have a meta.key");
+      errors.push(i18n.t("export.validation.requiresKey"));
     }
     if (!spec.instructions) {
-      errors.push("Spec must have instructions");
+      errors.push(i18n.t("export.validation.requiresInstructions"));
     }
     for (const tool3 of spec.tools ?? []) {
       if (!tool3.name) {
-        errors.push("All tools must have a name");
+        errors.push(i18n.t("export.validation.toolRequiresName"));
       }
       if (tool3.name && !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(tool3.name)) {
-        errors.push(`Tool name '${tool3.name}' should be a valid identifier (letters, numbers, underscores)`);
+        errors.push(i18n.t("export.validation.toolInvalidName", { name: tool3.name }));
       }
     }
     return { valid: errors.length === 0, errors };
@@ -2473,14 +4772,16 @@ class OpenCodeExporter {
     };
   }
   exportTools(spec) {
+    const i18n = getDefaultI18n();
     return spec.tools.map((tool3) => ({
       name: tool3.name,
-      description: tool3.description ?? `Execute ${tool3.name}`,
+      description: tool3.description ?? i18n.t("tool.fallbackDescription", { name: tool3.name }),
       schema: tool3.schema ?? { type: "object" },
       requires_approval: tool3.requiresApproval ?? !tool3.automationSafe
     }));
   }
   generateMarkdown(spec, jsonConfig, options) {
+    const i18n = getDefaultI18n();
     const lines = [];
     lines.push("---");
     lines.push(`name: ${jsonConfig.name}`);
@@ -2500,7 +4801,7 @@ class OpenCodeExporter {
     if (jsonConfig.tools.length > 0) {
       lines.push("tools:");
       for (const tool3 of jsonConfig.tools) {
-        const permission = tool3.requires_approval ? " # requires approval" : "";
+        const permission = tool3.requires_approval ? ` # ${i18n.t("export.requiresApproval")}` : "";
         lines.push(`  - ${tool3.name}${permission}`);
       }
     }
@@ -2512,20 +4813,20 @@ class OpenCodeExporter {
       lines.push(spec.description);
       lines.push("");
     }
-    lines.push(`> Agent type: **${jsonConfig.type}**`);
+    lines.push(i18n.t("export.agentType", { type: jsonConfig.type }));
     lines.push("");
     lines.push(this.getAgentTypeDescription(jsonConfig.type));
     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 approval = tool3.requiresApproval ? " *(requires approval)*" : "";
-        const safe = tool3.automationSafe === false ? " *(not automation safe)*" : "";
+        const approval = tool3.requiresApproval ? ` ${i18n.t("export.requiresApprovalMd")}` : "";
+        const safe = tool3.automationSafe === false ? ` ${i18n.t("export.notAutomationSafeMd")}` : "";
         lines.push(`### ${tool3.name}${approval}${safe}`);
         lines.push("");
         if (tool3.description) {
@@ -2533,7 +4834,7 @@ class OpenCodeExporter {
           lines.push("");
         }
         if (tool3.schema && options.includeComments !== false) {
-          lines.push("**Parameters:**");
+          lines.push(i18n.t("export.parameters"));
           lines.push("");
           lines.push("```json");
           lines.push(JSON.stringify(tool3.schema, null, options.prettyPrint !== false ? 2 : 0));
@@ -2543,10 +4844,10 @@ class OpenCodeExporter {
       }
     }
     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}`);
         if (k.instructions) {
           lines.push(`  - ${k.instructions}`);
@@ -2555,17 +4856,17 @@ class OpenCodeExporter {
       lines.push("");
     }
     if (spec.policy) {
-      lines.push("## Policy");
+      lines.push(i18n.t("export.policy"));
       lines.push("");
       if (spec.policy.confidence?.min) {
-        lines.push(`- Minimum confidence: ${spec.policy.confidence.min}`);
+        lines.push(i18n.t("export.minConfidence", { min: spec.policy.confidence.min }));
       }
       if (spec.policy.escalation) {
-        lines.push("- Escalation policy configured");
+        lines.push(i18n.t("export.escalationPolicyConfigured"));
       }
       lines.push("");
     }
-    lines.push("## Configuration");
+    lines.push(i18n.t("export.configuration"));
     lines.push("");
     lines.push("```json");
     lines.push(JSON.stringify(jsonConfig.config, null, options.prettyPrint !== false ? 2 : 0));
@@ -2573,21 +4874,22 @@ class OpenCodeExporter {
     lines.push("");
     lines.push("---");
     lines.push("");
-    lines.push(`*Generated from ContractSpec: ${agentKey(spec.meta)}*`);
-    lines.push(`*Exported at: ${new Date().toISOString()}*`);
+    lines.push(i18n.t("export.generatedFrom", { key: agentKey(spec.meta) }));
+    lines.push(i18n.t("export.exportedAt", { date: new Date().toISOString() }));
     return lines.join(`
 `);
   }
   getAgentTypeDescription(type) {
+    const i18n = getDefaultI18n();
     switch (type) {
       case "build":
-        return "Primary agent with full tool access for code generation and modification.";
+        return i18n.t("export.agentType.build");
       case "plan":
-        return "Restricted agent for analysis and planning. File edits and bash commands require approval.";
+        return i18n.t("export.agentType.plan");
       case "general":
-        return "General-purpose subagent for complex questions and multi-step tasks.";
+        return i18n.t("export.agentType.general");
       case "explore":
-        return "Fast subagent optimized for codebase exploration and pattern searching.";
+        return i18n.t("export.agentType.explore");
       default:
         return "";
     }
@@ -2612,6 +4914,7 @@ function validateForOpenCode(spec) {
   return exporter.validate(spec);
 }
 // src/spec/registry.ts
+init_i18n();
 import { compareVersions } from "compare-versions";
 import { SpecContractRegistry } from "@contractspec/lib.contracts/registry";
 
@@ -2629,7 +4932,9 @@ class AgentRegistry extends SpecContractRegistry {
   require(name, version) {
     const spec = this.get(name, version);
     if (!spec) {
-      throw new Error(`Agent spec not found for ${name}${version != null ? `.v${version}` : ""}`);
+      throw new Error(getDefaultI18n().t("error.agentSpecNotFound", {
+        name: `${name}${version != null ? `.v${version}` : ""}`
+      }));
     }
     return spec;
   }
@@ -2649,6 +4954,9 @@ class AgentRegistry extends SpecContractRegistry {
 function createAgentRegistry() {
   return new AgentRegistry;
 }
+
+// src/spec/index.ts
+init_spec();
 // src/tools/mcp-client.ts
 import { experimental_createMCPClient } from "@ai-sdk/mcp";
 import { Experimental_StdioMCPTransport as StdioClientTransport } from "@ai-sdk/mcp/mcp-stdio";
@@ -2681,18 +4989,20 @@ async function createMcpToolsets(configs) {
 
 // src/tools/mcp-server.ts
 init_json_schema_to_zod();
+init_i18n();
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import * as z4 from "zod";
 function agentToMcpServer(agent, spec2) {
+  const i18n = createAgentI18n();
   const server = new McpServer({
     name: spec2.meta.key,
     version: `${spec2.meta.version}`
   });
   server.registerTool(spec2.meta.key, {
-    description: spec2.description ?? `Interact with ${spec2.meta.key} agent`,
+    description: spec2.description ?? i18n.t("tool.mcp.agentDescription", { key: spec2.meta.key }),
     inputSchema: z4.object({
-      message: z4.string().describe("The message or query to send to the agent"),
-      sessionId: z4.string().optional().describe("Optional session ID to continue a conversation")
+      message: z4.string().describe(i18n.t("tool.mcp.param.message")),
+      sessionId: z4.string().optional().describe(i18n.t("tool.mcp.param.sessionId"))
     })
   }, async (args) => {
     const { message, sessionId } = args;
@@ -2712,11 +5022,14 @@ function agentToMcpServer(agent, spec2) {
   for (const toolConfig of spec2.tools) {
     const inputSchema = toolConfig.schema ? jsonSchemaToZodSafe(toolConfig.schema) : z4.object({});
     server.registerTool(`${spec2.meta.key}.${toolConfig.name}`, {
-      description: toolConfig.description ?? `Execute ${toolConfig.name} tool`,
+      description: toolConfig.description ?? i18n.t("tool.mcp.toolDescription", { name: toolConfig.name }),
       inputSchema
     }, async (args) => {
       const result = await agent.generate({
-        prompt: `Execute the ${toolConfig.name} tool with the following arguments: ${JSON.stringify(args)}`
+        prompt: i18n.t("tool.mcp.executePrompt", {
+          name: toolConfig.name,
+          args: JSON.stringify(args)
+        })
       });
       return {
         content: [
@@ -2776,11 +5089,15 @@ var SchemaOutput = {
 
 // src/schema/index.ts
 init_json_schema_to_zod();
+
+// src/knowledge/index.ts
+init_injector();
 // src/telemetry/index.ts
 init_adapter();
 
 // src/providers/registry.ts
 init_types();
+init_i18n();
 
 class InMemoryProviderRegistry {
   providers = new Map;
@@ -2800,10 +5117,10 @@ class InMemoryProviderRegistry {
   require(name) {
     const provider = this.providers.get(name);
     if (!provider) {
-      throw new ProviderNotAvailableError(name, "not registered");
+      throw new ProviderNotAvailableError(name, getDefaultI18n().t("error.provider.notRegistered"));
     }
     if (!provider.isAvailable()) {
-      throw new ProviderNotAvailableError(name, "dependencies not installed or not configured");
+      throw new ProviderNotAvailableError(name, getDefaultI18n().t("error.provider.depsNotInstalled"));
     }
     return provider;
   }
@@ -2821,6 +5138,9 @@ init_claude_agent_sdk();
 init_opencode_sdk();
 init_types();
 // src/interop/spec-consumer.ts
+init_spec();
+init_i18n();
+
 class ContractSpecConsumer {
   specs;
   includeMetadata;
@@ -2837,8 +5157,9 @@ class ContractSpecConsumer {
   getSpecMarkdown(specKey, options) {
     const spec2 = this.specs.get(specKey);
     if (!spec2) {
-      throw new Error(`Spec not found: ${specKey}`);
+      throw new Error(getDefaultI18n().t("error.specNotFound", { specKey }));
     }
+    const i18n = getDefaultI18n();
     const sections = [];
     const opts = {
       includeToc: options?.includeToc ?? true,
@@ -2857,7 +5178,7 @@ class ContractSpecConsumer {
       sections.push("");
     }
     if (opts.includeToc) {
-      sections.push("## Table of Contents");
+      sections.push(i18n.t("interop.md.toc"));
       sections.push("");
       sections.push("- [Overview](#overview)");
       sections.push("- [Instructions](#instructions)");
@@ -2869,28 +5190,32 @@ class ContractSpecConsumer {
       }
       sections.push("");
     }
-    sections.push("## Overview");
+    sections.push(i18n.t("interop.md.overview"));
     sections.push("");
     if (this.includeMetadata) {
-      sections.push(`- **Key**: \`${spec2.meta.key}\``);
-      sections.push(`- **Version**: ${spec2.meta.version}`);
+      sections.push(i18n.t("interop.md.metaKey", { key: spec2.meta.key }));
+      sections.push(i18n.t("interop.md.metaVersion", { version: spec2.meta.version }));
       if (spec2.meta.stability) {
-        sections.push(`- **Stability**: ${spec2.meta.stability}`);
+        sections.push(i18n.t("interop.md.metaStability", {
+          stability: spec2.meta.stability
+        }));
       }
       if (spec2.meta.owners && spec2.meta.owners.length > 0) {
-        sections.push(`- **Owners**: ${spec2.meta.owners.join(", ")}`);
+        sections.push(i18n.t("interop.md.metaOwners", {
+          owners: spec2.meta.owners.join(", ")
+        }));
       }
       if (spec2.tags && spec2.tags.length > 0) {
-        sections.push(`- **Tags**: ${spec2.tags.join(", ")}`);
+        sections.push(i18n.t("interop.md.metaTags", { tags: spec2.tags.join(", ") }));
       }
     }
     sections.push("");
-    sections.push("## Instructions");
+    sections.push(i18n.t("interop.prompt.instructions"));
     sections.push("");
     sections.push(spec2.instructions);
     sections.push("");
     if (opts.includeTools && spec2.tools && spec2.tools.length > 0) {
-      sections.push("## Tools");
+      sections.push(i18n.t("interop.md.tools"));
       sections.push("");
       for (const tool3 of spec2.tools) {
         sections.push(`### ${tool3.name}`);
@@ -2900,7 +5225,7 @@ class ContractSpecConsumer {
           sections.push("");
         }
         if (tool3.schema) {
-          sections.push("**Schema:**");
+          sections.push(i18n.t("interop.md.schema"));
           sections.push("");
           sections.push("```json");
           sections.push(JSON.stringify(tool3.schema, null, 2));
@@ -2908,16 +5233,19 @@ class ContractSpecConsumer {
           sections.push("");
         }
         if (tool3.automationSafe !== undefined) {
-          sections.push(`**Automation Safe**: ${tool3.automationSafe ? "Yes" : "No"}`);
+          sections.push(i18n.t("interop.md.automationSafe", {
+            value: tool3.automationSafe ? i18n.t("interop.md.yes") : i18n.t("interop.md.no")
+          }));
           sections.push("");
         }
       }
     }
     if (spec2.knowledge && spec2.knowledge.length > 0) {
-      sections.push("## Knowledge");
+      sections.push(i18n.t("interop.md.knowledge"));
       sections.push("");
       for (const k of spec2.knowledge) {
-        sections.push(`- **${k.key}**${k.required ? " (required)" : ""}`);
+        const marker = k.required ? ` ${i18n.t("interop.md.required")}` : "";
+        sections.push(`- **${k.key}**${marker}`);
         if (k.instructions) {
           sections.push(`  - ${k.instructions}`);
         }
@@ -2925,21 +5253,25 @@ class ContractSpecConsumer {
       sections.push("");
     }
     if (spec2.policy) {
-      sections.push("## Policy");
+      sections.push(i18n.t("interop.md.policy"));
       sections.push("");
       if (spec2.policy.confidence) {
-        sections.push(`- **Minimum Confidence**: ${spec2.policy.confidence.min ?? 0.7}`);
+        sections.push(i18n.t("interop.md.minConfidence", {
+          min: spec2.policy.confidence.min ?? 0.7
+        }));
       }
       if (spec2.policy.escalation) {
         const esc = spec2.policy.escalation;
         if (esc.confidenceThreshold) {
-          sections.push(`- **Escalation Threshold**: ${esc.confidenceThreshold}`);
+          sections.push(i18n.t("interop.md.escalationThreshold", {
+            threshold: esc.confidenceThreshold
+          }));
         }
         if (esc.onToolFailure) {
-          sections.push("- **Escalate on Tool Failure**: Yes");
+          sections.push(i18n.t("interop.md.escalateToolFailure"));
         }
         if (esc.onTimeout) {
-          sections.push("- **Escalate on Timeout**: Yes");
+          sections.push(i18n.t("interop.md.escalateTimeout"));
         }
       }
       sections.push("");
@@ -2950,32 +5282,36 @@ class ContractSpecConsumer {
   getSpecPrompt(specKey, options) {
     const spec2 = this.specs.get(specKey);
     if (!spec2) {
-      throw new Error(`Spec not found: ${specKey}`);
+      throw new Error(getDefaultI18n().t("error.specNotFound", { specKey }));
     }
+    const i18n = getDefaultI18n();
     const sections = [];
     const opts = {
       includeTools: options?.includeTools ?? true,
       format: options?.format ?? "structured",
       ...options
     };
-    sections.push("# Agent Identity");
+    sections.push(i18n.t("interop.prompt.agentIdentity"));
     sections.push("");
-    sections.push(`You are ${spec2.meta.key} (v${spec2.meta.version}).`);
+    sections.push(i18n.t("interop.prompt.youAre", {
+      key: spec2.meta.key,
+      version: spec2.meta.version
+    }));
     sections.push("");
     if (spec2.description) {
-      sections.push("## Description");
+      sections.push(i18n.t("interop.prompt.description"));
       sections.push("");
       sections.push(spec2.description);
       sections.push("");
     }
-    sections.push("## Instructions");
+    sections.push(i18n.t("interop.prompt.instructions"));
     sections.push("");
     sections.push(spec2.instructions);
     sections.push("");
     if (opts.includeTools && spec2.tools && spec2.tools.length > 0) {
-      sections.push("## Available Tools");
+      sections.push(i18n.t("interop.prompt.availableTools"));
       sections.push("");
-      sections.push("You have access to the following tools:");
+      sections.push(i18n.t("interop.prompt.toolsIntro"));
       sections.push("");
       for (const tool3 of spec2.tools) {
         sections.push(`### ${tool3.name}`);
@@ -2985,7 +5321,7 @@ class ContractSpecConsumer {
           sections.push("");
         }
         if (tool3.schema && opts.format === "structured") {
-          sections.push("Parameters:");
+          sections.push(i18n.t("interop.prompt.parameters"));
           sections.push("```json");
           sections.push(JSON.stringify(tool3.schema, null, 2));
           sections.push("```");
@@ -2996,7 +5332,7 @@ class ContractSpecConsumer {
     if (spec2.knowledge && spec2.knowledge.length > 0) {
       const requiredKnowledge = spec2.knowledge.filter((k) => k.required);
       if (requiredKnowledge.length > 0) {
-        sections.push("## Knowledge Context");
+        sections.push(i18n.t("interop.prompt.knowledgeContext"));
         sections.push("");
         for (const k of requiredKnowledge) {
           if (k.instructions) {
@@ -3007,7 +5343,7 @@ class ContractSpecConsumer {
       }
     }
     if (options?.customContext) {
-      sections.push("## Additional Context");
+      sections.push(i18n.t("interop.prompt.additionalContext"));
       sections.push("");
       sections.push(options.customContext);
       sections.push("");
@@ -3083,6 +5419,10 @@ function createSingleSpecConsumer(spec2, options) {
 }
 
 // src/interop/tool-consumer.ts
+init_tool_bridge();
+init_tool_bridge2();
+init_i18n();
+
 class MCPToolServer {
   tools;
   name;
@@ -3101,14 +5441,18 @@ class MCPToolServer {
       return;
     }
     this.running = true;
-    console.log(`[MCPToolServer] Started ${this.name}@${this.version} with ${this.tools.size} tools`);
+    console.log(getDefaultI18n().t("log.mcpServer.started", {
+      name: this.name,
+      version: this.version,
+      count: this.tools.size
+    }));
   }
   async stop() {
     if (!this.running) {
       return;
     }
     this.running = false;
-    console.log(`[MCPToolServer] Stopped ${this.name}`);
+    console.log(getDefaultI18n().t("log.mcpServer.stopped", { name: this.name }));
   }
   isRunning() {
     return this.running;
@@ -3119,10 +5463,10 @@ class MCPToolServer {
   async executeTool(toolName, args, context) {
     const tool3 = this.tools.get(toolName);
     if (!tool3) {
-      throw new Error(`Tool not found: ${toolName}`);
+      throw new Error(getDefaultI18n().t("error.toolNotFound", { name: toolName }));
     }
     if (!tool3.handler) {
-      throw new Error(`No handler registered for tool: ${toolName}`);
+      throw new Error(getDefaultI18n().t("error.noHandlerForTool", { name: toolName }));
     }
     const fullContext = {
       agentId: context?.agentId ?? "mcp-server",
@@ -3199,7 +5543,7 @@ class ContractSpecToolConsumer {
           }
         }));
       default:
-        throw new Error(`Unknown export format: ${format}`);
+        throw new Error(getDefaultI18n().t("error.unknownExportFormat", { format }));
     }
   }
   createBridgedHandler(toolName, _format) {
@@ -3228,10 +5572,10 @@ class ContractSpecToolConsumer {
   async executeTool(name, args, context) {
     const tool3 = this.tools.get(name);
     if (!tool3) {
-      throw new Error(`Tool not found: ${name}`);
+      throw new Error(getDefaultI18n().t("error.toolNotFound", { name }));
     }
     if (!tool3.handler) {
-      throw new Error(`No handler for tool: ${name}`);
+      throw new Error(getDefaultI18n().t("error.noToolHandler", { name }));
     }
     const fullContext = {
       agentId: context?.agentId ?? "consumer",
@@ -3266,6 +5610,7 @@ function exportToolsForExternalSDK(tools, format) {
   return consumer.exportToolsForSDK(format);
 }
 // src/index.ts
+init_i18n();
 import { Experimental_Agent } from "ai";
 export {
   zodToOutput,
@@ -3275,22 +5620,29 @@ export {
   textOutput,
   specToolsToAISDKTools,
   specToolToAISDKTool,
+  resolveLocale,
+  resetI18nRegistry,
   noopTelemetryCollector,
   mcpServerToTools,
   jsonSchemaToZodSafe,
   jsonSchemaToZod,
   jsonSchemaToOutput,
   jsonSchemaToArrayOutput,
+  isSupportedLocale,
   injectStaticKnowledge,
+  getDefaultI18n,
   getAvailableBackends,
   generateSessionId,
   generateOpenCodeMarkdown,
   generateOpenCodeJSON,
   generateClaudeMd,
+  frMessages,
   exportToolsForExternalSDK,
   exportToOpenCode,
   exportToClaudeAgent,
+  esMessages,
   enumToChoiceOutput,
+  enMessages,
   defineAgent,
   defaultProviderRegistry,
   createUnifiedAgent,
@@ -3300,38 +5652,55 @@ export {
   createSpecConsumer,
   createSingleSpecConsumer,
   createProviderRegistry,
+  createPostHogTracedModel,
+  createPostHogTelemetryCollector,
   createOpenCodeSDKAgent,
   createMcpToolsets,
   createKnowledgeQueryTool,
   createKnowledgeInjector,
   createInMemoryTelemetryCollector,
   createInMemorySessionStore,
+  createCompositeTelemetryCollector,
   createClaudeAgentSDKAgent,
   createApprovalWorkflow,
   createAgentRegistry,
   createAgentMcpServer,
   createAgentJsonRunner,
+  createAgentI18n,
   createAISDKAgent,
   buildToolHandlers,
   agentToMcpServer,
   agentKey,
   UnifiedAgent,
   Experimental_Agent as ToolLoopAgent,
+  TOOL_KEYS,
   SchemaOutput,
+  SUPPORTED_LOCALES,
   ProviderNotAvailableError,
   ProviderExecutionError,
+  PostHogTelemetryCollector,
   OpenCodeSDKProvider,
   OpenCodeExporter,
+  LOG_KEYS,
+  KNOWLEDGE_KEYS,
   InMemoryTelemetryCollector,
   InMemorySessionStore,
   InMemoryApprovalStore,
+  INTEROP_KEYS,
+  I18N_KEYS,
   ExternalProviderError,
+  EXPORT_KEYS,
+  ERROR_KEYS,
+  DEFAULT_LOCALE,
   ContractSpecToolConsumer,
   ContractSpecConsumer,
   ContractSpecAgent,
   ContextCreationError,
+  CompositeTelemetryCollector,
   ClaudeAgentSDKProvider,
   ClaudeAgentExporter,
   ApprovalWorkflow,
-  AgentRegistry
+  AgentRegistry,
+  APPROVAL_KEYS,
+  AGENT_KEYS
 };