langchain 0.2.18 → 0.3.0-rc.0

package/dist/retrievers/self_query/vectara.cjs

@@ -1,143 +0,0 @@
-"use strict";
-/* eslint-disable @typescript-eslint/no-explicit-any */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VectaraTranslator = void 0;
-const structured_query_1 = require("@langchain/core/structured_query");
-const entrypoint_deprecation_js_1 = require("../../util/entrypoint_deprecation.cjs");
-/* #__PURE__ */ (0, entrypoint_deprecation_js_1.logVersion020MigrationWarning)({
-    oldEntrypointName: "retrievers/self_query/vectara",
-    newEntrypointName: "structured_query/vectara",
-    newPackageName: "@langchain/community",
-});
-function processValue(value) {
-    /** Convert a value to a string and add single quotes if it is a string. */
-    if (typeof value === "string") {
-        return `'${value}'`;
-    }
-    else {
-        return String(value);
-    }
-}
-class VectaraTranslator extends structured_query_1.BaseTranslator {
-    constructor() {
-        super(...arguments);
-        Object.defineProperty(this, "allowedOperators", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [structured_query_1.Operators.and, structured_query_1.Operators.or]
-        });
-        Object.defineProperty(this, "allowedComparators", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [
-                structured_query_1.Comparators.eq,
-                structured_query_1.Comparators.ne,
-                structured_query_1.Comparators.lt,
-                structured_query_1.Comparators.lte,
-                structured_query_1.Comparators.gt,
-                structured_query_1.Comparators.gte,
-            ]
-        });
-    }
-    formatFunction(func) {
-        if (func in structured_query_1.Comparators) {
-            if (this.allowedComparators.length > 0 &&
-                this.allowedComparators.indexOf(func) === -1) {
-                throw new Error(`Comparator ${func} not allowed. Allowed operators: ${this.allowedComparators.join(", ")}`);
-            }
-        }
-        else if (func in structured_query_1.Operators) {
-            if (this.allowedOperators.length > 0 &&
-                this.allowedOperators.indexOf(func) === -1) {
-                throw new Error(`Operator ${func} not allowed. Allowed operators: ${this.allowedOperators.join(", ")}`);
-            }
-        }
-        else {
-            throw new Error("Unknown comparator or operator");
-        }
-        const mapDict = {
-            and: " and ",
-            or: " or ",
-            eq: "=",
-            ne: "!=",
-            lt: "<",
-            lte: "<=",
-            gt: ">",
-            gte: ">=",
-        };
-        return mapDict[func];
-    }
-    /**
-     * Visits an operation and returns a VectaraOperationResult. The
-     * operation's arguments are visited and the operator is formatted.
-     * @param operation The operation to visit.
-     * @returns A VectaraOperationResult.
-     */
-    visitOperation(operation) {
-        const args = operation.args?.map((arg) => arg.accept(this));
-        const operator = this.formatFunction(operation.operator);
-        return `( ${args.join(operator)} )`;
-    }
-    /**
-     * Visits a comparison and returns a VectaraComparisonResult. The
-     * comparison's value is checked for type and the comparator is formatted.
-     * Throws an error if the value type is not supported.
-     * @param comparison The comparison to visit.
-     * @returns A VectaraComparisonResult.
-     */
-    visitComparison(comparison) {
-        const comparator = this.formatFunction(comparison.comparator);
-        return `( doc.${comparison.attribute} ${comparator} ${processValue(comparison.value)} )`;
-    }
-    /**
-     * Visits a structured query and returns a VectaraStructuredQueryResult.
-     * If the query has a filter, it is visited.
-     * @param query The structured query to visit.
-     * @returns A VectaraStructuredQueryResult.
-     */
-    visitStructuredQuery(query) {
-        let nextArg = {};
-        if (query.filter) {
-            nextArg = {
-                filter: { filter: query.filter.accept(this) },
-            };
-        }
-        return nextArg;
-    }
-    mergeFilters(defaultFilter, generatedFilter, mergeType = "and", forceDefaultFilter = false) {
-        if ((0, structured_query_1.isFilterEmpty)(defaultFilter) && (0, structured_query_1.isFilterEmpty)(generatedFilter)) {
-            return undefined;
-        }
-        if ((0, structured_query_1.isFilterEmpty)(defaultFilter) || mergeType === "replace") {
-            if ((0, structured_query_1.isFilterEmpty)(generatedFilter)) {
-                return undefined;
-            }
-            return generatedFilter;
-        }
-        if ((0, structured_query_1.isFilterEmpty)(generatedFilter)) {
-            if (forceDefaultFilter) {
-                return defaultFilter;
-            }
-            if (mergeType === "and") {
-                return undefined;
-            }
-            return defaultFilter;
-        }
-        if (mergeType === "and") {
-            return {
-                filter: `${defaultFilter} and ${generatedFilter}`,
-            };
-        }
-        else if (mergeType === "or") {
-            return {
-                filter: `${defaultFilter} or ${generatedFilter}`,
-            };
-        }
-        else {
-            throw new Error("Unknown merge type");
-        }
-    }
-}
-exports.VectaraTranslator = VectaraTranslator;

