@langchain/core 0.1.42 → 0.1.44

package/dist/language_models/base.d.ts

@@ -107,7 +107,14 @@ export interface BaseFunctionCallOptions extends BaseLanguageModelCallOptions {
 }
 export type BaseLanguageModelInput = BasePromptValueInterface | string | BaseMessageLike[];
 export type StructuredOutputType = z.infer<z.ZodObject<any, any, any, any>>;
-export type StructuredOutputMethodParams<RunOutput extends Record<string, any> = Record<string, any>, IncludeRaw extends boolean = false> = {
+export type StructuredOutputMethodOptions<IncludeRaw extends boolean = false> = {
+    name?: string;
+    method?: "functionCalling" | "jsonMode";
+    includeRaw?: IncludeRaw;
+};
+/** @deprecated Use StructuredOutputMethodOptions instead */
+export type StructuredOutputMethodParams<RunOutput, IncludeRaw extends boolean = false> = {
+    /** @deprecated Pass schema in as the first argument */
     schema: z.ZodType<RunOutput> | Record<string, any>;
     name?: string;
     method?: "functionCalling" | "jsonMode";
@@ -184,8 +191,8 @@ export declare abstract class BaseLanguageModel<RunOutput = any, CallOptions ext
      * Load an LLM from a json-like object describing it.
      */
     static deserialize(_data: SerializedLLM): Promise<BaseLanguageModel>;
-    withStructuredOutput?<RunOutput extends Record<string, any> = Record<string, any>>({ schema, name, method, includeRaw, }: StructuredOutputMethodParams<RunOutput, false>): Runnable<BaseLanguageModelInput, RunOutput>;
-    withStructuredOutput?<RunOutput extends Record<string, any> = Record<string, any>>({ schema, name, method, includeRaw, }: StructuredOutputMethodParams<RunOutput, true>): Runnable<BaseLanguageModelInput, {
+    withStructuredOutput?<RunOutput extends Record<string, any> = Record<string, any>>(schema: z.ZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<false>): Runnable<BaseLanguageModelInput, RunOutput>;
+    withStructuredOutput?<RunOutput extends Record<string, any> = Record<string, any>>(schema: z.ZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<true>): Runnable<BaseLanguageModelInput, {
         raw: BaseMessage;
         parsed: RunOutput;
     }>;
@@ -196,20 +203,13 @@ export declare abstract class BaseLanguageModel<RunOutput = any, CallOptions ext
      * @template {Record<string, any>} RunOutput The output type for the Runnable, expected to be a Zod schema object for structured output validation.
      *
      * @param {z.ZodEffects<RunOutput>} schema The schema for the structured output. Either as a Zod schema or a valid JSON schema object.
+     *   If a Zod schema is passed, the returned attributes will be validated, whereas with JSON schema they will not be.
      * @param {string} name The name of the function to call.
      * @param {"functionCalling" | "jsonMode"} [method=functionCalling] The method to use for getting the structured output. Defaults to "functionCalling".
      * @param {boolean | undefined} [includeRaw=false] Whether to include the raw output in the result. Defaults to false.
      * @returns {Runnable<RunInput, RunOutput> | Runnable<RunInput, { raw: BaseMessage; parsed: RunOutput }>} A new runnable that calls the LLM with structured output.
      */
-    withStructuredOutput?<RunOutput extends Record<string, any> = Record<string, any>>({ schema, name, 
-    /**
-     * @default functionCalling
-     */
-    method, 
-    /**
-     * @default false
-     */
-    includeRaw, }: StructuredOutputMethodParams<RunOutput>): Runnable<BaseLanguageModelInput, RunOutput> | Runnable<BaseLanguageModelInput, {
+    withStructuredOutput?<RunOutput extends Record<string, any> = Record<string, any>>(schema: z.ZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<boolean>): Runnable<BaseLanguageModelInput, RunOutput> | Runnable<BaseLanguageModelInput, {
         raw: BaseMessage;
         parsed: RunOutput;
     }>;

package/dist/output_parsers/index.cjs

@@ -18,6 +18,7 @@ __exportStar(require("./base.cjs"), exports);
 __exportStar(require("./bytes.cjs"), exports);
 __exportStar(require("./list.cjs"), exports);
 __exportStar(require("./string.cjs"), exports);
+__exportStar(require("./structured.cjs"), exports);
 __exportStar(require("./transform.cjs"), exports);
 __exportStar(require("./json.cjs"), exports);
 __exportStar(require("./xml.cjs"), exports);

package/dist/output_parsers/index.d.ts

@@ -2,6 +2,7 @@ export * from "./base.js";
 export * from "./bytes.js";
 export * from "./list.js";
 export * from "./string.js";
+export * from "./structured.js";
 export * from "./transform.js";
 export * from "./json.js";
 export * from "./xml.js";

package/dist/output_parsers/index.js

@@ -2,6 +2,7 @@ export * from "./base.js";
 export * from "./bytes.js";
 export * from "./list.js";
 export * from "./string.js";
+export * from "./structured.js";
 export * from "./transform.js";
 export * from "./json.js";
 export * from "./xml.js";

package/dist/output_parsers/openai_tools/json_output_tools_parsers.cjs

@@ -121,9 +121,28 @@ class JsonOutputKeyToolsParser extends base_js_1.BaseLLMOutputParser {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "zodSchema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.keyName = params.keyName;
         this.returnSingle = params.returnSingle ?? this.returnSingle;
         this.initialParser = new JsonOutputToolsParser(params);
+        this.zodSchema = params.zodSchema;
+    }
+    async _validateResult(result) {
+        if (this.zodSchema === undefined) {
+            return result;
+        }
+        const zodParsedResult = await this.zodSchema.safeParseAsync(result);
+        if (zodParsedResult.success) {
+            return zodParsedResult.data;
+        }
+        else {
+            throw new base_js_1.OutputParserException(`Failed to parse. Text: "${JSON.stringify(result, null, 2)}". Error: ${JSON.stringify(zodParsedResult.error.errors)}`, JSON.stringify(result, null, 2));
+        }
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async parseResult(generations) {
@@ -135,9 +154,10 @@ class JsonOutputKeyToolsParser extends base_js_1.BaseLLMOutputParser {
             returnedValues = matchingResults.map((result) => result.args);
         }
         if (this.returnSingle) {
-            return returnedValues[0];
+            return this._validateResult(returnedValues[0]);
         }
-        return returnedValues;
+        const toolCallResults = await Promise.all(returnedValues.map((value) => this._validateResult(value)));
+        return toolCallResults;
     }
 }
 exports.JsonOutputKeyToolsParser = JsonOutputKeyToolsParser;

package/dist/output_parsers/openai_tools/json_output_tools_parsers.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { ChatGeneration } from "../../outputs.js";
 import { BaseLLMOutputParser } from "../base.js";
 export type ParsedToolCall = {
@@ -30,11 +31,12 @@ export declare class JsonOutputToolsParser extends BaseLLMOutputParser<ParsedToo
      */
     parseResult(generations: ChatGeneration[]): Promise<ParsedToolCall[]>;
 }
-export type JsonOutputKeyToolsParserParams = {
+export type JsonOutputKeyToolsParserParams<T extends Record<string, any> = Record<string, any>> = {
     keyName: string;
     returnSingle?: boolean;
     /** Whether to return the tool call id. */
     returnId?: boolean;
+    zodSchema?: z.ZodType<T>;
 };
 /**
  * Class for parsing the output of a tool-calling LLM into a JSON object if you are
@@ -50,6 +52,8 @@ export declare class JsonOutputKeyToolsParser<T extends Record<string, any> = Re
     /** Whether to return only the first tool call. */
     returnSingle: boolean;
     initialParser: JsonOutputToolsParser;
-    constructor(params: JsonOutputKeyToolsParserParams);
+    zodSchema?: z.ZodType<T>;
+    constructor(params: JsonOutputKeyToolsParserParams<T>);
+    protected _validateResult(result: unknown): Promise<T>;
     parseResult(generations: ChatGeneration[]): Promise<any>;
 }

package/dist/output_parsers/openai_tools/json_output_tools_parsers.js

@@ -1,4 +1,4 @@
-import { BaseLLMOutputParser } from "../base.js";
+import { BaseLLMOutputParser, OutputParserException } from "../base.js";
 /**
  * Class for parsing the output of a tool-calling LLM into a JSON object.
  */
@@ -117,9 +117,28 @@ export class JsonOutputKeyToolsParser extends BaseLLMOutputParser {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "zodSchema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.keyName = params.keyName;
         this.returnSingle = params.returnSingle ?? this.returnSingle;
         this.initialParser = new JsonOutputToolsParser(params);
+        this.zodSchema = params.zodSchema;
+    }
+    async _validateResult(result) {
+        if (this.zodSchema === undefined) {
+            return result;
+        }
+        const zodParsedResult = await this.zodSchema.safeParseAsync(result);
+        if (zodParsedResult.success) {
+            return zodParsedResult.data;
+        }
+        else {
+            throw new OutputParserException(`Failed to parse. Text: "${JSON.stringify(result, null, 2)}". Error: ${JSON.stringify(zodParsedResult.error.errors)}`, JSON.stringify(result, null, 2));
+        }
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async parseResult(generations) {
@@ -131,8 +150,9 @@ export class JsonOutputKeyToolsParser extends BaseLLMOutputParser {
             returnedValues = matchingResults.map((result) => result.args);
         }
         if (this.returnSingle) {
-            return returnedValues[0];
+            return this._validateResult(returnedValues[0]);
         }
-        return returnedValues;
+        const toolCallResults = await Promise.all(returnedValues.map((value) => this._validateResult(value)));
+        return toolCallResults;
     }
 }

package/dist/output_parsers/structured.cjs

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsymmetricStructuredOutputParser = exports.JsonMarkdownStructuredOutputParser = exports.StructuredOutputParser = void 0;
+const zod_1 = require("zod");
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const base_js_1 = require("./base.cjs");
+class StructuredOutputParser extends base_js_1.BaseOutputParser {
+    static lc_name() {
+        return "StructuredOutputParser";
+    }
+    toJSON() {
+        return this.toJSONNotImplemented();
+    }
+    constructor(schema) {
+        super(schema);
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: schema
+        });
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "output_parsers", "structured"]
+        });
+    }
+    /**
+     * Creates a new StructuredOutputParser from a Zod schema.
+     * @param schema The Zod schema which the output should match
+     * @returns A new instance of StructuredOutputParser.
+     */
+    static fromZodSchema(schema) {
+        return new this(schema);
+    }
+    /**
+     * Creates a new StructuredOutputParser from a set of names and
+     * descriptions.
+     * @param schemas An object where each key is a name and each value is a description
+     * @returns A new instance of StructuredOutputParser.
+     */
+    static fromNamesAndDescriptions(schemas) {
+        const zodSchema = zod_1.z.object(Object.fromEntries(Object.entries(schemas).map(([name, description]) => [name, zod_1.z.string().describe(description)])));
+        return new this(zodSchema);
+    }
+    /**
+     * Returns a markdown code snippet with a JSON object formatted according
+     * to the schema.
+     * @param options Optional. The options for formatting the instructions
+     * @returns A markdown code snippet with a JSON object formatted according to the schema.
+     */
+    getFormatInstructions() {
+        return `You must format your output as a JSON value that adheres to a given "JSON Schema" instance.
+
+"JSON Schema" is a declarative language that allows you to annotate and validate JSON documents.
+
+For example, the example "JSON Schema" instance {{"properties": {{"foo": {{"description": "a list of test words", "type": "array", "items": {{"type": "string"}}}}}}, "required": ["foo"]}}}}
+would match an object with one required property, "foo". The "type" property specifies "foo" must be an "array", and the "description" property semantically describes it as "a list of test words". The items within "foo" must be strings.
+Thus, the object {{"foo": ["bar", "baz"]}} is a well-formatted instance of this example "JSON Schema". The object {{"properties": {{"foo": ["bar", "baz"]}}}} is not well-formatted.
+
+Your output will be parsed and type-checked according to the provided schema instance, so make sure all fields in your output match the schema exactly and there are no trailing commas!
+
+Here is the JSON Schema instance your output must adhere to. Include the enclosing markdown codeblock:
+\`\`\`json
+${JSON.stringify((0, zod_to_json_schema_1.zodToJsonSchema)(this.schema))}
+\`\`\`
+`;
+    }
+    /**
+     * Parses the given text according to the schema.
+     * @param text The text to parse
+     * @returns The parsed output.
+     */
+    async parse(text) {
+        try {
+            const json = text.includes("```")
+                ? text.trim().split(/```(?:json)?/)[1]
+                : text.trim();
+            return await this.schema.parseAsync(JSON.parse(json));
+        }
+        catch (e) {
+            throw new base_js_1.OutputParserException(`Failed to parse. Text: "${text}". Error: ${e}`, text);
+        }
+    }
+}
+exports.StructuredOutputParser = StructuredOutputParser;
+/**
+ * A specific type of `StructuredOutputParser` that parses JSON data
+ * formatted as a markdown code snippet.
+ */
+class JsonMarkdownStructuredOutputParser extends StructuredOutputParser {
+    static lc_name() {
+        return "JsonMarkdownStructuredOutputParser";
+    }
+    getFormatInstructions(options) {
+        const interpolationDepth = options?.interpolationDepth ?? 1;
+        if (interpolationDepth < 1) {
+            throw new Error("f string interpolation depth must be at least 1");
+        }
+        return `Return a markdown code snippet with a JSON object formatted to look like:\n\`\`\`json\n${this._schemaToInstruction((0, zod_to_json_schema_1.zodToJsonSchema)(this.schema))
+            .replaceAll("{", "{".repeat(interpolationDepth))
+            .replaceAll("}", "}".repeat(interpolationDepth))}\n\`\`\``;
+    }
+    _schemaToInstruction(schemaInput, indent = 2) {
+        const schema = schemaInput;
+        if ("type" in schema) {
+            let nullable = false;
+            let type;
+            if (Array.isArray(schema.type)) {
+                const nullIdx = schema.type.findIndex((type) => type === "null");
+                if (nullIdx !== -1) {
+                    nullable = true;
+                    schema.type.splice(nullIdx, 1);
+                }
+                type = schema.type.join(" | ");
+            }
+            else {
+                type = schema.type;
+            }
+            if (schema.type === "object" && schema.properties) {
+                const description = schema.description
+                    ? ` // ${schema.description}`
+                    : "";
+                const properties = Object.entries(schema.properties)
+                    .map(([key, value]) => {
+                    const isOptional = schema.required?.includes(key)
+                        ? ""
+                        : " (optional)";
+                    return `${" ".repeat(indent)}"${key}": ${this._schemaToInstruction(value, indent + 2)}${isOptional}`;
+                })
+                    .join("\n");
+                return `{\n${properties}\n${" ".repeat(indent - 2)}}${description}`;
+            }
+            if (schema.type === "array" && schema.items) {
+                const description = schema.description
+                    ? ` // ${schema.description}`
+                    : "";
+                return `array[\n${" ".repeat(indent)}${this._schemaToInstruction(schema.items, indent + 2)}\n${" ".repeat(indent - 2)}] ${description}`;
+            }
+            const isNullable = nullable ? " (nullable)" : "";
+            const description = schema.description ? ` // ${schema.description}` : "";
+            return `${type}${description}${isNullable}`;
+        }
+        if ("anyOf" in schema) {
+            return schema.anyOf
+                .map((s) => this._schemaToInstruction(s, indent))
+                .join(`\n${" ".repeat(indent - 2)}`);
+        }
+        throw new Error("unsupported schema type");
+    }
+    static fromZodSchema(schema) {
+        return new this(schema);
+    }
+    static fromNamesAndDescriptions(schemas) {
+        const zodSchema = zod_1.z.object(Object.fromEntries(Object.entries(schemas).map(([name, description]) => [name, zod_1.z.string().describe(description)])));
+        return new this(zodSchema);
+    }
+}
+exports.JsonMarkdownStructuredOutputParser = JsonMarkdownStructuredOutputParser;
+/**
+ * A type of `StructuredOutputParser` that handles asymmetric input and
+ * output schemas.
+ */
+class AsymmetricStructuredOutputParser extends base_js_1.BaseOutputParser {
+    constructor({ inputSchema }) {
+        super(...arguments);
+        Object.defineProperty(this, "structuredInputParser", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.structuredInputParser = new JsonMarkdownStructuredOutputParser(inputSchema);
+    }
+    async parse(text) {
+        let parsedInput;
+        try {
+            parsedInput = await this.structuredInputParser.parse(text);
+        }
+        catch (e) {
+            throw new base_js_1.OutputParserException(`Failed to parse. Text: "${text}". Error: ${e}`, text);
+        }
+        return this.outputProcessor(parsedInput);
+    }
+    getFormatInstructions() {
+        return this.structuredInputParser.getFormatInstructions();
+    }
+}
+exports.AsymmetricStructuredOutputParser = AsymmetricStructuredOutputParser;

package/dist/output_parsers/structured.d.ts

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { BaseOutputParser, FormatInstructionsOptions } from "./base.js";
+export type JsonMarkdownStructuredOutputParserInput = {
+    interpolationDepth?: number;
+};
+export interface JsonMarkdownFormatInstructionsOptions extends FormatInstructionsOptions {
+    interpolationDepth?: number;
+}
+export declare class StructuredOutputParser<T extends z.ZodTypeAny> extends BaseOutputParser<z.infer<T>> {
+    schema: T;
+    static lc_name(): string;
+    lc_namespace: string[];
+    toJSON(): import("../load/serializable.js").SerializedNotImplemented;
+    constructor(schema: T);
+    /**
+     * Creates a new StructuredOutputParser from a Zod schema.
+     * @param schema The Zod schema which the output should match
+     * @returns A new instance of StructuredOutputParser.
+     */
+    static fromZodSchema<T extends z.ZodTypeAny>(schema: T): StructuredOutputParser<T>;
+    /**
+     * Creates a new StructuredOutputParser from a set of names and
+     * descriptions.
+     * @param schemas An object where each key is a name and each value is a description
+     * @returns A new instance of StructuredOutputParser.
+     */
+    static fromNamesAndDescriptions<S extends {
+        [key: string]: string;
+    }>(schemas: S): StructuredOutputParser<z.ZodObject<{
+        [k: string]: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        [x: string]: string;
+    }, {
+        [x: string]: string;
+    }>>;
+    /**
+     * Returns a markdown code snippet with a JSON object formatted according
+     * to the schema.
+     * @param options Optional. The options for formatting the instructions
+     * @returns A markdown code snippet with a JSON object formatted according to the schema.
+     */
+    getFormatInstructions(): string;
+    /**
+     * Parses the given text according to the schema.
+     * @param text The text to parse
+     * @returns The parsed output.
+     */
+    parse(text: string): Promise<z.infer<T>>;
+}
+/**
+ * A specific type of `StructuredOutputParser` that parses JSON data
+ * formatted as a markdown code snippet.
+ */
+export declare class JsonMarkdownStructuredOutputParser<T extends z.ZodTypeAny> extends StructuredOutputParser<T> {
+    static lc_name(): string;
+    getFormatInstructions(options?: JsonMarkdownFormatInstructionsOptions): string;
+    private _schemaToInstruction;
+    static fromZodSchema<T extends z.ZodTypeAny>(schema: T): JsonMarkdownStructuredOutputParser<T>;
+    static fromNamesAndDescriptions<S extends {
+        [key: string]: string;
+    }>(schemas: S): JsonMarkdownStructuredOutputParser<z.ZodObject<{
+        [k: string]: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        [x: string]: string;
+    }, {
+        [x: string]: string;
+    }>>;
+}
+export interface AsymmetricStructuredOutputParserFields<T extends z.ZodTypeAny> {
+    inputSchema: T;
+}
+/**
+ * A type of `StructuredOutputParser` that handles asymmetric input and
+ * output schemas.
+ */
+export declare abstract class AsymmetricStructuredOutputParser<T extends z.ZodTypeAny, Y = unknown> extends BaseOutputParser<Y> {
+    private structuredInputParser;
+    constructor({ inputSchema }: AsymmetricStructuredOutputParserFields<T>);
+    /**
+     * Processes the parsed input into the desired output format. Must be
+     * implemented by subclasses.
+     * @param input The parsed input
+     * @returns The processed output.
+     */
+    abstract outputProcessor(input: z.infer<T>): Promise<Y>;
+    parse(text: string): Promise<Y>;
+    getFormatInstructions(): string;
+}

package/dist/output_parsers/structured.js

@@ -0,0 +1,184 @@
+import { z } from "zod";
+import { zodToJsonSchema, } from "zod-to-json-schema";
+import { BaseOutputParser, OutputParserException, } from "./base.js";
+export class StructuredOutputParser extends BaseOutputParser {
+    static lc_name() {
+        return "StructuredOutputParser";
+    }
+    toJSON() {
+        return this.toJSONNotImplemented();
+    }
+    constructor(schema) {
+        super(schema);
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: schema
+        });
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "output_parsers", "structured"]
+        });
+    }
+    /**
+     * Creates a new StructuredOutputParser from a Zod schema.
+     * @param schema The Zod schema which the output should match
+     * @returns A new instance of StructuredOutputParser.
+     */
+    static fromZodSchema(schema) {
+        return new this(schema);
+    }
+    /**
+     * Creates a new StructuredOutputParser from a set of names and
+     * descriptions.
+     * @param schemas An object where each key is a name and each value is a description
+     * @returns A new instance of StructuredOutputParser.
+     */
+    static fromNamesAndDescriptions(schemas) {
+        const zodSchema = z.object(Object.fromEntries(Object.entries(schemas).map(([name, description]) => [name, z.string().describe(description)])));
+        return new this(zodSchema);
+    }
+    /**
+     * Returns a markdown code snippet with a JSON object formatted according
+     * to the schema.
+     * @param options Optional. The options for formatting the instructions
+     * @returns A markdown code snippet with a JSON object formatted according to the schema.
+     */
+    getFormatInstructions() {
+        return `You must format your output as a JSON value that adheres to a given "JSON Schema" instance.
+
+"JSON Schema" is a declarative language that allows you to annotate and validate JSON documents.
+
+For example, the example "JSON Schema" instance {{"properties": {{"foo": {{"description": "a list of test words", "type": "array", "items": {{"type": "string"}}}}}}, "required": ["foo"]}}}}
+would match an object with one required property, "foo". The "type" property specifies "foo" must be an "array", and the "description" property semantically describes it as "a list of test words". The items within "foo" must be strings.
+Thus, the object {{"foo": ["bar", "baz"]}} is a well-formatted instance of this example "JSON Schema". The object {{"properties": {{"foo": ["bar", "baz"]}}}} is not well-formatted.
+
+Your output will be parsed and type-checked according to the provided schema instance, so make sure all fields in your output match the schema exactly and there are no trailing commas!
+
+Here is the JSON Schema instance your output must adhere to. Include the enclosing markdown codeblock:
+\`\`\`json
+${JSON.stringify(zodToJsonSchema(this.schema))}
+\`\`\`
+`;
+    }
+    /**
+     * Parses the given text according to the schema.
+     * @param text The text to parse
+     * @returns The parsed output.
+     */
+    async parse(text) {
+        try {
+            const json = text.includes("```")
+                ? text.trim().split(/```(?:json)?/)[1]
+                : text.trim();
+            return await this.schema.parseAsync(JSON.parse(json));
+        }
+        catch (e) {
+            throw new OutputParserException(`Failed to parse. Text: "${text}". Error: ${e}`, text);
+        }
+    }
+}
+/**
+ * A specific type of `StructuredOutputParser` that parses JSON data
+ * formatted as a markdown code snippet.
+ */
+export class JsonMarkdownStructuredOutputParser extends StructuredOutputParser {
+    static lc_name() {
+        return "JsonMarkdownStructuredOutputParser";
+    }
+    getFormatInstructions(options) {
+        const interpolationDepth = options?.interpolationDepth ?? 1;
+        if (interpolationDepth < 1) {
+            throw new Error("f string interpolation depth must be at least 1");
+        }
+        return `Return a markdown code snippet with a JSON object formatted to look like:\n\`\`\`json\n${this._schemaToInstruction(zodToJsonSchema(this.schema))
+            .replaceAll("{", "{".repeat(interpolationDepth))
+            .replaceAll("}", "}".repeat(interpolationDepth))}\n\`\`\``;
+    }
+    _schemaToInstruction(schemaInput, indent = 2) {
+        const schema = schemaInput;
+        if ("type" in schema) {
+            let nullable = false;
+            let type;
+            if (Array.isArray(schema.type)) {
+                const nullIdx = schema.type.findIndex((type) => type === "null");
+                if (nullIdx !== -1) {
+                    nullable = true;
+                    schema.type.splice(nullIdx, 1);
+                }
+                type = schema.type.join(" | ");
+            }
+            else {
+                type = schema.type;
+            }
+            if (schema.type === "object" && schema.properties) {
+                const description = schema.description
+                    ? ` // ${schema.description}`
+                    : "";
+                const properties = Object.entries(schema.properties)
+                    .map(([key, value]) => {
+                    const isOptional = schema.required?.includes(key)
+                        ? ""
+                        : " (optional)";
+                    return `${" ".repeat(indent)}"${key}": ${this._schemaToInstruction(value, indent + 2)}${isOptional}`;
+                })
+                    .join("\n");
+                return `{\n${properties}\n${" ".repeat(indent - 2)}}${description}`;
+            }
+            if (schema.type === "array" && schema.items) {
+                const description = schema.description
+                    ? ` // ${schema.description}`
+                    : "";
+                return `array[\n${" ".repeat(indent)}${this._schemaToInstruction(schema.items, indent + 2)}\n${" ".repeat(indent - 2)}] ${description}`;
+            }
+            const isNullable = nullable ? " (nullable)" : "";
+            const description = schema.description ? ` // ${schema.description}` : "";
+            return `${type}${description}${isNullable}`;
+        }
+        if ("anyOf" in schema) {
+            return schema.anyOf
+                .map((s) => this._schemaToInstruction(s, indent))
+                .join(`\n${" ".repeat(indent - 2)}`);
+        }
+        throw new Error("unsupported schema type");
+    }
+    static fromZodSchema(schema) {
+        return new this(schema);
+    }
+    static fromNamesAndDescriptions(schemas) {
+        const zodSchema = z.object(Object.fromEntries(Object.entries(schemas).map(([name, description]) => [name, z.string().describe(description)])));
+        return new this(zodSchema);
+    }
+}
+/**
+ * A type of `StructuredOutputParser` that handles asymmetric input and
+ * output schemas.
+ */
+export class AsymmetricStructuredOutputParser extends BaseOutputParser {
+    constructor({ inputSchema }) {
+        super(...arguments);
+        Object.defineProperty(this, "structuredInputParser", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.structuredInputParser = new JsonMarkdownStructuredOutputParser(inputSchema);
+    }
+    async parse(text) {
+        let parsedInput;
+        try {
+            parsedInput = await this.structuredInputParser.parse(text);
+        }
+        catch (e) {
+            throw new OutputParserException(`Failed to parse. Text: "${text}". Error: ${e}`, text);
+        }
+        return this.outputProcessor(parsedInput);
+    }
+    getFormatInstructions() {
+        return this.structuredInputParser.getFormatInstructions();
+    }
+}

package/dist/utils/testing/index.cjs

@@ -311,7 +311,7 @@ class FakeListChatModel extends chat_models_js_1.BaseChatModel {
             this.i = 0;
         }
     }
-    withStructuredOutput(_params) {
+    withStructuredOutput(_params, _config) {
         return base_js_2.RunnableLambda.from(async (input) => {
             const message = await this.invoke(input);
             return JSON.parse(message.content);

package/dist/utils/testing/index.d.ts

@@ -12,7 +12,7 @@ import { Runnable } from "../../runnables/base.js";
 import { StructuredTool, ToolParams } from "../../tools.js";
 import { BaseTracer, Run } from "../../tracers/base.js";
 import { Embeddings, EmbeddingsParams } from "../../embeddings.js";
-import { StructuredOutputMethodParams, BaseLanguageModelInput } from "../../language_models/base.js";
+import { StructuredOutputMethodParams, BaseLanguageModelInput, StructuredOutputMethodOptions } from "../../language_models/base.js";
 /**
  * Parser for comma-separated values. It splits the input text by commas
  * and trims the resulting values.
@@ -114,8 +114,8 @@ export declare class FakeListChatModel extends BaseChatModel {
     _createResponseChunk(text: string): ChatGenerationChunk;
     _currentResponse(): string;
     _incrementResponse(): void;
-    withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(_params: StructuredOutputMethodParams<RunOutput, false>): Runnable<BaseLanguageModelInput, RunOutput>;
-    withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(_params: StructuredOutputMethodParams<RunOutput, true>): Runnable<BaseLanguageModelInput, {
+    withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(_params: StructuredOutputMethodParams<RunOutput, false> | z.ZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<false>): Runnable<BaseLanguageModelInput, RunOutput>;
+    withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(_params: StructuredOutputMethodParams<RunOutput, true> | z.ZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<true>): Runnable<BaseLanguageModelInput, {
         raw: BaseMessage;
         parsed: RunOutput;
     }>;

package/dist/utils/testing/index.js

@@ -302,7 +302,7 @@ export class FakeListChatModel extends BaseChatModel {
             this.i = 0;
         }
     }
-    withStructuredOutput(_params) {
+    withStructuredOutput(_params, _config) {
         return RunnableLambda.from(async (input) => {
             const message = await this.invoke(input);
             return JSON.parse(message.content);

package/package.json

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