@langchain/langgraph-sdk 1.11.1 → 1.12.0-rc.0

package/dist/stream/controller.cjs

@@ -16,6 +16,7 @@ const require_message_metadata_tracker = require("./message-metadata-tracker.cjs
 const require_lifecycle_loading_tracker = require("./lifecycle-loading-tracker.cjs");
 const require_root_message_projection = require("./root-message-projection.cjs");
 const require_optimistic_input = require("./optimistic-input.cjs");
+const require_queue_adapter = require("./queue-adapter.cjs");
 const require_submit_coordinator = require("./submit-coordinator.cjs");
 const require_tool_calls = require("./tool-calls.cjs");
 let _langchain_core_utils_uuid = require("@langchain/core/utils/uuid");
@@ -300,10 +301,11 @@ var StreamController = class {
 		});
 		this.#lifecycleLoading = new require_lifecycle_loading_tracker.LifecycleLoadingTracker({
 			store: this.rootStore,
-			isDisposed: () => this.#disposed
+			isDisposed: () => this.#disposed,
+			onSettled: () => this.#submitter.scheduleQueueDrainOnObservedIdle()
 		});
 		this.messageMetadataStore = this.#messageMetadata.store;
-		this.queueStore = new require_store.StreamStore(require_submit_coordinator.EMPTY_QUEUE);
+		this.queueStore = new require_store.StreamStore(require_queue_adapter.EMPTY_QUEUE);
 		this.#submitter = new require_submit_coordinator.SubmitCoordinator({
 			options: this.#options,
 			rootStore: this.rootStore,
@@ -454,7 +456,7 @@ var StreamController = class {
 			* thread so dispatching them against the new thread would be
 			* surprising. Mirrors the legacy `StreamOrchestrator` behaviour.
 			*/
-			this.queueStore.setState(() => require_submit_coordinator.EMPTY_QUEUE);
+			this.queueStore.setState(() => require_queue_adapter.EMPTY_QUEUE);
 			await teardown;
 		}
 		if (this.#currentThreadId == null) {
@@ -488,6 +490,7 @@ var StreamController = class {
 		let threadExists = false;
 		let threadMissing = false;
 		let threadActive = true;
+		let hasActiveInterrupts = false;
 		try {
 			const state = await this.#fetchHydrationState();
 			if (this.#disposed || this.#currentThreadId !== hydratedThreadId) return;
@@ -575,6 +578,7 @@ var StreamController = class {
 			if (Array.isArray(state?.tasks)) {
 				const generationAtFetch = this.#submitGeneration;
 				const { activeInterrupts, activeIds } = collectActiveInterruptsFromTasks(state.tasks);
+				hasActiveInterrupts = activeInterrupts.length > 0;
 				for (const id of activeIds) this.#resolvedInterrupts.delete(id);
 				this.rootStore.setState((s) => ({
 					...s,
@@ -631,6 +635,15 @@ var StreamController = class {
 		*/
 		const thread = this.#ensureThread(hydratedThreadId, !threadActive);
 		/**
+		* Picks up runs pending from before this page load, or another tab.
+		* Fire-and-forget. Must run after `#ensureThread` above, not before:
+		* `AgentServerQueueAdapter`'s own `getThread` callback also calls
+		* `#ensureThread(threadId, true)`, which would otherwise create
+		* `#thread` with the pump deferred before the line above decides it
+		* should be eager.
+		*/
+		this.#submitter.hydrateQueue(hydratedThreadId);
+		/**
 		* Start the wildcard lifecycle watcher up-front for existing,
 		* active threads. The root content pump runs at `depth: 1`, which
 		* covers root-namespace and one-deep events but not arbitrarily-
@@ -645,7 +658,21 @@ var StreamController = class {
 		*    against a not-yet-existent thread; `submitRun` / `respondInput`
 		*    call `startLifecycleWatcher` on first submission instead.
 		*/
-		if (threadExists && threadActive) thread.startLifecycleWatcher();
+		if (threadExists && threadActive) {
+			thread.startLifecycleWatcher();
+			/**
+			* Seed `isLoading` from the checkpoint itself, not just a live
+			* lifecycle event: a subscriber that joins after a foreign run's
+			* own `running` event already fired would otherwise never observe
+			* it. Excludes a thread merely parked at an interrupt — that's
+			* waiting on a human, not "loading", matching
+			* `LifecycleLoadingTracker`'s own `interrupted → isLoading = false`.
+			*/
+			if (threadActive && !hasActiveInterrupts) this.rootStore.setState((s) => s.isLoading ? s : {
+				...s,
+				isLoading: true
+			});
+		}
 		if (threadExists) {
 			/**
 			* Seed subgraph discovery and promote subagent execution
@@ -937,10 +964,10 @@ var StreamController = class {
 	* Cancel a queued submission by id. Returns `true` when the entry
 	* was found and removed, `false` otherwise.
 	*
-	* Today this only removes the entry from the client-side mirror —
-	* once the server exposes queue cancel (roadmap A0.3) the
-	* controller will additionally issue a cancel call against the
-	* active transport.
+	* Removes the client-side entry either way; also issues a server-side
+	* cancel when the configured queue adapter is server-backed (see
+	* `AgentServerAdapter.serverQueue`). A no-op for the default,
+	* client-only adapter.
 	*
 	* @param id - Client-side queue entry id to remove.
 	*/
@@ -948,7 +975,8 @@ var StreamController = class {
 		return this.#submitter.cancelQueued(id);
 	}
 	/**
-	* Drop every queued submission. Server-side cancel arrives with A0.3.
+	* Drop every queued submission. Cancels the underlying server-side
+	* runs too when the configured queue adapter is server-backed.
 	*/
 	async clearQueue() {
 		await this.#submitter.clearQueue();
@@ -1323,7 +1351,8 @@ var StreamController = class {
 		this.#interruptReplayThroughSeq = void 0;
 		this.#pendingHydrationInterruptEvents = [];
 		this.#discardPendingInterruptEvents();
-		this.queueStore.setState(() => require_submit_coordinator.EMPTY_QUEUE);
+		this.queueStore.setState(() => require_queue_adapter.EMPTY_QUEUE);
+		this.#submitter.detachQueue();
 		try {
 			await subscription?.unsubscribe();
 		} catch {}