package/dist/retrievers/self_query/vectara.d.ts

@@ -1,42 +0,0 @@
-import { BaseTranslator, Comparator, Comparison, Operation, Operator, StructuredQuery } from "@langchain/core/structured_query";
-import { VectorStore } from "@langchain/core/vectorstores";
-export type VectaraVisitorResult = VectaraOperationResult | VectaraComparisonResult | VectaraVisitorStructuredQueryResult;
-export type VectaraOperationResult = String;
-export type VectaraComparisonResult = String;
-export type VectaraVisitorStructuredQueryResult = {
-    filter?: {
-        filter?: VectaraOperationResult | VectaraComparisonResult;
-    };
-};
-type VectaraFilter = any;
-export declare class VectaraTranslator<T extends VectorStore> extends BaseTranslator<T> {
-    VisitOperationOutput: VectaraOperationResult;
-    VisitComparisonOutput: VectaraComparisonResult;
-    allowedOperators: Operator[];
-    allowedComparators: Comparator[];
-    formatFunction(func: Operator | Comparator): string;
-    /**
-     * Visits an operation and returns a VectaraOperationResult. The
-     * operation's arguments are visited and the operator is formatted.
-     * @param operation The operation to visit.
-     * @returns A VectaraOperationResult.
-     */
-    visitOperation(operation: Operation): this["VisitOperationOutput"];
-    /**
-     * Visits a comparison and returns a VectaraComparisonResult. The
-     * comparison's value is checked for type and the comparator is formatted.
-     * Throws an error if the value type is not supported.
-     * @param comparison The comparison to visit.
-     * @returns A VectaraComparisonResult.
-     */
-    visitComparison(comparison: Comparison): this["VisitComparisonOutput"];
-    /**
-     * Visits a structured query and returns a VectaraStructuredQueryResult.
-     * If the query has a filter, it is visited.
-     * @param query The structured query to visit.
-     * @returns A VectaraStructuredQueryResult.
-     */
-    visitStructuredQuery(query: StructuredQuery): this["VisitStructuredQueryOutput"];
-    mergeFilters(defaultFilter: VectaraFilter | undefined, generatedFilter: VectaraFilter | undefined, mergeType?: string, forceDefaultFilter?: boolean): VectaraFilter | undefined;
-}
-export {};

package/dist/retrievers/self_query/vectara.js

