@omnicross/core 0.1.0

package/dist/transformer/TransformerChainExecutor.js

@@ -0,0 +1,294 @@
+// src/transformer/anthropicBetaInject.ts
+import { isExtendedContextCapable } from "@omnicross/contracts/extended-context";
+var EXTENDED_CONTEXT_BETA = "context-1m-2025-08-07";
+var ANTHROPIC_BETA_HEADER = "anthropic-beta";
+function injectExtendedContextBeta(headers, model, useExtendedContext) {
+  if (!useExtendedContext) return;
+  if (!isExtendedContextCapable(model)) return;
+  let existingValue = "";
+  for (const key of Object.keys(headers)) {
+    if (key.toLowerCase() === ANTHROPIC_BETA_HEADER) {
+      const v = headers[key];
+      if (typeof v === "string") existingValue = v;
+      if (key !== ANTHROPIC_BETA_HEADER) delete headers[key];
+    }
+  }
+  const parts = existingValue.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (!parts.includes(EXTENDED_CONTEXT_BETA)) {
+    parts.push(EXTENDED_CONTEXT_BETA);
+  }
+  headers[ANTHROPIC_BETA_HEADER] = parts.join(",");
+}
+
+// src/transformer/TransformerChainExecutor.ts
+var defaultLogger = {
+  debug: (msg, ...args) => console.debug(`[ChainExecutor] ${msg}`, ...args),
+  info: (msg, ...args) => console.info(`[ChainExecutor] ${msg}`, ...args),
+  warn: (msg, ...args) => console.warn(`[ChainExecutor] ${msg}`, ...args),
+  error: (msg, ...args) => console.error(`[ChainExecutor] ${msg}`, ...args)
+};
+var TransformerChainExecutor = class {
+  logger;
+  constructor(logger) {
+    this.logger = logger ?? defaultLogger;
+  }
+  /**
+   * Execute the request transformation chain
+   *
+   * @param request - Original request body
+   * @param provider - LLM provider configuration
+   * @param chain - Resolved transformer chain
+   * @param options - Execution options
+   * @returns Transformed request result
+   */
+  async executeRequestChain(request, provider, chain, options = {}) {
+    const { endpointTransformer, headers, extendedContext } = options;
+    const context = {
+      logger: this.logger,
+      providerName: provider.name
+    };
+    let requestBody = request;
+    let config = {};
+    let bypass = false;
+    bypass = this.shouldBypassTransformers(
+      chain,
+      endpointTransformer,
+      requestBody
+    );
+    if (bypass) {
+      if (headers) {
+        const cleanHeaders = this.cleanHeaders(headers);
+        config.headers = cleanHeaders;
+      }
+      this.logger.debug("Bypass mode enabled - skipping transformations");
+    }
+    if (!bypass && endpointTransformer?.transformRequestOut) {
+      this.logger.debug("Executing transformRequestOut");
+      try {
+        const transformOut = await endpointTransformer.transformRequestOut(requestBody, context);
+        if (transformOut && typeof transformOut === "object") {
+          if ("body" in transformOut) {
+            requestBody = transformOut.body;
+            config = transformOut.config ?? {};
+          } else {
+            requestBody = transformOut;
+          }
+        }
+      } catch (error) {
+        this.logger.error(`transformRequestOut error: ${this.getErrorMessage(error)}`);
+        throw error;
+      }
+    }
+    if (!bypass && chain.providerTransformers.length > 0) {
+      this.logger.debug(`Executing ${chain.providerTransformers.length} provider transformers`);
+      for (const transformer of chain.providerTransformers) {
+        if (transformer.transformRequestIn) {
+          try {
+            const transformIn = await transformer.transformRequestIn(
+              requestBody,
+              provider,
+              context
+            );
+            if (transformIn && typeof transformIn === "object") {
+              if ("body" in transformIn) {
+                requestBody = transformIn.body;
+                config = { ...config, ...transformIn.config };
+              } else {
+                requestBody = transformIn;
+              }
+            }
+          } catch (error) {
+            this.logger.error(
+              `Provider transformer ${transformer.name} error: ${this.getErrorMessage(error)}`
+            );
+            throw error;
+          }
+        }
+      }
+    }
+    if (!bypass && chain.modelTransformers.length > 0) {
+      this.logger.debug(`Executing ${chain.modelTransformers.length} model transformers`);
+      for (const transformer of chain.modelTransformers) {
+        if (transformer.transformRequestIn) {
+          try {
+            const result = await transformer.transformRequestIn(
+              requestBody,
+              provider,
+              context
+            );
+            requestBody = result;
+          } catch (error) {
+            this.logger.error(
+              `Model transformer ${transformer.name} error: ${this.getErrorMessage(error)}`
+            );
+            throw error;
+          }
+        }
+      }
+    }
+    if (extendedContext?.enabled) {
+      if (!config.headers || typeof config.headers !== "object") {
+        config.headers = {};
+      }
+      injectExtendedContextBeta(
+        config.headers,
+        extendedContext.model,
+        true
+      );
+    }
+    return { requestBody, config, bypass };
+  }
+  /**
+   * Execute the response transformation chain
+   *
+   * @param request - Original request (for context)
+   * @param response - Response from provider
+   * @param provider - LLM provider configuration
+   * @param chain - Resolved transformer chain
+   * @param options - Execution options
+   * @returns Transformed response
+   */
+  async executeResponseChain(request, response, provider, chain, options = {}) {
+    const { endpointTransformer } = options;
+    const context = {
+      logger: this.logger,
+      providerName: provider.name
+    };
+    let finalResponse = response;
+    const bypass = this.shouldBypassTransformers(chain, endpointTransformer, request);
+    if (bypass) {
+      this.logger.debug("Bypass mode - skipping response transformations");
+      return finalResponse;
+    }
+    if (chain.modelTransformers.length > 0) {
+      const reversedModelTransformers = [...chain.modelTransformers].reverse();
+      this.logger.debug(
+        `Executing ${reversedModelTransformers.length} model response transformers (reversed)`
+      );
+      for (const transformer of reversedModelTransformers) {
+        if (transformer.transformResponseOut) {
+          try {
+            finalResponse = await transformer.transformResponseOut(finalResponse, context);
+          } catch (error) {
+            this.logger.error(
+              `Model transformer ${transformer.name} response error: ${this.getErrorMessage(error)}`
+            );
+            throw error;
+          }
+        }
+      }
+    }
+    if (chain.providerTransformers.length > 0) {
+      const reversedProviderTransformers = [...chain.providerTransformers].reverse();
+      this.logger.debug(
+        `Executing ${reversedProviderTransformers.length} provider response transformers (reversed)`
+      );
+      for (const transformer of reversedProviderTransformers) {
+        if (transformer.transformResponseOut) {
+          try {
+            finalResponse = await transformer.transformResponseOut(finalResponse, context);
+          } catch (error) {
+            this.logger.error(
+              `Provider transformer ${transformer.name} response error: ${this.getErrorMessage(error)}`
+            );
+            throw error;
+          }
+        }
+      }
+    }
+    if (endpointTransformer?.transformResponseIn) {
+      this.logger.debug("Executing transformResponseIn");
+      try {
+        finalResponse = await endpointTransformer.transformResponseIn(finalResponse, context);
+      } catch (error) {
+        this.logger.error(`transformResponseIn error: ${this.getErrorMessage(error)}`);
+        throw error;
+      }
+    }
+    return finalResponse;
+  }
+  /**
+   * Execute authentication handler if available
+   *
+   * @param request - Request body
+   * @param provider - LLM provider
+   * @param endpointTransformer - Endpoint transformer with auth handler
+   * @param context - Transformer context
+   * @returns Auth result with potentially modified request and config
+   */
+  async executeAuth(request, provider, endpointTransformer, context) {
+    let requestBody = request;
+    let config = {};
+    if (endpointTransformer?.auth) {
+      this.logger.debug("Executing auth handler");
+      try {
+        const auth = await endpointTransformer.auth(requestBody, provider, context);
+        if (auth && typeof auth === "object") {
+          if ("body" in auth) {
+            requestBody = auth.body;
+            const authConfig = auth.config;
+            if (authConfig) {
+              const headers = { ...config.headers ?? {}, ...authConfig.headers ?? {} };
+              delete headers["host"];
+              config = { ...config, ...authConfig, headers };
+            }
+          } else {
+            requestBody = auth;
+          }
+        }
+      } catch (error) {
+        this.logger.error(`Auth handler error: ${this.getErrorMessage(error)}`);
+        throw error;
+      }
+    }
+    return { requestBody, config };
+  }
+  /**
+   * Check if transformers should be bypassed (optimization)
+   *
+   * Bypass is enabled when:
+   * - Provider has only one transformer that matches the endpoint transformer
+   * - Model has no specific transformers or only the same endpoint transformer
+   */
+  shouldBypassTransformers(chain, endpointTransformer, _request) {
+    if (!endpointTransformer?.name) {
+      return false;
+    }
+    const providerHasOnlyEndpoint = chain.providerTransformers.length === 1 && chain.providerTransformers[0]?.name === endpointTransformer.name;
+    const modelHasNoTransformers = chain.modelTransformers.length === 0;
+    const modelHasOnlyEndpoint = chain.modelTransformers.length === 1 && chain.modelTransformers[0]?.name === endpointTransformer.name;
+    return providerHasOnlyEndpoint && (modelHasNoTransformers || modelHasOnlyEndpoint);
+  }
+  /**
+   * Clean headers for pass-through
+   */
+  cleanHeaders(headers) {
+    const result = {};
+    if (headers instanceof Headers) {
+      headers.forEach((value, key) => {
+        if (key.toLowerCase() !== "content-length") {
+          result[key] = value;
+        }
+      });
+    } else {
+      for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() !== "content-length") {
+          result[key] = value;
+        }
+      }
+    }
+    return result;
+  }
+  /**
+   * Get error message from unknown error
+   */
+  getErrorMessage(error) {
+    if (error instanceof Error) {
+      return error.message;
+    }
+    return String(error);
+  }
+};
+export {
+  TransformerChainExecutor
+};

