@langchain/langgraph-sdk 1.11.2 → 1.12.0

package/dist/stream/controller.d.cts

@@ -5,7 +5,7 @@ import { ChannelRegistry } from "./channel-registry.cjs";
 import { SubagentMap } from "./discovery/subagents.cjs";
 import { SubgraphByNodeMap, SubgraphMap } from "./discovery/subgraphs.cjs";
 import { MessageMetadata as MessageMetadata$1, MessageMetadataMap } from "./message-metadata-tracker.cjs";
-import { SubmissionQueueEntry, SubmissionQueueSnapshot } from "./submit-coordinator.cjs";
+import { SubmissionQueueEntry, SubmissionQueueSnapshot } from "./queue-adapter.cjs";
 import { Channel } from "@langchain/protocol";
 
 //#region src/stream/controller.d.ts
@@ -100,16 +100,17 @@ declare class StreamController<StateType extends object = Record<string, unknown
    * 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.
    */
   cancelQueued(id: string): Promise<boolean>;
   /**
-   * 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.
    */
   clearQueue(): Promise<void>;
   /**

package/dist/stream/controller.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.cts","names":[],"sources":["../../src/stream/controller.ts"],"mappings":";;;;;;;;;;;;;;AA6KA;;cAAa,kBAAA,WAA6B,OAAA;;AAwC1C;;;;;;;;;;;;cAAa,gBAAA,4BACgB,MAAA,8EAEO,MAAA;EAAA;WAEzB,SAAA,EAAW,WAAA,CAAY,YAAA,CAAa,SAAA,EAAW,aAAA;EAAA,SAC/C,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,mBAAA,EAAqB,WAAA,CAAY,iBAAA;EAAA,SACjC,oBAAA,EAAsB,WAAA,CAAY,kBAAA;EAAA,SAClC,UAAA,EAAY,WAAA,CAAY,uBAAA,CAAwB,SAAA;EAAA,SAChD,QAAA,EAAU,eAAA;EAiK0B;;;;;EAA7C,WAAA,CAAY,OAAA,EAAS,uBAAA,CAAwB,SAAA;EAiyBF;;;;;;;EAAA,IAtqBvC,gBAAA,CAAA,GAAoB,OAAA;EA20BS;;;;;;;;EAlxB3B,OAAA,CAAQ,QAAA,mBAA2B,OAAA;EAogCpB;;;;;;;;;;;;;;EA7pBf,wBAAA,CAAyB,UAAA,WAAqB,OAAA;EAjsB5B;;;;;;;;EAq8BlB,MAAA,CACJ,KAAA,WACA,OAAA,GAAU,mBAAA,CAAoB,SAAA,EAAW,gBAAA,IACxC,OAAA;EAr8B4B;;;;;;EA+8BzB,IAAA,CAAK,OAAA,GAAU,iBAAA,GAAoB,OAAA;EA78BtB;;;;EAi+Bb,UAAA,CAAA,GAAc,OAAA;EArsBhB;;;;;;;;;;;EAqwBE,YAAA,CAAa,EAAA,WAAa,OAAA;EA/FW;;;EAsGrC,UAAA,CAAA,GAAc,OAAA;EA3FC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwJf,OAAA,CACJ,QAAA,WACA,OAAA,GAAU,oBAAA,CAAqB,gBAAA,IAC9B,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiHG,UAAA,CACJ,aAAA,EAAe,MAAA,mBACf,OAAA,GAAU,uBAAA,CAAwB,gBAAA,IACjC,OAAA;;;;EA4DG,OAAA,CAAA,GAAW,OAAA;;;;;;;;;;;;;;;;EAyBjB,QAAA,CAAA;;;;;;EA4BA,SAAA,CAAA,GAAa,YAAA;;;;;;;;EAWb,eAAA,CACE,QAAA,GAAW,MAAA,EAAQ,YAAA;AAAA"}
+{"version":3,"file":"controller.d.cts","names":[],"sources":["../../src/stream/controller.ts"],"mappings":";;;;;;;;;;;;;;AA6KA;;cAAa,kBAAA,WAA6B,OAAA;;AAwC1C;;;;;;;;;;;;cAAa,gBAAA,4BACgB,MAAA,8EAEO,MAAA;EAAA;WAEzB,SAAA,EAAW,WAAA,CAAY,YAAA,CAAa,SAAA,EAAW,aAAA;EAAA,SAC/C,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,mBAAA,EAAqB,WAAA,CAAY,iBAAA;EAAA,SACjC,oBAAA,EAAsB,WAAA,CAAY,kBAAA;EAAA,SAClC,UAAA,EAAY,WAAA,CAAY,uBAAA,CAAwB,SAAA;EAAA,SAChD,QAAA,EAAU,eAAA;EAiK0B;;;;;EAA7C,WAAA,CAAY,OAAA,EAAS,uBAAA,CAAwB,SAAA;EAm0BF;;;;;;;EAAA,IArsBvC,gBAAA,CAAA,GAAoB,OAAA;EA22BS;;;;;;;;EAlzB3B,OAAA,CAAQ,QAAA,mBAA2B,OAAA;EAoiCpB;;;;;;;;;;;;;;EA9pBf,wBAAA,CAAyB,UAAA,WAAqB,OAAA;EAnuB5B;;;;;;;;EAu+BlB,MAAA,CACJ,KAAA,WACA,OAAA,GAAU,mBAAA,CAAoB,SAAA,EAAW,gBAAA,IACxC,OAAA;EAv+B4B;;;;;;EAi/BzB,IAAA,CAAK,OAAA,GAAU,iBAAA,GAAoB,OAAA;EA/+BtB;;;;EAmgCb,UAAA,CAAA,GAAc,OAAA;EApuBhB;;;;;;;;;;;EAoyBE,YAAA,CAAa,EAAA,WAAa,OAAA;EA/FW;;;;EAuGrC,UAAA,CAAA,GAAc,OAAA;EA5FT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyJL,OAAA,CACJ,QAAA,WACA,OAAA,GAAU,oBAAA,CAAqB,gBAAA,IAC9B,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiHG,UAAA,CACJ,aAAA,EAAe,MAAA,mBACf,OAAA,GAAU,uBAAA,CAAwB,gBAAA,IACjC,OAAA;;;;EA4DG,OAAA,CAAA,GAAW,OAAA;;;;;;;;;;;;;;;;EAyBjB,QAAA,CAAA;;;;;;EA4BA,SAAA,CAAA,GAAa,YAAA;;;;;;;;EAWb,eAAA,CACE,QAAA,GAAW,MAAA,EAAQ,YAAA;AAAA"}

package/dist/stream/controller.d.ts

@@ -5,7 +5,7 @@ import { ChannelRegistry } from "./channel-registry.js";
 import { SubagentMap } from "./discovery/subagents.js";
 import { SubgraphByNodeMap, SubgraphMap } from "./discovery/subgraphs.js";
 import { MessageMetadata as MessageMetadata$1, MessageMetadataMap } from "./message-metadata-tracker.js";
-import { SubmissionQueueEntry, SubmissionQueueSnapshot } from "./submit-coordinator.js";
+import { SubmissionQueueEntry, SubmissionQueueSnapshot } from "./queue-adapter.js";
 import { Channel } from "@langchain/protocol";
 
 //#region src/stream/controller.d.ts
@@ -100,16 +100,17 @@ declare class StreamController<StateType extends object = Record<string, unknown
    * 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.
    */
   cancelQueued(id: string): Promise<boolean>;
   /**
-   * 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.
    */
   clearQueue(): Promise<void>;
   /**

package/dist/stream/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","names":[],"sources":["../../src/stream/controller.ts"],"mappings":";;;;;;;;;;;;;;;AA6KA;cAAa,kBAAA,WAA6B,OAAA;;;AAwC1C;;;;;;;;;;;cAAa,gBAAA,4BACgB,MAAA,8EAEO,MAAA;EAAA;WAEzB,SAAA,EAAW,WAAA,CAAY,YAAA,CAAa,SAAA,EAAW,aAAA;EAAA,SAC/C,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,mBAAA,EAAqB,WAAA,CAAY,iBAAA;EAAA,SACjC,oBAAA,EAAsB,WAAA,CAAY,kBAAA;EAAA,SAClC,UAAA,EAAY,WAAA,CAAY,uBAAA,CAAwB,SAAA;EAAA,SAChD,QAAA,EAAU,eAAA;EAAA;;;;;EAiKnB,WAAA,CAAY,OAAA,EAAS,uBAAA,CAAwB,SAAA;EAiyBb;;;;;;;EAAA,IAtqB5B,gBAAA,CAAA,GAAoB,OAAA;EA4wBJ;;;;;;;;EAntBd,OAAA,CAAQ,QAAA,mBAA2B,OAAA;EAw/B5B;;;;;;;;;;;;;;EAjpBP,wBAAA,CAAyB,UAAA,WAAqB,OAAA;EAjsB3C;;;;;;;;EAq8BH,MAAA,CACJ,KAAA,WACA,OAAA,GAAU,mBAAA,CAAoB,SAAA,EAAW,gBAAA,IACxC,OAAA;EAr8BM;;;;;;EA+8BH,IAAA,CAAK,OAAA,GAAU,iBAAA,GAAoB,OAAA;EA78BhC;;;;EAi+BH,UAAA,CAAA,GAAc,OAAA;EAh0BR;;;;;;;;;;;EAg4BN,YAAA,CAAa,EAAA,WAAa,OAAA;EA/FA;;;EAsG1B,UAAA,CAAA,GAAc,OAAA;EA3Fd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwJA,OAAA,CACJ,QAAA,WACA,OAAA,GAAU,oBAAA,CAAqB,gBAAA,IAC9B,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiHG,UAAA,CACJ,aAAA,EAAe,MAAA,mBACf,OAAA,GAAU,uBAAA,CAAwB,gBAAA,IACjC,OAAA;;;;EA4DG,OAAA,CAAA,GAAW,OAAA;;;;;;;;;;;;;;;;EAyBjB,QAAA,CAAA;;;;;;EA4BA,SAAA,CAAA,GAAa,YAAA;;;;;;;;EAWb,eAAA,CACE,QAAA,GAAW,MAAA,EAAQ,YAAA;AAAA"}
+{"version":3,"file":"controller.d.ts","names":[],"sources":["../../src/stream/controller.ts"],"mappings":";;;;;;;;;;;;;;;;cA6Ka,kBAAA,WAA6B,OAAA;;;;AAwC1C;;;;;;;;;;cAAa,gBAAA,4BACgB,MAAA,8EAEO,MAAA;EAAA;WAEzB,SAAA,EAAW,WAAA,CAAY,YAAA,CAAa,SAAA,EAAW,aAAA;EAAA,SAC/C,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,aAAA,EAAe,WAAA,CAAY,WAAA;EAAA,SAC3B,mBAAA,EAAqB,WAAA,CAAY,iBAAA;EAAA,SACjC,oBAAA,EAAsB,WAAA,CAAY,kBAAA;EAAA,SAClC,UAAA,EAAY,WAAA,CAAY,uBAAA,CAAwB,SAAA;EAAA,SAChD,QAAA,EAAU,eAAA;EADE;;;;;EAkKrB,WAAA,CAAY,OAAA,EAAS,uBAAA,CAAwB,SAAA;EA6jBO;;;;;;;EAAA,IA/bhD,gBAAA,CAAA,GAAoB,OAAA;EAoyBQ;;;;;;;;EA3uB1B,OAAA,CAAQ,QAAA,mBAA2B,OAAA;EAm+BxB;;;;;;;;;;;;;;EA7lBX,wBAAA,CAAyB,UAAA,WAAqB,OAAA;EApuBI;;;;;;;;EAw+BlD,MAAA,CACJ,KAAA,WACA,OAAA,GAAU,mBAAA,CAAoB,SAAA,EAAW,gBAAA,IACxC,OAAA;EAx+BuC;;;;;;EAk/BpC,IAAA,CAAK,OAAA,GAAU,iBAAA,GAAoB,OAAA;EAh/BgB;;;;EAogCnD,UAAA,CAAA,GAAc,OAAA;EAl2ByB;;;;;;;;;;;EAk6BvC,YAAA,CAAa,EAAA,WAAa,OAAA;EA/FpB;;;;EAuGN,UAAA,CAAA,GAAc,OAAA;EA5Fd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyJA,OAAA,CACJ,QAAA,WACA,OAAA,GAAU,oBAAA,CAAqB,gBAAA,IAC9B,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiHG,UAAA,CACJ,aAAA,EAAe,MAAA,mBACf,OAAA,GAAU,uBAAA,CAAwB,gBAAA,IACjC,OAAA;;;;EA4DG,OAAA,CAAA,GAAW,OAAA;;;;;;;;;;;;;;;;EAyBjB,QAAA,CAAA;;;;;;EA4BA,SAAA,CAAA,GAAa,YAAA;;;;;;;;EAWb,eAAA,CACE,QAAA,GAAW,MAAA,EAAQ,YAAA;AAAA"}

package/dist/stream/controller.js

@@ -15,7 +15,8 @@ import { MessageMetadataTracker } from "./message-metadata-tracker.js";
 import { LifecycleLoadingTracker } from "./lifecycle-loading-tracker.js";
 import { RootMessageProjection } from "./root-message-projection.js";
 import { prepareOptimisticInput, serializeUpdateMessages } from "./optimistic-input.js";
-import { EMPTY_QUEUE, SubmitCoordinator } from "./submit-coordinator.js";
+import { EMPTY_QUEUE } from "./queue-adapter.js";
+import { SubmitCoordinator } from "./submit-coordinator.js";
 import { reconcileToolCallsFromMessages, seedToolCallsFromMessages, upsertToolCall } from "./tool-calls.js";
 import { v7 } from "@langchain/core/utils/uuid";
 import "@langchain/core/messages";
@@ -299,7 +300,8 @@ var StreamController = class {
 		});
 		this.#lifecycleLoading = new LifecycleLoadingTracker({
 			store: this.rootStore,
-			isDisposed: () => this.#disposed
+			isDisposed: () => this.#disposed,
+			onSettled: () => this.#submitter.scheduleQueueDrainOnObservedIdle()
 		});
 		this.messageMetadataStore = this.#messageMetadata.store;
 		this.queueStore = new StreamStore(EMPTY_QUEUE);
@@ -487,6 +489,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;
@@ -574,6 +577,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,
@@ -630,6 +634,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-
@@ -644,7 +657,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
@@ -936,10 +963,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.
 	*/
@@ -947,7 +974,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,6 +1351,7 @@ var StreamController = class {
 		this.#pendingHydrationInterruptEvents = [];
 		this.#discardPendingInterruptEvents();
 		this.queueStore.setState(() => EMPTY_QUEUE);
+		this.#submitter.detachQueue();
 		try {
 			await subscription?.unsubscribe();
 		} catch {}