@@ -1,139 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-import { BaseTranslator, isFilterEmpty, Comparators, Operators, } from "@langchain/core/structured_query";
-import { logVersion020MigrationWarning } from "../../util/entrypoint_deprecation.js";
-/* #__PURE__ */ logVersion020MigrationWarning({
-    oldEntrypointName: "retrievers/self_query/vectara",
-    newEntrypointName: "structured_query/vectara",
-    newPackageName: "@langchain/community",
-});
-function processValue(value) {
-    /** Convert a value to a string and add single quotes if it is a string. */
-    if (typeof value === "string") {
-        return `'${value}'`;
-    }
-    else {
-        return String(value);
-    }
-}
-export class VectaraTranslator extends BaseTranslator {
-    constructor() {
-        super(...arguments);
-        Object.defineProperty(this, "allowedOperators", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [Operators.and, Operators.or]
-        });
-        Object.defineProperty(this, "allowedComparators", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [
-                Comparators.eq,
-                Comparators.ne,
-                Comparators.lt,
-                Comparators.lte,
-                Comparators.gt,
-                Comparators.gte,
-            ]
-        });
-    }
-    formatFunction(func) {
-        if (func in Comparators) {
-            if (this.allowedComparators.length > 0 &&
-                this.allowedComparators.indexOf(func) === -1) {
-                throw new Error(`Comparator ${func} not allowed. Allowed operators: ${this.allowedComparators.join(", ")}`);
-            }
-        }
-        else if (func in Operators) {
-            if (this.allowedOperators.length > 0 &&
-                this.allowedOperators.indexOf(func) === -1) {
-                throw new Error(`Operator ${func} not allowed. Allowed operators: ${this.allowedOperators.join(", ")}`);
-            }
-        }
-        else {
-            throw new Error("Unknown comparator or operator");
-        }
-        const mapDict = {
-            and: " and ",
-            or: " or ",
-            eq: "=",
-            ne: "!=",
-            lt: "<",
-            lte: "<=",
-            gt: ">",
-            gte: ">=",
-        };
-        return mapDict[func];
-    }
-    /**
-     * Visits an operation and returns a VectaraOperationResult. The
-     * operation's arguments are visited and the operator is formatted.
-     * @param operation The operation to visit.
-     * @returns A VectaraOperationResult.
-     */
-    visitOperation(operation) {
-        const args = operation.args?.map((arg) => arg.accept(this));
-        const operator = this.formatFunction(operation.operator);
-        return `( ${args.join(operator)} )`;
-    }
-    /**
-     * Visits a comparison and returns a VectaraComparisonResult. The
-     * comparison's value is checked for type and the comparator is formatted.
-     * Throws an error if the value type is not supported.
-     * @param comparison The comparison to visit.
-     * @returns A VectaraComparisonResult.
-     */
-    visitComparison(comparison) {
-        const comparator = this.formatFunction(comparison.comparator);
-        return `( doc.${comparison.attribute} ${comparator} ${processValue(comparison.value)} )`;
-    }
-    /**
-     * Visits a structured query and returns a VectaraStructuredQueryResult.
-     * If the query has a filter, it is visited.
-     * @param query The structured query to visit.
-     * @returns A VectaraStructuredQueryResult.
-     */
-    visitStructuredQuery(query) {
-        let nextArg = {};
-        if (query.filter) {
-            nextArg = {
-                filter: { filter: query.filter.accept(this) },
-            };
-        }
-        return nextArg;
-    }
-    mergeFilters(defaultFilter, generatedFilter, mergeType = "and", forceDefaultFilter = false) {
-        if (isFilterEmpty(defaultFilter) && isFilterEmpty(generatedFilter)) {
-            return undefined;
-        }
-        if (isFilterEmpty(defaultFilter) || mergeType === "replace") {
-            if (isFilterEmpty(generatedFilter)) {
-                return undefined;
-            }
-            return generatedFilter;
-        }
-        if (isFilterEmpty(generatedFilter)) {
-            if (forceDefaultFilter) {
-                return defaultFilter;
-            }
-            if (mergeType === "and") {
-                return undefined;
-            }
-            return defaultFilter;
-        }
-        if (mergeType === "and") {
-            return {
-                filter: `${defaultFilter} and ${generatedFilter}`,
-            };
-        }
-        else if (mergeType === "or") {
-            return {
-                filter: `${defaultFilter} or ${generatedFilter}`,
-            };
-        }
-        else {
-            throw new Error("Unknown merge type");
-        }
-    }
-}