package/dist/transformer/TransformerService.cjs

@@ -0,0 +1,290 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/transformer/TransformerService.ts
+var TransformerService_exports = {};
+__export(TransformerService_exports, {
+  TransformerService: () => TransformerService
+});
+module.exports = __toCommonJS(TransformerService_exports);
+var defaultLogger = {
+  debug: (msg, ...args) => console.debug(`[TransformerService] ${msg}`, ...args),
+  info: (msg, ...args) => console.info(`[TransformerService] ${msg}`, ...args),
+  warn: (msg, ...args) => console.warn(`[TransformerService] ${msg}`, ...args),
+  error: (msg, ...args) => console.error(`[TransformerService] ${msg}`, ...args)
+};
+var TransformerService = class {
+  transformers = /* @__PURE__ */ new Map();
+  logger;
+  // Performance optimization: Cache instantiated transformers
+  instanceCache = /* @__PURE__ */ new Map();
+  // Performance optimization: Cache endpoint transformer results
+  endpointTransformersCache = null;
+  noEndpointTransformersCache = null;
+  constructor(logger) {
+    this.logger = logger ?? defaultLogger;
+  }
+  /**
+   * Clear instance caches
+   */
+  clearInstanceCache() {
+    this.instanceCache.clear();
+    this.endpointTransformersCache = null;
+    this.noEndpointTransformersCache = null;
+  }
+  /**
+   * Get cache statistics for diagnostics
+   */
+  getCacheStats() {
+    return {
+      instanceCacheSize: this.instanceCache.size,
+      hasEndpointCache: this.endpointTransformersCache !== null
+    };
+  }
+  /**
+   * Register a transformer by name
+   * @param name - Unique transformer name
+   * @param transformer - Transformer instance or constructor
+   */
+  registerTransformer(name, transformer) {
+    this.transformers.set(name, transformer);
+    this.clearInstanceCache();
+    const endpoint = "endPoint" in transformer ? transformer.endPoint : "prototype" in transformer && transformer.prototype?.endPoint ? transformer.prototype.endPoint : void 0;
+    this.logger.info(
+      `Registered transformer: ${name}${endpoint ? ` (endpoint: ${endpoint})` : " (no endpoint)"}`
+    );
+  }
+  /**
+   * Get a transformer by name
+   * @param name - Transformer name
+   * @returns Transformer instance/constructor or undefined
+   */
+  getTransformer(name) {
+    return this.transformers.get(name);
+  }
+  /**
+   * Get all registered transformers
+   * @returns Map of all transformers
+   */
+  getAllTransformers() {
+    return new Map(this.transformers);
+  }
+  /**
+   * Get transformers that have an endpoint defined
+   * Uses cache to avoid redundant traversal
+   * @returns Array of transformers with endpoints
+   */
+  getTransformersWithEndpoint() {
+    if (this.endpointTransformersCache) {
+      return this.endpointTransformersCache;
+    }
+    const result = [];
+    this.transformers.forEach((transformer, name) => {
+      const instance = this.instantiateIfNeeded(transformer);
+      if (instance?.endPoint) {
+        result.push({ name, transformer: instance });
+      }
+    });
+    this.endpointTransformersCache = result;
+    return result;
+  }
+  /**
+   * Get transformers without endpoints
+   * Uses cache to avoid redundant traversal
+   * @returns Array of transformers without endpoints
+   */
+  getTransformersWithoutEndpoint() {
+    if (this.noEndpointTransformersCache) {
+      return this.noEndpointTransformersCache;
+    }
+    const result = [];
+    this.transformers.forEach((transformer, name) => {
+      const instance = this.instantiateIfNeeded(transformer);
+      if (instance && !instance.endPoint) {
+        result.push({ name, transformer: instance });
+      }
+    });
+    this.noEndpointTransformersCache = result;
+    return result;
+  }
+  /**
+   * Remove a transformer by name
+   * @param name - Transformer name
+   * @returns true if removed, false if not found
+   */
+  removeTransformer(name) {
+    const removed = this.transformers.delete(name);
+    if (removed) {
+      this.clearInstanceCache();
+    }
+    return removed;
+  }
+  /**
+   * Check if a transformer is registered
+   * @param name - Transformer name
+   * @returns true if registered
+   */
+  hasTransformer(name) {
+    return this.transformers.has(name);
+  }
+  /**
+   * Initialize the service with default transformers
+   * @param defaultTransformers - Map or object of default transformers
+   */
+  async initialize(defaultTransformers) {
+    try {
+      if (defaultTransformers) {
+        await this.registerDefaultTransformers(defaultTransformers);
+      }
+      this.logger.info(
+        `TransformerService initialized with ${this.transformers.size} transformers`
+      );
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logger.error(`TransformerService init error: ${errorMessage}`);
+      throw error;
+    }
+  }
+  /**
+   * Register default transformers from a map
+   * @param transformers - Map of transformer name to transformer
+   */
+  async registerDefaultTransformers(transformers) {
+    for (const [key, TransformerClass] of Object.entries(transformers)) {
+      try {
+        if (this.isTransformerConstructor(TransformerClass)) {
+          const staticName = TransformerClass.TransformerName ?? key;
+          this.registerTransformer(staticName, TransformerClass);
+        } else {
+          const name = TransformerClass.name ?? key;
+          TransformerClass.logger = this.logger;
+          this.registerTransformer(name, TransformerClass);
+        }
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.logger.error(`Failed to register transformer ${key}: ${errorMessage}`);
+      }
+    }
+  }
+  /**
+   * Resolve a transformer chain configuration to actual transformer instances
+   * @param chainConfig - Transformer chain configuration
+   * @param modelName - Model name for model-specific transformers
+   * @returns Resolved transformer chain with instances
+   */
+  resolveTransformerChain(chainConfig, modelName) {
+    const result = {
+      providerTransformers: [],
+      modelTransformers: []
+    };
+    if (!chainConfig) {
+      return result;
+    }
+    if (chainConfig.use) {
+      result.providerTransformers = this.resolveTransformerReferences(chainConfig.use);
+    }
+    if (modelName && chainConfig[modelName]) {
+      const modelConfig = chainConfig[modelName];
+      if (Array.isArray(modelConfig)) {
+        result.modelTransformers = this.resolveTransformerReferences(modelConfig);
+      } else if (modelConfig && typeof modelConfig === "object" && "use" in modelConfig) {
+        result.modelTransformers = this.resolveTransformerReferences(modelConfig.use ?? []);
+      }
+    }
+    return result;
+  }
+  /**
+   * Resolve an array of transformer references to instances
+   * @param refs - Array of transformer references
+   * @returns Array of transformer instances
+   */
+  resolveTransformerReferences(refs) {
+    const instances = [];
+    for (const ref of refs) {
+      const [name, options] = Array.isArray(ref) ? ref : [ref, void 0];
+      const transformer = this.getTransformer(name);
+      if (!transformer) {
+        this.logger.warn(`Transformer not found: ${name}`);
+        continue;
+      }
+      const instance = this.instantiateIfNeeded(transformer, options);
+      if (instance) {
+        instance.logger = this.logger;
+        instances.push(instance);
+      }
+    }
+    return instances;
+  }
+  /**
+   * Instantiate a transformer if it's a constructor
+   * Uses instance cache to avoid redundant instantiation
+   *
+   * @param transformer - Transformer instance or constructor
+   * @param options - Options to pass to constructor
+   * @returns Transformer instance
+   */
+  instantiateIfNeeded(transformer, options) {
+    if (!this.isTransformerConstructor(transformer)) {
+      return transformer;
+    }
+    const constructorName = transformer.TransformerName || transformer.name || "anonymous";
+    const optionsHash = options ? JSON.stringify(options) : "";
+    const cacheKey = `${constructorName}:${optionsHash}`;
+    if (this.instanceCache.has(cacheKey)) {
+      return this.instanceCache.get(cacheKey);
+    }
+    try {
+      const instance = new transformer(options);
+      instance.logger = this.logger;
+      this.instanceCache.set(cacheKey, instance);
+      return instance;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logger.error(`Failed to instantiate transformer: ${errorMessage}`);
+      return void 0;
+    }
+  }
+  /**
+   * Check if a value is a transformer constructor
+   * @param value - Value to check
+   * @returns true if it's a constructor
+   */
+  isTransformerConstructor(value) {
+    return typeof value === "function" && value.prototype && (typeof value.prototype.transformRequestIn === "function" || typeof value.prototype.transformRequestOut === "function" || typeof value.prototype.transformResponseIn === "function" || typeof value.prototype.transformResponseOut === "function" || "TransformerName" in value);
+  }
+  /**
+   * Get list of all registered transformer names
+   * @returns Array of transformer names
+   */
+  getTransformerNames() {
+    return Array.from(this.transformers.keys());
+  }
+  /**
+   * Clear all registered transformers
+   */
+  clear() {
+    this.transformers.clear();
+    this.clearInstanceCache();
+    this.logger.info("All transformers cleared");
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TransformerService
+});