deepagents 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as langchain0 from "langchain";
 import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, InterruptOnConfig, ReactAgent, StructuredTool } from "langchain";
 import { AnnotationRoot } from "@langchain/langgraph";
 import { StructuredTool as StructuredTool$1 } from "@langchain/core/tools";
-import { LanguageModelLike } from "@langchain/core/language_models/base";
+import { BaseLanguageModel, LanguageModelLike } from "@langchain/core/language_models/base";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
 import { InteropZodObject } from "@langchain/core/utils/types";
 
@@ -117,6 +117,13 @@ interface BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): string | Promise<string>;
+  /**
+   * Read file content as raw FileData.
+   *
+   * @param filePath - Absolute file path
+   * @returns Raw file content as FileData
+   */
+  readRaw(filePath: string): FileData | Promise<FileData>;
   /**
    * Structured search results or error string for invalid input.
    *
@@ -191,6 +198,15 @@ interface StateAndStore {
 type BackendFactory = (stateAndStore: StateAndStore) => BackendProtocol;
 //#endregion
 //#region src/middleware/fs.d.ts
+type FilesystemEventResponse = {
+  kind: "raw-contents";
+} | {
+  kind: "metadata";
+  data: Record<string, unknown>;
+};
+interface FilesystemEvents {
+  onWrite?: (path: string, backend: BackendProtocol) => void | FilesystemEventResponse | Promise<void | FilesystemEventResponse>;
+}
 /**
  * Options for creating filesystem middleware.
  */
@@ -203,6 +219,8 @@ interface FilesystemMiddlewareOptions {
   customToolDescriptions?: Record<string, string> | null;
   /** Optional token limit before evicting a tool result to the filesystem (default: 20000 tokens, ~80KB) */
   toolTokenLimitBeforeEvict?: number | null;
+  /** Filesystem events callbacks */
+  events?: FilesystemEvents;
 }
 /**
  * Create filesystem middleware with all tools and features.
@@ -314,6 +332,13 @@ declare class StateBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): string;
+  /**
+   * Read file content as raw FileData.
+   *
+   * @param filePath - Absolute file path
+   * @returns Raw file content as FileData
+   */
+  readRaw(filePath: string): FileData;
   /**
    * Create a new file with content.
    * Returns WriteResult with filesUpdate to update LangGraph state.
@@ -360,7 +385,7 @@ declare class StoreBackend implements BackendProtocol {
    * [assistant_id, "filesystem"] to provide per-assistant isolation.
    * Otherwise return ["filesystem"].
    */
-  private getNamespace;
+  protected getNamespace(): string[];
   /**
    * Convert a store Item to FileData format.
    *
@@ -402,6 +427,13 @@ declare class StoreBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): Promise<string>;
+  /**
+   * Read file content as raw FileData.
+   *
+   * @param filePath - Absolute file path
+   * @returns Raw file content as FileData
+   */
+  readRaw(filePath: string): Promise<FileData>;
   /**
    * Create a new file with content.
    * Returns WriteResult. External storage sets filesUpdate=null.
@@ -469,6 +501,13 @@ declare class FilesystemBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): Promise<string>;
+  /**
+   * Read file content as raw FileData.
+   *
+   * @param filePath - Absolute file path
+   * @returns Raw file content as FileData
+   */
+  readRaw(filePath: string): Promise<FileData>;
   /**
    * Create a new file with content.
    * Returns WriteResult. External storage sets filesUpdate=null.
@@ -538,6 +577,13 @@ declare class CompositeBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): Promise<string>;
+  /**
+   * Read file content as raw FileData.
+   *
+   * @param filePath - Absolute file path
+   * @returns Raw file content as FileData
+   */
+  readRaw(filePath: string): Promise<FileData>;
   /**
    * Structured search results or error string for invalid input.
    */