package/dist/retrievers/self_query/weaviate.cjs

@@ -1,201 +0,0 @@
-"use strict";
-/* eslint-disable @typescript-eslint/no-explicit-any */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WeaviateTranslator = void 0;
-const structured_query_1 = require("@langchain/core/structured_query");
-const entrypoint_deprecation_js_1 = require("../../util/entrypoint_deprecation.cjs");
-/* #__PURE__ */ (0, entrypoint_deprecation_js_1.logVersion020MigrationWarning)({
-    oldEntrypointName: "retrievers/self_query/weaviate",
-    newEntrypointName: "",
-    newPackageName: "@langchain/weaviate",
-});
-/**
- * A class that translates or converts data into a format that can be used
- * with Weaviate, a vector search engine. It extends the `BaseTranslator`
- * class and provides specific implementation for Weaviate.
- * @example
- * ```typescript
- * const selfQueryRetriever = new SelfQueryRetriever({
- *   llm: new ChatOpenAI(),
- *   vectorStore: new WeaviateStore(),
- *   documentContents: "Brief summary of a movie",
- *   attributeInfo: [],
- *   structuredQueryTranslator: new WeaviateTranslator(),
- * });
- *
- * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
- *   "Which movies are rated higher than 8.5?",
- * );
- * ```
- */
-class WeaviateTranslator extends structured_query_1.BaseTranslator {
-    constructor() {
-        super(...arguments);
-        Object.defineProperty(this, "allowedOperators", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [structured_query_1.Operators.and, structured_query_1.Operators.or]
-        });
-        Object.defineProperty(this, "allowedComparators", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [
-                structured_query_1.Comparators.eq,
-                structured_query_1.Comparators.ne,
-                structured_query_1.Comparators.lt,
-                structured_query_1.Comparators.lte,
-                structured_query_1.Comparators.gt,
-                structured_query_1.Comparators.gte,
-            ]
-        });
-    }
-    /**
-     * Formats the given function into a string representation. Throws an
-     * error if the function is not a known comparator or operator, or if it
-     * is not allowed.
-     * @param func The function to format, which can be an Operator or Comparator.
-     * @returns A string representation of the function.
-     */
-    formatFunction(func) {
-        if (func in structured_query_1.Comparators) {
-            if (this.allowedComparators.length > 0 &&
-                this.allowedComparators.indexOf(func) === -1) {
-                throw new Error(`Comparator ${func} not allowed. Allowed operators: ${this.allowedComparators.join(", ")}`);
-            }
-        }
-        else if (func in structured_query_1.Operators) {
-            if (this.allowedOperators.length > 0 &&
-                this.allowedOperators.indexOf(func) === -1) {
-                throw new Error(`Operator ${func} not allowed. Allowed operators: ${this.allowedOperators.join(", ")}`);
-            }
-        }
-        else {
-            throw new Error("Unknown comparator or operator");
-        }
-        const dict = {
-            and: "And",
-            or: "Or",
-            eq: "Equal",
-            ne: "NotEqual",
-            lt: "LessThan",
-            lte: "LessThanEqual",
-            gt: "GreaterThan",
-            gte: "GreaterThanEqual",
-        };
-        return dict[func];
-    }
-    /**
-     * Visits an operation and returns a WeaviateOperationResult. The
-     * operation's arguments are visited and the operator is formatted.
-     * @param operation The operation to visit.
-     * @returns A WeaviateOperationResult.
-     */
-    visitOperation(operation) {
-        const args = operation.args?.map((arg) => arg.accept(this));
-        return {
-            operator: this.formatFunction(operation.operator),
-            operands: args,
-        };
-    }
-    /**
-     * Visits a comparison and returns a WeaviateComparisonResult. The
-     * comparison's value is checked for type and the comparator is formatted.
-     * Throws an error if the value type is not supported.
-     * @param comparison The comparison to visit.
-     * @returns A WeaviateComparisonResult.
-     */
-    visitComparison(comparison) {
-        if ((0, structured_query_1.isString)(comparison.value)) {
-            return {
-                path: [comparison.attribute],
-                operator: this.formatFunction(comparison.comparator),
-                valueText: comparison.value,
-            };
-        }
-        if ((0, structured_query_1.isInt)(comparison.value)) {
-            return {
-                path: [comparison.attribute],
-                operator: this.formatFunction(comparison.comparator),
-                valueInt: parseInt(comparison.value, 10),
-            };
-        }
-        if ((0, structured_query_1.isFloat)(comparison.value)) {
-            return {
-                path: [comparison.attribute],
-                operator: this.formatFunction(comparison.comparator),
-                valueNumber: parseFloat(comparison.value),
-            };
-        }
-        throw new Error("Value type is not supported");
-    }
-    /**
-     * Visits a structured query and returns a WeaviateStructuredQueryResult.
-     * If the query has a filter, it is visited.
-     * @param query The structured query to visit.
-     * @returns A WeaviateStructuredQueryResult.
-     */
-    visitStructuredQuery(query) {
-        let nextArg = {};
-        if (query.filter) {
-            nextArg = {
-                filter: { where: query.filter.accept(this) },
-            };
-        }
-        return nextArg;
-    }
-    /**
-     * Merges two filters into one. If both filters are empty, returns
-     * undefined. If one filter is empty or the merge type is 'replace',
-     * returns the other filter. If the merge type is 'and' or 'or', returns a
-     * new filter with the merged results. Throws an error for unknown merge
-     * types.
-     * @param defaultFilter The default filter to merge.
-     * @param generatedFilter The generated filter to merge.
-     * @param mergeType The type of merge to perform. Can be 'and', 'or', or 'replace'. Defaults to 'and'.
-     * @returns A merged WeaviateFilter, or undefined if both filters are empty.
-     */
-    mergeFilters(defaultFilter, generatedFilter, mergeType = "and") {
-        if ((0, structured_query_1.isFilterEmpty)(defaultFilter?.where) &&
-            (0, structured_query_1.isFilterEmpty)(generatedFilter?.where)) {
-            return undefined;
-        }
-        if ((0, structured_query_1.isFilterEmpty)(defaultFilter?.where) || mergeType === "replace") {
-            if ((0, structured_query_1.isFilterEmpty)(generatedFilter?.where)) {
-                return undefined;
-            }
-            return generatedFilter;
-        }
-        if ((0, structured_query_1.isFilterEmpty)(generatedFilter?.where)) {
-            if (mergeType === "and") {
-                return undefined;
-            }
-            return defaultFilter;
-        }
-        const merged = {
-            operator: "And",
-            operands: [
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                defaultFilter.where,
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                generatedFilter.where,
-            ],
-        };
-        if (mergeType === "and") {
-            return {
-                where: merged,
-            };
-        }
-        else if (mergeType === "or") {
-            merged.operator = "Or";
-            return {
-                where: merged,
-            };
-        }
-        else {
-            throw new Error("Unknown merge type");
-        }
-    }
-}
-exports.WeaviateTranslator = WeaviateTranslator;

