@assistant-ui/react-langchain 0.0.32 → 0.0.33

package/dist/findForkCheckpointInHistory.d.ts

@@ -1,24 +1,23 @@
-import { LangChainBaseMessage } from "./types.js";
-//#region src/findForkCheckpointInHistory.d.ts
+import type { LangChainBaseMessage } from "./types.js";
 type ForkCheckpointHistoryState = {
-  values?: Record<string, unknown> | undefined;
-  checkpoint?: {
-    checkpoint_id?: string | null | undefined;
-  } | undefined;
+    values?: Record<string, unknown> | undefined;
+    checkpoint?: {
+        checkpoint_id?: string | null | undefined;
+    } | undefined;
 };
 type ForkHistoryCursor = {
-  configurable: {
-    checkpoint_id: string;
-  };
+    configurable: {
+        checkpoint_id: string;
+    };
 };
 export type ForkCheckpointClient = {
-  threads: {
-    getHistory: (threadId: string, options?: {
-      limit?: number;
-      before?: ForkHistoryCursor;
-    }) => Promise<readonly ForkCheckpointHistoryState[]>;
-  };
+    threads: {
+        getHistory: (threadId: string, options?: {
+            limit?: number;
+            before?: ForkHistoryCursor;
+        }) => Promise<readonly ForkCheckpointHistoryState[]>;
+    };
 };
 export declare const findForkCheckpointInHistory: (client: ForkCheckpointClient, threadId: string, messagesUpToParent: readonly LangChainBaseMessage[], messagesKey: string, pageSize?: number) => Promise<string | null>;
-//#endregion
+export {};
 //# sourceMappingURL=findForkCheckpointInHistory.d.ts.map

package/dist/findForkCheckpointInHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findForkCheckpointInHistory.d.ts","names":[],"sources":["../src/findForkCheckpointInHistory.ts"],"mappings":";;KAEK;EACH,SAAS;EACT;IAAe;;;KAGZ;EAAsB;IAAgB;;;YAE/B;EACV;IACE,aACE,kBACA;MAAY;MAAgB,SAAS;UAClC,iBAAiB;;;qBAIb,8BACX,QAAQ,sBACR,kBACA,6BAA6B,wBAC7B,qBACA,sBACC"}
+{"version":3,"file":"findForkCheckpointInHistory.d.ts","sourceRoot":"","sources":["../src/findForkCheckpointInHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAgB;AAEpD,KAAK,0BAA0B,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,UAAU,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;CACxE,CAAC;AAEF,KAAK,iBAAiB,GAAG;IAAE,YAAY,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE;QACP,UAAU,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;SAAE,KACrD,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CAAC;KACrD,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,QAAQ,oBAAoB,EAC5B,UAAU,MAAM,EAChB,oBAAoB,SAAS,oBAAoB,EAAE,EACnD,aAAa,MAAM,EACnB,iBAAc,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CA2CvB,CAAC"}

package/dist/hooks.d.ts

@@ -1,11 +1,10 @@
-import { LangChainBaseMessage } from "./types.js";
-import { AssembledToolCall, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot } from "@langchain/react";
-//#region src/hooks.d.ts
+import type { AssembledToolCall, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot } from "@langchain/react";
+import type { LangChainBaseMessage } from "./types.js";
 /**
  * Read the current LangGraph interrupt state from the runtime extras.
  */
 export declare const useLangChainInterruptState: () => {
-  value?: unknown;
+    value?: unknown;
 } | undefined;
 /**
  * Read every interrupt pending at the current checkpoint, each with `id`
@@ -13,8 +12,8 @@ export declare const useLangChainInterruptState: () => {
  * (keyed by interrupt id) to resolve several at once.
  */
 export declare const useLangChainInterrupts: () => readonly {
-  id?: string;
-  value?: unknown;
+    id?: string;
+    value?: unknown;
 }[];
 /** Read the last run/hydration error from the runtime extras. */
 export declare const useLangChainError: () => unknown;
@@ -82,5 +81,4 @@ export declare const useLangChainSendCommand: () => (command: Record<string, unk
  */
 export declare function useLangChainState<T>(key: string): T | undefined;
 export declare function useLangChainState<T>(key: string, defaultValue: T): T;
-//#endregion
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","names":[],"sources":["../src/hooks.ts"],"mappings":";;;;;;qBAwBa;EAAA;;;;;;;qBAQA;EAAA;EAAA;;;qBAOA;;;;;;;qBASA,sCAAqB;;qBAIrB,6BAAqB,oBAAA;;qBAIrB,6BAAqB,oBAAA;;;;;;;qBASrB,qDAAkB;;;;;;qBAQlB,2BAGT,QAAQ,4CACR,UAAU,4BAAuB;;;;;;qBASxB,4BAEH,mBAAmB,UAAU,4BAAuB;;;;;;;qBAUjD,+BAGT,eAAe,yBACf,UAAU,4BAAuB;;;;;;qBASxB,yBAGT,mBAAmB,wBACnB,UAAU,4BAAuB;;;;;;;;qBAcxB,gCAEH,SAAS,4BAAuB;;;;;;;;;;;;wBAc1B,kBAAkB,GAAG,cAAc;wBACnC,kBAAkB,GAAG,aAAa,cAAc,IAAI"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAgB;AAYpD;;GAEG;AACH,eAAO,MAAM,0BAA0B;;aACa,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;GAIhC,CAAC;AAEJ,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,eACkB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,8DAC6C,CAAC;AAEhF,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,sDAC2C,CAAC;AAE9E,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,sDAC2C,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,wDACkB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,SAG3B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAEpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,SAEtB,UAAU,OAAO,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,SAG/B,eAAe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAEpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,SAGzB,UAAU,SAAS,oBAAoB,EAAE,EACzC,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAKpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,SAE1B,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBACzC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;AACjE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-import { LangChainContentBlock } from "./converter.js";
-import { LangChainBaseMessage, LangChainToolCall, RemoveUIMessage, UIMessage, UseStreamRuntimeOptions } from "./types.js";
-import { convertLangChainBaseMessage } from "./convertMessages.js";
-import { useLangChainError, useLangChainInterruptState, useLangChainInterrupts, useLangChainRespond, useLangChainRespondAll, useLangChainSend, useLangChainSendCommand, useLangChainState, useLangChainStream, useLangChainSubagents, useLangChainSubgraphs, useLangChainSubmit, useLangChainToolCalls } from "./hooks.js";
-import { useStreamRuntime } from "./useStreamRuntime.js";
-import { useLangChainStreamingTiming } from "./streamingTiming.js";
-import { SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot } from "@langchain/react";
-export { type LangChainBaseMessage, type LangChainContentBlock, type LangChainToolCall, type RemoveUIMessage, type SubagentDiscoverySnapshot, type SubgraphDiscoverySnapshot, type UIMessage, type UseStreamRuntimeOptions, convertLangChainBaseMessage, useLangChainError, useLangChainInterruptState, useLangChainInterrupts, useLangChainRespond, useLangChainRespondAll, useLangChainSend, useLangChainSendCommand, useLangChainState, useLangChainStream, useLangChainStreamingTiming, useLangChainSubagents, useLangChainSubgraphs, useLangChainSubmit, useLangChainToolCalls, useStreamRuntime };
+export { useStreamRuntime } from "./useStreamRuntime.js";
+export { useLangChainError, useLangChainInterrupts, useLangChainInterruptState, useLangChainRespond, useLangChainRespondAll, useLangChainSend, useLangChainSendCommand, useLangChainState, useLangChainStream, useLangChainSubagents, useLangChainSubgraphs, useLangChainSubmit, useLangChainToolCalls, } from "./hooks.js";
+export { convertLangChainBaseMessage } from "./convertMessages.js";
+export { useLangChainStreamingTiming } from "./streamingTiming.js";
+export type { SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, } from "@langchain/react";
+export type { LangChainBaseMessage, LangChainContentBlock, LangChainToolCall, RemoveUIMessage, UIMessage, UseStreamRuntimeOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,8BAA2B;AAEtD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,GACtB,mBAAgB;AAEjB,OAAO,EAAE,2BAA2B,EAAE,6BAA0B;AAChE,OAAO,EAAE,2BAA2B,EAAE,6BAA0B;AAEhE,YAAY,EACV,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,uBAAuB,GACxB,mBAAgB"}

package/dist/resolveForkCheckpoint.d.ts

@@ -1,8 +1,7 @@
-import { LangChainBaseMessage } from "./types.js";
-import { ForkCheckpointClient } from "./findForkCheckpointInHistory.js";
-//#region src/resolveForkCheckpoint.d.ts
+import type { LangChainBaseMessage } from "./types.js";
+import { type ForkCheckpointClient } from "./findForkCheckpointInHistory.js";
 type MessageMetadataSnapshot = ReadonlyMap<string, {
-  readonly parentCheckpointId: string | undefined;
+    readonly parentCheckpointId: string | undefined;
 }> | undefined;
 /**
  * Hydration seeds every message with the head's parent checkpoint, so only the
@@ -11,5 +10,5 @@ type MessageMetadataSnapshot = ReadonlyMap<string, {
  * message and forks from the thread's initial (empty-message) checkpoint.
  */
 export declare const resolveForkCheckpoint: (client: ForkCheckpointClient, threadId: string, messages: readonly LangChainBaseMessage[], parentId: string | null, sourceId: string | null | undefined, metadata: MessageMetadataSnapshot, messagesKey: string) => Promise<string | null>;
-//#endregion
+export {};
 //# sourceMappingURL=resolveForkCheckpoint.d.ts.map

package/dist/resolveForkCheckpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveForkCheckpoint.d.ts","names":[],"sources":["../src/resolveForkCheckpoint.ts"],"mappings":";;;KAMK,0BACD;WAA+B;;;;;;;;qBAStB,wBACX,QAAQ,sBACR,kBACA,mBAAmB,wBACnB,yBACA,qCACA,UAAU,yBACV,wBACC"}
+{"version":3,"file":"resolveForkCheckpoint.d.ts","sourceRoot":"","sources":["../src/resolveForkCheckpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAgB;AACpD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,yCAAsC;AAEvC,KAAK,uBAAuB,GACxB,WAAW,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,GACxE,SAAS,CAAC;AAEd;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,oBAAoB,EAC5B,UAAU,MAAM,EAChB,UAAU,SAAS,oBAAoB,EAAE,EACzC,UAAU,MAAM,GAAG,IAAI,EACvB,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,UAAU,uBAAuB,EACjC,aAAa,MAAM,KAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAwBvB,CAAC"}

package/dist/runtimeExtras.d.ts

@@ -1,5 +1,3 @@
-import { LangChainRuntimeExtras } from "./types.js";
-//#region src/runtimeExtras.d.ts
+import type { LangChainRuntimeExtras } from "./types.js";
 export declare const langChainExtras: import("@assistant-ui/core/react").RuntimeExtras<LangChainRuntimeExtras>;
-//#endregion
 //# sourceMappingURL=runtimeExtras.d.ts.map

package/dist/runtimeExtras.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeExtras.d.ts","names":[],"sources":["../src/runtimeExtras.ts"],"mappings":";;qBAGa,oDAAe,cAAA"}
+{"version":3,"file":"runtimeExtras.d.ts","sourceRoot":"","sources":["../src/runtimeExtras.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAgB;AAEtD,eAAO,MAAM,eAAe,0EACqC,CAAC"}

package/dist/sdkIdentity.d.ts

@@ -1,5 +1,3 @@
-import { SdkIdentity } from "assistant-cloud";
-//#region src/sdkIdentity.d.ts
+import type { SdkIdentity } from "assistant-cloud";
 export declare const LANGCHAIN_SDK: SdkIdentity;
-//#endregion
 //# sourceMappingURL=sdkIdentity.d.ts.map

package/dist/sdkIdentity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdkIdentity.d.ts","names":[],"sources":["../src/sdkIdentity.ts"],"mappings":";;qBAEa,eAAe"}
+{"version":3,"file":"sdkIdentity.d.ts","sourceRoot":"","sources":["../src/sdkIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,eAAO,MAAM,aAAa,EAAE,WAM3B,CAAC"}

package/dist/sdkIdentity.js

@@ -1,7 +1,7 @@
 //#region src/sdkIdentity.ts
 const LANGCHAIN_SDK = {
 	name: "@assistant-ui/react-langchain",
-	version: "0.0.32"
+	version: "0.0.33"
 };
 //#endregion
 export { LANGCHAIN_SDK };

package/dist/streamingTiming.d.ts

@@ -1,6 +1,5 @@
-import { LangChainBaseMessage } from "./types.js";
-import { MessageTiming } from "@assistant-ui/core";
-//#region src/streamingTiming.d.ts
+import type { MessageTiming } from "@assistant-ui/core";
+import type { LangChainBaseMessage } from "./types.js";
 export declare const langChainStreamingTimingAccessors: import("@assistant-ui/core").StreamingTimingAccessors<LangChainBaseMessage>;
 /**
  * Tracks per-message streaming timing for LangChain messages. Delegates to
@@ -9,5 +8,4 @@ export declare const langChainStreamingTimingAccessors: import("@assistant-ui/co
  * blocks including text/thinking/reasoning, `tool_calls`).
  */
 export declare const useLangChainStreamingTiming: (messages: readonly LangChainBaseMessage[], isRunning: boolean) => Record<string, MessageTiming>;
-//#endregion
 //# sourceMappingURL=streamingTiming.d.ts.map

package/dist/streamingTiming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamingTiming.d.ts","names":[],"sources":["../src/streamingTiming.ts"],"mappings":";;;qBAQa,gEAAiC,yBAAA;;;;;;;qBASjC,8BACX,mBAAmB,wBACnB,uBACC,eAAe"}
+{"version":3,"file":"streamingTiming.d.ts","sourceRoot":"","sources":["../src/streamingTiming.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAgB;AAEpD,eAAO,MAAM,iCAAiC,6EACiC,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAU,SAAS,oBAAoB,EAAE,EACzC,WAAW,OAAO,KACjB,MAAM,CAAC,MAAM,EAAE,aAAa,CAC6C,CAAC"}

package/dist/subagentMessagesProjection.d.ts

@@ -0,0 +1,17 @@
+import type { BaseMessage } from "@langchain/core/messages";
+import { type ProjectionSpec } from "@langchain/langgraph-sdk/stream";
+type MessagesProjection = ProjectionSpec<BaseMessage[]>;
+/**
+ * The SDK's messages projection subscribes at the protocol's default depth
+ * of 1 and applies every delivered event, so a nested subagent's `values`
+ * snapshots rebuild its parent's store from the child's state while the child
+ * runs. The projection exposes no depth option, so this spec opens it against
+ * a thread whose subscription is pinned to depth 0: the namespace the SDK
+ * sets stays and only events at exactly that namespace are delivered, the
+ * rule the SDK's root projection already applies. The client unions every
+ * subscription's depth into the server filter, so a depth 0 subscription
+ * narrows nothing for other consumers.
+ */
+export declare const subagentMessagesProjection: (namespace: readonly string[]) => MessagesProjection;
+export {};
+//# sourceMappingURL=subagentMessagesProjection.d.ts.map

package/dist/subagentMessagesProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentMessagesProjection.d.ts","sourceRoot":"","sources":["../src/subagentMessagesProjection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,iCAAiC,CAAC;AAEzC,KAAK,kBAAkB,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC;AAgBxD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GACrC,WAAW,SAAS,MAAM,EAAE,KAC3B,kBAcF,CAAC"}

package/dist/subagentMessagesProjection.js

@@ -0,0 +1,40 @@
+import { messagesProjection } from "@langchain/langgraph-sdk/stream";
+//#region src/subagentMessagesProjection.ts
+const exactDepthThread = (thread) => new Proxy(thread, { get(target, property) {
+	if (property === "subscribe") return (...[params]) => target.subscribe({
+		...params,
+		depth: 0
+	});
+	const value = Reflect.get(target, property, target);
+	return typeof value === "function" ? value.bind(target) : value;
+} });
+/**
+* The SDK's messages projection subscribes at the protocol's default depth
+* of 1 and applies every delivered event, so a nested subagent's `values`
+* snapshots rebuild its parent's store from the child's state while the child
+* runs. The projection exposes no depth option, so this spec opens it against
+* a thread whose subscription is pinned to depth 0: the namespace the SDK
+* sets stays and only events at exactly that namespace are delivered, the
+* rule the SDK's root projection already applies. The client unions every
+* subscription's depth into the server filter, so a depth 0 subscription
+* narrows nothing for other consumers.
+*/
+const subagentMessagesProjection = (namespace) => {
+	const projection = messagesProjection(namespace);
+	return {
+		key: `exact|${projection.key}`,
+		namespace: projection.namespace,
+		initial: projection.initial,
+		open({ thread, store, rootBus }) {
+			return projection.open({
+				thread: exactDepthThread(thread),
+				store,
+				rootBus
+			});
+		}
+	};
+};
+//#endregion
+export { subagentMessagesProjection };
+
+//# sourceMappingURL=subagentMessagesProjection.js.map

package/dist/subagentMessagesProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentMessagesProjection.js","names":[],"sources":["../src/subagentMessagesProjection.ts"],"sourcesContent":["import type { BaseMessage } from \"@langchain/core/messages\";\nimport {\n  messagesProjection,\n  type ProjectionSpec,\n} from \"@langchain/langgraph-sdk/stream\";\n\ntype MessagesProjection = ProjectionSpec<BaseMessage[]>;\n\ntype ProjectionThread = Parameters<MessagesProjection[\"open\"]>[0][\"thread\"];\n\nconst exactDepthThread = (thread: ProjectionThread): ProjectionThread =>\n  new Proxy(thread, {\n    get(target, property) {\n      if (property === \"subscribe\") {\n        return (...[params]: Parameters<ProjectionThread[\"subscribe\"]>) =>\n          target.subscribe({ ...params, depth: 0 });\n      }\n      const value = Reflect.get(target, property, target);\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  });\n\n/**\n * The SDK's messages projection subscribes at the protocol's default depth\n * of 1 and applies every delivered event, so a nested subagent's `values`\n * snapshots rebuild its parent's store from the child's state while the child\n * runs. The projection exposes no depth option, so this spec opens it against\n * a thread whose subscription is pinned to depth 0: the namespace the SDK\n * sets stays and only events at exactly that namespace are delivered, the\n * rule the SDK's root projection already applies. The client unions every\n * subscription's depth into the server filter, so a depth 0 subscription\n * narrows nothing for other consumers.\n */\nexport const subagentMessagesProjection = (\n  namespace: readonly string[],\n): MessagesProjection => {\n  const projection = messagesProjection(namespace);\n  return {\n    key: `exact|${projection.key}`,\n    namespace: projection.namespace,\n    initial: projection.initial,\n    open({ thread, store, rootBus }) {\n      return projection.open({\n        thread: exactDepthThread(thread),\n        store,\n        rootBus,\n      });\n    },\n  };\n};\n"],"mappings":";;AAUA,MAAM,oBAAoB,WACxB,IAAI,MAAM,QAAQ,EAChB,IAAI,QAAQ,UAAU;CACpB,IAAI,aAAa,aACf,QAAQ,GAAG,CAAC,YACV,OAAO,UAAU;EAAE,GAAG;EAAQ,OAAO;CAAE,CAAC;CAE5C,MAAM,QAAQ,QAAQ,IAAI,QAAQ,UAAU,MAAM;CAClD,OAAO,OAAO,UAAU,aAAa,MAAM,KAAK,MAAM,IAAI;AAC5D,EACF,CAAC;;;;;;;;;;;;AAaH,MAAa,8BACX,cACuB;CACvB,MAAM,aAAa,mBAAmB,SAAS;CAC/C,OAAO;EACL,KAAK,SAAS,WAAW;EACzB,WAAW,WAAW;EACtB,SAAS,WAAW;EACpB,KAAK,EAAE,QAAQ,OAAO,WAAW;GAC/B,OAAO,WAAW,KAAK;IACrB,QAAQ,iBAAiB,MAAM;IAC/B;IACA;GACF,CAAC;EACH;CACF;AACF"}

package/dist/types.d.ts

@@ -1,12 +1,11 @@
-import { LangChainContentBlock } from "./converter.js";
-import { AttachmentAdapter, DictationAdapter, ExternalStoreSharedOptions, FeedbackAdapter, MessageStatus, RealtimeVoiceAdapter, RemoteThreadListAdapter, SpeechSynthesisAdapter } from "@assistant-ui/core";
-import { AnyStream, AssembledToolCall, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot, UseStreamOptions } from "@langchain/react";
-import { AssistantCloud } from "assistant-cloud";
-//#region src/types.d.ts
+import type { AttachmentAdapter, DictationAdapter, ExternalStoreSharedOptions, FeedbackAdapter, MessageStatus, RealtimeVoiceAdapter, RemoteThreadListAdapter, SpeechSynthesisAdapter } from "@assistant-ui/core";
+import type { AssistantCloud } from "assistant-cloud";
+import type { UseStreamOptions, AssembledToolCall, AnyStream, SubagentDiscoverySnapshot, SubgraphDiscoverySnapshot } from "@langchain/react";
+export type { LangChainContentBlock } from "./converter.js";
 export type LangChainToolCall = {
-  id: string;
-  name: string;
-  args: Record<string, unknown>;
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
 };
 /**
  * A generative UI component the graph accumulates in its state. Read from
@@ -16,27 +15,27 @@ export type LangChainToolCall = {
  * Python SDK and in `metadata.id` by the JS SDK; the runtime reads either.
  */
 export type UIMessage<TName extends string = string, TProps extends Record<string, unknown> = Record<string, unknown>> = {
-  type: "ui";
-  id: string;
-  name: TName;
-  props: TProps;
-  metadata?: {
-    merge?: boolean;
-    run_id?: string;
-    name?: string;
-    tags?: string[];
-    message_id?: string;
-    id?: string;
-    [key: string]: unknown;
-  };
+    type: "ui";
+    id: string;
+    name: TName;
+    props: TProps;
+    metadata?: {
+        merge?: boolean;
+        run_id?: string;
+        name?: string;
+        tags?: string[];
+        message_id?: string;
+        id?: string;
+        [key: string]: unknown;
+    };
 };
 /**
  * Emitted on the live `custom` channel by the graph's `remove_ui_message`
  * helper to drop a pushed `UIMessage` by id.
  */
 export type RemoveUIMessage = {
-  type: "remove-ui";
-  id: string;
+    type: "remove-ui";
+    id: string;
 };
 /**
  * Minimal duck-typed interface for BaseMessage class instances returned by
@@ -46,89 +45,87 @@ export type RemoveUIMessage = {
  * `@langchain/core`'s `MessageContent` union.
  */
 export type LangChainBaseMessage = {
-  _getType: () => string;
-  content: unknown;
-  id?: string | undefined;
-  name?: string | undefined;
-  additional_kwargs?: Record<string, unknown> | undefined;
-  /** Present on AIMessage */
-  tool_calls?: readonly LangChainToolCall[] | undefined;
-  /** Present on ToolMessage */
-  tool_call_id?: string | undefined;
-  /** Completion status (AIMessage) or outcome status (ToolMessage) */
-  status?: MessageStatus | "success" | "error" | undefined;
-  /** Present on ToolMessage */
-  artifact?: unknown;
+    _getType: () => string;
+    content: unknown;
+    id?: string | undefined;
+    name?: string | undefined;
+    additional_kwargs?: Record<string, unknown> | undefined;
+    /** Present on AIMessage */
+    tool_calls?: readonly LangChainToolCall[] | undefined;
+    /** Present on ToolMessage */
+    tool_call_id?: string | undefined;
+    /** Completion status (AIMessage) or outcome status (ToolMessage) */
+    status?: MessageStatus | "success" | "error" | undefined;
+    /** Present on ToolMessage */
+    artifact?: unknown;
 };
 export type LangChainRuntimeExtras = {
-  interrupt: {
-    value?: unknown;
-  } | undefined;
-  interrupts: readonly {
-    id?: string;
-    value?: unknown;
-  }[];
-  toolCalls: readonly AssembledToolCall[];
-  subagents: ReadonlyMap<string, SubagentDiscoverySnapshot>;
-  subgraphs: ReadonlyMap<string, SubgraphDiscoverySnapshot>;
-  stream: AnyStream;
-  error: unknown;
-  submit: (values: Record<string, unknown> | null | undefined, options?: Record<string, unknown>) => Promise<void>;
-  respond: (response: unknown, options?: Record<string, unknown>) => Promise<void>;
-  respondAll: (responsesById: Record<string, unknown>, options?: Record<string, unknown>) => Promise<void>;
-  values: Record<string, unknown>;
-  messagesKey: string;
+    interrupt: {
+        value?: unknown;
+    } | undefined;
+    interrupts: readonly {
+        id?: string;
+        value?: unknown;
+    }[];
+    toolCalls: readonly AssembledToolCall[];
+    subagents: ReadonlyMap<string, SubagentDiscoverySnapshot>;
+    subgraphs: ReadonlyMap<string, SubgraphDiscoverySnapshot>;
+    stream: AnyStream;
+    error: unknown;
+    submit: (values: Record<string, unknown> | null | undefined, options?: Record<string, unknown>) => Promise<void>;
+    respond: (response: unknown, options?: Record<string, unknown>) => Promise<void>;
+    respondAll: (responsesById: Record<string, unknown>, options?: Record<string, unknown>) => Promise<void>;
+    values: Record<string, unknown>;
+    messagesKey: string;
 };
 export type LangChainRuntimeExtraOptions = ExternalStoreSharedOptions & {
-  /**
-   * Called whenever the active thread's canonical (remote) ID changes, so the
-   * value can be treated as a managed/controlled variable (e.g. synced to a URL
-   * query param). Only the settled remote ID is emitted: while a freshly created
-   * thread is still optimistic the value is `undefined`, and the real ID is
-   * emitted once the thread is initialized; the transient local ID is never
-   * surfaced.
-   */
-  onThreadIdChange?: ((threadId: string | undefined) => void) | undefined;
-  cloud?: AssistantCloud | undefined;
-  adapters?: {
-    attachments?: AttachmentAdapter | undefined;
-    speech?: SpeechSynthesisAdapter | undefined;
-    dictation?: DictationAdapter | undefined;
-    voice?: RealtimeVoiceAdapter | undefined;
-    feedback?: FeedbackAdapter | undefined;
-  } | undefined;
-  /**
-   * When the user sends a new message while previous tool calls are
-   * still pending, automatically submit `tool` messages that cancel
-   * them so the agent's tool-call accounting stays consistent.
-   * Defaults to `true`.
-   */
-  autoCancelPendingToolCalls?: boolean | undefined;
-  /**
-   * Routes the Cancel button's click to `useStream().stop()`. On by
-   * default. Pass `false` to disable the Cancel button.
-   */
-  unstable_allowCancellation?: boolean | undefined;
-  /**
-   * Custom `RemoteThreadListAdapter`. When provided, replaces the
-   * cloud-backed thread list adapter.
-   */
-  unstable_threadListAdapter?: RemoteThreadListAdapter | undefined;
-  /** Custom thread-creation hook, forwarded to the cloud adapter. */
-  create?: (() => Promise<{
-    externalId: string | undefined;
-  }>) | undefined;
-  /** Custom thread-deletion hook, forwarded to the cloud adapter. */
-  delete?: ((threadId: string) => Promise<void>) | undefined;
-  /**
-   * State key the graph accumulates generative `UIMessage`s under. Each UI
-   * is attached to the assistant message identified by its `metadata.message_id`
-   * (Python SDK) or `metadata.id` (JS SDK) and emitted as a `data` part.
-   * Defaults to `"ui"`.
-   */
-  uiStateKey?: string | undefined;
+    /**
+     * Called whenever the active thread's canonical (remote) ID changes, so the
+     * value can be treated as a managed/controlled variable (e.g. synced to a URL
+     * query param). Only the settled remote ID is emitted: while a freshly created
+     * thread is still optimistic the value is `undefined`, and the real ID is
+     * emitted once the thread is initialized; the transient local ID is never
+     * surfaced.
+     */
+    onThreadIdChange?: ((threadId: string | undefined) => void) | undefined;
+    cloud?: AssistantCloud | undefined;
+    adapters?: {
+        attachments?: AttachmentAdapter | undefined;
+        speech?: SpeechSynthesisAdapter | undefined;
+        dictation?: DictationAdapter | undefined;
+        voice?: RealtimeVoiceAdapter | undefined;
+        feedback?: FeedbackAdapter | undefined;
+    } | undefined;
+    /**
+     * When the user sends a new message while previous tool calls are
+     * still pending, automatically submit `tool` messages that cancel
+     * them so the agent's tool-call accounting stays consistent.
+     * Defaults to `true`.
+     */
+    autoCancelPendingToolCalls?: boolean | undefined;
+    /**
+     * Routes the Cancel button's click to `useStream().stop()`. On by
+     * default. Pass `false` to disable the Cancel button.
+     */
+    unstable_allowCancellation?: boolean | undefined;
+    /**
+     * Custom `RemoteThreadListAdapter`. When provided, replaces the
+     * cloud-backed thread list adapter.
+     */
+    unstable_threadListAdapter?: RemoteThreadListAdapter | undefined;
+    /** Custom thread-creation hook, forwarded to the cloud adapter. */
+    create?: (() => Promise<{
+        externalId: string | undefined;
+    }>) | undefined;
+    /** Custom thread-deletion hook, forwarded to the cloud adapter. */
+    delete?: ((threadId: string) => Promise<void>) | undefined;
+    /**
+     * State key the graph accumulates generative `UIMessage`s under. Each UI
+     * is attached to the assistant message identified by its `metadata.message_id`
+     * (Python SDK) or `metadata.id` (JS SDK) and emitted as a `data` part.
+     * Defaults to `"ui"`.
+     */
+    uiStateKey?: string | undefined;
 };
-export type UseStreamRuntimeOptions = UseStreamOptions extends (infer O) ? O extends UseStreamOptions ? O & LangChainRuntimeExtraOptions : never : never;
-//#endregion
-export type { LangChainContentBlock };
+export type UseStreamRuntimeOptions = UseStreamOptions extends infer O ? O extends UseStreamOptions ? O & LangChainRuntimeExtraOptions : never : never;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;YAqBY;EACV;EACA;EACA,MAAM;;;;;;;;;YAUI,UACV,+BACA,eAAe,0BAA0B;EAEzC;EACA;EACA,MAAM;EACN,OAAO;EACP;IACE;IACA;IACA;IACA;IACA;IACA;KACC;;;;;;;YAQO;EACV;EACA;;;;;;;;;YAUU;EACV;EACA;EACA;EACA;EACA,oBAAoB;;EAEpB,sBAAsB;;EAEtB;;EAEA,SAAS;;EAET;;YAGU;EACV;IAAa;;EACb;IAAuB;IAAa;;EACpC,oBAAoB;EACpB,WAAW,oBAAoB;EAC/B,WAAW,oBAAoB;EAC/B,QAAQ;EACR;EACA,SACE,QAAQ,4CACR,UAAU,4BACP;EACL,UACE,mBACA,UAAU,4BACP;EACL,aACE,eAAe,yBACf,UAAU,4BACP;EACL,QAAQ;EACR;;YAGU,+BAA+B;;;;;;;;;EASzC,qBAAqB;EACrB,QAAQ;EACR;IAEM,cAAc;IACd,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,WAAW;;;;;;;;EASjB;;;;;EAKA;;;;;EAKA,6BAA6B;;EAE7B,gBAAgB;IAAU;;;EAE1B,WAAW,qBAAqB;;;;;;;EAOhC;;YAOU,0BAA0B,gCAA+B,KACjE,UAAU,mBACR,IAAI"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/uiMessages.d.ts

@@ -1,6 +1,5 @@
-import { RemoveUIMessage, UIMessage } from "./types.js";
-import { Channel } from "@langchain/react";
-//#region src/uiMessages.d.ts
+import type { Channel } from "@langchain/react";
+import type { RemoveUIMessage, UIMessage } from "./types.js";
 /** Channels the generative-UI fold reads, at the root and per subagent. */
 export declare const UI_CUSTOM_CHANNELS: readonly Channel[];
 export type UIUpdate = UIMessage | RemoveUIMessage;
@@ -13,8 +12,8 @@ export declare const applyUIUpdate: (list: readonly UIMessage[], update: UIUpdat
  */
 export declare const extractUIUpdate: (event: unknown) => UIUpdate | readonly UIUpdate[] | undefined;
 export type UIFoldMemo = {
-  events: readonly unknown[];
-  messages: UIMessage[];
+    events: readonly unknown[];
+    messages: UIMessage[];
 };
 export declare const createUIFoldMemo: () => UIFoldMemo;
 /**
@@ -26,6 +25,20 @@ export declare const createUIFoldMemo: () => UIFoldMemo;
  * and is folded from scratch.
  */
 export declare const foldUIUpdates: (events: readonly unknown[], memo?: UIFoldMemo) => UIMessage[];
+export type UISnapshotMemo = {
+    snapshot: unknown;
+    entries: readonly UIMessage[];
+};
+export declare const createUISnapshotMemo: () => UISnapshotMemo;
+/**
+ * Recovers entry identity across `values` events. The SDK rebuilds the
+ * `values` object from every snapshot and reconciles only the messages slot by
+ * id, so an unchanged UI list arrives as a new array of new objects on every
+ * superstep. An entry structurally equal to the previous entry with its id is
+ * replaced by that previous object, and a list whose entries all survive in
+ * place is replaced by the previous list.
+ */
+export declare const reconcileUISnapshot: (snapshot: unknown, memo: UISnapshotMemo) => readonly UIMessage[];
 /**
  * Merges live-streamed UI with the state snapshot. The snapshot is
  * authoritative by id: once a UI lands in graph state it supersedes its live
@@ -34,5 +47,4 @@ export declare const foldUIUpdates: (events: readonly unknown[], memo?: UIFoldMe
  * the snapshot catches up.
  */
 export declare const mergeUIMessages: (live: readonly UIMessage[], snapshot: unknown) => UIMessage[];
-//#endregion
 //# sourceMappingURL=uiMessages.d.ts.map

package/dist/uiMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uiMessages.d.ts","names":[],"sources":["../src/uiMessages.ts"],"mappings":";;;;qBAIa,6BAA6B;YAE9B,WAAW,YAAY;qBAEtB,aACX,mBACC,SAAS,oBAAoB;qBAmBnB,gBACX,eAAe,aACf,QAAQ,oBAAoB,eAC3B;;;;;;qBA0BU,kBACX,mBACC,oBAAoB;YAQX;EACV;EACA,UAAU;;qBAGC,wBAAuB;;;;;;;;;qBAavB,gBACX,4BACA,OAAM,eACL;;;;;;;;qBAuBU,kBACX,eAAe,aACf,sBACC"}
+{"version":3,"file":"uiMessages.d.ts","sourceRoot":"","sources":["../src/uiMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,mBAAgB;AAE1D,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,EAAE,SAAS,OAAO,EAAe,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;AAEnD,eAAO,MAAM,UAAU,GACrB,OAAO,OAAO,KACb,KAAK,IAAI,QAAQ,GAAG,SAAS,QAAQ,EAiBvC,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,SAAS,SAAS,EAAE,EAC1B,QAAQ,QAAQ,GAAG,SAAS,QAAQ,EAAE,KACrC,SAAS,EAmBX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,OAAO,KACb,QAAQ,GAAG,SAAS,QAAQ,EAAE,GAAG,SAMnC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAO,UAGlC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS,OAAO,EAAE,EAC1B,OAAM,UAA+B,KACpC,SAAS,EAcX,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAO,cAGtC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,OAAO,EACjB,MAAM,cAAc,KACnB,SAAS,SAAS,EAmBpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,SAAS,SAAS,EAAE,EAC1B,UAAU,OAAO,KAChB,SAAS,EAOX,CAAC"}

package/dist/uiMessages.js

@@ -1,3 +1,4 @@
+import { isJSONValueEqual } from "@assistant-ui/core/internal";
 //#region src/uiMessages.ts
 /** Channels the generative-UI fold reads, at the root and per subagent. */
 const UI_CUSTOM_CHANNELS = ["custom"];
@@ -67,6 +68,37 @@ const foldUIUpdates = (events, memo = createUIFoldMemo()) => {
 	memo.messages = acc;
 	return acc;
 };
+const createUISnapshotMemo = () => ({
+	snapshot: void 0,
+	entries: []
+});
+/**
+* Recovers entry identity across `values` events. The SDK rebuilds the
+* `values` object from every snapshot and reconciles only the messages slot by
+* id, so an unchanged UI list arrives as a new array of new objects on every
+* superstep. An entry structurally equal to the previous entry with its id is
+* replaced by that previous object, and a list whose entries all survive in
+* place is replaced by the previous list.
+*/
+const reconcileUISnapshot = (snapshot, memo) => {
+	if (snapshot === memo.snapshot) return memo.entries;
+	memo.snapshot = snapshot;
+	if (!Array.isArray(snapshot)) {
+		if (memo.entries.length > 0) memo.entries = [];
+		return memo.entries;
+	}
+	const previous = memo.entries;
+	const previousById = new Map(previous.map((ui) => [ui.id, ui]));
+	let same = snapshot.length === previous.length;
+	const entries = snapshot.map((ui, index) => {
+		const before = previousById.get(ui.id);
+		const entry = before !== void 0 && isJSONValueEqual(before, ui) ? before : ui;
+		if (entry !== previous[index]) same = false;
+		return entry;
+	});
+	if (!same) memo.entries = entries;
+	return memo.entries;
+};
 /**
 * Merges live-streamed UI with the state snapshot. The snapshot is
 * authoritative by id: once a UI lands in graph state it supersedes its live
@@ -81,6 +113,6 @@ const mergeUIMessages = (live, snapshot) => {
 	return [...byId.values()];
 };
 //#endregion
-export { UI_CUSTOM_CHANNELS, applyUIUpdate, createUIFoldMemo, extractUIUpdate, foldUIUpdates, isUIUpdate, mergeUIMessages };
+export { UI_CUSTOM_CHANNELS, applyUIUpdate, createUIFoldMemo, createUISnapshotMemo, extractUIUpdate, foldUIUpdates, isUIUpdate, mergeUIMessages, reconcileUISnapshot };
 
 //# sourceMappingURL=uiMessages.js.map