deepagents 1.12.3 → 1.12.4

package/dist/{langsmith-CUTUAjHo.js → langsmith-DRyafCNe.js}

@@ -1992,7 +1992,7 @@ function createGrepTool(backend, options) {
 			pattern: z.string().describe("Literal text pattern to search for (not regex)"),
 			path: z.string().optional().default("/").describe("Base path to search from (default: /)"),
 			glob: z.string().optional().nullable().default(null).describe("Optional glob pattern to filter files (e.g., '*.py')"),
-			max_count: 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."),
+			max_count: z.coerce.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: z.enum([
 				"files_with_matches",
 				"content",
@@ -2254,23 +2254,18 @@ const SUBAGENT_RESPONSE_FORMAT_CONFIG_KEY = "__deepagents_subagent_response_form
 */
 const DEFAULT_SUBAGENT_PROMPT = "In order to complete the objective that the user asks of you, you have access to a number of standard tools.";
 /**
-* State keys that are excluded when passing state to subagents and when returning
-* updates from subagents.
-*
-* When returning updates:
-* 1. The messages key is handled explicitly to ensure only the final message is included
-* 2. The todos and structuredResponse keys are excluded as they do not have a defined reducer
-*    and no clear meaning for returning them from a subagent to the main agent.
-* 3. The skillsMetadata and memoryContents keys are automatically excluded from subagent output
-*    to prevent parent state from leaking to child agents. Each agent loads its own skills/memory
-*    independently based on its middleware configuration.
+* State keys excluded when passing state to subagents and when returning
+* updates from subagents. Summarization keys are excluded because their
+* cutoffIndex is only valid against the message list it was computed from.
 */
 const EXCLUDED_STATE_KEYS = [
 	"messages",
 	"todos",
 	"structuredResponse",
 	"skillsMetadata",
-	"memoryContents"
+	"memoryContents",
+	"_summarizationEvent",
+	"_summarizationSessionId"
 ];
 /**
 * Default description for the general-purpose subagent.
@@ -2492,6 +2487,7 @@ function createTaskTool(options) {
 		const subagent = selectSubagent(subagent_type, config);
 		const subagentState = filterStateForSubagent(getCurrentTaskInput());
 		subagentState.messages = [new HumanMessage$1({ content: description })];
+		subagentState._summarizationSessionId = `session_${crypto.randomUUID().substring(0, 8)}`;
 		const subagentConfig = {
 			...config,
 			metadata: {
@@ -2732,6 +2728,43 @@ function isAnthropicModel(model) {
 	return model.getName() === "ChatAnthropic";
 }
 /**
+* A one-shot promise whose settlement is controlled externally.
+*
+* Use this when one part of a workflow must wait for an event that is owned
+* elsewhere—for example, a queued mutation waiting for the worker that will
+* push it. `Deferred` is awaitable because it implements `PromiseLike`, and
+* `.promise` is available when a concrete `Promise` is required.
+*
+* The first call to `resolve` or `reject` wins; later calls are ignored. This
+* class deliberately does not provide cancellation, reset, or notification
+* semantics. It models exactly one eventual outcome.
+*/
+var Deferred = class {
+	promise;
+	settled = false;
+	resolvePromise;
+	rejectPromise;
+	constructor() {
+		this.promise = new Promise((resolve, reject) => {
+			this.resolvePromise = resolve;
+			this.rejectPromise = reject;
+		});
+	}
+	resolve(value) {
+		if (this.settled) return;
+		this.settled = true;
+		this.resolvePromise(value);
+	}
+	reject(reason) {
+		if (this.settled) return;
+		this.settled = true;
+		this.rejectPromise(reason);
+	}
+	then(onfulfilled, onrejected) {
+		return this.promise.then(onfulfilled, onrejected);
+	}
+};
+/**
 * Detect whether a model is an AWS Bedrock Converse model.
 *
 * Accepts the wider `RunnableInterface` shape (the type of `request.model`
@@ -6586,9 +6619,36 @@ var StoreBackend = class {
 /**
 * ContextHubBackend: Store files in a LangSmith Hub agent repo (persistent).
 */
-const URL_COMMIT_SUFFIX_RE = /:([0-9a-f]{8,64})$/i;
+const CONTEXT_URL_COMMIT_PATH_RE = /^\/context\/([^/]+)\/([0-9a-f]{8})$/;
+const LEGACY_URL_COMMIT_PATH_RE = /^\/hub\/([^/]+)\/([^/:]+):([0-9a-f]{8})$/;
+const MUTATION_COALESCE_MS = 50;
+const MAX_CONFLICT_RETRIES = 3;
 const TEXT_MIME_TYPE = "text/plain";
 const FNMATCH_OPTIONS = { bash: true };
+function parseHubTargetIdentifier(identifier) {
+	if (!identifier || identifier.split("/").length > 2 || identifier.startsWith("/") || identifier.endsWith("/") || identifier.split(":").length > 2) return null;
+	const [ownerNamePart] = identifier.split(":");
+	if (ownerNamePart.includes("/")) {
+		const [owner, name] = ownerNamePart.split("/", 2);
+		return owner && name ? [owner, name] : null;
+	}
+	return ownerNamePart ? ["-", ownerNamePart] : null;
+}
+function parseCommitHashFromUrl(url, identifier) {
+	try {
+		const pathname = decodeURIComponent(new URL(url).pathname);
+		const target = parseHubTargetIdentifier(identifier);
+		if (target === null) return null;
+		const [targetOwner, targetName] = target;
+		const contextMatch = CONTEXT_URL_COMMIT_PATH_RE.exec(pathname);
+		if (contextMatch !== null && contextMatch[1] === targetName) return contextMatch[2];
+		const legacyMatch = LEGACY_URL_COMMIT_PATH_RE.exec(pathname);
+		if (legacyMatch !== null && legacyMatch[1] === targetOwner && legacyMatch[2] === targetName) return legacyMatch[3];
+		return null;
+	} catch {
+		return null;
+	}
+}
 function getErrorMessage(error) {
 	if (typeof error === "string") return error;
 	if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") return error.message;
@@ -6627,6 +6687,12 @@ function getLangSmithStatus(error) {
 	const maybeError = error;
 	if (typeof maybeError.status === "number") return maybeError.status;
 }
+function createLangSmithConflictError(message) {
+	const error = new Error(message);
+	error.name = "LangSmithConflictError";
+	error.status = 409;
+	return error;
+}
 function mapHubFileOperationError(error) {
 	const status = getLangSmithStatus(error);
 	if (status === 401 || status === 403) return "permission_denied";
@@ -6636,12 +6702,49 @@ function mapHubFileOperationError(error) {
 /**
 * Backend that stores files in a LangSmith Hub agent repo (persistent).
 */
+/**
+* Backend that stores files in a LangSmith Hub agent repository.
+*
+* ## Mutation model
+*
+* Mutations are accepted in call order, coalesced for a short window, and
+* pushed by one worker. Only one batch is in flight at a time; mutations that
+* arrive during a push form the next batch. This serializes one backend
+* instance's writes while still reducing the number of Hub commits.
+*
+* Reads use an optimistic view: the last durable cache overlaid with the
+* in-flight batch and then the pending batch. A read can therefore observe an
+* accepted mutation before it is durable; a failed push invalidates that view
+* and the next operation reloads from Hub.
+*
+* A `409` parent conflict triggers an authoritative pull and rematerializes
+* the in-flight batch over the fetched tree before retrying. Edits replay their
+* original replacement intent; absolute writes, deletes, and uploads replay as
+* absolute changes. Retries are bounded by `MAX_CONFLICT_RETRIES`.
+*/
 var ContextHubBackend = class ContextHubBackend {
 	identifier;
 	client;
+	/** Last durable Hub file state; `null` means the next access must load it. */
 	cache = null;
 	linkedEntries = {};
+	/** Parent hash for the durable cache, used for optimistic-concurrency pushes. */
 	commitHash = null;
+	/** Shared cold-load promise so concurrent first operations perform one pull. */
+	loadPromise = null;
+	/** Promise chain serializing mutation acceptance and optimistic projections. */
+	mutationOrder = Promise.resolve();
+	/** Mutations accepted for the next coalesced push. */
+	pendingBatch = null;
+	/** The batch currently submitted to Hub and visible to optimistic reads. */
+	inFlightBatch = null;
+	/** The single queue-draining worker, when active. */
+	workerPromise = null;
+	/**
+	* Blocks cache consumers while a successful push without a parseable commit
+	* hash is being confirmed by an authoritative pull.
+	*/
+	snapshotPublication = null;
 	constructor(identifier, options = {}) {
 		this.identifier = identifier;
 		this.client = options.client ?? new Client$1();
@@ -6652,49 +6755,319 @@ var ContextHubBackend = class ContextHubBackend {
 	static toHubUnavailableError(error) {
 		return `Hub unavailable: ${getErrorMessage(error)}`;
 	}
-	async loadTree() {
+	async fetchTree() {
 		let context;
 		try {
 			context = await this.client.pullAgent(this.identifier);
 		} catch (error) {
-			if (isLangSmithNotFoundError(error)) {
-				this.cache = {};
-				this.linkedEntries = {};
-				this.commitHash = null;
-				return;
-			}
+			if (isLangSmithNotFoundError(error)) return {
+				cache: {},
+				linkedEntries: {},
+				commitHash: null
+			};
 			throw error;
 		}
-		this.commitHash = context.commit_hash;
-		this.cache = {};
-		this.linkedEntries = {};
-		for (const [path, entry] of Object.entries(context.files)) if (entry.type === "file") this.cache[path] = entry.content;
-		else if ((entry.type === "agent" || entry.type === "skill") && typeof entry.repo_handle === "string") this.linkedEntries[path] = entry.repo_handle;
+		const cache = {};
+		const linkedEntries = {};
+		for (const [path, entry] of Object.entries(context.files)) if (entry.type === "file") cache[path] = entry.content;
+		else if ((entry.type === "agent" || entry.type === "skill") && typeof entry.repo_handle === "string") linkedEntries[path] = entry.repo_handle;
+		return {
+			cache,
+			linkedEntries,
+			commitHash: context.commit_hash
+		};
 	}
-	async ensureCache() {
-		if (this.cache === null) await this.loadTree();
+	publishSnapshot(snapshot) {
+		this.cache = snapshot.cache;
+		this.linkedEntries = snapshot.linkedEntries;
+		this.commitHash = snapshot.commitHash;
+	}
+	async loadTree() {
+		this.publishSnapshot(await this.fetchTree());
+	}
+	beginSnapshotPublication() {
+		if (this.snapshotPublication !== null) throw new Error("Context Hub snapshot publication is already pending");
+		this.snapshotPublication = new Deferred();
+	}
+	finishSnapshotPublication() {
+		const publication = this.snapshotPublication;
+		this.snapshotPublication = null;
+		publication?.resolve();
+	}
+	async ensureCacheLoaded() {
+		while (this.snapshotPublication !== null) await this.snapshotPublication;
+		if (this.cache === null) {
+			let loadPromise = this.loadPromise;
+			if (loadPromise === null) {
+				loadPromise = this.loadTree();
+				this.loadPromise = loadPromise;
+			}
+			try {
+				await loadPromise;
+			} finally {
+				if (this.loadPromise === loadPromise) this.loadPromise = null;
+			}
+		}
 		if (this.cache === null) throw new Error("Context Hub cache failed to initialize");
-		return this.cache;
-	}
-	async commit(changes) {
-		if (Object.keys(changes).length === 0) return;
-		const payload = {};
-		for (const [path, content] of Object.entries(changes)) payload[path] = content === null ? null : {
-			type: "file",
-			content
+	}
+	async ensureCache() {
+		await this.ensureCacheLoaded();
+		return this.visibleCache();
+	}
+	static applyChanges(cache, changes) {
+		const next = { ...cache };
+		for (const [path, content] of Object.entries(changes)) if (content === null) delete next[path];
+		else next[path] = content;
+		return next;
+	}
+	/**
+	* Build the read-your-writes view without publishing speculative data as the
+	* durable cache. Later batches overlay earlier ones, matching worker order.
+	*/
+	visibleCache() {
+		let visible = { ...this.cache ?? {} };
+		if (this.inFlightBatch !== null) visible = ContextHubBackend.applyChanges(visible, this.inFlightBatch.changes);
+		if (this.pendingBatch !== null) visible = ContextHubBackend.applyChanges(visible, this.pendingBatch.changes);
+		return visible;
+	}
+	invalidateCache() {
+		this.cache = null;
+		this.linkedEntries = {};
+		this.commitHash = null;
+		this.loadPromise = null;
+	}
+	async acquireMutationTurn() {
+		let release;
+		const previous = this.mutationOrder;
+		this.mutationOrder = new Promise((resolve) => {
+			release = resolve;
+		});
+		await previous;
+		return release;
+	}
+	/**
+	* Serialize validation and enqueueing so each operation is evaluated against
+	* a stable optimistic projection. Cache loading begins before acquiring the
+	* turn, allowing concurrent cold-start callers to share the same pull.
+	*/
+	async acceptMutation(operation) {
+		const turn = this.acquireMutationTurn();
+		const cacheOutcome = this.ensureCacheLoaded().then(() => ({ loaded: true }), (error) => ({
+			loaded: false,
+			error
+		}));
+		const release = await turn;
+		try {
+			const outcome = await cacheOutcome;
+			if (!outcome.loaded) throw outcome.error;
+			while (this.cache === null) await this.ensureCacheLoaded();
+			return operation(this.visibleCache());
+		} finally {
+			release();
+		}
+	}
+	/**
+	* Start a batch's coalescing window. The worker waits for this signal before
+	* detaching the batch; cancellation resolves it immediately so failures do
+	* not leave the worker waiting on a timer.
+	*/
+	createMutationBatch() {
+		const batch = {
+			changes: {},
+			waiters: [],
+			ready: new Deferred(),
+			timer: null
 		};
-		const url = await this.client.pushAgent(this.identifier, {
-			files: payload,
-			...this.commitHash ? { parentCommit: this.commitHash } : {}
+		batch.timer = setTimeout(() => {
+			batch.timer = null;
+			batch.ready.resolve();
+		}, MUTATION_COALESCE_MS);
+		return batch;
+	}
+	cancelBatchTimer(batch) {
+		if (batch.timer !== null) {
+			clearTimeout(batch.timer);
+			batch.timer = null;
+		}
+		batch.ready.resolve();
+	}
+	enqueueCommit(changes, intent = {
+		kind: "changes",
+		changes: { ...changes }
+	}) {
+		if (Object.keys(changes).length === 0) return Promise.resolve();
+		let batch = this.pendingBatch;
+		if (batch === null) {
+			batch = this.createMutationBatch();
+			this.pendingBatch = batch;
+		}
+		Object.assign(batch.changes, changes);
+		const completion = new Deferred();
+		batch.waiters.push({
+			intent,
+			completion
 		});
-		const match = URL_COMMIT_SUFFIX_RE.exec(url);
-		if (match) this.commitHash = match[1];
-		if (this.cache !== null) {
-			const deletions = new Set(Object.entries(changes).filter(([, content]) => content === null).map(([path]) => path));
-			const updates = Object.fromEntries(Object.entries(changes).filter((entry) => entry[1] !== null));
-			this.cache = {
-				...Object.fromEntries(Object.entries(this.cache).filter(([path]) => !deletions.has(path))),
-				...updates
+		this.startWorker();
+		return completion.promise;
+	}
+	/**
+	* Replay ordered intents over an authoritative base after a conflict. This
+	* rebuilds the push payload and optimistic overlay. An edit that no longer
+	* applies throws the supplied conflict error; absolute changes are reapplied.
+	*/
+	rematerializeBatch(batch, base, conflictError) {
+		let cache = { ...base };
+		const changes = {};
+		for (const waiter of batch.waiters) {
+			const { intent } = waiter;
+			if (intent.kind === "changes") {
+				Object.assign(changes, intent.changes);
+				cache = ContextHubBackend.applyChanges(cache, intent.changes);
+				continue;
+			}
+			const current = cache[intent.path];
+			if (current === void 0) throw conflictError;
+			const replacementResult = performStringReplacement(current, intent.oldString, intent.newString, intent.replaceAll);
+			if (typeof replacementResult === "string") throw conflictError;
+			const [newContent, occurrences] = replacementResult;
+			const editChanges = { [intent.path]: newContent };
+			Object.assign(changes, editChanges);
+			cache = ContextHubBackend.applyChanges(cache, editChanges);
+			intent.updateOccurrences(occurrences);
+		}
+		batch.changes = changes;
+		return cache;
+	}
+	rematerializeAfterConflict(batch, snapshot, conflictError) {
+		const cache = this.rematerializeBatch(batch, snapshot.cache, conflictError);
+		let pendingReplayError = null;
+		if (this.pendingBatch !== null) try {
+			this.rematerializeBatch(this.pendingBatch, cache, conflictError);
+		} catch (error) {
+			if (error !== conflictError) throw error;
+			pendingReplayError = error;
+		}
+		this.publishSnapshot(snapshot);
+		if (pendingReplayError !== null) this.failPendingBatch(pendingReplayError);
+	}
+	rematerializePendingBatch(snapshot) {
+		if (this.pendingBatch === null) return null;
+		const conflictError = createLangSmithConflictError("Pending Context Hub mutation conflicts with authoritative state");
+		try {
+			this.rematerializeBatch(this.pendingBatch, snapshot.cache, conflictError);
+			return null;
+		} catch (error) {
+			if (error !== conflictError) throw error;
+			return conflictError;
+		}
+	}
+	startWorker() {
+		if (this.workerPromise !== null) return;
+		const worker = this.drainMutationQueue().catch((error) => {
+			this.failAllBatches(error);
+		}).finally(() => {
+			if (this.workerPromise === worker) {
+				this.workerPromise = null;
+				if (this.pendingBatch !== null) this.startWorker();
+			}
+		});
+		this.workerPromise = worker;
+	}
+	/**
+	* Drain coalesced batches sequentially. A completed batch publishes durable
+	* state before settling its callers; a failed batch invalidates local state
+	* and rejects both in-flight and queued callers so the next mutation reloads.
+	*/
+	async drainMutationQueue() {
+		while (this.pendingBatch !== null) {
+			const batch = this.pendingBatch;
+			await batch.ready;
+			if (this.pendingBatch !== batch) continue;
+			this.pendingBatch = null;
+			this.inFlightBatch = batch;
+			let pendingReplayError = null;
+			try {
+				const result = await this.pushBatch(batch);
+				if (result.kind === "snapshot") {
+					pendingReplayError = this.rematerializePendingBatch(result.snapshot);
+					this.publishSnapshot(result.snapshot);
+				} else {
+					this.cache = ContextHubBackend.applyChanges(this.cache ?? {}, batch.changes);
+					this.commitHash = result.commitHash;
+				}
+			} catch (error) {
+				this.inFlightBatch = null;
+				this.invalidateCache();
+				this.finishSnapshotPublication();
+				for (const waiter of batch.waiters) waiter.completion.reject(error);
+				this.failPendingBatch(error);
+				return;
+			}
+			this.inFlightBatch = null;
+			this.finishSnapshotPublication();
+			for (const waiter of batch.waiters) waiter.completion.resolve();
+			if (pendingReplayError !== null) {
+				this.failPendingBatch(pendingReplayError);
+				return;
+			}
+		}
+	}
+	failPendingBatch(error) {
+		const pending = this.pendingBatch;
+		if (pending === null) return;
+		this.pendingBatch = null;
+		this.cancelBatchTimer(pending);
+		for (const waiter of pending.waiters) waiter.completion.reject(error);
+	}
+	failAllBatches(error) {
+		const inFlight = this.inFlightBatch;
+		this.inFlightBatch = null;
+		this.invalidateCache();
+		this.finishSnapshotPublication();
+		if (inFlight !== null) {
+			this.cancelBatchTimer(inFlight);
+			for (const waiter of inFlight.waiters) waiter.completion.reject(error);
+		}
+		this.failPendingBatch(error);
+	}
+	/**
+	* Push a materialized batch with the durable commit as its parent. On a 409,
+	* refresh Hub state, replay the batch, and retry with the new parent. A push
+	* response without a trustworthy hash is confirmed by a pull before callers
+	* are allowed to observe it as durable.
+	*/
+	async pushBatch(batch) {
+		for (let attempt = 0;; attempt += 1) {
+			const payload = {};
+			for (const [path, content] of Object.entries(batch.changes)) payload[path] = content === null ? null : {
+				type: "file",
+				content
+			};
+			let url;
+			try {
+				url = await this.client.pushAgent(this.identifier, {
+					files: payload,
+					...this.commitHash ? { parentCommit: this.commitHash } : {}
+				});
+			} catch (error) {
+				if (getLangSmithStatus(error) !== 409 || attempt >= MAX_CONFLICT_RETRIES) throw error;
+				const snapshot = await this.fetchTree();
+				this.rematerializeAfterConflict(batch, snapshot, error);
+				continue;
+			}
+			const pushedCommitHash = parseCommitHashFromUrl(url, this.identifier);
+			if (pushedCommitHash === null) {
+				this.beginSnapshotPublication();
+				const snapshot = await this.fetchTree();
+				if (snapshot.commitHash === null) throw new Error("Context Hub commit succeeded but its hash could not be resolved");
+				return {
+					kind: "snapshot",
+					snapshot
+				};
+			}
+			return {
+				kind: "commit",
+				commitHash: pushedCommitHash
 			};
 		}
 	}
@@ -6822,53 +7195,71 @@ var ContextHubBackend = class ContextHubBackend {
 	async write(filePath, content) {
 		const hubPath = ContextHubBackend.stripPrefix(filePath);
 		try {
-			await this.ensureCache();
-			await this.commit({ [hubPath]: content });
+			const accepted = await this.acceptMutation(() => {
+				return {
+					result: {
+						path: filePath,
+						filesUpdate: null
+					},
+					completion: this.enqueueCommit({ [hubPath]: content })
+				};
+			});
+			await accepted.completion;
+			return accepted.result;
 		} catch (error) {
-			if (isLangSmithError(error)) {
-				this.cache = null;
-				return { error: ContextHubBackend.toHubUnavailableError(error) };
-			}
+			if (isLangSmithError(error)) return { error: ContextHubBackend.toHubUnavailableError(error) };
 			throw error;
 		}
-		return {
-			path: filePath,
-			filesUpdate: null
-		};
 	}
 	async edit(filePath, oldString, newString, replaceAll = false) {
 		const hubPath = ContextHubBackend.stripPrefix(filePath);
 		try {
-			const current = (await this.ensureCache())[hubPath];
-			if (current === void 0) return { error: `Error: File '${filePath}' not found` };
-			const replacementResult = performStringReplacement(current, oldString, newString, replaceAll);
-			if (typeof replacementResult === "string") return { error: replacementResult };
-			const [newContent, occurrences] = replacementResult;
-			await this.commit({ [hubPath]: newContent });
-			return {
-				path: filePath,
-				filesUpdate: null,
-				occurrences
-			};
+			const accepted = await this.acceptMutation((cache) => {
+				const current = cache[hubPath];
+				if (current === void 0) return { result: { error: `Error: File '${filePath}' not found` } };
+				const replacementResult = performStringReplacement(current, oldString, newString, replaceAll);
+				if (typeof replacementResult === "string") return { result: { error: replacementResult } };
+				const [newContent, occurrences] = replacementResult;
+				const result = {
+					path: filePath,
+					filesUpdate: null,
+					occurrences
+				};
+				return {
+					result,
+					completion: this.enqueueCommit({ [hubPath]: newContent }, {
+						kind: "edit",
+						path: hubPath,
+						oldString,
+						newString,
+						replaceAll,
+						updateOccurrences: (replayedOccurrences) => {
+							result.occurrences = replayedOccurrences;
+						}
+					})
+				};
+			});
+			await accepted.completion;
+			return accepted.result;
 		} catch (error) {
-			if (isLangSmithError(error)) {
-				this.cache = null;
-				return { error: ContextHubBackend.toHubUnavailableError(error) };
-			}
+			if (isLangSmithError(error)) return { error: ContextHubBackend.toHubUnavailableError(error) };
 			throw error;
 		}
 	}
 	async delete(filePath) {
 		const hubPath = ContextHubBackend.stripPrefix(filePath);
 		try {
-			if (!(hubPath in await this.ensureCache())) return { error: `Error: File '${filePath}' not found` };
-			await this.commit({ [hubPath]: null });
-			return { path: filePath };
+			const accepted = await this.acceptMutation((cache) => {
+				if (!(hubPath in cache)) return { result: { error: `Error: File '${filePath}' not found` } };
+				return {
+					result: { path: filePath },
+					completion: this.enqueueCommit({ [hubPath]: null })
+				};
+			});
+			await accepted.completion;
+			return accepted.result;
 		} catch (error) {
-			if (isLangSmithError(error)) {
-				this.cache = null;
-				return { error: ContextHubBackend.toHubUnavailableError(error) };
-			}
+			if (isLangSmithError(error)) return { error: ContextHubBackend.toHubUnavailableError(error) };
 			throw error;
 		}
 	}
@@ -6885,13 +7276,15 @@ var ContextHubBackend = class ContextHubBackend {
 		}
 		let commitError = null;
 		if (Object.keys(validFiles).length > 0) try {
-			await this.ensureCache();
-			await this.commit(validFiles);
+			await (await this.acceptMutation(() => {
+				return {
+					result: null,
+					completion: this.enqueueCommit(validFiles)
+				};
+			})).completion;
 		} catch (error) {
-			if (isLangSmithError(error)) {
-				this.cache = null;
-				commitError = mapHubFileOperationError(error);
-			} else throw error;
+			if (isLangSmithError(error)) commitError = mapHubFileOperationError(error);
+			else throw error;
 		}
 		return decoded.map(([path, text]) => {
 			if (text === null) return {
@@ -7576,4 +7969,4 @@ var LangSmithSandbox = class LangSmithSandbox extends BaseSandbox {
 //#endregion
 export { filesValue as A, StateBackend as B, createSummarizationMiddleware as C, MAX_SKILL_NAME_LENGTH as D, MAX_SKILL_FILE_SIZE as E, SUBAGENT_RESPONSE_FORMAT_CONFIG_KEY as F, resolveBackend as G, applyGrepMaxCount as H, createSubAgent as I, checkEmptyContent as J, adaptBackendProtocol as K, createSubAgentMiddleware as L, DEFAULT_GENERAL_PURPOSE_DESCRIPTION as M, DEFAULT_SUBAGENT_PROMPT as N, createSkillsMiddleware as O, GENERAL_PURPOSE_SUBAGENT as P, createFilesystemMiddleware as R, computeSummarizationDefaults as S, MAX_SKILL_DESCRIPTION_LENGTH as T, isSandboxBackend as U, SandboxError as V, isSandboxProtocol as W, isTextMimeType as X, getMimeType as Y, performStringReplacement as Z, createHarnessProfile as _, ASYNC_TASK_SYSTEM_PROMPT as a, createAsyncSubAgentMiddleware as b, TASK_SYSTEM_PROMPT as c, registerHarnessProfile as d, generalPurposeSubagentConfigSchema as f, EMPTY_HARNESS_PROFILE as g, serializeProfile as h, StoreBackend as i, createPatchToolCallsMiddleware as j, createMemoryMiddleware as k, createDeepAgent as l, parseHarnessProfileConfig as m, BaseSandbox as n, BASE_AGENT_PROMPT as o, harnessProfileConfigSchema as p, adaptSandboxProtocol as q, ContextHubBackend as r, EXECUTION_SYSTEM_PROMPT as s, LangSmithSandbox as t, getHarnessProfile as u, REQUIRED_MIDDLEWARE_NAMES as v, createCompletionCallbackMiddleware as w, isAsyncSubAgent as x, ConfigurationError as y, CompositeBackend as z };
 
-//# sourceMappingURL=langsmith-CUTUAjHo.js.map
+//# sourceMappingURL=langsmith-DRyafCNe.js.map