package/dist/retrievers/self_query/weaviate.d.ts

@@ -1,99 +0,0 @@
-import { BaseTranslator, Comparator, Comparison, Operation, Operator, StructuredQuery } from "@langchain/core/structured_query";
-import { VectorStore } from "@langchain/core/vectorstores";
-type WeaviateOperatorValues = {
-    valueText: string;
-    valueInt: number;
-    valueNumber: number;
-    valueBoolean: boolean;
-};
-type WeaviateFilter = any;
-type WeaviateOperatorKeys = keyof WeaviateOperatorValues;
-type ExclusiveOperatorValue = {
-    [L in WeaviateOperatorKeys]: {
-        [key in L]: WeaviateOperatorValues[key];
-    } & Omit<{
-        [key in WeaviateOperatorKeys]?: never;
-    }, L>;
-}[WeaviateOperatorKeys];
-export type WeaviateVisitorResult = WeaviateOperationResult | WeaviateComparisonResult | WeaviateStructuredQueryResult;
-export type WeaviateOperationResult = {
-    operator: string;
-    operands: WeaviateVisitorResult[];
-};
-export type WeaviateComparisonResult = {
-    path: [string];
-    operator: string;
-} & ExclusiveOperatorValue;
-export type WeaviateStructuredQueryResult = {
-    filter?: {
-        where?: WeaviateComparisonResult | WeaviateOperationResult;
-    };
-};
-/**
- * A class that translates or converts data into a format that can be used
- * with Weaviate, a vector search engine. It extends the `BaseTranslator`
- * class and provides specific implementation for Weaviate.
- * @example
- * ```typescript
- * const selfQueryRetriever = new SelfQueryRetriever({
- *   llm: new ChatOpenAI(),
- *   vectorStore: new WeaviateStore(),
- *   documentContents: "Brief summary of a movie",
- *   attributeInfo: [],
- *   structuredQueryTranslator: new WeaviateTranslator(),
- * });
- *
- * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
- *   "Which movies are rated higher than 8.5?",
- * );
- * ```
- */
-export declare class WeaviateTranslator<T extends VectorStore> extends BaseTranslator<T> {
-    VisitOperationOutput: WeaviateOperationResult;
-    VisitComparisonOutput: WeaviateComparisonResult;
-    allowedOperators: Operator[];
-    allowedComparators: Comparator[];
-    /**
-     * Formats the given function into a string representation. Throws an
-     * error if the function is not a known comparator or operator, or if it
-     * is not allowed.
-     * @param func The function to format, which can be an Operator or Comparator.
-     * @returns A string representation of the function.
-     */
-    formatFunction(func: Operator | Comparator): string;
-    /**
-     * Visits an operation and returns a WeaviateOperationResult. The
-     * operation's arguments are visited and the operator is formatted.
-     * @param operation The operation to visit.
-     * @returns A WeaviateOperationResult.
-     */
-    visitOperation(operation: Operation): this["VisitOperationOutput"];
-    /**
-     * Visits a comparison and returns a WeaviateComparisonResult. The
-     * comparison's value is checked for type and the comparator is formatted.
-     * Throws an error if the value type is not supported.
-     * @param comparison The comparison to visit.
-     * @returns A WeaviateComparisonResult.
-     */
-    visitComparison(comparison: Comparison): this["VisitComparisonOutput"];
-    /**
-     * Visits a structured query and returns a WeaviateStructuredQueryResult.
-     * If the query has a filter, it is visited.
-     * @param query The structured query to visit.
-     * @returns A WeaviateStructuredQueryResult.
-     */
-    visitStructuredQuery(query: StructuredQuery): this["VisitStructuredQueryOutput"];
-    /**
-     * Merges two filters into one. If both filters are empty, returns
-     * undefined. If one filter is empty or the merge type is 'replace',
-     * returns the other filter. If the merge type is 'and' or 'or', returns a
-     * new filter with the merged results. Throws an error for unknown merge
-     * types.
-     * @param defaultFilter The default filter to merge.
-     * @param generatedFilter The generated filter to merge.
-     * @param mergeType The type of merge to perform. Can be 'and', 'or', or 'replace'. Defaults to 'and'.
-     * @returns A merged WeaviateFilter, or undefined if both filters are empty.
-     */
-    mergeFilters(defaultFilter: WeaviateFilter | undefined, generatedFilter: WeaviateFilter | undefined, mergeType?: string): WeaviateFilter | undefined;
-}
-export {};