@contractspec/lib.ai-agent 2.3.0 → 2.5.0

package/dist/i18n/catalogs/index.js

@@ -603,6 +603,26 @@ var init_en = __esm(() => {
         value: "[MCPToolServer] Stopped {name}",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics requires @posthog/ai to be installed. Run: npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics requires either a client instance or an apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics requires posthog-node to be installed. Run: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Provider '{provider}' is not available{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", type: "string" }
+        ]
       }
     }
   });
@@ -1214,6 +1234,26 @@ var init_fr = __esm(() => {
         value: "[MCPToolServer] {name} arr\xEAt\xE9",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite l'installation de @posthog/ai. Ex\xE9cutez : npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite soit une instance client, soit une apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite l'installation de posthog-node. Ex\xE9cutez : npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Le fournisseur \xAB {provider} \xBB n'est pas disponible{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", type: "string" }
+        ]
       }
     }
   });
@@ -1859,6 +1899,26 @@ var init_es = __esm(() => {
         value: "[MCPToolServer] Detenido {name}",
         description: "Mensaje de registro cuando el servidor de herramientas MCP se detiene",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics requiere que @posthog/ai est\xE9 instalado. Ejecute: npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics requiere una instancia de cliente o una apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics requiere que posthog-node est\xE9 instalado. Ejecute: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "El proveedor '{provider}' no est\xE1 disponible{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", type: "string" }
+        ]
       }
     }
   });

package/dist/i18n/index.js

@@ -603,6 +603,26 @@ var init_en = __esm(() => {
         value: "[MCPToolServer] Stopped {name}",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics requires @posthog/ai to be installed. Run: npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics requires either a client instance or an apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics requires posthog-node to be installed. Run: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Provider '{provider}' is not available{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", type: "string" }
+        ]
       }
     }
   });
@@ -1214,6 +1234,26 @@ var init_fr = __esm(() => {
         value: "[MCPToolServer] {name} arr\xEAt\xE9",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite l'installation de @posthog/ai. Ex\xE9cutez : npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite soit une instance client, soit une apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite l'installation de posthog-node. Ex\xE9cutez : npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Le fournisseur \xAB {provider} \xBB n'est pas disponible{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", type: "string" }
+        ]
       }
     }
   });
