langchain 0.3.2 → 0.3.3

package/dist/chains/graph_qa/cypher.cjs

@@ -11,6 +11,8 @@ const entrypoint_deprecation_js_1 = require("../../util/entrypoint_deprecation.c
 });
 exports.INTERMEDIATE_STEPS_KEY = "intermediateSteps";
 /**
+ * Chain for question-answering against a graph by generating Cypher statements.
+ *
  * @example
  * ```typescript
  * const chain = new GraphCypherQAChain({
@@ -19,6 +21,18 @@ exports.INTERMEDIATE_STEPS_KEY = "intermediateSteps";
  * });
  * const res = await chain.invoke("Who played in Pulp Fiction?");
  * ```
+ *
+ * @security
+ * This chain will execute Cypher statements against the provided database.
+ * Make sure that the database connection uses credentials
+ * that are narrowly-scoped to only include necessary permissions.
+ * Failure to do so may result in data corruption or loss, since the calling code
+ * may attempt commands that would result in deletion, mutation of data
+ * if appropriately prompted or reading sensitive data if such data is present in the database.
+ * The best way to guard against such negative outcomes is to (as appropriate) limit the
+ * permissions granted to the credentials used with this tool.
+ *
+ * See https://js.langchain.com/docs/security for more information.
  */
 class GraphCypherQAChain extends base_js_1.BaseChain {
     constructor(props) {

package/dist/chains/graph_qa/cypher.d.ts

@@ -26,6 +26,8 @@ export interface FromLLMInput {
     returnDirect?: boolean;
 }
 /**
+ * Chain for question-answering against a graph by generating Cypher statements.
+ *
  * @example
  * ```typescript
  * const chain = new GraphCypherQAChain({
@@ -34,6 +36,18 @@ export interface FromLLMInput {
  * });
  * const res = await chain.invoke("Who played in Pulp Fiction?");
  * ```
+ *
+ * @security
+ * This chain will execute Cypher statements against the provided database.
+ * Make sure that the database connection uses credentials
+ * that are narrowly-scoped to only include necessary permissions.
+ * Failure to do so may result in data corruption or loss, since the calling code
+ * may attempt commands that would result in deletion, mutation of data
+ * if appropriately prompted or reading sensitive data if such data is present in the database.
+ * The best way to guard against such negative outcomes is to (as appropriate) limit the
+ * permissions granted to the credentials used with this tool.
+ *
+ * See https://js.langchain.com/docs/security for more information.
  */
 export declare class GraphCypherQAChain extends BaseChain {
     private graph;

package/dist/chains/graph_qa/cypher.js

@@ -8,6 +8,8 @@ import { logVersion020MigrationWarning } from "../../util/entrypoint_deprecation
 });
 export const INTERMEDIATE_STEPS_KEY = "intermediateSteps";
 /**
+ * Chain for question-answering against a graph by generating Cypher statements.
+ *
  * @example
  * ```typescript
  * const chain = new GraphCypherQAChain({
@@ -16,6 +18,18 @@ export const INTERMEDIATE_STEPS_KEY = "intermediateSteps";
  * });
  * const res = await chain.invoke("Who played in Pulp Fiction?");
  * ```
+ *
+ * @security
+ * This chain will execute Cypher statements against the provided database.
+ * Make sure that the database connection uses credentials
+ * that are narrowly-scoped to only include necessary permissions.
+ * Failure to do so may result in data corruption or loss, since the calling code
+ * may attempt commands that would result in deletion, mutation of data
+ * if appropriately prompted or reading sensitive data if such data is present in the database.
+ * The best way to guard against such negative outcomes is to (as appropriate) limit the
+ * permissions granted to the credentials used with this tool.
+ *
+ * See https://js.langchain.com/docs/security for more information.
  */
 export class GraphCypherQAChain extends BaseChain {
     constructor(props) {

package/dist/chains/openai_functions/extraction.d.ts

@@ -10,7 +10,7 @@ import { LLMChain } from "../llm_chain.js";
  * @param llm Must be a ChatOpenAI or AnthropicFunctions model that supports function calling.
  * @returns A LLMChain instance configured to return data matching the schema.
  */
-export declare function createExtractionChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;
+export declare function createExtractionChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").AIMessageChunk>>;
 /**
  * Function that creates an extraction chain from a Zod schema. It
  * converts the Zod schema to a JSON schema using zod-to-json-schema
@@ -19,4 +19,4 @@ export declare function createExtractionChain(schema: FunctionParameters, llm: B
  * @param llm Must be a ChatOpenAI or AnthropicFunctions model that supports function calling.
  * @returns A LLMChain instance configured to return data matching the schema.
  */
-export declare function createExtractionChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;
+export declare function createExtractionChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").AIMessageChunk>>;

package/dist/chains/openai_functions/structured_output.d.ts

@@ -55,6 +55,6 @@ export declare class FunctionCallStructuredOutputParser<T extends z.AnyZodObject
  * as well as an additional required "outputSchema" JSON Schema object.
  * @returns OpenAPIChain
  */
-export declare function createStructuredOutputChain<T extends z.AnyZodObject = z.AnyZodObject>(input: StructuredOutputChainInput<T>): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;
+export declare function createStructuredOutputChain<T extends z.AnyZodObject = z.AnyZodObject>(input: StructuredOutputChainInput<T>): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").AIMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;
 /** @deprecated Use {@link https://api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
-export declare function createStructuredOutputChainFromZod<T extends z.AnyZodObject>(zodSchema: T, input: Omit<StructuredOutputChainInput<T>, "outputSchema">): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;
+export declare function createStructuredOutputChainFromZod<T extends z.AnyZodObject>(zodSchema: T, input: Omit<StructuredOutputChainInput<T>, "outputSchema">): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").AIMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;

package/dist/chains/openai_functions/tagging.d.ts

@@ -23,7 +23,7 @@ export type TaggingChainOptions = {
  * Switch to expression language: https://js.langchain.com/docs/expression_language/
  * Will be removed in 0.2.0
  */
-export declare function createTaggingChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;
+export declare function createTaggingChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").AIMessageChunk>>;
 /**
  * Function that creates a tagging chain from a Zod schema. It converts
  * the Zod schema to a JSON schema using the zodToJsonSchema function and
@@ -37,4 +37,4 @@ export declare function createTaggingChain(schema: FunctionParameters, llm: Base
  * Switch to expression language: https://js.langchain.com/docs/expression_language/
  * Will be removed in 0.2.0
  */
-export declare function createTaggingChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;
+export declare function createTaggingChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").AIMessageChunk>>;

package/dist/chains/query_constructor/index.d.ts

@@ -69,4 +69,4 @@ export type QueryConstructorRunnableOptions = {
 };
 /** @deprecated */
 export type QueryConstructorChainOptions = QueryConstructorRunnableOptions;
-export declare function loadQueryConstructorRunnable(opts: QueryConstructorRunnableOptions): import("@langchain/core/runnables").Runnable<any, StructuredQuery, import("@langchain/core/runnables").RunnableConfig>;
+export declare function loadQueryConstructorRunnable(opts: QueryConstructorRunnableOptions): import("@langchain/core/runnables").Runnable<any, StructuredQuery, import("@langchain/core/runnables").RunnableConfig<Record<string, any>>>;

package/dist/chat_models/universal.d.ts

@@ -60,7 +60,7 @@ declare class _ConfigurableModel<RunInput extends BaseLanguageModelInput = BaseL
      */
     _queuedMethodOperations: Record<string, any>;
     constructor(fields: ConfigurableModelFields);
-    _model(config?: RunnableConfig): Promise<BaseChatModel<BaseChatModelCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;
+    _model(config?: RunnableConfig): Promise<BaseChatModel<BaseChatModelCallOptions, AIMessageChunk>>;
     _generate(messages: BaseMessage[], options?: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
     bindTools(tools: BindToolsInput[], params?: Record<string, any>): _ConfigurableModel<RunInput, CallOptions>;
     withStructuredOutput: BaseChatModel["withStructuredOutput"];

package/dist/experimental/openai_assistant/index.d.ts

@@ -33,14 +33,18 @@ export declare class OpenAIAssistantRunnable<AsAgent extends boolean | undefined
      * @link {https://platform.openai.com/docs/api-reference/assistants/deleteAssistant}
      * @returns {Promise<AssistantDeleted>}
      */
-    deleteAssistant(): Promise<OpenAIClient.Beta.Assistants.AssistantDeleted>;
+    deleteAssistant(): Promise<OpenAIClient.Beta.Assistants.AssistantDeleted & {
+        _request_id?: string | null | undefined;
+    }>;
     /**
      * Retrieves an assistant.
      *
      * @link {https://platform.openai.com/docs/api-reference/assistants/getAssistant}
      * @returns {Promise<OpenAIClient.Beta.Assistants.Assistant>}
      */
-    getAssistant(): Promise<OpenAIClient.Beta.Assistants.Assistant>;
+    getAssistant(): Promise<OpenAIClient.Beta.Assistants.Assistant & {
+        _request_id?: string | null | undefined;
+    }>;
     /**
      * Modifies an assistant.
      *
@@ -52,7 +56,9 @@ export declare class OpenAIAssistantRunnable<AsAgent extends boolean | undefined
         name?: string;
         instructions?: string;
         fileIds?: string[];
-    }): Promise<OpenAIClient.Beta.Assistants.Assistant>;
+    }): Promise<OpenAIClient.Beta.Assistants.Assistant & {
+        _request_id?: string | null | undefined;
+    }>;
     private _parseStepsInput;
     private _createRun;
     private _createThreadAndRun;

package/dist/experimental/openai_files/index.d.ts

@@ -22,7 +22,9 @@ export declare class OpenAIFiles extends Serializable {
      */
     createFile({ file, purpose, options, }: OpenAIClient.FileCreateParams & {
         options?: OpenAIClient.RequestOptions;
-    }): Promise<OpenAIClient.Files.FileObject>;
+    }): Promise<OpenAIClient.Files.FileObject & {
+        _request_id?: string | null | undefined;
+    }>;
     /**
      * Delete a file.
      *
@@ -34,7 +36,9 @@ export declare class OpenAIFiles extends Serializable {
     deleteFile({ fileId, options, }: {
         fileId: string;
         options?: OpenAIClient.RequestOptions;
-    }): Promise<OpenAIClient.Files.FileDeleted>;
+    }): Promise<OpenAIClient.Files.FileDeleted & {
+        _request_id?: string | null | undefined;
+    }>;
     /**
      * List files
      * Returns a list of files that belong to the user's organization.
@@ -60,7 +64,9 @@ export declare class OpenAIFiles extends Serializable {
     retrieveFile({ fileId, options, }: {
         fileId: string;
         options?: OpenAIClient.RequestOptions;
-    }): Promise<OpenAIClient.Files.FileObject>;
+    }): Promise<OpenAIClient.Files.FileObject & {
+        _request_id?: string | null | undefined;
+    }>;
     /**
      * Retrieve file content
      * Returns the contents of the specified file.

package/dist/output_parsers/openai_tools.cjs

@@ -76,6 +76,7 @@ exports.JsonOutputToolsParser = JsonOutputToolsParser;
 /**
  * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 class JsonOutputKeyToolsParser extends output_parsers_1.BaseLLMOutputParser {
     static lc_name() {
         return "JsonOutputKeyToolsParser";

package/dist/output_parsers/openai_tools.js

@@ -72,6 +72,7 @@ export class JsonOutputToolsParser extends BaseLLMOutputParser {
 /**
  * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export class JsonOutputKeyToolsParser extends BaseLLMOutputParser {
     static lc_name() {
         return "JsonOutputKeyToolsParser";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langchain",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Typescript bindings for langchain",
   "type": "module",
   "engines": {
@@ -520,7 +520,7 @@
     "js-tiktoken": "^1.0.12",
     "js-yaml": "^4.1.0",
     "jsonpointer": "^5.0.1",
-    "langsmith": "^0.1.56-rc.1",
+    "langsmith": "^0.1.56",
     "openapi-types": "^12.1.3",
     "p-retry": "4",
     "uuid": "^10.0.0",