@langchain/core 0.3.26 → 0.3.28

package/dist/prompts/base.cjs

@@ -46,6 +46,22 @@ class BasePromptTemplate extends base_js_1.Runnable {
             writable: true,
             value: void 0
         });
+        /**
+         * Metadata to be used for tracing.
+         */
+        Object.defineProperty(this, "metadata", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Tags to be used for tracing. */
+        Object.defineProperty(this, "tags", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         const { inputVariables } = input;
         if (inputVariables.includes("stop")) {
             throw new Error("Cannot have an input variable named 'stop', as it is used internally, please rename.");
@@ -81,7 +97,12 @@ class BasePromptTemplate extends base_js_1.Runnable {
      * @returns A Promise that resolves to the output of the prompt template.
      */
     async invoke(input, options) {
-        return this._callWithConfig((input) => this.formatPromptValue(input), input, { ...options, runType: "prompt" });
+        const metadata = {
+            ...this.metadata,
+            ...options?.metadata,
+        };
+        const tags = [...(this.tags ?? []), ...(options?.tags ?? [])];
+        return this._callWithConfig((input) => this.formatPromptValue(input), input, { ...options, tags, metadata, runType: "prompt" });
     }
     /**
      * Return a json-like object representing this prompt template.

package/dist/prompts/base.d.ts

@@ -34,6 +34,12 @@ export declare abstract class BasePromptTemplate<RunInput extends InputValues =
     inputVariables: Array<Extract<keyof RunInput, string>>;
     outputParser?: BaseOutputParser;
     partialVariables: PartialValues<PartialVariableName>;
+    /**
+     * Metadata to be used for tracing.
+     */
+    metadata?: Record<string, unknown>;
+    /** Tags to be used for tracing. */
+    tags?: string[];
     constructor(input: BasePromptTemplateInput);
     abstract partial(values: PartialValues): Promise<BasePromptTemplate<RunInput, RunOutput, PartialVariableName>>;
     /**

package/dist/prompts/base.js

@@ -43,6 +43,22 @@ export class BasePromptTemplate extends Runnable {
             writable: true,
             value: void 0
         });
+        /**
+         * Metadata to be used for tracing.
+         */
+        Object.defineProperty(this, "metadata", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Tags to be used for tracing. */
+        Object.defineProperty(this, "tags", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         const { inputVariables } = input;
         if (inputVariables.includes("stop")) {
             throw new Error("Cannot have an input variable named 'stop', as it is used internally, please rename.");
@@ -78,7 +94,12 @@ export class BasePromptTemplate extends Runnable {
      * @returns A Promise that resolves to the output of the prompt template.
      */
     async invoke(input, options) {
-        return this._callWithConfig((input) => this.formatPromptValue(input), input, { ...options, runType: "prompt" });
+        const metadata = {
+            ...this.metadata,
+            ...options?.metadata,
+        };
+        const tags = [...(this.tags ?? []), ...(options?.tags ?? [])];
+        return this._callWithConfig((input) => this.formatPromptValue(input), input, { ...options, tags, metadata, runType: "prompt" });
     }
     /**
      * Return a json-like object representing this prompt template.

package/dist/structured_query/base.cjs

@@ -51,7 +51,7 @@ class BasicTranslator extends BaseTranslator {
         if (func in ir_js_1.Comparators) {
             if (this.allowedComparators.length > 0 &&
                 this.allowedComparators.indexOf(func) === -1) {
-                throw new Error(`Comparator ${func} not allowed. Allowed operators: ${this.allowedComparators.join(", ")}`);
+                throw new Error(`Comparator ${func} not allowed. Allowed comparators: ${this.allowedComparators.join(", ")}`);
             }
         }
         else if (func in ir_js_1.Operators) {

package/dist/structured_query/base.js

@@ -47,7 +47,7 @@ export class BasicTranslator extends BaseTranslator {
         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(", ")}`);
+                throw new Error(`Comparator ${func} not allowed. Allowed comparators: ${this.allowedComparators.join(", ")}`);
             }
         }
         else if (func in Operators) {

package/dist/structured_query/functional.cjs

@@ -41,6 +41,41 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
     formatFunction() {
         throw new Error("Not implemented");
     }
+    /**
+     * Returns the allowed comparators for a given data type.
+     * @param input The input value to get the allowed comparators for.
+     * @returns An array of allowed comparators for the input data type.
+     */
+    getAllowedComparatorsForType(inputType) {
+        switch (inputType) {
+            case "string": {
+                return [
+                    ir_js_1.Comparators.eq,
+                    ir_js_1.Comparators.ne,
+                    ir_js_1.Comparators.gt,
+                    ir_js_1.Comparators.gte,
+                    ir_js_1.Comparators.lt,
+                    ir_js_1.Comparators.lte,
+                ];
+            }
+            case "number": {
+                return [
+                    ir_js_1.Comparators.eq,
+                    ir_js_1.Comparators.ne,
+                    ir_js_1.Comparators.gt,
+                    ir_js_1.Comparators.gte,
+                    ir_js_1.Comparators.lt,
+                    ir_js_1.Comparators.lte,
+                ];
+            }
+            case "boolean": {
+                return [ir_js_1.Comparators.eq, ir_js_1.Comparators.ne];
+            }
+            default: {
+                throw new Error(`Unsupported data type: ${inputType}`);
+            }
+        }
+    }
     /**
      * Returns a function that performs a comparison based on the provided
      * comparator.
@@ -130,6 +165,9 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
         const { comparator, attribute, value } = comparison;
         const undefinedTrue = [ir_js_1.Comparators.ne];
         if (this.allowedComparators.includes(comparator)) {
+            if (!this.getAllowedComparatorsForType(typeof value).includes(comparator)) {
+                throw new Error(`'${comparator}' comparator not allowed to be used with ${typeof value}`);
+            }
             const comparatorFunction = this.getComparatorFunction(comparator);
             return (document) => {
                 const documentValue = document.metadata[attribute];

package/dist/structured_query/functional.d.ts

@@ -7,8 +7,8 @@ import { BaseTranslator } from "./base.js";
  * the result of a comparison operation.
  */
 type ValueType = {
-    eq: string | number;
-    ne: string | number;
+    eq: string | number | boolean;
+    ne: string | number | boolean;
     lt: string | number;
     lte: string | number;
     gt: string | number;
@@ -41,6 +41,12 @@ export declare class FunctionalTranslator extends BaseTranslator {
     allowedOperators: Operator[];
     allowedComparators: Comparator[];
     formatFunction(): string;
+    /**
+     * Returns the allowed comparators for a given data type.
+     * @param input The input value to get the allowed comparators for.
+     * @returns An array of allowed comparators for the input data type.
+     */
+    getAllowedComparatorsForType(inputType: string): Comparator[];
     /**
      * Returns a function that performs a comparison based on the provided
      * comparator.
@@ -68,7 +74,7 @@ export declare class FunctionalTranslator extends BaseTranslator {
      * @param comparison The comparison part of a structured query.
      * @returns A function that takes a `Document` as an argument and returns a boolean based on the comparison.
      */
-    visitComparison(comparison: Comparison): this["VisitComparisonOutput"];
+    visitComparison(comparison: Comparison<string | number | boolean>): this["VisitComparisonOutput"];
     /**
      * Visits a structured query and translates it into a functional filter.
      * @param query The structured query to translate.

package/dist/structured_query/functional.js

@@ -38,6 +38,41 @@ export class FunctionalTranslator extends BaseTranslator {
     formatFunction() {
         throw new Error("Not implemented");
     }
+    /**
+     * Returns the allowed comparators for a given data type.
+     * @param input The input value to get the allowed comparators for.
+     * @returns An array of allowed comparators for the input data type.
+     */
+    getAllowedComparatorsForType(inputType) {
+        switch (inputType) {
+            case "string": {
+                return [
+                    Comparators.eq,
+                    Comparators.ne,
+                    Comparators.gt,
+                    Comparators.gte,
+                    Comparators.lt,
+                    Comparators.lte,
+                ];
+            }
+            case "number": {
+                return [
+                    Comparators.eq,
+                    Comparators.ne,
+                    Comparators.gt,
+                    Comparators.gte,
+                    Comparators.lt,
+                    Comparators.lte,
+                ];
+            }
+            case "boolean": {
+                return [Comparators.eq, Comparators.ne];
+            }
+            default: {
+                throw new Error(`Unsupported data type: ${inputType}`);
+            }
+        }
+    }
     /**
      * Returns a function that performs a comparison based on the provided
      * comparator.
@@ -127,6 +162,9 @@ export class FunctionalTranslator extends BaseTranslator {
         const { comparator, attribute, value } = comparison;
         const undefinedTrue = [Comparators.ne];
         if (this.allowedComparators.includes(comparator)) {
+            if (!this.getAllowedComparatorsForType(typeof value).includes(comparator)) {
+                throw new Error(`'${comparator}' comparator not allowed to be used with ${typeof value}`);
+            }
             const comparatorFunction = this.getComparatorFunction(comparator);
             return (document) => {
                 const documentValue = document.metadata[attribute];

package/dist/structured_query/ir.d.ts

@@ -66,7 +66,7 @@ export type VisitorOperationResult = {
  */
 export type VisitorComparisonResult = {
     [attr: string]: {
-        [comparator: string]: string | number;
+        [comparator: string]: string | number | boolean;
     };
 };
 /**
@@ -109,12 +109,12 @@ export declare abstract class FilterDirective extends Expression {
  * Class representing a comparison filter directive. It extends the
  * FilterDirective class.
  */
-export declare class Comparison extends FilterDirective {
+export declare class Comparison<ValueTypes = string | number> extends FilterDirective {
     comparator: Comparator;
     attribute: string;
-    value: string | number;
+    value: ValueTypes;
     exprName: "Comparison";
-    constructor(comparator: Comparator, attribute: string, value: string | number);
+    constructor(comparator: Comparator, attribute: string, value: ValueTypes);
 }
 /**
  * Class representing an operation filter directive. It extends the

package/dist/structured_query/utils.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.castValue = exports.isString = exports.isFloat = exports.isInt = exports.isFilterEmpty = exports.isObject = void 0;
+exports.castValue = exports.isBoolean = exports.isString = exports.isFloat = exports.isInt = exports.isFilterEmpty = exports.isObject = void 0;
 /**
  * Checks if the provided argument is an object and not an array.
  */
@@ -69,6 +69,13 @@ function isString(value) {
         (Number.isNaN(parseFloat(value)) || parseFloat(value).toString() !== value));
 }
 exports.isString = isString;
+/**
+ * Checks if the provided value is a boolean.
+ */
+function isBoolean(value) {
+    return typeof value === "boolean";
+}
+exports.isBoolean = isBoolean;
 /**
  * Casts a value that might be string or number to actual string or number.
  * Since LLM might return back an integer/float as a string, we need to cast
@@ -86,6 +93,9 @@ function castValue(input) {
     else if (isFloat(input)) {
         value = parseFloat(input);
     }
+    else if (isBoolean(input)) {
+        value = Boolean(input);
+    }
     else {
         throw new Error("Unsupported value type");
     }

package/dist/structured_query/utils.d.ts

@@ -20,10 +20,14 @@ export declare function isFloat(value: unknown): boolean;
  * number.
  */
 export declare function isString(value: unknown): boolean;
+/**
+ * Checks if the provided value is a boolean.
+ */
+export declare function isBoolean(value: unknown): boolean;
 /**
  * Casts a value that might be string or number to actual string or number.
  * Since LLM might return back an integer/float as a string, we need to cast
  * it back to a number, as many vector databases can't handle number as string
  * values as a comparator.
  */
-export declare function castValue(input: unknown): string | number;
+export declare function castValue(input: unknown): string | number | boolean;

package/dist/structured_query/utils.js

@@ -61,6 +61,12 @@ export function isString(value) {
     return (typeof value === "string" &&
         (Number.isNaN(parseFloat(value)) || parseFloat(value).toString() !== value));
 }
+/**
+ * Checks if the provided value is a boolean.
+ */
+export function isBoolean(value) {
+    return typeof value === "boolean";
+}
 /**
  * Casts a value that might be string or number to actual string or number.
  * Since LLM might return back an integer/float as a string, we need to cast
@@ -78,6 +84,9 @@ export function castValue(input) {
     else if (isFloat(input)) {
         value = parseFloat(input);
     }
+    else if (isBoolean(input)) {
+        value = Boolean(input);
+    }
     else {
         throw new Error("Unsupported value type");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.3.26",
+  "version": "0.3.28",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {