@assistant-ui/core 0.2.18 → 0.2.20

package/dist/react/model-context/useInteractableState.js

@@ -1,80 +1,80 @@
+"use client";
 import { useAui, useAuiState } from "@assistant-ui/store";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 //#region src/react/model-context/useInteractableState.ts
-/**
-* Reads and writes the state of a registered interactable.
-*
-* Pair with {@link useAssistantInteractable} which handles registration.
-*/
-const useInteractableState = (id, fallback) => {
-	const $ = c(19);
+const useInteractableState = (id) => {
+	const $ = c(17);
 	const aui = useAui();
-	const state = useAuiState((s) => s.interactables.definitions[id]?.state) ?? fallback;
 	let t0;
 	if ($[0] !== id) {
-		t0 = (s_0) => s_0.interactables.persistence[id];
+		t0 = (s) => s.unstable_interactables.definitions[id]?.state;
 		$[0] = id;
 		$[1] = t0;
 	} else t0 = $[1];
-	const persistenceStatus = useAuiState(t0);
+	const state = useAuiState(t0);
 	let t1;
-	if ($[2] !== aui || $[3] !== id) {
-		t1 = (updater) => {
-			aui.interactables().setState(id, (prev) => {
+	if ($[2] !== id) {
+		t1 = (s_0) => s_0.unstable_interactables.persistence[id];
+		$[2] = id;
+		$[3] = t1;
+	} else t1 = $[3];
+	const persistenceStatus = useAuiState(t1);
+	let t2;
+	if ($[4] !== aui || $[5] !== id) {
+		t2 = (updater) => {
+			aui.unstable_interactables().setState(id, (prev) => {
 				if (typeof updater === "function") return updater(prev);
 				return updater;
 			});
 		};
-		$[2] = aui;
-		$[3] = id;
-		$[4] = t1;
-	} else t1 = $[4];
-	const setState = t1;
-	let t2;
-	if ($[5] !== aui || $[6] !== id) {
-		t2 = (selected) => {
-			aui.interactables().setSelected(id, selected);
-		};
-		$[5] = aui;
-		$[6] = id;
-		$[7] = t2;
-	} else t2 = $[7];
-	const setSelected = t2;
+		$[4] = aui;
+		$[5] = id;
+		$[6] = t2;
+	} else t2 = $[6];
+	const setState = t2;
 	let t3;
-	if ($[8] !== aui) {
-		t3 = () => aui.interactables().flush();
-		$[8] = aui;
-		$[9] = t3;
-	} else t3 = $[9];
+	if ($[7] !== aui) {
+		t3 = () => aui.unstable_interactables().flush();
+		$[7] = aui;
+		$[8] = t3;
+	} else t3 = $[8];
 	const flush = t3;
 	const t4 = persistenceStatus?.isPending ?? false;
 	const t5 = persistenceStatus?.error;
 	let t6;
-	if ($[10] !== flush || $[11] !== setSelected || $[12] !== setState || $[13] !== t4 || $[14] !== t5) {
+	if ($[9] !== flush || $[10] !== setState || $[11] !== t4 || $[12] !== t5) {
 		t6 = {
 			setState,
-			setSelected,
 			isPending: t4,
 			error: t5,
 			flush
 		};
-		$[10] = flush;
-		$[11] = setSelected;
-		$[12] = setState;
-		$[13] = t4;
-		$[14] = t5;
-		$[15] = t6;
-	} else t6 = $[15];
+		$[9] = flush;
+		$[10] = setState;
+		$[11] = t4;
+		$[12] = t5;
+		$[13] = t6;
+	} else t6 = $[13];
 	let t7;
-	if ($[16] !== state || $[17] !== t6) {
+	if ($[14] !== state || $[15] !== t6) {
 		t7 = [state, t6];
-		$[16] = state;
-		$[17] = t6;
-		$[18] = t7;
-	} else t7 = $[18];
+		$[14] = state;
+		$[15] = t6;
+		$[16] = t7;
+	} else t7 = $[16];
 	return t7;
 };
+/**
+* Reads and writes the state of an interactable registered elsewhere, by id.
+*
+* Use this from secondary readers (children, siblings); the owning component
+* registers with `unstable_useInteractable`, which returns state directly. Returns
+* `undefined` until the owning interactable is registered.
+*
+* @deprecated Unstable / Experimental (not actually removed).
+*/
+const unstable_useInteractableState = useInteractableState;
 //#endregion
-export { useInteractableState };
+export { unstable_useInteractableState };
 
 //# sourceMappingURL=useInteractableState.js.map

package/dist/react/model-context/useInteractableState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useInteractableState.js","names":["useCallback","useAui","useAuiState","StateUpdater","TState","prev","useInteractableState","id","fallback","$","_c","aui","state","s","interactables","definitions","t0","s_0","persistence","persistenceStatus","t1","updater","setState","t2","selected","setSelected","t3","flush","t4","isPending","t5","error","t6","t7"],"sources":["../../../src/react/model-context/useInteractableState.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\n\ntype StateUpdater<TState> = TState | ((prev: TState) => TState);\n\n/**\n * Reads and writes the state of a registered interactable.\n *\n * Pair with {@link useAssistantInteractable} which handles registration.\n */\nexport const useInteractableState = <TState>(\n  id: string,\n  fallback: TState,\n): [\n  TState,\n  {\n    setState: (updater: StateUpdater<TState>) => void;\n    setSelected: (selected: boolean) => void;\n    isPending: boolean;\n    error: unknown;\n    flush: () => Promise<void>;\n  },\n] => {\n  const aui = useAui();\n\n  const state =\n    (useAuiState((s) => s.interactables.definitions[id]?.state) as TState) ??\n    (fallback as TState);\n\n  const persistenceStatus = useAuiState((s) => s.interactables.persistence[id]);\n\n  const setState = useCallback(\n    (updater: StateUpdater<TState>) => {\n      aui.interactables().setState(id, (prev) => {\n        if (typeof updater === \"function\") {\n          return (updater as (prev: TState) => TState)(prev as TState);\n        }\n        return updater;\n      });\n    },\n    [aui, id],\n  );\n\n  const setSelected = useCallback(\n    (selected: boolean) => {\n      aui.interactables().setSelected(id, selected);\n    },\n    [aui, id],\n  );\n\n  const flush = useCallback(() => aui.interactables().flush(), [aui]);\n\n  return [\n    state,\n    {\n      setState,\n      setSelected,\n      isPending: persistenceStatus?.isPending ?? false,\n      error: persistenceStatus?.error,\n      flush,\n    },\n  ];\n};\n"],"mappings":";;;;;;;;AAUA,MAAaM,wBAAuBC,IAAAC,aAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAalC,MAAAC,MAAYV,OAAO;CAEnB,MAAAW,QACGV,aAAYW,MAAOA,EAACC,cAAcC,YAAaR,GAAU,EAAAK,KAAA,KACzDJ;CAAoB,IAAAQ;CAAA,IAAAP,EAAA,OAAAF,IAAA;EAEeS,MAAAC,QAAOJ,IAACC,cAAcI,YAAaX;EAAGE,EAAA,KAAAF;EAAAE,EAAA,KAAAO;CAAA,OAAAA,KAAAP,EAAA;CAA5E,MAAAU,oBAA0BjB,YAAYc,EAAsC;CAAE,IAAAI;CAAA,IAAAX,EAAA,OAAAE,OAAAF,EAAA,OAAAF,IAAA;EAG5Ea,MAAAC,YAAA;GACEV,IAAGG,cAAe,CAAC,CAAAQ,SAAUf,KAAIF,SAAA;IAC/B,IAAI,OAAOgB,YAAY,YAAU,OACvBA,QAAqChB,IAAc;IAC5D,OACMgB;GAAO,CACf;EAAC;EACHZ,EAAA,KAAAE;EAAAF,EAAA,KAAAF;EAAAE,EAAA,KAAAW;CAAA,OAAAA,KAAAX,EAAA;CARH,MAAAa,WAAiBF;CAUf,IAAAG;CAAA,IAAAd,EAAA,OAAAE,OAAAF,EAAA,OAAAF,IAAA;EAGAgB,MAAAC,aAAA;GACEb,IAAGG,cAAe,CAAC,CAAAW,YAAalB,IAAIiB,QAAQ;EAAC;EAC9Cf,EAAA,KAAAE;EAAAF,EAAA,KAAAF;EAAAE,EAAA,KAAAc;CAAA,OAAAA,KAAAd,EAAA;CAHH,MAAAgB,cAAoBF;CAKlB,IAAAG;CAAA,IAAAjB,EAAA,OAAAE,KAAA;EAEwBe,WAAMf,IAAGG,cAAe,CAAC,CAAAa,MAAO;EAAClB,EAAA,KAAAE;EAAAF,EAAA,KAAAiB;CAAA,OAAAA,KAAAjB,EAAA;CAA3D,MAAAkB,QAAcD;CAOC,MAAAE,KAAAT,mBAAiBU,aAAjB;CACJ,MAAAC,KAAAX,mBAAiBY;CAAO,IAAAC;CAAA,IAAAvB,EAAA,QAAAkB,SAAAlB,EAAA,QAAAgB,eAAAhB,EAAA,QAAAa,YAAAb,EAAA,QAAAmB,MAAAnB,EAAA,QAAAqB,IAAA;EAJjCE,KAAA;GAAAV;GAAAG;GAAAI,WAGaD;GAAqCG,OACzCD;GAAwBH;EAEjC;EAAClB,EAAA,MAAAkB;EAAAlB,EAAA,MAAAgB;EAAAhB,EAAA,MAAAa;EAAAb,EAAA,MAAAmB;EAAAnB,EAAA,MAAAqB;EAAArB,EAAA,MAAAuB;CAAA,OAAAA,KAAAvB,EAAA;CAAA,IAAAwB;CAAA,IAAAxB,EAAA,QAAAG,SAAAH,EAAA,QAAAuB,IAAA;EARIC,KAAA,CACLrB,OACAoB,EAMC;EACFvB,EAAA,MAAAG;EAAAH,EAAA,MAAAuB;EAAAvB,EAAA,MAAAwB;CAAA,OAAAA,KAAAxB,EAAA;CAAA,OATMwB;AASN"}
+{"version":3,"file":"useInteractableState.js","names":["c","_c","useCallback","useAui","useAuiState","StateUpdater","TState","prev","useInteractableState","id","$","aui","t0","s","unstable_interactables","definitions","state","t1","s_0","persistence","persistenceStatus","t2","updater","setState","t3","flush","t4","isPending","t5","error","t6","t7","unstable_useInteractableState","Promise"],"sources":["../../../src/react/model-context/useInteractableState.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback } from \"react\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\n\ntype StateUpdater<TState> = TState | ((prev: TState) => TState);\n\nconst useInteractableState = <TState>(\n  id: string,\n): [\n  TState | undefined,\n  {\n    setState: (updater: StateUpdater<TState>) => void;\n    isPending: boolean;\n    error: unknown;\n    flush: () => Promise<void>;\n  },\n] => {\n  const aui = useAui();\n\n  const state = useAuiState(\n    (s) => s.unstable_interactables.definitions[id]?.state,\n  ) as TState | undefined;\n\n  const persistenceStatus = useAuiState(\n    (s) => s.unstable_interactables.persistence[id],\n  );\n\n  const setState = useCallback(\n    (updater: StateUpdater<TState>) => {\n      aui.unstable_interactables().setState(id, (prev) => {\n        if (typeof updater === \"function\") {\n          return (updater as (prev: TState) => TState)(prev as TState);\n        }\n        return updater;\n      });\n    },\n    [aui, id],\n  );\n\n  const flush = useCallback(() => aui.unstable_interactables().flush(), [aui]);\n\n  return [\n    state,\n    {\n      setState,\n      isPending: persistenceStatus?.isPending ?? false,\n      error: persistenceStatus?.error,\n      flush,\n    },\n  ];\n};\n\n/**\n * Reads and writes the state of an interactable registered elsewhere, by id.\n *\n * Use this from secondary readers (children, siblings); the owning component\n * registers with `unstable_useInteractable`, which returns state directly. Returns\n * `undefined` until the owning interactable is registered.\n *\n * @deprecated Unstable / Experimental (not actually removed).\n */\nexport const unstable_useInteractableState: <TState>(id: string) => [\n  TState | undefined,\n  {\n    setState: (updater: StateUpdater<TState>) => void;\n    isPending: boolean;\n    error: unknown;\n    flush: () => Promise<void>;\n  },\n] = useInteractableState;\n"],"mappings":";;;;AAOA,MAAMQ,wBAAuBC,OAAA;CAAA,MAAAC,IAAAT,EAAA,EAAA;CAW3B,MAAAU,MAAYR,OAAO;CAAE,IAAAS;CAAA,IAAAF,EAAA,OAAAD,IAAA;EAGnBG,MAAAC,MAAOA,EAACC,uBAAuBC,YAAaN,GAAU,EAAAO;EAAAN,EAAA,KAAAD;EAAAC,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CADxD,MAAAM,QAAcZ,YACZQ,EACF;CAAwB,IAAAK;CAAA,IAAAP,EAAA,OAAAD,IAAA;EAGtBQ,MAAAC,QAAOL,IAACC,uBAAuBK,YAAaV;EAAGC,EAAA,KAAAD;EAAAC,EAAA,KAAAO;CAAA,OAAAA,KAAAP,EAAA;CADjD,MAAAU,oBAA0BhB,YACxBa,EACF;CAAE,IAAAI;CAAA,IAAAX,EAAA,OAAAC,OAAAD,EAAA,OAAAD,IAAA;EAGAY,MAAAC,YAAA;GACEX,IAAGG,uBAAwB,CAAC,CAAAS,SAAUd,KAAIF,SAAA;IACxC,IAAI,OAAOe,YAAY,YAAU,OACvBA,QAAqCf,IAAc;IAC5D,OACMe;GAAO,CACf;EAAC;EACHZ,EAAA,KAAAC;EAAAD,EAAA,KAAAD;EAAAC,EAAA,KAAAW;CAAA,OAAAA,KAAAX,EAAA;CARH,MAAAa,WAAiBF;CAUf,IAAAG;CAAA,IAAAd,EAAA,OAAAC,KAAA;EAEwBa,WAAMb,IAAGG,uBAAwB,CAAC,CAAAW,MAAO;EAACf,EAAA,KAAAC;EAAAD,EAAA,KAAAc;CAAA,OAAAA,KAAAd,EAAA;CAApE,MAAAe,QAAcD;CAMC,MAAAE,KAAAN,mBAAiBO,aAAjB;CACJ,MAAAC,KAAAR,mBAAiBS;CAAO,IAAAC;CAAA,IAAApB,EAAA,OAAAe,SAAAf,EAAA,QAAAa,YAAAb,EAAA,QAAAgB,MAAAhB,EAAA,QAAAkB,IAAA;EAHjCE,KAAA;GAAAP;GAAAI,WAEaD;GAAqCG,OACzCD;GAAwBH;EAEjC;EAACf,EAAA,KAAAe;EAAAf,EAAA,MAAAa;EAAAb,EAAA,MAAAgB;EAAAhB,EAAA,MAAAkB;EAAAlB,EAAA,MAAAoB;CAAA,OAAAA,KAAApB,EAAA;CAAA,IAAAqB;CAAA,IAAArB,EAAA,QAAAM,SAAAN,EAAA,QAAAoB,IAAA;EAPIC,KAAA,CACLf,OACAc,EAKC;EACFpB,EAAA,MAAAM;EAAAN,EAAA,MAAAoB;EAAApB,EAAA,MAAAqB;CAAA,OAAAA,KAAArB,EAAA;CAAA,OARMqB;AAQN;;;;;;;;;;AAYH,MAAaC,gCAQTxB"}

package/dist/react/model-context/useInteractableVersions.d.ts

@@ -0,0 +1,19 @@
+import { Unstable_InteractableVersion } from "../../model-context/interactable-composer-metadata.js";
+
+//#region src/react/model-context/useInteractableVersions.d.ts
+/**
+ * Every version of a tool-created interactable recorded in the current
+ * thread, oldest first: the creating tool call, each user edit, and each
+ * `update_*` call. Each entry carries the full state as of that version and a
+ * `restore()` that sets the live instance back to it — enough for a version
+ * picker like an artifact's history dropdown.
+ *
+ * @deprecated Unstable / Experimental (not actually removed).
+ */
+declare const unstable_useInteractableVersions: <TState = unknown>(id: string, name: string) => (Omit<Unstable_InteractableVersion, "state"> & {
+  state: TState;
+  restore: () => void;
+})[];
+//#endregion
+export { unstable_useInteractableVersions };
+//# sourceMappingURL=useInteractableVersions.d.ts.map

package/dist/react/model-context/useInteractableVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractableVersions.d.ts","names":[],"sources":["../../../src/react/model-context/useInteractableVersions.ts"],"mappings":";;;;;AAyCA;;;;;;;cAAa,gCAAA,qBACX,EAAA,UACA,IAAA,cACI,IAAA,CAAK,4BAAA;EACT,KAAA,EAAO,MAAA;EACP,OAAA;AAAA"}

package/dist/react/model-context/useInteractableVersions.js

@@ -0,0 +1,51 @@
+import { unstable_getInteractableVersions } from "../../model-context/interactable-composer-metadata.js";
+import { unstable_useInteractableState } from "./useInteractableState.js";
+import { useJSONEqual } from "../utils/useJSONEqual.js";
+import { useAuiState } from "@assistant-ui/store";
+import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
+//#region src/react/model-context/useInteractableVersions.ts
+const useInteractableVersions = (id, name) => {
+	const $ = c(8);
+	let t0;
+	if ($[0] !== id || $[1] !== name) {
+		t0 = (s) => unstable_getInteractableVersions(s.thread.messages, id, name);
+		$[0] = id;
+		$[1] = name;
+		$[2] = t0;
+	} else t0 = $[2];
+	const versions = useAuiState(useJSONEqual(t0));
+	const [, t1] = unstable_useInteractableState(id);
+	const { setState } = t1;
+	let t2;
+	if ($[3] !== setState || $[4] !== versions) {
+		let t3;
+		if ($[6] !== setState) {
+			t3 = (v) => ({
+				...v,
+				state: v.state,
+				restore: () => setState(v.state)
+			});
+			$[6] = setState;
+			$[7] = t3;
+		} else t3 = $[7];
+		t2 = versions.map(t3);
+		$[3] = setState;
+		$[4] = versions;
+		$[5] = t2;
+	} else t2 = $[5];
+	return t2;
+};
+/**
+* Every version of a tool-created interactable recorded in the current
+* thread, oldest first: the creating tool call, each user edit, and each
+* `update_*` call. Each entry carries the full state as of that version and a
+* `restore()` that sets the live instance back to it — enough for a version
+* picker like an artifact's history dropdown.
+*
+* @deprecated Unstable / Experimental (not actually removed).
+*/
+const unstable_useInteractableVersions = useInteractableVersions;
+//#endregion
+export { unstable_useInteractableVersions };
+
+//# sourceMappingURL=useInteractableVersions.js.map

package/dist/react/model-context/useInteractableVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractableVersions.js","names":["useMemo","useAuiState","unstable_getInteractableVersions","getInteractableVersions","Unstable_InteractableVersion","unstable_useInteractableState","useInteractableState","useJSONEqual","useInteractableVersions","id","name","$","_c","t0","s","thread","messages","versions","t1","setState","t2","t3","v","state","TState","restore","map","unstable_useInteractableVersions","Omit"],"sources":["../../../src/react/model-context/useInteractableVersions.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useAuiState } from \"@assistant-ui/store\";\nimport {\n  unstable_getInteractableVersions as getInteractableVersions,\n  type Unstable_InteractableVersion,\n} from \"../../model-context/interactable-composer-metadata\";\nimport { unstable_useInteractableState as useInteractableState } from \"./useInteractableState\";\nimport { useJSONEqual } from \"../utils/useJSONEqual\";\n\nconst useInteractableVersions = <TState = unknown>(\n  id: string,\n  name: string,\n): (Omit<Unstable_InteractableVersion, \"state\"> & {\n  state: TState;\n  restore: () => void;\n})[] => {\n  const versions = useAuiState(\n    useJSONEqual((s) => getInteractableVersions(s.thread.messages, id, name)),\n  );\n  const [, { setState }] = useInteractableState<TState>(id);\n\n  return useMemo(\n    () =>\n      versions.map((v) => ({\n        ...v,\n        state: v.state as TState,\n        restore: () => setState(v.state as TState),\n      })),\n    [versions, setState],\n  );\n};\n\n/**\n * Every version of a tool-created interactable recorded in the current\n * thread, oldest first: the creating tool call, each user edit, and each\n * `update_*` call. Each entry carries the full state as of that version and a\n * `restore()` that sets the live instance back to it — enough for a version\n * picker like an artifact's history dropdown.\n *\n * @deprecated Unstable / Experimental (not actually removed).\n */\nexport const unstable_useInteractableVersions: <TState = unknown>(\n  id: string,\n  name: string,\n) => (Omit<Unstable_InteractableVersion, \"state\"> & {\n  state: TState;\n  restore: () => void;\n})[] = useInteractableVersions;\n"],"mappings":";;;;;;AASA,MAAMQ,2BAA0BC,IAAAC,SAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAF,MAAAE,EAAA,OAAAD,MAAA;EAQfG,MAAAC,MAAOX,iCAAwBW,EAACC,OAAOC,UAAWP,IAAIC,IAAI;EAACC,EAAA,KAAAF;EAAAE,EAAA,KAAAD;EAAAC,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CAD1E,MAAAM,WAAiBhB,YACfM,aAAaM,EAA2D,CAC1E;CACA,MAAA,GAAAK,MAAyBZ,8BAA6BG,EAAE;CAA/C,MAAA,EAAAU,aAAAD;CAAY,IAAAE;CAAA,IAAAT,EAAA,OAAAQ,YAAAR,EAAA,OAAAM,UAAA;EAAA,IAAAI;EAAA,IAAAV,EAAA,OAAAQ,UAAA;GAIJE,MAAAC,OAAQ;IAAA,GAChBA;IAACC,OACGD,EAACC;IAAgBE,eACTN,SAASG,EAACC,KAAgB;GAC3C;GAAEZ,EAAA,KAAAQ;GAAAR,EAAA,KAAAU;EAAA,OAAAA,KAAAV,EAAA;EAJFS,KAAAH,SAAQS,IAAKL,EAIX;EAACV,EAAA,KAAAQ;EAAAR,EAAA,KAAAM;EAAAN,EAAA,KAAAS;CAAA,OAAAA,KAAAT,EAAA;CAAA,OAJHS;AAIG;;;;;;;;;;AAcT,MAAaO,mCAMNnB"}

package/dist/react/primitive-hooks/useThreadMessageIds.d.ts

@@ -0,0 +1,15 @@
+//#region src/react/primitive-hooks/useThreadMessageIds.d.ts
+/**
+ * Returns the ids of the messages in the current thread, in order.
+ *
+ * The returned array keeps a stable identity across content-only updates (e.g.
+ * streaming), changing reference only when the id sequence itself changes. Pair
+ * with `ThreadPrimitive.Unstable_MessageById` to drive a virtualized or custom
+ * message list.
+ *
+ * @deprecated Unstable / Experimental - may change in any release.
+ */
+declare const unstable_useThreadMessageIds: () => readonly string[];
+//#endregion
+export { unstable_useThreadMessageIds };
+//# sourceMappingURL=useThreadMessageIds.d.ts.map

package/dist/react/primitive-hooks/useThreadMessageIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThreadMessageIds.d.ts","names":[],"sources":["../../../src/react/primitive-hooks/useThreadMessageIds.ts"],"mappings":";;AA0BA;;;;AAA+D;;;;;cAAlD,4BAAA"}

package/dist/react/primitive-hooks/useThreadMessageIds.js

@@ -0,0 +1,26 @@
+import { useAuiState } from "@assistant-ui/store";
+import { useRef } from "@assistant-ui/tap/react-shim";
+//#region src/react/primitive-hooks/useThreadMessageIds.ts
+const useThreadMessageIds = () => {
+	const messages = useAuiState((s) => s.thread.messages);
+	const prevIdsRef = useRef([]);
+	const ids = messages.map((m) => m.id);
+	const prev = prevIdsRef.current;
+	if (prev.length !== ids.length || prev.some((id, i) => id !== ids[i])) prevIdsRef.current = ids;
+	return prevIdsRef.current;
+};
+/**
+* Returns the ids of the messages in the current thread, in order.
+*
+* The returned array keeps a stable identity across content-only updates (e.g.
+* streaming), changing reference only when the id sequence itself changes. Pair
+* with `ThreadPrimitive.Unstable_MessageById` to drive a virtualized or custom
+* message list.
+*
+* @deprecated Unstable / Experimental - may change in any release.
+*/
+const unstable_useThreadMessageIds = useThreadMessageIds;
+//#endregion
+export { unstable_useThreadMessageIds };
+
+//# sourceMappingURL=useThreadMessageIds.js.map

package/dist/react/primitive-hooks/useThreadMessageIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThreadMessageIds.js","names":["useRef","useAuiState","useThreadMessageIds","messages","s","thread","prevIdsRef","ids","map","m","id","prev","current","length","some","i","unstable_useThreadMessageIds"],"sources":["../../../src/react/primitive-hooks/useThreadMessageIds.ts"],"sourcesContent":["import { useRef } from \"react\";\nimport { useAuiState } from \"@assistant-ui/store\";\n\nconst useThreadMessageIds = (): readonly string[] => {\n  const messages = useAuiState((s) => s.thread.messages);\n  const prevIdsRef = useRef<readonly string[]>([]);\n\n  const ids = messages.map((m) => m.id);\n  const prev = prevIdsRef.current;\n  if (prev.length !== ids.length || prev.some((id, i) => id !== ids[i])) {\n    prevIdsRef.current = ids;\n  }\n\n  return prevIdsRef.current;\n};\n\n/**\n * Returns the ids of the messages in the current thread, in order.\n *\n * The returned array keeps a stable identity across content-only updates (e.g.\n * streaming), changing reference only when the id sequence itself changes. Pair\n * with `ThreadPrimitive.Unstable_MessageById` to drive a virtualized or custom\n * message list.\n *\n * @deprecated Unstable / Experimental - may change in any release.\n */\nexport const unstable_useThreadMessageIds = useThreadMessageIds;\n"],"mappings":";;;AAGA,MAAME,4BAA+C;CACnD,MAAMC,WAAWF,aAAaG,MAAMA,EAAEC,OAAOF,QAAQ;CACrD,MAAMG,aAAaN,OAA0B,CAAA,CAAE;CAE/C,MAAMO,MAAMJ,SAASK,KAAKC,MAAMA,EAAEC,EAAE;CACpC,MAAMC,OAAOL,WAAWM;CACxB,IAAID,KAAKE,WAAWN,IAAIM,UAAUF,KAAKG,MAAMJ,IAAIK,MAAML,OAAOH,IAAIQ,EAAE,GAClET,WAAWM,UAAUL;CAGvB,OAAOD,WAAWM;AACpB;;;;;;;;;;;AAYA,MAAaI,+BAA+Bd"}

package/dist/react/primitive-hooks/useVoice.js

@@ -1,5 +1,5 @@
-import { useSyncExternalStore } from "@assistant-ui/tap/react-shim";
 import { useAui, useAuiState } from "@assistant-ui/store";
+import { useSyncExternalStore } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 //#region src/react/primitive-hooks/useVoice.ts
 const useVoiceState = () => {

package/dist/react/primitives/chainOfThought/ChainOfThoughtParts.js

@@ -1,7 +1,7 @@
 import { ChainOfThoughtPartByIndexProvider } from "../../providers/ChainOfThoughtPartByIndexProvider.js";
 import { MessagePartComponent } from "../message/MessageParts.js";
-import { useMemo } from "@assistant-ui/tap/react-shim";
 import { RenderChildrenWithAccessor, useAuiState } from "@assistant-ui/store";
+import { useMemo } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/primitives/chainOfThought/ChainOfThoughtParts.tsx

package/dist/react/primitives/composer/ComposerAttachments.js

@@ -1,6 +1,6 @@
 import { ComposerAttachmentByIndexProvider } from "../../providers/AttachmentByIndexProvider.js";
-import { memo, useMemo } from "@assistant-ui/tap/react-shim";
 import { RenderChildrenWithAccessor, useAuiState } from "@assistant-ui/store";
+import { memo, useMemo } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/primitives/composer/ComposerAttachments.tsx

package/dist/react/primitives/composer/ComposerQueue.js

@@ -1,6 +1,6 @@
 import { QueueItemByIndexProvider } from "../../providers/QueueItemByIndexProvider.js";
-import { memo, useMemo } from "@assistant-ui/tap/react-shim";
 import { RenderChildrenWithAccessor, useAuiState } from "@assistant-ui/store";
+import { memo, useMemo } from "@assistant-ui/tap/react-shim";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/primitives/composer/ComposerQueue.tsx
 const ComposerPrimitiveQueueInner = ({ children }) => {

package/dist/react/primitives/generativeUI/GenerativeUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GenerativeUI.d.ts","names":[],"sources":["../../../../src/react/primitives/generativeUI/GenerativeUI.tsx"],"mappings":";;;;;;;AAyBA;;;;cAAa,uBAAA,SAAgC,KAAK;EAAA,SAChC,aAAA;cAGd,aAAA,UACA,OAAA;AAAA;;;AAA+E;AAuEnF;;cAAa,kBAAA,EAAoB,EAAE,CAAC,uBAAA;AAAA,kBAgBnB,4BAAA;EAAA,KACH,KAAA;IADG;;;;;;;IASb,UAAA,EAAY,6BAAA;IARF;;;;;IAcV,IAAA,GAAO,gBAAA,cAGH;IADJ,QAAA,GACI,aAAA;MAAgB,SAAA;MAAmB,KAAA;IAAA;EAAA;AAAA;;;;;;;AAuBP;;;;;;;;;;;cADvB,4BAAA,EAA8B,EAAE,CAC3C,4BAAA,CAA6B,KAAA"}
+{"version":3,"file":"GenerativeUI.d.ts","names":[],"sources":["../../../../src/react/primitives/generativeUI/GenerativeUI.tsx"],"mappings":";;;;;;;AAyBA;;;;cAAa,uBAAA,SAAgC,KAAK;EAAA,SAChC,aAAA;cAGd,aAAA,UACA,OAAA;AAAA;;;AAA+E;AA2EnF;;cAAa,kBAAA,EAAoB,EAAE,CAAC,uBAAA;AAAA,kBAgBnB,4BAAA;EAAA,KACH,KAAA;IADG;;;;;;;IASb,UAAA,EAAY,6BAAA;IARF;;;;;IAcV,IAAA,GAAO,gBAAA,cAGH;IADJ,QAAA,GACI,aAAA;MAAgB,SAAA;MAAmB,KAAA;IAAA;EAAA;AAAA;;;;;;;AAuBP;;;;;;;;;;;cADvB,4BAAA,EAA8B,EAAE,CAC3C,4BAAA,CAA6B,KAAA"}

package/dist/react/primitives/generativeUI/GenerativeUI.js

@@ -1,6 +1,6 @@
 "use client";
-import { createElement } from "@assistant-ui/tap/react-shim";
 import { useAuiState } from "@assistant-ui/store";
+import { createElement } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 //#region src/react/primitives/generativeUI/GenerativeUI.tsx
@@ -22,7 +22,7 @@ const isObjectNode = (node) => typeof node === "object" && node !== null;
 const renderNode = (node, components, Fallback, path) => {
 	if (node === void 0 || node === null) return null;
 	if (typeof node === "string") return node;
-	if (!isObjectNode(node) || !("component" in node)) {
+	if (!isObjectNode(node) || !("component" in node) || typeof node.component !== "string") {
 		if (typeof process !== "undefined" && process.env?.NODE_ENV !== "production") console.warn(`[generative-ui] Skipping malformed node at ${path}:`, node);
 		return null;
 	}

package/dist/react/primitives/generativeUI/GenerativeUI.js.map

@@ -1 +1 @@
-{"version":3,"file":"GenerativeUI.js","names":["c","_c","ComponentType","FC","ReactNode","createElement","useMemo","useAuiState","GenerativeUINode","GenerativeUISpec","GenerativeUIComponentRegistry","GenerativeUIRenderProps","GenerativeUIRenderError","Error","componentName","constructor","message","name","isObjectNode","node","Exclude","renderNode","components","Fallback","path","undefined","process","env","NODE_ENV","console","warn","component","props","children","key","Resolved","renderedChildren","length","map","child","i","normalizeRoot","spec","root","Array","isArray","GenerativeUIRender","t0","$","t1","nodes","t2","t3","displayName","MessagePrimitiveGenerativeUI","Props","storeSpec","_temp","partSpec","s","part","type"],"sources":["../../../../src/react/primitives/generativeUI/GenerativeUI.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  type ComponentType,\n  type FC,\n  type ReactNode,\n  createElement,\n  useMemo,\n} from \"react\";\nimport { useAuiState } from \"@assistant-ui/store\";\nimport type {\n  GenerativeUINode,\n  GenerativeUISpec,\n} from \"../../../types/message\";\nimport type {\n  GenerativeUIComponentRegistry,\n  GenerativeUIRenderProps,\n} from \"../../types/MessagePartComponentTypes\";\n\n/**\n * Thrown when a generative-ui spec references a component name that is not\n * present in the consumer-provided allowlist. The allowlist is the security\n * boundary in the same-realm rendering path — there is no fallback by\n * default. Pass `Fallback` to opt into a soft-fail UX.\n */\nexport class GenerativeUIRenderError extends Error {\n  public readonly componentName: string;\n\n  constructor(\n    componentName: string,\n    message = `Component \"${componentName}\" is not in the generative-ui allowlist.`,\n  ) {\n    super(message);\n    this.name = \"GenerativeUIRenderError\";\n    this.componentName = componentName;\n  }\n}\n\nconst isObjectNode = (\n  node: GenerativeUINode,\n): node is Exclude<GenerativeUINode, string> =>\n  typeof node === \"object\" && node !== null;\n\nconst renderNode = (\n  node: GenerativeUINode | undefined,\n  components: GenerativeUIComponentRegistry,\n  Fallback: GenerativeUIRenderProps[\"Fallback\"],\n  path: string,\n): ReactNode => {\n  if (node === undefined || node === null) return null;\n\n  if (typeof node === \"string\") return node;\n\n  if (!isObjectNode(node) || !(\"component\" in node)) {\n    if (\n      typeof process !== \"undefined\" &&\n      process.env?.NODE_ENV !== \"production\"\n    ) {\n      console.warn(`[generative-ui] Skipping malformed node at ${path}:`, node);\n    }\n    return null;\n  }\n\n  const { component, props, children, key } = node;\n\n  const Resolved = components[component];\n  if (!Resolved) {\n    if (Fallback) {\n      return <Fallback key={key ?? path} component={component} props={props} />;\n    }\n    throw new GenerativeUIRenderError(component);\n  }\n\n  const renderedChildren = children?.length\n    ? children.map((child, i) =>\n        renderNode(child, components, Fallback, `${path}/${i}`),\n      )\n    : undefined;\n\n  return createElement(\n    Resolved,\n    { ...(props ?? {}), key: key ?? path },\n    ...(renderedChildren ?? []),\n  );\n};\n\nconst normalizeRoot = (\n  spec: GenerativeUISpec | undefined,\n): readonly GenerativeUINode[] => {\n  if (!spec || spec.root === undefined || spec.root === null) return [];\n  const root = spec.root;\n  return Array.isArray(root)\n    ? (root as readonly GenerativeUINode[])\n    : [root as GenerativeUINode];\n};\n\n/**\n * Internal renderer. Resolves a {@link GenerativeUISpec} against the consumer\n * allowlist. Used by `MessagePrimitive.GenerativeUI` and by\n * `MessagePrimitive.Parts` when handling a `generative-ui` part.\n */\nexport const GenerativeUIRender: FC<GenerativeUIRenderProps> = ({\n  spec,\n  components,\n  Fallback,\n}) => {\n  const nodes = useMemo(() => normalizeRoot(spec), [spec]);\n\n  return (\n    <>\n      {nodes.map((node, i) => renderNode(node, components, Fallback, `${i}`))}\n    </>\n  );\n};\n\nGenerativeUIRender.displayName = \"GenerativeUIRender\";\n\nexport namespace MessagePrimitiveGenerativeUI {\n  export type Props = {\n    /**\n     * The component allowlist. Keys are the names referenced in the spec\n     * (e.g. `\"Card\"`, `\"Button\"`), values are the React components.\n     *\n     * This is the security boundary — any name not in the allowlist is\n     * rejected with {@link GenerativeUIRenderError}.\n     */\n    components: GenerativeUIComponentRegistry;\n    /**\n     * Optional override spec. If omitted, the primitive reads the\n     * `generative-ui` part from the surrounding `MessagePartProvider` /\n     * `PartByIndexProvider` context.\n     */\n    spec?: GenerativeUISpec | undefined;\n    /** Optional fallback for unknown component names. */\n    Fallback?:\n      | ComponentType<{ component: string; props?: unknown }>\n      | undefined;\n  };\n}\n\n/**\n * Renders a generative-ui message part using a consumer-provided allowlist.\n *\n * The agent emits a `generative-ui` message part containing a JSON spec\n * (see {@link GenerativeUISpec}). This primitive walks the spec and resolves\n * each `component` name against the allowlist. Names not in the allowlist\n * throw {@link GenerativeUIRenderError} unless a `Fallback` is provided.\n *\n * Stream-friendly: a partial spec renders progressively as it is filled in.\n *\n * @example\n * ```tsx\n * <MessagePrimitive.GenerativeUI\n *   components={{ Card: MyCard, Button: MyButton }}\n * />\n * ```\n */\nexport const MessagePrimitiveGenerativeUI: FC<\n  MessagePrimitiveGenerativeUI.Props\n> = ({ components, spec, Fallback }) => {\n  // Selector reads store state only — combining with the `spec` prop inside\n  // the selector closes over a value that may change identity per render and\n  // would trigger spurious tearing-detection re-renders in\n  // `useSyncExternalStore`.\n  const storeSpec = useAuiState((s) => {\n    const part = s.part as { type?: string; spec?: GenerativeUISpec };\n    return part?.type === \"generative-ui\" ? part.spec : undefined;\n  });\n  const partSpec = spec ?? storeSpec;\n\n  if (!partSpec) return null;\n\n  return (\n    <GenerativeUIRender\n      spec={partSpec}\n      components={components}\n      Fallback={Fallback}\n    />\n  );\n};\n\nMessagePrimitiveGenerativeUI.displayName = \"MessagePrimitive.GenerativeUI\";\n"],"mappings":"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"}
+{"version":3,"file":"GenerativeUI.js","names":["c","_c","ComponentType","FC","ReactNode","createElement","useMemo","useAuiState","GenerativeUINode","GenerativeUISpec","GenerativeUIComponentRegistry","GenerativeUIRenderProps","GenerativeUIRenderError","Error","componentName","constructor","message","name","isObjectNode","node","Exclude","renderNode","components","Fallback","path","undefined","component","process","env","NODE_ENV","console","warn","props","children","key","Resolved","renderedChildren","length","map","child","i","normalizeRoot","spec","root","Array","isArray","GenerativeUIRender","t0","$","t1","nodes","t2","t3","displayName","MessagePrimitiveGenerativeUI","Props","storeSpec","_temp","partSpec","s","part","type"],"sources":["../../../../src/react/primitives/generativeUI/GenerativeUI.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  type ComponentType,\n  type FC,\n  type ReactNode,\n  createElement,\n  useMemo,\n} from \"react\";\nimport { useAuiState } from \"@assistant-ui/store\";\nimport type {\n  GenerativeUINode,\n  GenerativeUISpec,\n} from \"../../../types/message\";\nimport type {\n  GenerativeUIComponentRegistry,\n  GenerativeUIRenderProps,\n} from \"../../types/MessagePartComponentTypes\";\n\n/**\n * Thrown when a generative-ui spec references a component name that is not\n * present in the consumer-provided allowlist. The allowlist is the security\n * boundary in the same-realm rendering path — there is no fallback by\n * default. Pass `Fallback` to opt into a soft-fail UX.\n */\nexport class GenerativeUIRenderError extends Error {\n  public readonly componentName: string;\n\n  constructor(\n    componentName: string,\n    message = `Component \"${componentName}\" is not in the generative-ui allowlist.`,\n  ) {\n    super(message);\n    this.name = \"GenerativeUIRenderError\";\n    this.componentName = componentName;\n  }\n}\n\nconst isObjectNode = (\n  node: GenerativeUINode,\n): node is Exclude<GenerativeUINode, string> =>\n  typeof node === \"object\" && node !== null;\n\nconst renderNode = (\n  node: GenerativeUINode | undefined,\n  components: GenerativeUIComponentRegistry,\n  Fallback: GenerativeUIRenderProps[\"Fallback\"],\n  path: string,\n): ReactNode => {\n  if (node === undefined || node === null) return null;\n\n  if (typeof node === \"string\") return node;\n\n  if (\n    !isObjectNode(node) ||\n    !(\"component\" in node) ||\n    typeof node.component !== \"string\"\n  ) {\n    if (\n      typeof process !== \"undefined\" &&\n      process.env?.NODE_ENV !== \"production\"\n    ) {\n      console.warn(`[generative-ui] Skipping malformed node at ${path}:`, node);\n    }\n    return null;\n  }\n\n  const { component, props, children, key } = node;\n\n  const Resolved = components[component];\n  if (!Resolved) {\n    if (Fallback) {\n      return <Fallback key={key ?? path} component={component} props={props} />;\n    }\n    throw new GenerativeUIRenderError(component);\n  }\n\n  const renderedChildren = children?.length\n    ? children.map((child, i) =>\n        renderNode(child, components, Fallback, `${path}/${i}`),\n      )\n    : undefined;\n\n  return createElement(\n    Resolved,\n    { ...(props ?? {}), key: key ?? path },\n    ...(renderedChildren ?? []),\n  );\n};\n\nconst normalizeRoot = (\n  spec: GenerativeUISpec | undefined,\n): readonly GenerativeUINode[] => {\n  if (!spec || spec.root === undefined || spec.root === null) return [];\n  const root = spec.root;\n  return Array.isArray(root)\n    ? (root as readonly GenerativeUINode[])\n    : [root as GenerativeUINode];\n};\n\n/**\n * Internal renderer. Resolves a {@link GenerativeUISpec} against the consumer\n * allowlist. Used by `MessagePrimitive.GenerativeUI` and by\n * `MessagePrimitive.Parts` when handling a `generative-ui` part.\n */\nexport const GenerativeUIRender: FC<GenerativeUIRenderProps> = ({\n  spec,\n  components,\n  Fallback,\n}) => {\n  const nodes = useMemo(() => normalizeRoot(spec), [spec]);\n\n  return (\n    <>\n      {nodes.map((node, i) => renderNode(node, components, Fallback, `${i}`))}\n    </>\n  );\n};\n\nGenerativeUIRender.displayName = \"GenerativeUIRender\";\n\nexport namespace MessagePrimitiveGenerativeUI {\n  export type Props = {\n    /**\n     * The component allowlist. Keys are the names referenced in the spec\n     * (e.g. `\"Card\"`, `\"Button\"`), values are the React components.\n     *\n     * This is the security boundary — any name not in the allowlist is\n     * rejected with {@link GenerativeUIRenderError}.\n     */\n    components: GenerativeUIComponentRegistry;\n    /**\n     * Optional override spec. If omitted, the primitive reads the\n     * `generative-ui` part from the surrounding `MessagePartProvider` /\n     * `PartByIndexProvider` context.\n     */\n    spec?: GenerativeUISpec | undefined;\n    /** Optional fallback for unknown component names. */\n    Fallback?:\n      | ComponentType<{ component: string; props?: unknown }>\n      | undefined;\n  };\n}\n\n/**\n * Renders a generative-ui message part using a consumer-provided allowlist.\n *\n * The agent emits a `generative-ui` message part containing a JSON spec\n * (see {@link GenerativeUISpec}). This primitive walks the spec and resolves\n * each `component` name against the allowlist. Names not in the allowlist\n * throw {@link GenerativeUIRenderError} unless a `Fallback` is provided.\n *\n * Stream-friendly: a partial spec renders progressively as it is filled in.\n *\n * @example\n * ```tsx\n * <MessagePrimitive.GenerativeUI\n *   components={{ Card: MyCard, Button: MyButton }}\n * />\n * ```\n */\nexport const MessagePrimitiveGenerativeUI: FC<\n  MessagePrimitiveGenerativeUI.Props\n> = ({ components, spec, Fallback }) => {\n  // Selector reads store state only — combining with the `spec` prop inside\n  // the selector closes over a value that may change identity per render and\n  // would trigger spurious tearing-detection re-renders in\n  // `useSyncExternalStore`.\n  const storeSpec = useAuiState((s) => {\n    const part = s.part as { type?: string; spec?: GenerativeUISpec };\n    return part?.type === \"generative-ui\" ? part.spec : undefined;\n  });\n  const partSpec = spec ?? storeSpec;\n\n  if (!partSpec) return null;\n\n  return (\n    <GenerativeUIRender\n      spec={partSpec}\n      components={components}\n      Fallback={Fallback}\n    />\n  );\n};\n\nMessagePrimitiveGenerativeUI.displayName = \"MessagePrimitive.GenerativeUI\";\n"],"mappings":"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"}

package/dist/react/primitives/message/MessageAttachments.js

@@ -1,6 +1,6 @@
 import { MessageAttachmentByIndexProvider } from "../../providers/AttachmentByIndexProvider.js";
-import { memo, useMemo } from "@assistant-ui/tap/react-shim";
 import { RenderChildrenWithAccessor, useAuiState } from "@assistant-ui/store";
+import { memo, useMemo } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/primitives/message/MessageAttachments.tsx

package/dist/react/primitives/message/MessageGroupedParts.js

@@ -1,8 +1,8 @@
 "use client";
 import { MessagePartChildren } from "./MessageParts.js";
 import { GROUPBY_MEMO_KEY, buildGroupTree } from "../../utils/groupParts.js";
-import { Fragment, useMemo } from "@assistant-ui/tap/react-shim";
 import { useAuiState } from "@assistant-ui/store";
+import { Fragment, useMemo } from "@assistant-ui/tap/react-shim";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useShallow } from "zustand/shallow";
 //#region src/react/primitives/message/MessageGroupedParts.tsx

package/dist/react/primitives/message/MessageParts.js

@@ -4,8 +4,8 @@ import { TextMessagePartProvider } from "../../providers/TextMessagePartProvider
 import { ChainOfThoughtByIndicesProvider } from "../../providers/ChainOfThoughtByIndicesProvider.js";
 import { getMessageQuote } from "../../utils/getMessageQuote.js";
 import { GenerativeUIRender } from "../generativeUI/GenerativeUI.js";
-import { memo } from "@assistant-ui/tap/react-shim";
 import { RenderChildrenWithAccessor, useAui, useAuiState } from "@assistant-ui/store";
+import { memo } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useShallow } from "zustand/shallow";

package/dist/react/primitives/message/MessageQuote.js

@@ -1,6 +1,6 @@
 import { getMessageQuote } from "../../utils/getMessageQuote.js";
-import { memo } from "@assistant-ui/tap/react-shim";
 import { useAuiState } from "@assistant-ui/store";
+import { memo } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 //#region src/react/primitives/message/MessageQuote.tsx

package/dist/react/primitives/part/PartMessages.d.ts

@@ -5,10 +5,13 @@ import { FC, ReactNode } from "react";
 //#region src/react/primitives/part/PartMessages.d.ts
 declare namespace PartPrimitiveMessages {
   type Props = {
-    components?: ThreadPrimitiveMessages.Props["components"]; /** Render function called for each message. Receives the message. */
-    children?: (value: {
+    components: NonNullable<ThreadPrimitiveMessages.Props["components"]>;
+    children?: never;
+  } | {
+    /** Render function called for each message. Receives the message. */children: (value: {
       message: ThreadMessage;
     }) => ReactNode;
+    components?: never;
   };
 }
 /**

package/dist/react/primitives/part/PartMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PartMessages.d.ts","names":[],"sources":["../../../../src/react/primitives/part/PartMessages.tsx"],"mappings":";;;;;kBASiB,qBAAA;EAAA,KACH,KAAA;IACV,UAAA,GAAa,uBAAA,CAAwB,KAAA,gBAFH;IAIlC,QAAA,IAAY,KAAA;MAAS,OAAA,EAAS,aAAA;IAAA,MAAoB,SAAA;EAAA;AAAA;;;;;;;;;;;;AAAS;AAsC/D;;;;;;;;AAAsE;AAyBtE;;;cAzBa,yBAAA,EAA2B,EAAE,CAAC,qBAAA,CAAsB,KAAA;AAAA,cAyBpD,qBAAA,kBAAqB,oBAAA,CAAA,qBAAA,CAAA,KAAA"}
+{"version":3,"file":"PartMessages.d.ts","names":[],"sources":["../../../../src/react/primitives/part/PartMessages.tsx"],"mappings":";;;;;kBASiB,qBAAA;EAAA,KACH,KAAA;IAEN,UAAA,EAAY,WAAA,CAAY,uBAAA,CAAwB,KAAA;IAChD,QAAA;EAAA;IADwB,qEAKxB,QAAA,GAAW,KAAA;MAAS,OAAA,EAAS,aAAA;IAAA,MAAoB,SAAA;IACjD,UAAA;EAAA;AAAA;;;;;;;;;;;;;AAAU;AAsClB;;;;;;;;AAAsE;AAyBtE;;cAzBa,yBAAA,EAA2B,EAAE,CAAC,qBAAA,CAAsB,KAAA;AAAA,cAyBpD,qBAAA,kBAAqB,oBAAA,CAAA,qBAAA,CAAA,KAAA"}

package/dist/react/primitives/part/PartMessages.js

@@ -1,7 +1,7 @@
 import { ReadonlyThreadProvider } from "../../providers/ReadonlyThreadProvider.js";
 import { ThreadPrimitiveMessagesImpl } from "../thread/ThreadMessages.js";
-import { memo } from "@assistant-ui/tap/react-shim";
 import { useAuiState } from "@assistant-ui/store";
+import { memo } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/primitives/part/PartMessages.tsx
@@ -37,11 +37,11 @@ const PartPrimitiveMessagesImpl = (t0) => {
 	const { components, children } = t0;
 	const messages = usePartMessages();
 	if (!messages?.length) return null;
-	if (children) {
+	if (components) {
 		let t1;
-		if ($[0] !== children) {
-			t1 = /* @__PURE__ */ jsx(ThreadPrimitiveMessagesImpl, { children });
-			$[0] = children;
+		if ($[0] !== components) {
+			t1 = /* @__PURE__ */ jsx(ThreadPrimitiveMessagesImpl, { components });
+			$[0] = components;
 			$[1] = t1;
 		} else t1 = $[1];
 		let t2;
@@ -57,9 +57,9 @@ const PartPrimitiveMessagesImpl = (t0) => {
 		return t2;
 	}
 	let t1;
-	if ($[5] !== components) {
-		t1 = /* @__PURE__ */ jsx(ThreadPrimitiveMessagesImpl, { components });
-		$[5] = components;
+	if ($[5] !== children) {
+		t1 = /* @__PURE__ */ jsx(ThreadPrimitiveMessagesImpl, { children });
+		$[5] = children;
 		$[6] = t1;
 	} else t1 = $[6];
 	let t2;

package/dist/react/primitives/part/PartMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"PartMessages.js","names":["FC","ReactNode","memo","useAuiState","ThreadMessage","ReadonlyThreadProvider","ThreadPrimitiveMessages","ThreadPrimitiveMessagesImpl","PartPrimitiveMessages","Props","components","children","value","message","usePartMessages","_temp","PartPrimitiveMessagesImpl","t0","$","_c","messages","length","t1","t2","displayName","s","part","type","undefined"],"sources":["../../../../src/react/primitives/part/PartMessages.tsx"],"sourcesContent":["import { type FC, type ReactNode, memo } from \"react\";\nimport { useAuiState } from \"@assistant-ui/store\";\nimport type { ThreadMessage } from \"../../../types/message\";\nimport { ReadonlyThreadProvider } from \"../../providers/ReadonlyThreadProvider\";\nimport {\n  type ThreadPrimitiveMessages,\n  ThreadPrimitiveMessagesImpl,\n} from \"../thread/ThreadMessages\";\n\nexport namespace PartPrimitiveMessages {\n  export type Props = {\n    components?: ThreadPrimitiveMessages.Props[\"components\"];\n    /** Render function called for each message. Receives the message. */\n    children?: (value: { message: ThreadMessage }) => ReactNode;\n  };\n}\n\nconst usePartMessages = (): readonly ThreadMessage[] | undefined => {\n  return useAuiState((s) => {\n    const part = s.part;\n    if (part.type !== \"tool-call\") return undefined;\n    return \"messages\" in part\n      ? (part.messages as readonly ThreadMessage[] | undefined)\n      : undefined;\n  });\n};\n\n/**\n * Renders the nested messages of a tool call part (e.g. sub-agent conversation).\n *\n * This primitive reads `messages` from the current tool call part in the PartScope\n * and renders them using a readonly thread context. All existing message and part\n * primitives work inside, and parent tool UI registrations are inherited.\n *\n * @example\n * ```tsx\n * const toolkit = defineToolkit({\n *   invoke_sub_agent: {\n *     type: \"backend\",\n *     render: () => (\n *       <PartPrimitive.Messages>\n *         {({ message }) => {\n *           if (message.role === \"user\") return <MyUserMessage />;\n *           return <MyAssistantMessage />;\n *         }}\n *       </PartPrimitive.Messages>\n *     ),\n *   },\n * });\n * ```\n */\nexport const PartPrimitiveMessagesImpl: FC<PartPrimitiveMessages.Props> = ({\n  components,\n  children,\n}) => {\n  const messages = usePartMessages();\n\n  if (!messages?.length) return null;\n\n  if (children) {\n    return (\n      <ReadonlyThreadProvider messages={messages}>\n        <ThreadPrimitiveMessagesImpl>{children}</ThreadPrimitiveMessagesImpl>\n      </ReadonlyThreadProvider>\n    );\n  }\n\n  return (\n    <ReadonlyThreadProvider messages={messages}>\n      <ThreadPrimitiveMessagesImpl components={components!} />\n    </ReadonlyThreadProvider>\n  );\n};\n\nPartPrimitiveMessagesImpl.displayName = \"PartPrimitive.Messages\";\n\nexport const PartPrimitiveMessages = memo(PartPrimitiveMessagesImpl);\n"],"mappings":";;;;;;;AAiBA,MAAMc,wBAAkB;CAAA,OACfX,YAAYY,KAMlB;AAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA2BJ,MAAaC,6BAA6DC,OAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAC,MAAA,EAAAT,YAAAC,aAAAM;CAIzE,MAAAG,WAAiBN,gBAAgB;CAEjC,IAAI,CAACM,UAAQC,QAAQ,OAAS;CAE9B,IAAIV,UAAQ;EAAA,IAAAW;EAAA,IAAAJ,EAAA,OAAAP,UAAA;GAGNW,KAAA,oBAAC,6BAAD,EAA8BX,SAAF,CAAA;GAAyCO,EAAA,KAAAP;GAAAO,EAAA,KAAAI;EAAA,OAAAA,KAAAJ,EAAA;EAAA,IAAAK;EAAA,IAAAL,EAAA,OAAAE,YAAAF,EAAA,OAAAI,IAAA;GADvEC,KAAA,oBAAC,wBAAD;IAAkCH;cAChCE;GADqB,CAAA;GAEEJ,EAAA,KAAAE;GAAAF,EAAA,KAAAI;GAAAJ,EAAA,KAAAK;EAAA,OAAAA,KAAAL,EAAA;EAAA,OAFzBK;CAEyB;CAE5B,IAAAD;CAAA,IAAAJ,EAAA,OAAAR,YAAA;EAIGY,KAAA,oBAAC,6BAAD,EAAyCZ,WAAU,CAAA;EAAKQ,EAAA,KAAAR;EAAAQ,EAAA,KAAAI;CAAA,OAAAA,KAAAJ,EAAA;CAAA,IAAAK;CAAA,IAAAL,EAAA,OAAAE,YAAAF,EAAA,OAAAI,IAAA;EAD1DC,KAAA,oBAAC,wBAAD;GAAkCH;aAChCE;EADqB,CAAA;EAEEJ,EAAA,KAAAE;EAAAF,EAAA,KAAAI;EAAAJ,EAAA,KAAAK;CAAA,OAAAA,KAAAL,EAAA;CAAA,OAFzBK;AAEyB;AAI7BP,0BAA0BQ,cAAc;AAExC,MAAahB,wBAAwBN,KAAKc,yBAAyB;AA3D3C,SAAAD,MAAAU,GAAA;CAEpB,MAAAC,OAAaD,EAACC;CACd,IAAIA,KAAIC,SAAU,aAAW;CAAmB,OACzC,cAAcD,OAChBA,KAAIN,WADFQ,KAAAA;AAEM"}
+{"version":3,"file":"PartMessages.js","names":["FC","ReactNode","memo","useAuiState","ThreadMessage","ReadonlyThreadProvider","ThreadPrimitiveMessages","ThreadPrimitiveMessagesImpl","PartPrimitiveMessages","Props","components","NonNullable","children","value","message","usePartMessages","_temp","PartPrimitiveMessagesImpl","t0","$","_c","messages","length","t1","t2","displayName","s","part","type","undefined"],"sources":["../../../../src/react/primitives/part/PartMessages.tsx"],"sourcesContent":["import { type FC, type ReactNode, memo } from \"react\";\nimport { useAuiState } from \"@assistant-ui/store\";\nimport type { ThreadMessage } from \"../../../types/message\";\nimport { ReadonlyThreadProvider } from \"../../providers/ReadonlyThreadProvider\";\nimport {\n  type ThreadPrimitiveMessages,\n  ThreadPrimitiveMessagesImpl,\n} from \"../thread/ThreadMessages\";\n\nexport namespace PartPrimitiveMessages {\n  export type Props =\n    | {\n        components: NonNullable<ThreadPrimitiveMessages.Props[\"components\"]>;\n        children?: never;\n      }\n    | {\n        /** Render function called for each message. Receives the message. */\n        children: (value: { message: ThreadMessage }) => ReactNode;\n        components?: never;\n      };\n}\n\nconst usePartMessages = (): readonly ThreadMessage[] | undefined => {\n  return useAuiState((s) => {\n    const part = s.part;\n    if (part.type !== \"tool-call\") return undefined;\n    return \"messages\" in part\n      ? (part.messages as readonly ThreadMessage[] | undefined)\n      : undefined;\n  });\n};\n\n/**\n * Renders the nested messages of a tool call part (e.g. sub-agent conversation).\n *\n * This primitive reads `messages` from the current tool call part in the PartScope\n * and renders them using a readonly thread context. All existing message and part\n * primitives work inside, and parent tool UI registrations are inherited.\n *\n * @example\n * ```tsx\n * const toolkit = defineToolkit({\n *   invoke_sub_agent: {\n *     type: \"backend\",\n *     render: () => (\n *       <PartPrimitive.Messages>\n *         {({ message }) => {\n *           if (message.role === \"user\") return <MyUserMessage />;\n *           return <MyAssistantMessage />;\n *         }}\n *       </PartPrimitive.Messages>\n *     ),\n *   },\n * });\n * ```\n */\nexport const PartPrimitiveMessagesImpl: FC<PartPrimitiveMessages.Props> = ({\n  components,\n  children,\n}) => {\n  const messages = usePartMessages();\n\n  if (!messages?.length) return null;\n\n  if (components) {\n    return (\n      <ReadonlyThreadProvider messages={messages}>\n        <ThreadPrimitiveMessagesImpl components={components} />\n      </ReadonlyThreadProvider>\n    );\n  }\n\n  return (\n    <ReadonlyThreadProvider messages={messages}>\n      <ThreadPrimitiveMessagesImpl>{children}</ThreadPrimitiveMessagesImpl>\n    </ReadonlyThreadProvider>\n  );\n};\n\nPartPrimitiveMessagesImpl.displayName = \"PartPrimitive.Messages\";\n\nexport const PartPrimitiveMessages = memo(PartPrimitiveMessagesImpl);\n"],"mappings":";;;;;;;AAsBA,MAAMe,wBAAkB;CAAA,OACfZ,YAAYa,KAMlB;AAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA2BJ,MAAaC,6BAA6DC,OAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAC,MAAA,EAAAV,YAAAE,aAAAM;CAIzE,MAAAG,WAAiBN,gBAAgB;CAEjC,IAAI,CAACM,UAAQC,QAAQ,OAAS;CAE9B,IAAIZ,YAAU;EAAA,IAAAa;EAAA,IAAAJ,EAAA,OAAAT,YAAA;GAGRa,KAAA,oBAAC,6BAAD,EAAyCb,WAAU,CAAA;GAAIS,EAAA,KAAAT;GAAAS,EAAA,KAAAI;EAAA,OAAAA,KAAAJ,EAAA;EAAA,IAAAK;EAAA,IAAAL,EAAA,OAAAE,YAAAF,EAAA,OAAAI,IAAA;GADzDC,KAAA,oBAAC,wBAAD;IAAkCH;cAChCE;GADqB,CAAA;GAEEJ,EAAA,KAAAE;GAAAF,EAAA,KAAAI;GAAAJ,EAAA,KAAAK;EAAA,OAAAA,KAAAL,EAAA;EAAA,OAFzBK;CAEyB;CAE5B,IAAAD;CAAA,IAAAJ,EAAA,OAAAP,UAAA;EAIGW,KAAA,oBAAC,6BAAD,EAA8BX,SAAF,CAAA;EAAyCO,EAAA,KAAAP;EAAAO,EAAA,KAAAI;CAAA,OAAAA,KAAAJ,EAAA;CAAA,IAAAK;CAAA,IAAAL,EAAA,OAAAE,YAAAF,EAAA,OAAAI,IAAA;EADvEC,KAAA,oBAAC,wBAAD;GAAkCH;aAChCE;EADqB,CAAA;EAEEJ,EAAA,KAAAE;EAAAF,EAAA,KAAAI;EAAAJ,EAAA,KAAAK;CAAA,OAAAA,KAAAL,EAAA;CAAA,OAFzBK;AAEyB;AAI7BP,0BAA0BQ,cAAc;AAExC,MAAajB,wBAAwBN,KAAKe,yBAAyB;AA3D3C,SAAAD,MAAAU,GAAA;CAEpB,MAAAC,OAAaD,EAACC;CACd,IAAIA,KAAIC,SAAU,aAAW;CAAmB,OACzC,cAAcD,OAChBA,KAAIN,WADFQ,KAAAA;AAEM"}

package/dist/react/primitives/thread/ThreadMessages.d.ts

@@ -42,6 +42,36 @@ declare namespace ThreadPrimitiveMessageByIndex {
  * Renders a single message at the specified index in the current thread.
  */
 declare const ThreadPrimitiveMessageByIndex: FC<ThreadPrimitiveMessageByIndex.Props>;
+declare namespace ThreadPrimitiveUnstable_MessageById {
+  type Props = {
+    messageId: string;
+    components: MessagesComponentConfig;
+  };
+}
+/**
+ * Renders the message with the given id in the current thread.
+ *
+ * Unlike {@link ThreadPrimitiveMessageByIndex}, this keys off the message id,
+ * so it stays attached to the same message across reordering and windowing -
+ * the shape needed to drive a virtualized or custom message list together with
+ * `unstable_useThreadMessageIds`. A missing or removed id renders `null` rather
+ * than throwing.
+ *
+ * @deprecated Unstable / Experimental - may change in any release.
+ *
+ * @example
+ * ```tsx
+ * const messageIds = unstable_useThreadMessageIds();
+ * return messageIds.map((messageId) => (
+ *   <ThreadPrimitive.Unstable_MessageById
+ *     key={messageId}
+ *     messageId={messageId}
+ *     components={MESSAGE_COMPONENTS}
+ *   />
+ * ));
+ * ```
+ */
+declare const ThreadPrimitiveUnstable_MessageById: FC<ThreadPrimitiveUnstable_MessageById.Props>;
 /**
  * Renders all messages in the current thread.
  *
@@ -58,5 +88,5 @@ declare const ThreadPrimitiveMessageByIndex: FC<ThreadPrimitiveMessageByIndex.Pr
 declare const ThreadPrimitiveMessagesImpl: FC<ThreadPrimitiveMessages.Props>;
 declare const ThreadPrimitiveMessages: import("react").NamedExoticComponent<ThreadPrimitiveMessages.Props>;
 //#endregion
-export { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl };
+export { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveUnstable_MessageById };
 //# sourceMappingURL=ThreadMessages.d.ts.map

package/dist/react/primitives/thread/ThreadMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThreadMessages.d.ts","names":[],"sources":["../../../../src/react/primitives/thread/ThreadMessages.tsx"],"mappings":";;;;KAWK,uBAAA;mDAGC,OAAA,EAAS,aAAA,EAHV;EAKC,YAAA,GAAe,aAAA;EAEf,gBAAA,GAAmB,aAAA,cAFJ;EAIf,qBAAA,GAAwB,aAAA,cAAA;EAExB,kBAAA,GAAqB,aAAA,cAEP;EAAd,WAAA,GAAc,aAAA,cAIE;EAFhB,gBAAA,GAAmB,aAAA,cAQJ;EANf,aAAA,GAAgB,aAAA;AAAA;EAYK,4DARrB,OAAA,GAAU,aAAA,cAYQ;EAVlB,YAAA,GAAe,aAAA,cAYc;EAV7B,gBAAA,GAAmB,aAAA,cAtBnB;EAwBA,qBAAA,GAAwB,aAAA,cAtBxB;EAwBA,kBAAA,GAAqB,aAAA,cAtBrB;EAwBA,WAAA,EAAa,aAAA,EAtBb;EAwBA,gBAAA,EAAkB,aAAA,EAtBlB;EAwBA,aAAA,GAAgB,aAAA;AAAA;AAAA,kBAGL,uBAAA;EAAA,KACH,KAAA;IAxBW,4DA2BjB,UAAA,EAAY,uBAAA;IACZ,QAAA;EAAA;IAtBQ,qEA0BR,QAAA,GAAW,KAAA;MAAS,OAAA,EAAS,YAAA;IAAA,MAAmB,SAAA;IAChD,UAAA;EAAA;AAAA;AAAA,kBAuFS,6BAAA;EAAA,KACH,KAAA;IACV,KAAA;IACA,UAAA,EAAY,uBAAuB;EAAA;AAAA;;;;cAO1B,6BAAA,EAA+B,EAAE,CAAC,6BAAA,CAA8B,KAAA;AA3G7E;;;;;;;;;;;;;AAAA,cAiKa,2BAAA,EAA6B,EAAE,CAAC,uBAAA,CAAwB,KAAA;AAAA,cAkBxD,uBAAA,kBAAuB,oBAAA,CAAA,uBAAA,CAAA,KAAA"}
+{"version":3,"file":"ThreadMessages.d.ts","names":[],"sources":["../../../../src/react/primitives/thread/ThreadMessages.tsx"],"mappings":";;;;KAYK,uBAAA;mDAGC,OAAA,EAAS,aAAA,EAHV;EAKC,YAAA,GAAe,aAAA;EAEf,gBAAA,GAAmB,aAAA,cAFJ;EAIf,qBAAA,GAAwB,aAAA,cAAA;EAExB,kBAAA,GAAqB,aAAA,cAEP;EAAd,WAAA,GAAc,aAAA,cAIE;EAFhB,gBAAA,GAAmB,aAAA,cAQJ;EANf,aAAA,GAAgB,aAAA;AAAA;EAYK,4DARrB,OAAA,GAAU,aAAA,cAYQ;EAVlB,YAAA,GAAe,aAAA,cAYc;EAV7B,gBAAA,GAAmB,aAAA,cAtBnB;EAwBA,qBAAA,GAAwB,aAAA,cAtBxB;EAwBA,kBAAA,GAAqB,aAAA,cAtBrB;EAwBA,WAAA,EAAa,aAAA,EAtBb;EAwBA,gBAAA,EAAkB,aAAA,EAtBlB;EAwBA,aAAA,GAAgB,aAAA;AAAA;AAAA,kBAGL,uBAAA;EAAA,KACH,KAAA;IAxBW,4DA2BjB,UAAA,EAAY,uBAAA;IACZ,QAAA;EAAA;IAtBQ,qEA0BR,QAAA,GAAW,KAAA;MAAS,OAAA,EAAS,YAAA;IAAA,MAAmB,SAAA;IAChD,UAAA;EAAA;AAAA;AAAA,kBAqGS,6BAAA;EAAA,KACH,KAAA;IACV,KAAA;IACA,UAAA,EAAY,uBAAuB;EAAA;AAAA;;;;cAO1B,6BAAA,EAA+B,EAAE,CAAC,6BAAA,CAA8B,KAAA;AAAA,kBAgB5D,mCAAA;EAAA,KACH,KAAA;IACV,SAAA;IACA,UAAA,EAAY,uBAAuB;EAAA;AAAA;;;;;;;;;;;;;;AAlIrB;AAqGlB;;;;;;;;;cAwDa,mCAAA,EAAqC,EAAE,CAAC,mCAAA,CAAoC,KAAA;AA9CzF;;;;;;;;AAAkF;AAgBlF;;;;AAhBA,cA0Ga,2BAAA,EAA6B,EAAE,CAAC,uBAAA,CAAwB,KAAA;AAAA,cAkBxD,uBAAA,kBAAuB,oBAAA,CAAA,uBAAA,CAAA,KAAA"}