@assistant-ui/core 0.2.18 → 0.2.19

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.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

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"}

package/dist/react/primitives/thread/ThreadMessages.js

@@ -1,6 +1,7 @@
 import { MessageByIndexProvider } from "../../providers/MessageByIndexProvider.js";
-import { memo, useMemo } from "@assistant-ui/tap/react-shim";
+import { MessageByIdProvider } from "../../providers/MessageByIdProvider.js";
 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/thread/ThreadMessages.tsx
@@ -8,6 +9,15 @@ const isComponentsSame = (prev, next) => {
 	return prev.Message === next.Message && prev.EditComposer === next.EditComposer && prev.UserEditComposer === next.UserEditComposer && prev.AssistantEditComposer === next.AssistantEditComposer && prev.SystemEditComposer === next.SystemEditComposer && prev.UserMessage === next.UserMessage && prev.AssistantMessage === next.AssistantMessage && prev.SystemMessage === next.SystemMessage;
 };
 const DEFAULT_SYSTEM_MESSAGE = () => null;
+const messageIdSetCache = /* @__PURE__ */ new WeakMap();
+const hasMessageId = (messages, messageId) => {
+	let ids = messageIdSetCache.get(messages);
+	if (!ids) {
+		ids = new Set(messages.map((m) => m.id));
+		messageIdSetCache.set(messages, ids);
+	}
+	return ids.has(messageId);
+};
 const getComponent = (components, role, isEditing) => {
 	switch (role) {
 		case "user": if (isEditing) return components.UserEditComposer ?? components.EditComposer ?? components.UserMessage ?? components.Message;
@@ -66,6 +76,58 @@ const ThreadPrimitiveMessageByIndex = memo((t0) => {
 	return t2;
 }, (prev, next) => prev.index === next.index && isComponentsSame(prev.components, next.components));
 ThreadPrimitiveMessageByIndex.displayName = "ThreadPrimitive.MessageByIndex";
+/**
+* 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}
+*   />
+* ));
+* ```
+*/
+const ThreadPrimitiveUnstable_MessageById = memo((t0) => {
+	const $ = c(7);
+	const { messageId, components } = t0;
+	let t1;
+	if ($[0] !== messageId) {
+		t1 = (s) => hasMessageId(s.thread.messages, messageId);
+		$[0] = messageId;
+		$[1] = t1;
+	} else t1 = $[1];
+	if (!useAuiState(t1)) return null;
+	let t2;
+	if ($[2] !== components) {
+		t2 = /* @__PURE__ */ jsx(ThreadMessageComponent, { components });
+		$[2] = components;
+		$[3] = t2;
+	} else t2 = $[3];
+	let t3;
+	if ($[4] !== messageId || $[5] !== t2) {
+		t3 = /* @__PURE__ */ jsx(MessageByIdProvider, {
+			id: messageId,
+			children: t2
+		});
+		$[4] = messageId;
+		$[5] = t2;
+		$[6] = t3;
+	} else t3 = $[6];
+	return t3;
+}, (prev, next) => prev.messageId === next.messageId && isComponentsSame(prev.components, next.components));
+ThreadPrimitiveUnstable_MessageById.displayName = "ThreadPrimitive.Unstable_MessageById";
 const ThreadPrimitiveMessagesInner = ({ children }) => {
 	const messagesLength = useAuiState((s) => s.thread.messages.length);
 	return useMemo(() => {
@@ -126,6 +188,6 @@ function _temp2(s_0) {
 	return s_0.message.composer.isEditing;
 }
 //#endregion
-export { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl };
+export { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveUnstable_MessageById };
 
 //# sourceMappingURL=ThreadMessages.js.map