@@ -573,7 +619,7 @@ declare class CompositeBackend implements BackendProtocol {
  */
 interface CreateDeepAgentParams<ContextSchema extends AnnotationRoot<any> | InteropZodObject = AnnotationRoot<any>> {
   /** The model to use (model name string or LanguageModelLike instance). Defaults to claude-sonnet-4-5-20250929 */
-  model?: LanguageModelLike | string;
+  model?: BaseLanguageModel | string;
   /** Tools the agent should have access to */
   tools?: StructuredTool$1[];
   /** Custom system prompt for the agent. This will be combined with the base agent prompt */

package/dist/index.js

@@ -312,6 +312,17 @@ var StateBackend = class {
 		return formatReadResponse(fileData, offset, limit);
 	}
 	/**
+	* Read file content as raw FileData.
+	*
+	* @param filePath - Absolute file path
+	* @returns Raw file content as FileData
+	*/
+	readRaw(filePath) {
+		const fileData = this.getFiles()[filePath];
+		if (!fileData) throw new Error(`File '${filePath}' not found`);
+		return fileData;
+	}
+	/**
 	* Create a new file with content.
 	* Returns WriteResult with filesUpdate to update LangGraph state.
 	*/
@@ -426,7 +437,8 @@ const GREP_TOOL_DESCRIPTION = "Search for a regex pattern in files. Returns matc
 /**
 * Create ls tool using backend.
 */
-function createLsTool(backend, customDescription) {
+function createLsTool(backend, options) {
+	const { customDescription } = options;
 	return tool(async (input, config) => {
 		const resolvedBackend = getBackend(backend, {
 			state: getCurrentTaskInput(config),
@@ -451,7 +463,8 @@ function createLsTool(backend, customDescription) {
 /**
 * Create read_file tool using backend.
 */
-function createReadFileTool(backend, customDescription) {
+function createReadFileTool(backend, options) {
+	const { customDescription } = options;
 	return tool(async (input, config) => {
 		const resolvedBackend = getBackend(backend, {
 			state: getCurrentTaskInput(config),
@@ -472,24 +485,32 @@ function createReadFileTool(backend, customDescription) {
 /**
 * Create write_file tool using backend.
 */
-function createWriteFileTool(backend, customDescription) {
+function createWriteFileTool(backend, options) {
+	const { customDescription, events } = options;
 	return tool(async (input, config) => {
 		const resolvedBackend = getBackend(backend, {
 			state: getCurrentTaskInput(config),
 			store: config.store
 		});
 		const { file_path, content } = input;
-		const result = await awaitIfPromise(resolvedBackend.write(file_path, content));
+		const result = await resolvedBackend.write(file_path, content);
 		if (result.error) return result.error;
+		const resolved = await events?.onWrite?.(file_path, resolvedBackend) ?? void 0;
+		const metadata = await (async () => {
+			if (resolved?.kind === "metadata") return resolved.data;
+			if (resolved?.kind === "raw-contents") return { ...await resolvedBackend.readRaw(file_path) };
+		})();
+		const message = new ToolMessage({
+			content: `Successfully wrote to '${file_path}'`,
+			tool_call_id: config.toolCall?.id,
+			name: "write_file",
+			metadata
+		});
 		if (result.filesUpdate) return new Command({ update: {
 			files: result.filesUpdate,
-			messages: [new ToolMessage({
-				content: `Successfully wrote to '${file_path}'`,
-				tool_call_id: config.toolCall?.id,
-				name: "write_file"
-			})]
+			messages: [message]
 		} });
-		return `Successfully wrote to '${file_path}'`;
+		return message;
 	}, {
 		name: "write_file",
 		description: customDescription || WRITE_FILE_TOOL_DESCRIPTION,
@@ -502,7 +523,8 @@ function createWriteFileTool(backend, customDescription) {
 /**
 * Create edit_file tool using backend.
 */
-function createEditFileTool(backend, customDescription) {
+function createEditFileTool(backend, options) {
+	const { customDescription, events } = options;
 	return tool(async (input, config) => {
 		const resolvedBackend = getBackend(backend, {
 			state: getCurrentTaskInput(config),
@@ -511,14 +533,20 @@ function createEditFileTool(backend, customDescription) {
 		const { file_path, old_string, new_string, replace_all = false } = input;
 		const result = await awaitIfPromise(resolvedBackend.edit(file_path, old_string, new_string, replace_all));
 		if (result.error) return result.error;
-		const message = `Successfully replaced ${result.occurrences} occurrence(s) in '${file_path}'`;
+		const resolved = await events?.onWrite?.(file_path, resolvedBackend) ?? void 0;
+		const metadata = await (async () => {
+			if (resolved?.kind === "metadata") return resolved.data;
+			if (resolved?.kind === "raw-contents") return { ...await resolvedBackend.readRaw(file_path) };
+		})();
+		const message = new ToolMessage({
+			content: `Successfully replaced ${result.occurrences} occurrence(s) in '${file_path}'`,
+			tool_call_id: config.toolCall?.id,
+			name: "edit_file",
+			metadata
+		});
 		if (result.filesUpdate) return new Command({ update: {
 			files: result.filesUpdate,
-			messages: [new ToolMessage({
-				content: message,
-				tool_call_id: config.toolCall?.id,
-				name: "edit_file"
-			})]
+			messages: [message]
 		} });
 		return message;
 	}, {
@@ -535,7 +563,8 @@ function createEditFileTool(backend, customDescription) {
 /**
 * Create glob tool using backend.
 */
-function createGlobTool(backend, customDescription) {
+function createGlobTool(backend, options) {
+	const { customDescription } = options;
 	return tool(async (input, config) => {
 		const resolvedBackend = getBackend(backend, {
 			state: getCurrentTaskInput(config),
@@ -557,7 +586,8 @@ function createGlobTool(backend, customDescription) {
 /**
 * Create grep tool using backend.
 */
-function createGrepTool(backend, customDescription) {
+function createGrepTool(backend, options) {
+	const { customDescription } = options;
 	return tool(async (input, config) => {
 		const resolvedBackend = getBackend(backend, {
 			state: getCurrentTaskInput(config),
@@ -591,15 +621,33 @@ function createGrepTool(backend, customDescription) {
 * Create filesystem middleware with all tools and features.
 */
 function createFilesystemMiddleware(options = {}) {
-	const { backend = (stateAndStore) => new StateBackend(stateAndStore), systemPrompt: customSystemPrompt = null, customToolDescriptions = null, toolTokenLimitBeforeEvict = 2e4 } = options;
+	const { backend = (stateAndStore) => new StateBackend(stateAndStore), systemPrompt: customSystemPrompt = null, customToolDescriptions = null, toolTokenLimitBeforeEvict = 2e4, events = void 0 } = options;
 	const systemPrompt = customSystemPrompt || FILESYSTEM_SYSTEM_PROMPT;
 	const tools = [
-		createLsTool(backend, customToolDescriptions?.ls ?? null),
-		createReadFileTool(backend, customToolDescriptions?.read_file ?? null),
-		createWriteFileTool(backend, customToolDescriptions?.write_file ?? null),
-		createEditFileTool(backend, customToolDescriptions?.edit_file ?? null),
-		createGlobTool(backend, customToolDescriptions?.glob ?? null),
-		createGrepTool(backend, customToolDescriptions?.grep ?? null)
+		createLsTool(backend, {
+			customDescription: customToolDescriptions?.ls ?? null,
+			events
+		}),
+		createReadFileTool(backend, {
+			customDescription: customToolDescriptions?.read_file ?? null,
+			events
+		}),
+		createWriteFileTool(backend, {
+			customDescription: customToolDescriptions?.write_file ?? null,
+			events
+		}),
+		createEditFileTool(backend, {
+			customDescription: customToolDescriptions?.edit_file ?? null,
+			events
+		}),
+		createGlobTool(backend, {
+			customDescription: customToolDescriptions?.glob ?? null,
+			events
+		}),
+		createGrepTool(backend, {
+			customDescription: customToolDescriptions?.grep ?? null,
+			events
+		})
 	];
 	return createMiddleware({
 		name: "FilesystemMiddleware",
@@ -908,7 +956,7 @@ function createTaskTool(options) {
 		const subagent = subagentGraphs[subagent_type];
 		const subagentState = filterStateForSubagent(getCurrentTaskInput());
 		subagentState.messages = [new HumanMessage({ content: description })];
-		const result = await subagent.invoke(subagentState);
+		const result = await subagent.invoke(subagentState, config);
 		if (!config.toolCall?.id) throw new Error("Tool call ID is required for subagent invocation");
 		return returnCommandWithStateUpdate(result, config.toolCall.id);
 	}, {
@@ -1146,17 +1194,26 @@ var StoreBackend = class {
 	* @returns Formatted file content with line numbers, or error message
 	*/
 	async read(filePath, offset = 0, limit = 2e3) {
-		const store = this.getStore();
-		const namespace = this.getNamespace();
-		const item = await store.get(namespace, filePath);
-		if (!item) return `Error: File '${filePath}' not found`;
 		try {
-			return formatReadResponse(this.convertStoreItemToFileData(item), offset, limit);
+			return formatReadResponse(await this.readRaw(filePath), offset, limit);
 		} catch (e) {
 			return `Error: ${e.message}`;
 		}
 	}
 	/**
+	* Read file content as raw FileData.
+	*
+	* @param filePath - Absolute file path
+	* @returns Raw file content as FileData
+	*/
+	async readRaw(filePath) {
+		const store = this.getStore();
+		const namespace = this.getNamespace();
+		const item = await store.get(namespace, filePath);
+		if (!item) throw new Error(`File '${filePath}' not found`);
+		return this.convertStoreItemToFileData(item);
+	}
+	/**
 	* Create a new file with content.
 	* Returns WriteResult. External storage sets filesUpdate=null.
 	*/
@@ -1389,6 +1446,37 @@ var FilesystemBackend = class {
 		}
 	}
 	/**
+	* Read file content as raw FileData.
+	*
+	* @param filePath - Absolute file path
+	* @returns Raw file content as FileData
+	*/
+	async readRaw(filePath) {
+		const resolvedPath = this.resolvePath(filePath);
+		let content;
+		let stat;
+		if (SUPPORTS_NOFOLLOW) {
+			stat = await fs.stat(resolvedPath);
+			if (!stat.isFile()) throw new Error(`File '${filePath}' not found`);
+			const fd = await fs.open(resolvedPath, fsSync.constants.O_RDONLY | fsSync.constants.O_NOFOLLOW);
+			try {
+				content = await fd.readFile({ encoding: "utf-8" });
+			} finally {
+				await fd.close();
+			}
+		} else {
+			stat = await fs.lstat(resolvedPath);
+			if (stat.isSymbolicLink()) throw new Error(`Symlinks are not allowed: ${filePath}`);
+			if (!stat.isFile()) throw new Error(`File '${filePath}' not found`);
+			content = await fs.readFile(resolvedPath, "utf-8");
+		}
+		return {
+			content: content.split("\n"),
+			created_at: stat.ctime.toISOString(),
+			modified_at: stat.mtime.toISOString()
+		};
+	}
+	/**
 	* Create a new file with content.
 	* Returns WriteResult. External storage sets filesUpdate=null.
 	*/
@@ -1720,6 +1808,16 @@ var CompositeBackend = class {
 		return await backend.read(strippedKey, offset, limit);
 	}
 	/**
+	* Read file content as raw FileData.
+	*
+	* @param filePath - Absolute file path
+	* @returns Raw file content as FileData
+	*/
+	async readRaw(filePath) {
+		const [backend, strippedKey] = this.getBackendAndKey(filePath);
+		return await backend.readRaw(strippedKey);
+	}
+	/**
 	* Structured search results or error string for invalid input.
 	*/
 	async grepRaw(pattern, path$1 = "/", glob = null) {
@@ -1829,8 +1927,8 @@ function createDeepAgent(params = {}) {
 				createFilesystemMiddleware({ backend: filesystemBackend }),
 				summarizationMiddleware({
 					model,
-					maxTokensBeforeSummary: 17e4,
-					messagesToKeep: 6
+					trigger: { tokens: 17e4 },
+					keep: { messages: 6 }
 				}),
 				anthropicPromptCachingMiddleware({ unsupportedModelBehavior: "ignore" }),
 				createPatchToolCallsMiddleware()
@@ -1841,8 +1939,8 @@ function createDeepAgent(params = {}) {
 		}),
 		summarizationMiddleware({
 			model,
-			maxTokensBeforeSummary: 17e4,
-			messagesToKeep: 6
+			trigger: { tokens: 17e4 },
+			keep: { messages: 6 }
 		}),
 		anthropicPromptCachingMiddleware({ unsupportedModelBehavior: "ignore" }),
 		createPatchToolCallsMiddleware()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepagents",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Deep Agents - a library for building controllable AI agents with LangGraph",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,7 +28,7 @@
     "@langchain/core": "^1.0.0",
     "@langchain/langgraph": "^1.0.0",
     "fast-glob": "^3.3.3",
-    "langchain": "^1.0.0",
+    "langchain": "^1.0.4",
     "micromatch": "^4.0.8",
     "zod": "^4.1.11"
   },
@@ -36,9 +36,9 @@
     "@changesets/cli": "^2.29.7",
     "@eslint/eslintrc": "^3.1.0",
     "@eslint/js": "^9.19.0",
-    "@langchain/langgraph-checkpoint": "^0.0.13",
+    "@langchain/langgraph-checkpoint": "^1.0.0",
     "@langchain/openai": "^1.0.0",
-    "@langchain/tavily": "^0.1.4",
+    "@langchain/tavily": "^1.0.0",
     "@tsconfig/recommended": "^1.0.10",
     "@types/micromatch": "^4.0.10",
     "@types/node": "^22.13.5",