deepagents 1.12.1 → 1.12.3

package/dist/{langsmith-DdOXam6Z.cjs → langsmith-Bjhs2iT_.cjs}

@@ -15,7 +15,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
@@ -326,13 +326,13 @@ function performStringReplacement(content, oldString, newString, replaceAll) {
 function truncateIfTooLong(result) {
 	if (Array.isArray(result)) {
 		const totalChars = result.reduce((sum, item) => sum + item.length, 0);
-		if (totalChars > 2e4 * 4) {
+		if (totalChars > 8e4) {
 			const truncateAt = Math.floor(result.length * TOOL_RESULT_TOKEN_LIMIT * 4 / totalChars);
 			return [...result.slice(0, truncateAt), TRUNCATION_GUIDANCE];
 		}
 		return result;
 	}
-	if (result.length > 2e4 * 4) return result.substring(0, TOOL_RESULT_TOKEN_LIMIT * 4) + "\n... [results truncated, try being more specific with your parameters]";
+	if (result.length > 8e4) return result.substring(0, TOOL_RESULT_TOKEN_LIMIT * 4) + "\n... [results truncated, try being more specific with your parameters]";
 	return result;
 }
 /**
@@ -425,6 +425,30 @@ function globSearchFiles(files, pattern, path = "/") {
 	return matches.map(([fp]) => fp).join("\n");
 }
 /**
+* Format grep search results based on output mode.
+*
+* @param results - Dictionary mapping file paths to list of [line_num, line_content] tuples
+* @param outputMode - Output format - "files_with_matches", "content", or "count"
+* @returns Formatted string output
+*/
+function formatGrepResults(results, outputMode) {
+	if (outputMode === "files_with_matches") return Object.keys(results).sort().join("\n");
+	if (outputMode === "count") {
+		const lines = [];
+		for (const filePath of Object.keys(results).sort()) {
+			const count = results[filePath].length;
+			lines.push(`${filePath}: ${count}`);
+		}
+		return lines.join("\n");
+	}
+	const lines = [];
+	for (const filePath of Object.keys(results).sort()) {
+		lines.push(`${filePath}:`);
+		for (const [lineNum, line] of results[filePath]) lines.push(`  ${lineNum}: ${line}`);
+	}
+	return lines.join("\n");
+}
+/**
 * Return structured grep matches from an in-memory files mapping.
 *
 * Performs literal text search (not regex). Binary files are skipped.
@@ -455,6 +479,24 @@ function grepMatchesFromFiles(files, pattern, path = null, glob = null) {
 	return matches;
 }
 /**
+* Group structured matches into the legacy dict form used by formatters.
+*/
+function buildGrepResultsDict(matches) {
+	const grouped = {};
+	for (const m of matches) {
+		if (!grouped[m.path]) grouped[m.path] = [];
+		grouped[m.path].push([m.line, m.text]);
+	}
+	return grouped;
+}
+/**
+* Format structured grep matches using existing formatting logic.
+*/
+function formatGrepMatches(matches, outputMode) {
+	if (matches.length === 0) return "No matches found";
+	return formatGrepResults(buildGrepResultsDict(matches), outputMode);
+}
+/**
 * Determine MIME type from a file path's extension.
 *
 * Defaults to "text/plain" for unknown extensions. Only the known non-text
@@ -554,9 +596,12 @@ function adaptBackendProtocol(backend) {
 			if (typeof result === "string") return { content: result };
 			return result;
 		},
-		async grep(pattern, path, glob) {
-			const result = await ("grep" in backend ? backend.grep(pattern, path, glob) : backend.grepRaw(pattern, path, glob));
-			if (Array.isArray(result)) return { matches: result };
+		async grep(pattern, path, glob, maxCount) {
+			const result = await ("grep" in backend ? backend.grep(pattern, path, glob, maxCount) : backend.grepRaw(pattern, path, glob));
+			if (Array.isArray(result)) return applyGrepMaxCount({
+				result: { matches: result },
+				maxCount
+			});
 			if (typeof result === "string") return { error: result };
 			return result;
 		}
@@ -591,6 +636,21 @@ function adaptSandboxProtocol(sandbox) {
 //#endregion
 //#region src/backends/protocol.ts
 /**
+* Enforce a match cap after a backend grep has completed.
+*
+* When `maxCount` is set and the result exceeds it, the matches are sliced
+* to the cap and the result is flagged `truncated: true`.
+*/
+function applyGrepMaxCount(params) {
+	const { result, maxCount } = params;
+	if (maxCount == null || result.matches == null || result.matches.length <= maxCount) return result;
+	return {
+		error: result.error,
+		matches: result.matches.slice(0, maxCount),
+		truncated: true
+	};
+}
+/**
 * Type guard to check if a backend supports execution.
 *
 * @param backend - Backend instance to check
@@ -871,9 +931,12 @@ var StateBackend = class {
 	* Search file contents for a literal text pattern.
 	* Binary files are skipped.
 	*/
-	grep(pattern, path = "/", glob = null) {
+	grep(pattern, path = "/", glob = null, maxCount = null) {
 		const files = this.files;
-		return { matches: grepMatchesFromFiles(files, pattern, path, glob) };
+		return applyGrepMaxCount({
+			result: { matches: grepMatchesFromFiles(files, pattern, path, glob) },
+			maxCount
+		});
 	}
 	/**
 	* Structured glob matching returning FileInfo objects.
@@ -1115,7 +1178,7 @@ var CompositeBackend = class {
 			const results = [];
 			const defaultResult = await this.default.ls(path);
 			if (defaultResult.error) return defaultResult;
-			results.push(...defaultResult.files || []);
+			for (const fi of defaultResult.files || []) results.push(fi);
 			for (const [routePrefix] of this.sortedRoutes) results.push({
 				path: routePrefix,
 				is_dir: true,
@@ -1151,33 +1214,56 @@ var CompositeBackend = class {
 	}
 	/**
 	* Structured search results or error string for invalid input.
+	*
+	* @param maxCount - Optional total cap on returned matches across all routed
+	*                   backends. When the cap is reached, remaining routes are
+	*                   short-circuited and the result is flagged `truncated: true`.
 	*/
-	async grep(pattern, path = "/", glob = null) {
+	async grep(pattern, path = "/", glob = null, maxCount = null) {
 		const searchPath = path || "/";
 		for (const [routePrefix, backend] of this.sortedRoutes) if (this.isPathWithinRoute(searchPath, routePrefix)) {
 			const routeSearchPath = searchPath.substring(routePrefix.length - 1);
-			const raw = await backend.grep(pattern, routeSearchPath || "/", glob);
+			const raw = await backend.grep(pattern, routeSearchPath || "/", glob, maxCount);
 			if (raw.error) return raw;
-			return { matches: (raw.matches || []).map((m) => ({
-				...m,
-				path: routePrefix.slice(0, -1) + m.path
-			})) };
+			return applyGrepMaxCount({
+				result: {
+					matches: (raw.matches || []).map((m) => ({
+						...m,
+						path: routePrefix.slice(0, -1) + m.path
+					})),
+					truncated: raw.truncated
+				},
+				maxCount
+			});
 		}
 		const allMatches = [];
-		const rawDefault = await this.default.grep(pattern, searchPath, glob);
+		let truncated = false;
+		const rawDefault = await this.default.grep(pattern, searchPath, glob, maxCount);
 		if (rawDefault.error) return rawDefault;
-		allMatches.push(...rawDefault.matches || []);
+		for (const m of rawDefault.matches || []) allMatches.push(m);
+		truncated = truncated || rawDefault.truncated === true;
 		for (const [routePrefix, backend] of Object.entries(this.routes)) {
 			if (!this.isRouteUnderPath(routePrefix, searchPath)) continue;
-			const raw = await backend.grep(pattern, "/", glob);
+			const remaining = maxCount == null ? null : Math.max(maxCount - allMatches.length, 0);
+			if (remaining === 0) {
+				truncated = true;
+				break;
+			}
+			const raw = await backend.grep(pattern, "/", glob, remaining);
 			if (raw.error) return raw;
-			const matches = (raw.matches || []).map((m) => ({
+			for (const m of raw.matches || []) allMatches.push({
 				...m,
 				path: routePrefix.slice(0, -1) + m.path
-			}));
-			allMatches.push(...matches);
+			});
+			truncated = truncated || raw.truncated === true;
 		}
-		return { matches: allMatches };
+		return applyGrepMaxCount({
+			result: {
+				matches: allMatches,
+				truncated
+			},
+			maxCount
+		});
 	}
 	/**
 	* Structured glob matching returning FileInfo objects.
@@ -1188,26 +1274,33 @@ var CompositeBackend = class {
 			const searchPath = path.substring(routePrefix.length - 1);
 			const result = await backend.glob(pattern, searchPath || "/");
 			if (result.error) return result;
-			return { files: (result.files || []).map((fi) => ({
-				...fi,
-				path: routePrefix.slice(0, -1) + fi.path
-			})) };
+			return {
+				files: (result.files || []).map((fi) => ({
+					...fi,
+					path: routePrefix.slice(0, -1) + fi.path
+				})),
+				truncated: result.truncated
+			};
 		}
 		const defaultResult = await this.default.glob(pattern, path);
 		if (defaultResult.error) return defaultResult;
-		results.push(...defaultResult.files || []);
+		for (const fi of defaultResult.files || []) results.push(fi);
+		let truncated = defaultResult.truncated === true;
 		for (const [routePrefix, backend] of Object.entries(this.routes)) {
 			if (!this.isRouteUnderPath(routePrefix, path)) continue;
 			const result = await backend.glob(pattern, "/");
 			if (result.error) continue;
-			const files = (result.files || []).map((fi) => ({
+			for (const fi of result.files || []) results.push({
 				...fi,
 				path: routePrefix.slice(0, -1) + fi.path
-			}));
-			results.push(...files);
+			});
+			truncated = truncated || result.truncated === true;
 		}
 		results.sort((a, b) => a.path.localeCompare(b.path));
-		return { files: results };
+		return {
+			files: results,
+			truncated
+		};
 	}
 	/**
 	* Write content to a file, routing to appropriate backend.
@@ -1394,7 +1487,7 @@ const TOOLS_EXCLUDED_FROM_EVICTION = FILESYSTEM_TOOL_NAMES.filter((name) => name
 * Base64-encoded content is ~33% larger, so 10MB raw ≈ 13.3MB in context.
 * This keeps inline multimodal payloads within all major provider limits.
 */
-const MAX_BINARY_READ_SIZE_BYTES = 10 * 1024 * 1024;
+const MAX_BINARY_READ_SIZE_BYTES = 10485760;
 /**
 * Template for truncation message in read_file.
 * {file_path} will be filled in at runtime.
@@ -1403,6 +1496,15 @@ const READ_FILE_TRUNCATION_MSG = `
 
 [Output was truncated due to size limits. The file content is very large. Consider reformatting the file to make it easier to navigate. For example, if this is JSON, use execute(command='jq . {file_path}') to pretty-print it with line breaks. For other formats, you can use appropriate formatting tools to split long lines.]`;
 /**
+* Note appended to grep results that were cut short by the match-count cap.
+*/
+const GREP_TRUNCATION_NOTE = "Note: the search stopped early because it hit the maximum match count. The matches above are valid but incomplete. Narrow the search (a more specific pattern or a narrower path), or raise max_count, to see the rest.";
+/**
+* Default cap on the number of matches the grep tool returns.
+* Set to null to disable the cap.
+*/
+const DEFAULT_GREP_MAX_COUNT = 1e3;
+/**
 * Message template for evicted tool results.
 */
 const TOO_LARGE_TOOL_MSG = langchain.context`
@@ -1474,8 +1576,9 @@ function buildEvictedHumanContent(message, replacementText) {
 */
 function buildTruncatedHumanMessage(message, filePath) {
 	const contentSample = createContentPreview(extractTextFromMessage(message));
+	const evictedContent = buildEvictedHumanContent(message, TOO_LARGE_HUMAN_MSG.replace("{file_path}", filePath).replace("{content_sample}", contentSample));
 	return new langchain.HumanMessage({
-		content: buildEvictedHumanContent(message, TOO_LARGE_HUMAN_MSG.replace("{file_path}", filePath).replace("{content_sample}", contentSample)),
+		content: evictedContent,
 		id: message.id,
 		additional_kwargs: { ...message.additional_kwargs },
 		response_metadata: { ...message.response_metadata }
@@ -1749,7 +1852,7 @@ function createReadFileTool(backend, options) {
 			const sizeBytes = Math.ceil(base64Data.length * 3 / 4);
 			if (sizeBytes > 10485760) return [{
 				type: "text",
-				text: `Error: file too large to read (${Math.round(sizeBytes / (1024 * 1024))}MB exceeds ${MAX_BINARY_READ_SIZE_BYTES / (1024 * 1024)}MB limit for binary files)`
+				text: `Error: file too large to read (${Math.round(sizeBytes / 1048576)}MB exceeds ${MAX_BINARY_READ_SIZE_BYTES / 1048576}MB limit for binary files)`
 			}];
 			if (mimeType.startsWith("image/")) return [{
 				type: "image",
@@ -1891,35 +1994,34 @@ function createGlobTool(backend, options) {
 * Create grep tool using backend.
 */
 function createGrepTool(backend, options) {
-	const { customDescription, permissions, includeExecution } = options;
+	const { customDescription, permissions, includeExecution, grepMaxCount } = options;
 	return (0, langchain.tool)(async (input, runtime) => {
 		const permissionError = checkPermission(permissions, "read", input.path ?? "/");
 		if (permissionError !== void 0) return toolError(runtime, "grep", permissionError);
 		const resolvedBackend = await resolveBackend(backend, runtime);
-		const { pattern, path = "/", glob = null } = input;
-		const result = await resolvedBackend.grep(pattern, path, glob);
+		const { pattern, path = "/", glob = null, output_mode = "content" } = input;
+		const maxCount = input.max_count ?? grepMaxCount;
+		const result = await resolvedBackend.grep(pattern, path, glob, maxCount);
 		if (result.error) return result.error;
 		const matches = filterByPermissions(result.matches ?? [], permissions, "read", (m) => m.path);
 		if (matches.length === 0) return `No matches found for pattern '${pattern}'`;
-		const lines = [];
-		let currentFile = null;
-		for (const match of matches) {
-			if (match.path !== currentFile) {
-				currentFile = match.path;
-				lines.push(`\n${currentFile}:`);
-			}
-			lines.push(`  ${match.line}: ${match.text}`);
-		}
-		const truncated = truncateIfTooLong(lines);
-		if (Array.isArray(truncated)) return truncated.join("\n");
-		return truncated;
+		const truncated = truncateIfTooLong(formatGrepMatches(matches, output_mode));
+		let content = typeof truncated === "string" ? truncated : truncated.join("\n");
+		if (result.truncated) content += `\n\n${GREP_TRUNCATION_NOTE}`;
+		return content;
 	}, {
 		name: "grep",
 		description: customDescription || getGrepToolDescription(includeExecution),
 		schema: zod_v4.z.object({
 			pattern: zod_v4.z.string().describe("Literal text pattern to search for (not regex)"),
 			path: zod_v4.z.string().optional().default("/").describe("Base path to search from (default: /)"),
-			glob: zod_v4.z.string().optional().nullable().default(null).describe("Optional glob pattern to filter files (e.g., '*.py')")
+			glob: zod_v4.z.string().optional().nullable().default(null).describe("Optional glob pattern to filter files (e.g., '*.py')"),
+			max_count: zod_v4.z.number().int().positive().optional().nullable().default(null).describe("Optional cap on the total number of matches returned across all files. Leave unset to use the configured default. When the cap is hit, results are truncated and a note says so; narrow the pattern or path to see the rest."),
+			output_mode: zod_v4.z.enum([
+				"files_with_matches",
+				"content",
+				"count"
+			]).optional().default("content").describe("Output format: 'files_with_matches' lists matching file paths, 'content' shows matching lines (default), 'count' shows match counts per file")
 		})
 	});
 }
@@ -1988,7 +2090,7 @@ function allPathsScopedToRoutes(permissions, backend) {
 * ```
 */
 function createFilesystemMiddleware(options = {}) {
-	const { backend = (runtime) => new StateBackend(runtime), systemPrompt: customSystemPrompt = null, customToolDescriptions = null, toolTokenLimitBeforeEvict = 2e4, humanMessageTokenLimitBeforeEvict = 5e4, permissions = [], tools: filesystemTools = null } = options;
+	const { backend = (runtime) => new StateBackend(runtime), systemPrompt: customSystemPrompt = null, customToolDescriptions = null, toolTokenLimitBeforeEvict = 2e4, humanMessageTokenLimitBeforeEvict = 5e4, permissions = [], tools: filesystemTools = null, grepMaxCount = DEFAULT_GREP_MAX_COUNT } = options;
 	const enabledFilesystemTools = normalizeFilesystemTools(filesystemTools);
 	const executeToolEnabled = enabledFilesystemTools == null || enabledFilesystemTools.has("execute");
 	if (permissions.length > 0) validatePermissionPaths(permissions);
@@ -2024,7 +2126,8 @@ function createFilesystemMiddleware(options = {}) {
 		grep: createGrepTool(backend, {
 			customDescription: customToolDescriptions?.grep,
 			permissions,
-			includeExecution: configuredToolNames.has("execute") && typeof backend !== "function" && isSandboxBackend(backend)
+			includeExecution: configuredToolNames.has("execute") && typeof backend !== "function" && isSandboxBackend(backend),
+			grepMaxCount
 		}),
 		execute: createExecuteTool(backend, {
 			customDescription: customToolDescriptions?.execute,
@@ -2055,9 +2158,10 @@ function createFilesystemMiddleware(options = {}) {
 		const evictPath = `/large_tool_results/${sanitizeToolCallId(fallbackToolCallId || msg.tool_call_id)}.txt`;
 		const writeResult = await resolvedBackend.write(evictPath, textContent);
 		const contentSample = createContentPreview(textContent);
+		const replacementText = writeResult.error ? `Tool result too large, but the result could not be saved to the filesystem: ${writeResult.error}` : TOO_LARGE_TOOL_MSG.replace("{tool_call_id}", msg.tool_call_id).replace("{file_path}", evictPath).replace("{content_sample}", contentSample);
 		return {
 			message: new langchain.ToolMessage({
-				content: writeResult.error ? `Tool result too large, but the result could not be saved to the filesystem: ${writeResult.error}` : TOO_LARGE_TOOL_MSG.replace("{tool_call_id}", msg.tool_call_id).replace("{file_path}", evictPath).replace("{content_sample}", contentSample),
+				content: replacementText,
 				tool_call_id: msg.tool_call_id,
 				name: msg.name,
 				id: msg.id,
@@ -2402,6 +2506,7 @@ function createTaskTool(options) {
 		}
 		return subagentGraphs[subagentType];
 	}
+	const finalTaskDescription = taskDescription ? taskDescription : getTaskToolDescription(subagentDescriptions);
 	return (0, langchain.tool)(async (input, config) => {
 		const { description, subagent_type } = input;
 		if (!(subagent_type in subagentGraphs)) {
@@ -2437,7 +2542,7 @@ function createTaskTool(options) {
 		return returnCommandWithStateUpdate(result, config.toolCall.id);
 	}, {
 		name: "task",
-		description: taskDescription ? taskDescription : getTaskToolDescription(subagentDescriptions),
+		description: finalTaskDescription,
 		schema: zod_v4.z.object({
 			description: zod_v4.z.string().describe("The task to execute with the selected agent"),
 			subagent_type: zod_v4.z.string().describe(`Name of the agent to use. Available: ${Object.keys(subagentGraphs).join(", ")}`)
@@ -2449,18 +2554,19 @@ function createTaskTool(options) {
 */
 function createSubAgentMiddleware(options) {
 	const { defaultModel, defaultTools = [], defaultMiddleware = null, generalPurposeMiddleware = null, defaultInterruptOn = null, subagents = [], systemPrompt = null, generalPurposeAgent = true, taskDescription = null } = options;
+	const taskTool = createTaskTool({
+		defaultModel,
+		defaultTools,
+		defaultMiddleware,
+		generalPurposeMiddleware,
+		defaultInterruptOn,
+		subagents,
+		generalPurposeAgent,
+		taskDescription
+	});
 	return (0, langchain.createMiddleware)({
 		name: "subAgentMiddleware",
-		tools: [createTaskTool({
-			defaultModel,
-			defaultTools,
-			defaultMiddleware,
-			generalPurposeMiddleware,
-			defaultInterruptOn,
-			subagents,
-			generalPurposeAgent,
-			taskDescription
-		})],
+		tools: [taskTool],
 		wrapModelCall: async (request, handler) => {
 			if (systemPrompt !== null) return handler({
 				...request,
@@ -2965,7 +3071,7 @@ function createMemoryMiddleware(options) {
 * });
 * ```
 */
-const MAX_SKILL_FILE_SIZE = 10 * 1024 * 1024;
+const MAX_SKILL_FILE_SIZE = 10485760;
 const DEFAULT_SKILL_READ_LINE_LIMIT = 1e3;
 const MAX_SKILL_NAME_LENGTH = 64;
 const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
@@ -3733,7 +3839,6 @@ function createCompletionCallbackMiddleware(options) {
 * from `langchain` directly.
 */
 const DEFAULT_MESSAGES_TO_KEEP = 20;
-const DEFAULT_TRIM_TOKEN_LIMIT = 4e3;
 const FALLBACK_TRIGGER = {
 	type: "tokens",
 	value: 17e4
@@ -3850,7 +3955,7 @@ function isSummaryMessage(msg) {
 * @returns AgentMiddleware for summarization and history offloading
 */
 function createSummarizationMiddleware(options) {
-	const { model, backend, summaryPrompt = DEFAULT_SUMMARY_PROMPT, trimTokensToSummarize = DEFAULT_TRIM_TOKEN_LIMIT, historyPathPrefix = "/conversation_history" } = options;
+	const { model, backend, summaryPrompt = DEFAULT_SUMMARY_PROMPT, trimTokensToSummarize, historyPathPrefix = "/conversation_history" } = options;
 	let trigger = options.trigger;
 	let keep = options.keep ?? {
 		type: "messages",
@@ -4054,7 +4159,9 @@ function createSummarizationMiddleware(options) {
 	* This gives a more accurate picture of what actually gets sent to the model.
 	*/
 	function countTotalTokens(messages, systemMessage, tools) {
-		return (0, langchain.countTokensApproximately)(systemMessage && langchain.SystemMessage.isInstance(systemMessage) ? [systemMessage, ...messages] : [...messages], tools && Array.isArray(tools) && tools.length > 0 ? tools : null);
+		const countedMessages = systemMessage && langchain.SystemMessage.isInstance(systemMessage) ? [systemMessage, ...messages] : [...messages];
+		const toolsArray = tools && Array.isArray(tools) && tools.length > 0 ? tools : null;
+		return (0, langchain.countTokensApproximately)(countedMessages, toolsArray);
 	}
 	/**
 	* Truncate ToolMessage content so that the total payload fits within the
@@ -4201,7 +4308,8 @@ function createSummarizationMiddleware(options) {
 	*/
 	async function createSummary(messages, chatModel) {
 		let messagesToSummarize = messages;
-		if ((0, langchain.countTokensApproximately)(messages) > trimTokensToSummarize) {
+		const tokens = (0, langchain.countTokensApproximately)(messages);
+		if (trimTokensToSummarize !== void 0 && tokens > trimTokensToSummarize) {
 			let kept = 0;
 			const trimmedMessages = [];
 			for (let i = messages.length - 1; i >= 0; i--) {
@@ -4214,8 +4322,7 @@ function createSummarizationMiddleware(options) {
 		}
 		const conversation = (0, _langchain_core_messages.getBufferString)(messagesToSummarize);
 		const prompt = summaryPrompt.replace("{conversation}", conversation);
-		const response = await chatModel.invoke([new langchain.HumanMessage({ content: prompt })]);
-		return typeof response.content === "string" ? response.content : JSON.stringify(response.content);
+		return (await chatModel.invoke([new langchain.HumanMessage({ content: prompt })])).text;
 	}
 	/**
 	* Build the summary message with file path reference.
@@ -6386,7 +6493,7 @@ var StoreBackend = class {
 	* Search file contents for a literal text pattern.
 	* Binary files are skipped.
 	*/
-	async grep(pattern, path = "/", glob = null) {
+	async grep(pattern, path = "/", glob = null, maxCount = null) {
 		const store = this.getStore();
 		const namespace = this.getNamespace();
 		const items = await this.searchStorePaginated(store, namespace);
@@ -6396,7 +6503,10 @@ var StoreBackend = class {
 		} catch {
 			continue;
 		}
-		return { matches: grepMatchesFromFiles(files, pattern, path, glob) };
+		return applyGrepMaxCount({
+			result: { matches: grepMatchesFromFiles(files, pattern, path, glob) },
+			maxCount
+		});
 	}
 	/**
 	* Structured glob matching returning FileInfo objects.
@@ -6695,7 +6805,7 @@ var ContextHubBackend = class ContextHubBackend {
 			modified_at: now
 		} };
 	}
-	async grep(pattern, path = null, glob = null) {
+	async grep(pattern, path = null, glob = null, maxCount = null) {
 		let cache;
 		try {
 			cache = await this.ensureCache();
@@ -6718,7 +6828,10 @@ var ContextHubBackend = class ContextHubBackend {
 				});
 			}
 		}
-		return { matches };
+		return applyGrepMaxCount({
+			result: { matches },
+			maxCount
+		});
 	}
 	async glob(pattern, _path = "/") {
 		let cache;
@@ -7114,7 +7227,7 @@ var BaseSandbox = class {
 	* @param glob - Optional glob pattern to filter which files to search.
 	* @returns List of GrepMatch dicts containing path, line number, and matched text.
 	*/
-	async grep(pattern, path = "/", glob = null) {
+	async grep(pattern, path = "/", glob = null, maxCount = null) {
 		const command = buildGrepCommand(pattern, path, glob);
 		const output = (await this.execute(command)).output.trim();
 		if (!output) return { matches: [] };
@@ -7132,7 +7245,10 @@ var BaseSandbox = class {
 				});
 			}
 		}
-		return { matches };
+		return applyGrepMaxCount({
+			result: { matches },
+			maxCount
+		});
 	}
 	/**
 	* Structured glob matching returning FileInfo objects.
@@ -7631,6 +7747,12 @@ Object.defineProperty(exports, "adaptSandboxProtocol", {
 		return adaptSandboxProtocol;
 	}
 });
+Object.defineProperty(exports, "applyGrepMaxCount", {
+	enumerable: true,
+	get: function() {
+		return applyGrepMaxCount;
+	}
+});
 Object.defineProperty(exports, "checkEmptyContent", {
 	enumerable: true,
 	get: function() {
@@ -7794,4 +7916,4 @@ Object.defineProperty(exports, "serializeProfile", {
 	}
 });
 
-//# sourceMappingURL=langsmith-DdOXam6Z.cjs.map
+//# sourceMappingURL=langsmith-Bjhs2iT_.cjs.map