@contractspec/lib.ai-agent 2.4.0 → 2.6.0

package/dist/node/providers/claude-agent-sdk/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êté",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics nécessite l'installation de @posthog/ai. Exécutez : npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics nécessite soit une instance client, soit une apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics nécessite l'installation de posthog-node. Exécutez : npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Le fournisseur « {provider} » 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é 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é instalado. Ejecute: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "El proveedor '{provider}' no está 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",
@@ -2105,7 +2129,7 @@ var init_i18n = __esm(() => {
 
 // src/spec/spec.ts
 function defineAgent(spec) {
-  const i18n = getDefaultI18n();
+  const i18n = createAgentI18n(spec.locale);
   if (!spec.meta?.key) {
     throw new Error(i18n.t("error.agentKeyRequired"));
   }
@@ -2194,6 +2218,7 @@ var init_injector = __esm(() => {
 // src/providers/types.ts
 var ExternalProviderError, ProviderNotAvailableError, ProviderExecutionError, ContextCreationError;
 var init_types = __esm(() => {
+  init_i18n();
   ExternalProviderError = class ExternalProviderError extends Error {
     provider;
     code;
@@ -2207,8 +2232,12 @@ var init_types = __esm(() => {
     }
   };
   ProviderNotAvailableError = class ProviderNotAvailableError extends ExternalProviderError {
-    constructor(provider, reason) {
-      super(`Provider '${provider}' is not available${reason ? `: ${reason}` : ""}`, provider, "PROVIDER_NOT_AVAILABLE");
+    constructor(provider, reason, locale) {
+      const i18n = createAgentI18n(locale);
+      super(i18n.t("error.provider.notAvailable", {
+        provider,
+        reason: reason ? `: ${reason}` : ""
+      }), provider, "PROVIDER_NOT_AVAILABLE");
       this.name = "ProviderNotAvailableError";
     }
   };
@@ -2230,7 +2259,7 @@ var init_types = __esm(() => {
 function specToolToClaudeAgentTool(tool, handler, context) {
   return {
     name: tool.name,
-    description: tool.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool.name }),
+    description: tool.description ?? createAgentI18n().t("tool.fallbackDescription", { name: tool.name }),
     input_schema: normalizeSchema(tool.schema),
     requires_confirmation: tool.requiresApproval ?? !tool.automationSafe,
     execute: async (input) => {
@@ -2250,7 +2279,7 @@ function specToolsToClaudeAgentTools(tools, handlers, context) {
   return tools.filter((tool) => handlers.has(tool.name)).map((tool) => {
     const handler = handlers.get(tool.name);
     if (!handler) {
-      throw new Error(getDefaultI18n().t("error.handlerNotFoundForTool", {
+      throw new Error(createAgentI18n().t("error.handlerNotFoundForTool", {
         name: tool.name
       }));
     }
@@ -2283,7 +2312,7 @@ function claudeAgentToolsToSpecTools(claudeTools) {
 function specToolToExternalTool(tool, handler, context) {
   return {
     name: tool.name,
-    description: tool.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool.name }),
+    description: tool.description ?? createAgentI18n().t("tool.fallbackDescription", { name: tool.name }),
     inputSchema: tool.schema ?? { type: "object" },
     requiresApproval: tool.requiresApproval ?? !tool.automationSafe,
     execute: handler ? async (input) => {
@@ -2479,7 +2508,7 @@ class ClaudeAgentSDKProvider {
   }
   async createContext(spec) {
     if (!this.isAvailable()) {
-      throw new ProviderNotAvailableError(this.name, getDefaultI18n().t("error.provider.sdkNotConfigured"));
+      throw new ProviderNotAvailableError(this.name, createAgentI18n(this.config.locale).t("error.provider.sdkNotConfigured"));
     }
     try {
       const toolSet = {};
@@ -2504,7 +2533,7 @@ class ClaudeAgentSDKProvider {
         cleanup: async () => {}
       };
     } catch (error) {
-      throw new ContextCreationError(this.name, getDefaultI18n().t("error.provider.contextCreation", {
+      throw new ContextCreationError(this.name, createAgentI18n(this.config.locale).t("error.provider.contextCreation", {
         error: error instanceof Error ? error.message : String(error)
       }), error instanceof Error ? error : undefined);
     }
@@ -2562,7 +2591,7 @@ ${params.systemOverride}` : context.spec.instructions;
         }
       };
     } catch (error) {
-      throw new ProviderExecutionError(this.name, getDefaultI18n().t("error.provider.executionFailed", {
+      throw new ProviderExecutionError(this.name, createAgentI18n(this.config.locale).t("error.provider.executionFailed", {
         error: error instanceof Error ? error.message : String(error)
       }), error instanceof Error ? error : undefined);
     }
@@ -2644,7 +2673,7 @@ ${params.systemOverride}` : context.spec.instructions;
         }
       };
     } catch (error) {
-      throw new ProviderExecutionError(this.name, getDefaultI18n().t("error.provider.streamFailed", {
+      throw new ProviderExecutionError(this.name, createAgentI18n(this.config.locale).t("error.provider.streamFailed", {
         error: error instanceof Error ? error.message : String(error)
       }), error instanceof Error ? error : undefined);
     }
@@ -2654,7 +2683,7 @@ ${params.systemOverride}` : context.spec.instructions;
       const module = __require("@anthropic-ai/claude-agent-sdk");
       return module.default ?? module;
     } catch {
-      throw new ProviderNotAvailableError(this.name, getDefaultI18n().t("error.provider.claudeSdkMissing"));
+      throw new ProviderNotAvailableError(this.name, createAgentI18n(this.config.locale).t("error.provider.claudeSdkMissing"));
     }
   }
   prepareToolsForSDK(context, params) {
@@ -2664,7 +2693,7 @@ ${params.systemOverride}` : context.spec.instructions;
       if (externalTool?.execute) {
         handlers.set(tool.name, async (input) => {
           if (!externalTool.execute) {
-            throw new Error(getDefaultI18n().t("error.toolNoExecuteHandler", {
+            throw new Error(createAgentI18n(this.config.locale).t("error.toolNoExecuteHandler", {
               name: tool.name
             }));
           }
@@ -2688,7 +2717,7 @@ ${params.systemOverride}` : context.spec.instructions;
       return {
         toolCallId: toolCall.toolCallId,
         toolName: toolCall.toolName,
-        output: getDefaultI18n().t("error.toolNotFoundOrNoHandler", {
+        output: createAgentI18n(this.config.locale).t("error.toolNotFoundOrNoHandler", {
           name: toolCall.toolName
         })
       };

package/dist/node/providers/claude-agent-sdk/tool-bridge.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êté",
         description: "Log message when MCP tool server stops",
         placeholders: [{ name: "name", type: "string" }]
+      },
+      "error.telemetry.posthogAiRequired": {
+        value: "PostHog LLM Analytics nécessite l'installation de @posthog/ai. Exécutez : npm install @posthog/ai posthog-node",
+        description: "Error when PostHog AI dependency is missing"
+      },
+      "error.telemetry.posthogClientOrKeyRequired": {
+        value: "PostHog LLM Analytics nécessite soit une instance client, soit une apiKey.",
+        description: "Error when PostHog client or API key is not configured"
+      },
+      "error.telemetry.posthogNodeRequired": {
+        value: "PostHog LLM Analytics nécessite l'installation de posthog-node. Exécutez : npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "Le fournisseur « {provider} » 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é 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é instalado. Ejecute: npm install posthog-node",
+        description: "Error when posthog-node dependency is missing"
+      },
+      "error.provider.notAvailable": {
+        value: "El proveedor '{provider}' no está 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",
@@ -2107,7 +2131,7 @@ var init_i18n = __esm(() => {
 function specToolToClaudeAgentTool(tool, handler, context) {
   return {
     name: tool.name,
-    description: tool.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool.name }),
+    description: tool.description ?? createAgentI18n().t("tool.fallbackDescription", { name: tool.name }),
     input_schema: normalizeSchema(tool.schema),
     requires_confirmation: tool.requiresApproval ?? !tool.automationSafe,
     execute: async (input) => {
@@ -2127,7 +2151,7 @@ function specToolsToClaudeAgentTools(tools, handlers, context) {
   return tools.filter((tool) => handlers.has(tool.name)).map((tool) => {
     const handler = handlers.get(tool.name);
     if (!handler) {
-      throw new Error(getDefaultI18n().t("error.handlerNotFoundForTool", {
+      throw new Error(createAgentI18n().t("error.handlerNotFoundForTool", {
         name: tool.name
       }));
     }
@@ -2160,7 +2184,7 @@ function claudeAgentToolsToSpecTools(claudeTools) {
 function specToolToExternalTool(tool, handler, context) {
   return {
     name: tool.name,
-    description: tool.description ?? getDefaultI18n().t("tool.fallbackDescription", { name: tool.name }),
+    description: tool.description ?? createAgentI18n().t("tool.fallbackDescription", { name: tool.name }),
     inputSchema: tool.schema ?? { type: "object" },
     requiresApproval: tool.requiresApproval ?? !tool.automationSafe,
     execute: handler ? async (input) => {