@@ -1859,78 +1899,58 @@ var init_es = __esm(() => {
         value: "[MCPToolServer] Detenido {name}",
         description: "Mensaje de registro cuando el servidor de herramientas MCP se detiene",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics requiere que @posthog/ai est\xE9 instalado. Ejecute: npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics requiere una instancia de cliente o una apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics requiere que posthog-node est\xE9 instalado. Ejecute: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "El proveedor '{provider}' no est\xE1 disponible{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", 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-spec/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;
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+var factory, createAgentI18n, getDefaultI18n, resetI18nRegistry;
 var init_messages = __esm(() => {
   init_en();
   init_fr();
   init_es();
-  init_locale();
+  factory = createI18nFactory({
+    specKey: "ai-agent.messages",
+    catalogs: [enMessages, frMessages, esMessages]
+  });
+  createAgentI18n = factory.create;
+  getDefaultI18n = factory.getDefault;
+  resetI18nRegistry = factory.resetRegistry;
 });
 
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+var init_locale = () => {};
+
 // src/i18n/keys.ts
 var AGENT_KEYS, KNOWLEDGE_KEYS, TOOL_KEYS, INTEROP_KEYS, ERROR_KEYS, EXPORT_KEYS, APPROVAL_KEYS, LOG_KEYS, I18N_KEYS;
 var init_keys = __esm(() => {
@@ -2025,7 +2045,11 @@ var init_keys = __esm(() => {
     "error.provider.sdkNotInstalled": "error.provider.sdkNotInstalled",
     "error.provider.contextCreation": "error.provider.contextCreation",
     "error.provider.executionFailed": "error.provider.executionFailed",
-    "error.provider.streamFailed": "error.provider.streamFailed"
+    "error.provider.streamFailed": "error.provider.streamFailed",
+    "error.provider.notAvailable": "error.provider.notAvailable",
+    "error.telemetry.posthogAiRequired": "error.telemetry.posthogAiRequired",
+    "error.telemetry.posthogClientOrKeyRequired": "error.telemetry.posthogClientOrKeyRequired",
+    "error.telemetry.posthogNodeRequired": "error.telemetry.posthogNodeRequired"
   };
   EXPORT_KEYS = {
     "export.agentConfiguration": "export.agentConfiguration",

package/dist/i18n/keys.d.ts

@@ -181,6 +181,14 @@ export declare const ERROR_KEYS: {
     readonly 'error.provider.executionFailed': "error.provider.executionFailed";
     /** "Stream failed: {error}" */
     readonly 'error.provider.streamFailed': "error.provider.streamFailed";
+    /** "Provider '{provider}' is not available: {reason}" */
+    readonly 'error.provider.notAvailable': "error.provider.notAvailable";
+    /** "PostHog LLM Analytics requires @posthog/ai to be installed." */
+    readonly 'error.telemetry.posthogAiRequired': "error.telemetry.posthogAiRequired";
+    /** "PostHog LLM Analytics requires either a client instance or an apiKey." */
+    readonly 'error.telemetry.posthogClientOrKeyRequired': "error.telemetry.posthogClientOrKeyRequired";
+    /** "PostHog LLM Analytics requires posthog-node to be installed." */
+    readonly 'error.telemetry.posthogNodeRequired': "error.telemetry.posthogNodeRequired";
 };
 export declare const EXPORT_KEYS: {
     /** "# Agent Configuration" */
@@ -443,6 +451,14 @@ export declare const I18N_KEYS: {
     readonly 'error.provider.executionFailed': "error.provider.executionFailed";
     /** "Stream failed: {error}" */
     readonly 'error.provider.streamFailed': "error.provider.streamFailed";
+    /** "Provider '{provider}' is not available: {reason}" */
+    readonly 'error.provider.notAvailable': "error.provider.notAvailable";
+    /** "PostHog LLM Analytics requires @posthog/ai to be installed." */
+    readonly 'error.telemetry.posthogAiRequired': "error.telemetry.posthogAiRequired";
+    /** "PostHog LLM Analytics requires either a client instance or an apiKey." */
+    readonly 'error.telemetry.posthogClientOrKeyRequired': "error.telemetry.posthogClientOrKeyRequired";
+    /** "PostHog LLM Analytics requires posthog-node to be installed." */
+    readonly 'error.telemetry.posthogNodeRequired': "error.telemetry.posthogNodeRequired";
     /** "# Agent Identity" */
     readonly 'interop.prompt.agentIdentity': "interop.prompt.agentIdentity";
     /** "You are {key} (v{version})." */

package/dist/i18n/keys.js

@@ -106,7 +106,11 @@ var init_keys = __esm(() => {
     "error.provider.sdkNotInstalled": "error.provider.sdkNotInstalled",
     "error.provider.contextCreation": "error.provider.contextCreation",
     "error.provider.executionFailed": "error.provider.executionFailed",
-    "error.provider.streamFailed": "error.provider.streamFailed"
+    "error.provider.streamFailed": "error.provider.streamFailed",
+    "error.provider.notAvailable": "error.provider.notAvailable",
+    "error.telemetry.posthogAiRequired": "error.telemetry.posthogAiRequired",
+    "error.telemetry.posthogClientOrKeyRequired": "error.telemetry.posthogClientOrKeyRequired",
+    "error.telemetry.posthogNodeRequired": "error.telemetry.posthogNodeRequired"
   };
   EXPORT_KEYS = {
     "export.agentConfiguration": "export.agentConfiguration",

package/dist/i18n/locale.d.ts

@@ -1,33 +1,8 @@
 /**
- * Locale resolution and configuration for the ai-agent i18n system.
+ * Locale utilities for the ai-agent package.
  *
- * Locale priority: runtime override > spec-level > DEFAULT_LOCALE
+ * Re-exported from the shared i18n factory in contracts-spec.
  *
  * @module i18n/locale
  */
-/** Default locale when none is specified */
-export declare const DEFAULT_LOCALE = "en";
-/** Supported locales shipped with the ai-agent package */
-export declare const SUPPORTED_LOCALES: readonly ["en", "fr", "es"];
-/** Type for supported locales */
-export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
-/**
- * Resolve the effective locale from spec-level and runtime overrides.
- *
- * Priority (highest wins):
- *   1. runtimeLocale (from AgentCallOptions.locale)
- *   2. specLocale    (from AgentSpec.locale)
- *   3. DEFAULT_LOCALE ("en")
- *
- * If the resolved locale is not in SUPPORTED_LOCALES, falls back
- * to the base language (e.g., "fr-CA" -> "fr") or DEFAULT_LOCALE.
- *
- * @param specLocale    - Locale from the agent spec definition
- * @param runtimeLocale - Locale override passed at execution time
- * @returns The effective locale string
- */
-export declare function resolveLocale(specLocale?: string, runtimeLocale?: string): string;
-/**
- * Check if a locale string is one of the supported locales.
- */
-export declare function isSupportedLocale(locale: string): locale is SupportedLocale;
+export { DEFAULT_LOCALE, SUPPORTED_LOCALES, resolveLocale, isSupportedLocale, type SupportedLocale, } from '@contractspec/lib.contracts-spec/translations';

package/dist/i18n/locale.js

@@ -13,24 +13,13 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // 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"];
-});
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+var init_locale = () => {};
 init_locale();
 
 export {

package/dist/i18n/messages.d.ts

@@ -1,65 +1,14 @@
 /**
  * Translation helper for the ai-agent package.
- *
- * Provides a lightweight `t()` function that resolves message keys
- * to translated strings using the TranslationRegistry from
- * @contractspec/lib.contracts-spec.
- *
  * @module i18n/messages
  */
+import { type I18nInstance } from '@contractspec/lib.contracts-spec/translations';
 import type { AgentMessageKey } from './keys';
-/**
- * Interface for the agent i18n helper.
- */
-export interface AgentI18n {
-    /**
-     * Translate a message key, with optional placeholder interpolation.
-     *
-     * @param key    - A key from I18N_KEYS
-     * @param params - Optional placeholder values to interpolate
-     * @returns The translated string (falls back to English, then to the key itself)
-     *
-     * @example
-     * ```ts
-     * const i18n = createAgentI18n("fr");
-     * i18n.t("error.missingToolHandler", { name: "search" });
-     * // => "Gestionnaire manquant pour l'outil : search"
-     * ```
-     */
-    t(key: AgentMessageKey | string, params?: Record<string, string | number>): string;
-    /** The effective locale being used */
-    readonly locale: string;
-}
-/**
- * Create an AgentI18n instance for a given locale.
- *
- * The locale is resolved through the standard priority chain:
- *   runtimeLocale > specLocale > DEFAULT_LOCALE ("en")
- *
- * @param specLocale    - Locale from the agent spec (optional)
- * @param runtimeLocale - Runtime locale override (optional)
- * @returns An AgentI18n instance bound to the resolved locale
- *
- * @example
- * ```ts
- * // Use spec locale
- * const i18n = createAgentI18n("fr");
- *
- * // Use runtime override
- * const i18n = createAgentI18n("fr", "es"); // resolves to "es"
- *
- * // Use default
- * const i18n = createAgentI18n(); // resolves to "en"
- * ```
- */
-export declare function createAgentI18n(specLocale?: string, runtimeLocale?: string): AgentI18n;
-/**
- * Convenience: create a default (English) i18n instance.
- * Useful in contexts where no locale information is available.
- */
-export declare function getDefaultI18n(): AgentI18n;
-/**
- * Reset the shared registry (useful for testing).
- * @internal
- */
-export declare function resetI18nRegistry(): void;
+/** I18n instance type for the ai-agent package. */
+export type AgentI18n = I18nInstance<AgentMessageKey>;
+/** Create an i18n instance for a given locale. */
+export declare const createAgentI18n: (optionsLocale?: string, runtimeLocale?: string) => I18nInstance<"agent.json.rules.validJsonOnly" | "agent.json.rules.noMarkdownFences" | "agent.json.rules.noCommentary" | "agent.json.rules.doubleQuotes" | "agent.json.rules.noTrailingCommas" | "agent.json.defaultDescription" | "agent.json.systemPrompt" | "knowledge.header" | "knowledge.description" | "tool.knowledge.description" | "tool.knowledge.availableSpaces" | "tool.knowledge.spaceDefault" | "tool.knowledge.param.query" | "tool.knowledge.param.spaceKey" | "tool.knowledge.param.topK" | "tool.knowledge.noResults" | "tool.knowledge.sourceLabel" | "tool.fallbackDescription" | "tool.mcp.param.message" | "tool.mcp.param.sessionId" | "tool.mcp.agentDescription" | "tool.mcp.executePrompt" | "tool.mcp.toolDescription" | "interop.prompt.agentIdentity" | "interop.prompt.youAre" | "interop.prompt.description" | "interop.prompt.instructions" | "interop.prompt.availableTools" | "interop.prompt.toolsIntro" | "interop.prompt.parameters" | "interop.prompt.knowledgeContext" | "interop.prompt.additionalContext" | "interop.md.toc" | "interop.md.overview" | "interop.md.tools" | "interop.md.knowledge" | "interop.md.policy" | "interop.md.metaKey" | "interop.md.metaVersion" | "interop.md.metaStability" | "interop.md.metaOwners" | "interop.md.metaTags" | "interop.md.schema" | "interop.md.automationSafe" | "interop.md.required" | "interop.md.optional" | "interop.md.minConfidence" | "interop.md.escalationThreshold" | "interop.md.escalateToolFailure" | "interop.md.escalateTimeout" | "interop.md.yes" | "interop.md.no" | "error.jsonRunner.requiresModel" | "error.missingToolHandler" | "error.unknownBackend" | "error.claudeSdk.notAvailable" | "error.claudeSdk.notInstalled" | "error.opencodeSdk.notAvailable" | "error.opencodeSdk.notInstalled" | "error.providerNotInitialized" | "error.agentKeyRequired" | "error.agentMissingVersion" | "error.agentRequiresInstructions" | "error.agentRequiresTool" | "error.agentDuplicateTool" | "error.agentSpecNotFound" | "error.specNotFound" | "error.toolNotFound" | "error.noHandlerForTool" | "error.noToolHandler" | "error.unknownExportFormat" | "error.handlerNotFoundForTool" | "error.toolNotFoundOrNoHandler" | "error.toolNoExecuteHandler" | "error.provider.notRegistered" | "error.provider.depsNotInstalled" | "error.provider.sdkNotConfigured" | "error.provider.claudeSdkMissing" | "error.provider.opencodeSdkMissing" | "error.provider.sdkNotInstalled" | "error.provider.contextCreation" | "error.provider.executionFailed" | "error.provider.streamFailed" | "export.agentConfiguration" | "export.metadata" | "export.metaName" | "export.metaVersion" | "export.metaOwners" | "export.metaModel" | "export.instructions" | "export.availableTools" | "export.tools" | "export.knowledgeSources" | "export.policy" | "export.additionalContext" | "export.configuration" | "export.mcpServers" | "export.parameters" | "export.requiresApproval" | "export.notAutomationSafe" | "export.requiresApprovalMd" | "export.notAutomationSafeMd" | "export.required" | "export.optional" | "export.minConfidence" | "export.escalationConfigured" | "export.escalationPolicyConfigured" | "export.featureFlags" | "export.generatedFrom" | "export.exportedAt" | "export.agentType" | "export.noDescription" | "export.validation.requiresKey" | "export.validation.requiresInstructions" | "export.validation.requiresTool" | "export.validation.toolRequiresName" | "export.validation.toolRequiresDescOrName" | "export.validation.toolInvalidName" | "export.agentType.build" | "export.agentType.plan" | "export.agentType.general" | "export.agentType.explore" | "export.bridge.requiresApproval" | "export.bridge.askMode" | "approval.toolRequiresApproval" | "log.unifiedAgent.fallback" | "log.knowledge.spaceNotAvailable" | "log.knowledge.loadFailed" | "log.knowledge.queryFailed" | "log.mcpServer.started" | "log.mcpServer.stopped" | "error.telemetry.posthogAiRequired" | "error.telemetry.posthogClientOrKeyRequired" | "error.telemetry.posthogNodeRequired" | "error.provider.notAvailable">;
+/** Create a default (English) i18n instance. */
+export declare const getDefaultI18n: () => I18nInstance<"agent.json.rules.validJsonOnly" | "agent.json.rules.noMarkdownFences" | "agent.json.rules.noCommentary" | "agent.json.rules.doubleQuotes" | "agent.json.rules.noTrailingCommas" | "agent.json.defaultDescription" | "agent.json.systemPrompt" | "knowledge.header" | "knowledge.description" | "tool.knowledge.description" | "tool.knowledge.availableSpaces" | "tool.knowledge.spaceDefault" | "tool.knowledge.param.query" | "tool.knowledge.param.spaceKey" | "tool.knowledge.param.topK" | "tool.knowledge.noResults" | "tool.knowledge.sourceLabel" | "tool.fallbackDescription" | "tool.mcp.param.message" | "tool.mcp.param.sessionId" | "tool.mcp.agentDescription" | "tool.mcp.executePrompt" | "tool.mcp.toolDescription" | "interop.prompt.agentIdentity" | "interop.prompt.youAre" | "interop.prompt.description" | "interop.prompt.instructions" | "interop.prompt.availableTools" | "interop.prompt.toolsIntro" | "interop.prompt.parameters" | "interop.prompt.knowledgeContext" | "interop.prompt.additionalContext" | "interop.md.toc" | "interop.md.overview" | "interop.md.tools" | "interop.md.knowledge" | "interop.md.policy" | "interop.md.metaKey" | "interop.md.metaVersion" | "interop.md.metaStability" | "interop.md.metaOwners" | "interop.md.metaTags" | "interop.md.schema" | "interop.md.automationSafe" | "interop.md.required" | "interop.md.optional" | "interop.md.minConfidence" | "interop.md.escalationThreshold" | "interop.md.escalateToolFailure" | "interop.md.escalateTimeout" | "interop.md.yes" | "interop.md.no" | "error.jsonRunner.requiresModel" | "error.missingToolHandler" | "error.unknownBackend" | "error.claudeSdk.notAvailable" | "error.claudeSdk.notInstalled" | "error.opencodeSdk.notAvailable" | "error.opencodeSdk.notInstalled" | "error.providerNotInitialized" | "error.agentKeyRequired" | "error.agentMissingVersion" | "error.agentRequiresInstructions" | "error.agentRequiresTool" | "error.agentDuplicateTool" | "error.agentSpecNotFound" | "error.specNotFound" | "error.toolNotFound" | "error.noHandlerForTool" | "error.noToolHandler" | "error.unknownExportFormat" | "error.handlerNotFoundForTool" | "error.toolNotFoundOrNoHandler" | "error.toolNoExecuteHandler" | "error.provider.notRegistered" | "error.provider.depsNotInstalled" | "error.provider.sdkNotConfigured" | "error.provider.claudeSdkMissing" | "error.provider.opencodeSdkMissing" | "error.provider.sdkNotInstalled" | "error.provider.contextCreation" | "error.provider.executionFailed" | "error.provider.streamFailed" | "export.agentConfiguration" | "export.metadata" | "export.metaName" | "export.metaVersion" | "export.metaOwners" | "export.metaModel" | "export.instructions" | "export.availableTools" | "export.tools" | "export.knowledgeSources" | "export.policy" | "export.additionalContext" | "export.configuration" | "export.mcpServers" | "export.parameters" | "export.requiresApproval" | "export.notAutomationSafe" | "export.requiresApprovalMd" | "export.notAutomationSafeMd" | "export.required" | "export.optional" | "export.minConfidence" | "export.escalationConfigured" | "export.escalationPolicyConfigured" | "export.featureFlags" | "export.generatedFrom" | "export.exportedAt" | "export.agentType" | "export.noDescription" | "export.validation.requiresKey" | "export.validation.requiresInstructions" | "export.validation.requiresTool" | "export.validation.toolRequiresName" | "export.validation.toolRequiresDescOrName" | "export.validation.toolInvalidName" | "export.agentType.build" | "export.agentType.plan" | "export.agentType.general" | "export.agentType.explore" | "export.bridge.requiresApproval" | "export.bridge.askMode" | "approval.toolRequiresApproval" | "log.unifiedAgent.fallback" | "log.knowledge.spaceNotAvailable" | "log.knowledge.loadFailed" | "log.knowledge.queryFailed" | "log.mcpServer.started" | "log.mcpServer.stopped" | "error.telemetry.posthogAiRequired" | "error.telemetry.posthogClientOrKeyRequired" | "error.telemetry.posthogNodeRequired" | "error.provider.notAvailable">;
+/** Reset the shared registry (useful for testing). @internal */
+export declare const resetI18nRegistry: () => void;

package/dist/i18n/messages.js

@@ -603,6 +603,26 @@ var init_en = __esm(() => {
         value: "[MCPToolServer] Stopped {name}",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics requires @posthog/ai to be installed. Run: npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics requires either a client instance or an apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics requires posthog-node to be installed. Run: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Provider '{provider}' is not available{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", type: "string" }
+        ]
       }
     }
   });
@@ -1214,6 +1234,26 @@ var init_fr = __esm(() => {
         value: "[MCPToolServer] {name} arr\xEAt\xE9",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite l'installation de @posthog/ai. Ex\xE9cutez : npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite soit une instance client, soit une apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics n\xE9cessite l'installation de posthog-node. Ex\xE9cutez : npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Le fournisseur \xAB {provider} \xBB n'est pas disponible{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", type: "string" }
+        ]
       }
     }
   });
@@ -1859,76 +1899,47 @@ var init_es = __esm(() => {
         value: "[MCPToolServer] Detenido {name}",
         description: "Mensaje de registro cuando el servidor de herramientas MCP se detiene",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics requiere que @posthog/ai est\xE9 instalado. Ejecute: npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics requiere una instancia de cliente o una apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics requiere que posthog-node est\xE9 instalado. Ejecute: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "El proveedor '{provider}' no est\xE1 disponible{reason}",
+        description: "Error when a provider is unavailable",
+        placeholders: [
+          { name: "provider", type: "string" },
+          { name: "reason", 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-spec/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;
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+var factory, createAgentI18n, getDefaultI18n, resetI18nRegistry;
 var init_messages = __esm(() => {
   init_en();
   init_fr();
   init_es();
-  init_locale();
+  factory = createI18nFactory({
+    specKey: "ai-agent.messages",
+    catalogs: [enMessages, frMessages, esMessages]
+  });
+  createAgentI18n = factory.create;
+  getDefaultI18n = factory.getDefault;
+  resetI18nRegistry = factory.resetRegistry;
 });
 init_messages();