@arabold/docs-mcp-server 1.15.1 → 1.16.0

package/dist/{EmbeddingFactory-C6_OpOiy.js → EmbeddingFactory-CElwVk3X.js}

@@ -116,21 +116,22 @@ function createEmbeddingModel(providerAndModel) {
           "BEDROCK_AWS_REGION or AWS_REGION environment variable is required for AWS Bedrock"
         );
       }
-      if (!process.env.AWS_ACCESS_KEY_ID || !process.env.AWS_SECRET_ACCESS_KEY) {
+      if (!process.env.AWS_PROFILE && !process.env.AWS_ACCESS_KEY_ID && !process.env.AWS_SECRET_ACCESS_KEY) {
         throw new ModelConfigurationError(
-          "AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables are required for AWS Bedrock"
+          "Either AWS_PROFILE or both AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables are required for AWS Bedrock"
         );
       }
+      const credentials = process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY ? {
+        accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+        sessionToken: process.env.AWS_SESSION_TOKEN
+      } : void 0;
       return new BedrockEmbeddings({
         ...baseConfig,
         model,
         // e.g., "amazon.titan-embed-text-v1"
         region,
-        credentials: {
-          accessKeyId: process.env.AWS_ACCESS_KEY_ID,
-          secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
-          sessionToken: process.env.AWS_SESSION_TOKEN
-        }
+        ...credentials ? { credentials } : {}
       });
     }
     case "microsoft": {
@@ -172,4 +173,4 @@ export {
   UnsupportedProviderError,
   createEmbeddingModel
 };
-//# sourceMappingURL=EmbeddingFactory-C6_OpOiy.js.map
+//# sourceMappingURL=EmbeddingFactory-CElwVk3X.js.map

package/dist/{EmbeddingFactory-C6_OpOiy.js.map → EmbeddingFactory-CElwVk3X.js.map}

@@ -1 +1 @@
-{"version":3,"file":"EmbeddingFactory-C6_OpOiy.js","sources":["../src/store/embeddings/FixedDimensionEmbeddings.ts","../src/store/embeddings/EmbeddingFactory.ts"],"sourcesContent":["import { Embeddings } from \"@langchain/core/embeddings\";\nimport { DimensionError } from \"../errors\";\n\n/**\n * Wrapper around an Embeddings implementation that ensures vectors have a fixed dimension.\n * - If a vector's dimension is greater than the target and truncation is allowed,\n *   the vector is truncated (e.g., for models that support MRL - Matryoshka\n *   Representation Learning).\n * - If a vector's dimension is greater than the target and truncation is not\n *   allowed, a DimensionError is thrown.\n * - If a vector's dimension is less than the target, it is padded with zeros.\n */\nexport class FixedDimensionEmbeddings extends Embeddings {\n  private provider: string;\n  private model: string;\n\n  constructor(\n    private readonly embeddings: Embeddings,\n    private readonly targetDimension: number,\n    providerAndModel: string,\n    private readonly allowTruncate: boolean = false,\n  ) {\n    super({});\n    // Parse provider and model from string (e.g., \"gemini:embedding-001\" or just \"text-embedding-3-small\")\n    const [providerOrModel, modelName] = providerAndModel.split(\":\");\n    this.provider = modelName ? providerOrModel : \"openai\"; // Default to openai if no provider specified\n    this.model = modelName || providerOrModel;\n  }\n\n  /**\n   * Normalize a vector to the target dimension by truncating (for MRL models) or padding.\n   * @throws {DimensionError} If vector is too large and provider doesn't support MRL\n   */\n  private normalizeVector(vector: number[]): number[] {\n    const dimension = vector.length;\n\n    if (dimension > this.targetDimension) {\n      // If truncation is allowed (e.g., for MRL models like Gemini), truncate the vector\n      if (this.allowTruncate) {\n        return vector.slice(0, this.targetDimension);\n      }\n      // Otherwise, throw an error\n      throw new DimensionError(\n        `${this.provider}:${this.model}`,\n        dimension,\n        this.targetDimension,\n      );\n    }\n\n    if (dimension < this.targetDimension) {\n      // Pad with zeros to reach target dimension\n      return [...vector, ...new Array(this.targetDimension - dimension).fill(0)];\n    }\n\n    return vector;\n  }\n\n  async embedQuery(text: string): Promise<number[]> {\n    const vector = await this.embeddings.embedQuery(text);\n    return this.normalizeVector(vector);\n  }\n\n  async embedDocuments(documents: string[]): Promise<number[][]> {\n    const vectors = await this.embeddings.embedDocuments(documents);\n    return vectors.map((vector) => this.normalizeVector(vector));\n  }\n}\n","import { BedrockEmbeddings } from \"@langchain/aws\";\nimport type { Embeddings } from \"@langchain/core/embeddings\";\nimport { GoogleGenerativeAIEmbeddings } from \"@langchain/google-genai\";\nimport { VertexAIEmbeddings } from \"@langchain/google-vertexai\";\nimport {\n  AzureOpenAIEmbeddings,\n  type ClientOptions,\n  OpenAIEmbeddings,\n  type OpenAIEmbeddingsParams,\n} from \"@langchain/openai\";\nimport { VECTOR_DIMENSION } from \"../types\";\nimport { FixedDimensionEmbeddings } from \"./FixedDimensionEmbeddings\";\n\n/**\n * Supported embedding model providers. Each provider requires specific environment\n * variables to be set for API access.\n */\nexport type EmbeddingProvider = \"openai\" | \"vertex\" | \"gemini\" | \"aws\" | \"microsoft\";\n\n/**\n * Error thrown when an invalid or unsupported embedding provider is specified.\n */\nexport class UnsupportedProviderError extends Error {\n  constructor(provider: string) {\n    super(`Unsupported embedding provider: ${provider}`);\n    this.name = \"UnsupportedProviderError\";\n  }\n}\n\n/**\n * Error thrown when there's an issue with the model configuration or missing environment variables.\n */\nexport class ModelConfigurationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ModelConfigurationError\";\n  }\n}\n\n/**\n * Creates an embedding model instance based on the specified provider and model name.\n * The provider and model name should be specified in the format \"provider:model_name\"\n * (e.g., \"google:text-embedding-004\"). If no provider is specified (i.e., just \"model_name\"),\n * OpenAI is used as the default provider.\n *\n * Environment variables required per provider:\n * - OpenAI: OPENAI_API_KEY (and optionally OPENAI_API_BASE, OPENAI_ORG_ID)\n * - Google Cloud Vertex AI: GOOGLE_APPLICATION_CREDENTIALS (path to service account JSON)\n * - Google GenAI (Gemini): GOOGLE_API_KEY\n * - AWS: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION (or BEDROCK_AWS_REGION)\n * - Microsoft: AZURE_OPENAI_API_KEY, AZURE_OPENAI_API_INSTANCE_NAME, AZURE_OPENAI_API_DEPLOYMENT_NAME, AZURE_OPENAI_API_VERSION\n *\n * @param providerAndModel - The provider and model name in the format \"provider:model_name\"\n *                          or just \"model_name\" for OpenAI models.\n * @returns A configured instance of the appropriate Embeddings implementation.\n * @throws {UnsupportedProviderError} If an unsupported provider is specified.\n * @throws {ModelConfigurationError} If there's an issue with the model configuration.\n */\nexport function createEmbeddingModel(providerAndModel: string): Embeddings {\n  // Parse provider and model name\n  const [providerOrModel, ...modelNameParts] = providerAndModel.split(\":\");\n  const modelName = modelNameParts.join(\":\");\n  const provider = modelName ? (providerOrModel as EmbeddingProvider) : \"openai\";\n  const model = modelName || providerOrModel;\n\n  // Default configuration for each provider\n  const baseConfig = { stripNewLines: true };\n\n  switch (provider) {\n    case \"openai\": {\n      const config: Partial<OpenAIEmbeddingsParams> & { configuration?: ClientOptions } =\n        {\n          ...baseConfig,\n          modelName: model,\n          batchSize: 512, // OpenAI supports large batches\n        };\n      // Add custom base URL if specified\n      const baseURL = process.env.OPENAI_API_BASE;\n      if (baseURL) {\n        config.configuration = { baseURL };\n      }\n      return new OpenAIEmbeddings(config);\n    }\n\n    case \"vertex\": {\n      if (!process.env.GOOGLE_APPLICATION_CREDENTIALS) {\n        throw new ModelConfigurationError(\n          \"GOOGLE_APPLICATION_CREDENTIALS environment variable is required for Google Cloud Vertex AI\",\n        );\n      }\n      return new VertexAIEmbeddings({\n        ...baseConfig,\n        model: model, // e.g., \"text-embedding-004\"\n      });\n    }\n\n    case \"gemini\": {\n      if (!process.env.GOOGLE_API_KEY) {\n        throw new ModelConfigurationError(\n          \"GOOGLE_API_KEY environment variable is required for Google AI (Gemini)\",\n        );\n      }\n      // Create base embeddings and wrap with FixedDimensionEmbeddings since Gemini\n      // supports MRL (Matryoshka Representation Learning) for safe truncation\n      const baseEmbeddings = new GoogleGenerativeAIEmbeddings({\n        ...baseConfig,\n        apiKey: process.env.GOOGLE_API_KEY,\n        model: model, // e.g., \"gemini-embedding-exp-03-07\"\n      });\n      return new FixedDimensionEmbeddings(\n        baseEmbeddings,\n        VECTOR_DIMENSION,\n        providerAndModel,\n        true,\n      );\n    }\n\n    case \"aws\": {\n      // For AWS, model should be the full Bedrock model ID\n      const region = process.env.BEDROCK_AWS_REGION || process.env.AWS_REGION;\n      if (!region) {\n        throw new ModelConfigurationError(\n          \"BEDROCK_AWS_REGION or AWS_REGION environment variable is required for AWS Bedrock\",\n        );\n      }\n      if (!process.env.AWS_ACCESS_KEY_ID || !process.env.AWS_SECRET_ACCESS_KEY) {\n        throw new ModelConfigurationError(\n          \"AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables are required for AWS Bedrock\",\n        );\n      }\n\n      return new BedrockEmbeddings({\n        ...baseConfig,\n        model: model, // e.g., \"amazon.titan-embed-text-v1\"\n        region,\n        credentials: {\n          accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n          secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n          sessionToken: process.env.AWS_SESSION_TOKEN,\n        },\n      });\n    }\n\n    case \"microsoft\": {\n      // For Azure, model name corresponds to the deployment name\n      if (!process.env.AZURE_OPENAI_API_KEY) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_KEY environment variable is required for Azure OpenAI\",\n        );\n      }\n      if (!process.env.AZURE_OPENAI_API_INSTANCE_NAME) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_INSTANCE_NAME environment variable is required for Azure OpenAI\",\n        );\n      }\n      if (!process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_DEPLOYMENT_NAME environment variable is required for Azure OpenAI\",\n        );\n      }\n      if (!process.env.AZURE_OPENAI_API_VERSION) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_VERSION environment variable is required for Azure OpenAI\",\n        );\n      }\n\n      return new AzureOpenAIEmbeddings({\n        ...baseConfig,\n        azureOpenAIApiKey: process.env.AZURE_OPENAI_API_KEY,\n        azureOpenAIApiInstanceName: process.env.AZURE_OPENAI_API_INSTANCE_NAME,\n        azureOpenAIApiDeploymentName: process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME,\n        azureOpenAIApiVersion: process.env.AZURE_OPENAI_API_VERSION,\n        deploymentName: model,\n      });\n    }\n\n    default:\n      throw new UnsupportedProviderError(provider);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"EmbeddingFactory-CElwVk3X.js","sources":["../src/store/embeddings/FixedDimensionEmbeddings.ts","../src/store/embeddings/EmbeddingFactory.ts"],"sourcesContent":["import { Embeddings } from \"@langchain/core/embeddings\";\nimport { DimensionError } from \"../errors\";\n\n/**\n * Wrapper around an Embeddings implementation that ensures vectors have a fixed dimension.\n * - If a vector's dimension is greater than the target and truncation is allowed,\n *   the vector is truncated (e.g., for models that support MRL - Matryoshka\n *   Representation Learning).\n * - If a vector's dimension is greater than the target and truncation is not\n *   allowed, a DimensionError is thrown.\n * - If a vector's dimension is less than the target, it is padded with zeros.\n */\nexport class FixedDimensionEmbeddings extends Embeddings {\n  private provider: string;\n  private model: string;\n\n  constructor(\n    private readonly embeddings: Embeddings,\n    private readonly targetDimension: number,\n    providerAndModel: string,\n    private readonly allowTruncate: boolean = false,\n  ) {\n    super({});\n    // Parse provider and model from string (e.g., \"gemini:embedding-001\" or just \"text-embedding-3-small\")\n    const [providerOrModel, modelName] = providerAndModel.split(\":\");\n    this.provider = modelName ? providerOrModel : \"openai\"; // Default to openai if no provider specified\n    this.model = modelName || providerOrModel;\n  }\n\n  /**\n   * Normalize a vector to the target dimension by truncating (for MRL models) or padding.\n   * @throws {DimensionError} If vector is too large and provider doesn't support MRL\n   */\n  private normalizeVector(vector: number[]): number[] {\n    const dimension = vector.length;\n\n    if (dimension > this.targetDimension) {\n      // If truncation is allowed (e.g., for MRL models like Gemini), truncate the vector\n      if (this.allowTruncate) {\n        return vector.slice(0, this.targetDimension);\n      }\n      // Otherwise, throw an error\n      throw new DimensionError(\n        `${this.provider}:${this.model}`,\n        dimension,\n        this.targetDimension,\n      );\n    }\n\n    if (dimension < this.targetDimension) {\n      // Pad with zeros to reach target dimension\n      return [...vector, ...new Array(this.targetDimension - dimension).fill(0)];\n    }\n\n    return vector;\n  }\n\n  async embedQuery(text: string): Promise<number[]> {\n    const vector = await this.embeddings.embedQuery(text);\n    return this.normalizeVector(vector);\n  }\n\n  async embedDocuments(documents: string[]): Promise<number[][]> {\n    const vectors = await this.embeddings.embedDocuments(documents);\n    return vectors.map((vector) => this.normalizeVector(vector));\n  }\n}\n","import { BedrockEmbeddings } from \"@langchain/aws\";\nimport type { Embeddings } from \"@langchain/core/embeddings\";\nimport { GoogleGenerativeAIEmbeddings } from \"@langchain/google-genai\";\nimport { VertexAIEmbeddings } from \"@langchain/google-vertexai\";\nimport {\n  AzureOpenAIEmbeddings,\n  type ClientOptions,\n  OpenAIEmbeddings,\n  type OpenAIEmbeddingsParams,\n} from \"@langchain/openai\";\nimport { VECTOR_DIMENSION } from \"../types\";\nimport { FixedDimensionEmbeddings } from \"./FixedDimensionEmbeddings\";\n\n/**\n * Supported embedding model providers. Each provider requires specific environment\n * variables to be set for API access.\n */\nexport type EmbeddingProvider = \"openai\" | \"vertex\" | \"gemini\" | \"aws\" | \"microsoft\";\n\n/**\n * Error thrown when an invalid or unsupported embedding provider is specified.\n */\nexport class UnsupportedProviderError extends Error {\n  constructor(provider: string) {\n    super(`Unsupported embedding provider: ${provider}`);\n    this.name = \"UnsupportedProviderError\";\n  }\n}\n\n/**\n * Error thrown when there's an issue with the model configuration or missing environment variables.\n */\nexport class ModelConfigurationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ModelConfigurationError\";\n  }\n}\n\n/**\n * Creates an embedding model instance based on the specified provider and model name.\n * The provider and model name should be specified in the format \"provider:model_name\"\n * (e.g., \"google:text-embedding-004\"). If no provider is specified (i.e., just \"model_name\"),\n * OpenAI is used as the default provider.\n *\n * Environment variables required per provider:\n * - OpenAI: OPENAI_API_KEY (and optionally OPENAI_API_BASE, OPENAI_ORG_ID)\n * - Google Cloud Vertex AI: GOOGLE_APPLICATION_CREDENTIALS (path to service account JSON)\n * - Google GenAI (Gemini): GOOGLE_API_KEY\n * - AWS: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION (or BEDROCK_AWS_REGION)\n * - Microsoft: AZURE_OPENAI_API_KEY, AZURE_OPENAI_API_INSTANCE_NAME, AZURE_OPENAI_API_DEPLOYMENT_NAME, AZURE_OPENAI_API_VERSION\n *\n * @param providerAndModel - The provider and model name in the format \"provider:model_name\"\n *                          or just \"model_name\" for OpenAI models.\n * @returns A configured instance of the appropriate Embeddings implementation.\n * @throws {UnsupportedProviderError} If an unsupported provider is specified.\n * @throws {ModelConfigurationError} If there's an issue with the model configuration.\n */\nexport function createEmbeddingModel(providerAndModel: string): Embeddings {\n  // Parse provider and model name\n  const [providerOrModel, ...modelNameParts] = providerAndModel.split(\":\");\n  const modelName = modelNameParts.join(\":\");\n  const provider = modelName ? (providerOrModel as EmbeddingProvider) : \"openai\";\n  const model = modelName || providerOrModel;\n\n  // Default configuration for each provider\n  const baseConfig = { stripNewLines: true };\n\n  switch (provider) {\n    case \"openai\": {\n      const config: Partial<OpenAIEmbeddingsParams> & { configuration?: ClientOptions } =\n        {\n          ...baseConfig,\n          modelName: model,\n          batchSize: 512, // OpenAI supports large batches\n        };\n      // Add custom base URL if specified\n      const baseURL = process.env.OPENAI_API_BASE;\n      if (baseURL) {\n        config.configuration = { baseURL };\n      }\n      return new OpenAIEmbeddings(config);\n    }\n\n    case \"vertex\": {\n      if (!process.env.GOOGLE_APPLICATION_CREDENTIALS) {\n        throw new ModelConfigurationError(\n          \"GOOGLE_APPLICATION_CREDENTIALS environment variable is required for Google Cloud Vertex AI\",\n        );\n      }\n      return new VertexAIEmbeddings({\n        ...baseConfig,\n        model: model, // e.g., \"text-embedding-004\"\n      });\n    }\n\n    case \"gemini\": {\n      if (!process.env.GOOGLE_API_KEY) {\n        throw new ModelConfigurationError(\n          \"GOOGLE_API_KEY environment variable is required for Google AI (Gemini)\",\n        );\n      }\n      // Create base embeddings and wrap with FixedDimensionEmbeddings since Gemini\n      // supports MRL (Matryoshka Representation Learning) for safe truncation\n      const baseEmbeddings = new GoogleGenerativeAIEmbeddings({\n        ...baseConfig,\n        apiKey: process.env.GOOGLE_API_KEY,\n        model: model, // e.g., \"gemini-embedding-exp-03-07\"\n      });\n      return new FixedDimensionEmbeddings(\n        baseEmbeddings,\n        VECTOR_DIMENSION,\n        providerAndModel,\n        true,\n      );\n    }\n\n    case \"aws\": {\n      // For AWS, model should be the full Bedrock model ID\n      const region = process.env.BEDROCK_AWS_REGION || process.env.AWS_REGION;\n      if (!region) {\n        throw new ModelConfigurationError(\n          \"BEDROCK_AWS_REGION or AWS_REGION environment variable is required for AWS Bedrock\",\n        );\n      }\n      // Allow using AWS_PROFILE for credentials if set\n      if (\n        !process.env.AWS_PROFILE &&\n        !process.env.AWS_ACCESS_KEY_ID &&\n        !process.env.AWS_SECRET_ACCESS_KEY\n      ) {\n        throw new ModelConfigurationError(\n          \"Either AWS_PROFILE or both AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables are required for AWS Bedrock\",\n        );\n      }\n\n      // Only pass explicit credentials if present, otherwise let SDK resolve via profile/other means\n      const credentials =\n        process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY\n          ? {\n              accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n              secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n              sessionToken: process.env.AWS_SESSION_TOKEN,\n            }\n          : undefined;\n\n      return new BedrockEmbeddings({\n        ...baseConfig,\n        model: model, // e.g., \"amazon.titan-embed-text-v1\"\n        region,\n        ...(credentials ? { credentials } : {}),\n      });\n    }\n\n    case \"microsoft\": {\n      // For Azure, model name corresponds to the deployment name\n      if (!process.env.AZURE_OPENAI_API_KEY) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_KEY environment variable is required for Azure OpenAI\",\n        );\n      }\n      if (!process.env.AZURE_OPENAI_API_INSTANCE_NAME) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_INSTANCE_NAME environment variable is required for Azure OpenAI\",\n        );\n      }\n      if (!process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_DEPLOYMENT_NAME environment variable is required for Azure OpenAI\",\n        );\n      }\n      if (!process.env.AZURE_OPENAI_API_VERSION) {\n        throw new ModelConfigurationError(\n          \"AZURE_OPENAI_API_VERSION environment variable is required for Azure OpenAI\",\n        );\n      }\n\n      return new AzureOpenAIEmbeddings({\n        ...baseConfig,\n        azureOpenAIApiKey: process.env.AZURE_OPENAI_API_KEY,\n        azureOpenAIApiInstanceName: process.env.AZURE_OPENAI_API_INSTANCE_NAME,\n        azureOpenAIApiDeploymentName: process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME,\n        azureOpenAIApiVersion: process.env.AZURE_OPENAI_API_VERSION,\n        deploymentName: model,\n      });\n    }\n\n    default:\n      throw new UnsupportedProviderError(provider);\n  }\n}\n"],"names":[],"mappings":"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"}