@ulearning/ai-sdk 0.0.0-stage → 1.0.0-next.0

package/dist/context/providers/MessageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageProvider.d.ts","mappings":"AAIA,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,0BAA0B;AAEjC,eAAO,MAAM,eAAe,kIAwB3B","names":[],"ignoreList":[],"sources":["../../../src/context/providers/MessageProvider.tsx"],"sourcesContent":[null]}

package/dist/context/providers/MessageProvider.js

@@ -0,0 +1,25 @@
+"use client";
+import { defineComponent, h } from "vue";
+import { AuiConfig, AuiProvider, useAui } from "@ulearning/ai-store";
+import { ThreadMessageClient } from "@ulearning/ai-core/store";
+// src/context/providers/MessageProvider.tsx
+const MessageProvider = defineComponent(function MessageProvider(props, { slots }) {
+	const aui = useAui();
+	return () => h(AuiProvider, {
+		extends: aui,
+		config: AuiConfig({ message: ThreadMessageClient(props) })
+	}, slots);
+}, {
+	name: "MessageProvider",
+	props: [
+		"message",
+		"index",
+		"isLast",
+		"branchNumber",
+		"branchCount",
+		"submission"
+	]
+});
+export { MessageProvider };
+
+//# sourceMappingURL=MessageProvider.js.map

package/dist/context/providers/MessageProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageProvider.js","names":["defineComponent","h","useAui","AuiConfig","AuiProvider","ThreadMessageClientProps","ThreadMessageClient","MessageProvider","props","slots","aui","extends","config","message","name"],"sources":["../../../src/context/providers/MessageProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport { defineComponent, h } from \"vue\";\nimport { useAui, AuiConfig, AuiProvider } from \"@ulearning/ai-store\";\nimport {\n  type ThreadMessageClientProps,\n  ThreadMessageClient,\n} from \"@ulearning/ai-core/store\";\n\nexport const MessageProvider = defineComponent(\n  function MessageProvider(props: ThreadMessageClientProps, { slots }) {\n    const aui = useAui();\n    return () =>\n      h(\n        AuiProvider,\n        {\n          extends: aui,\n          config: AuiConfig({ message: ThreadMessageClient(props) }),\n        },\n        slots,\n      );\n  },\n  {\n    name: \"MessageProvider\",\n    props: [\n      \"message\",\n      \"index\",\n      \"isLast\",\n      \"branchNumber\",\n      \"branchCount\",\n      \"submission\",\n    ],\n  },\n);\n"],"mappings":";;;;;AASA,MAAaO,kBAAkBP,gBAC7B,SAASO,gBAAgBC,OAAiC,EAAEC,SAAS;CACnE,MAAMC,MAAMR,OAAO;CACnB,aACED,EACEG,aACA;EACEO,SAASD;EACTE,QAAQT,UAAU,EAAEU,SAASP,oBAAoBE,KAAK,EAAE,CAAC;CAC3D,GACAC,KACF;AACJ,GACA;CACEK,MAAM;CACNN,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;CAAY;AAEhB,CACF"}

package/dist/context/providers/PartByIndexProvider.d.ts

@@ -0,0 +1,2 @@
+export { PartByIndexProvider } from "@ulearning/ai-core/vue";
+//# sourceMappingURL=PartByIndexProvider.d.ts.map

package/dist/context/providers/PartByIndexProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartByIndexProvider.d.ts","mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB","names":[],"ignoreList":[],"sources":["../../../src/context/providers/PartByIndexProvider.tsx"],"sourcesContent":[null]}

package/dist/context/providers/PartByIndexProvider.js

@@ -0,0 +1,2 @@
+"use client";
+export { PartByIndexProvider } from "@ulearning/ai-core/vue";

package/dist/context/providers/SuggestionByIndexProvider.d.ts

@@ -0,0 +1,2 @@
+export { SuggestionByIndexProvider, type SuggestionByIndexProviderProps, } from "@ulearning/ai-core/vue";
+//# sourceMappingURL=SuggestionByIndexProvider.d.ts.map

package/dist/context/providers/SuggestionByIndexProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestionByIndexProvider.d.ts","mappings":"AAEA,OAAO,EACL,yBAAyB,EACzB,KAAK,8BAA8B,GACpC,MAAM,wBAAwB","names":[],"ignoreList":[],"sources":["../../../src/context/providers/SuggestionByIndexProvider.tsx"],"sourcesContent":[null]}

package/dist/context/providers/SuggestionByIndexProvider.js

@@ -0,0 +1,2 @@
+"use client";
+export { SuggestionByIndexProvider } from "@ulearning/ai-core/vue";

package/dist/context/providers/TextMessagePartProvider.d.ts

@@ -0,0 +1,2 @@
+export { TextMessagePartProvider } from "@ulearning/ai-core/vue";
+//# sourceMappingURL=TextMessagePartProvider.d.ts.map

package/dist/context/providers/TextMessagePartProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextMessagePartProvider.d.ts","mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB","names":[],"ignoreList":[],"sources":["../../../src/context/providers/TextMessagePartProvider.tsx"],"sourcesContent":[null]}

package/dist/context/providers/TextMessagePartProvider.js

@@ -0,0 +1,2 @@
+"use client";
+export { TextMessagePartProvider } from "@ulearning/ai-core/vue";

package/dist/context/providers/ThreadListItemProvider.d.ts

@@ -0,0 +1,2 @@
+export { ThreadListItemByIndexProvider, ThreadListItemRuntimeProvider, } from "@ulearning/ai-core/vue";
+//# sourceMappingURL=ThreadListItemProvider.d.ts.map

package/dist/context/providers/ThreadListItemProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadListItemProvider.d.ts","mappings":"AAEA,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,wBAAwB","names":[],"ignoreList":[],"sources":["../../../src/context/providers/ThreadListItemProvider.tsx"],"sourcesContent":[null]}

package/dist/context/providers/ThreadListItemProvider.js

@@ -0,0 +1,2 @@
+"use client";
+export { ThreadListItemByIndexProvider, ThreadListItemRuntimeProvider } from "@ulearning/ai-core/vue";

package/dist/context/providers/ThreadViewportProvider.d.ts

@@ -0,0 +1,6 @@
+import { type ThreadViewportStoreOptions } from "../stores/ThreadViewport.js";
+export type ThreadViewportProviderProps = {
+    options?: ThreadViewportStoreOptions | undefined;
+};
+export declare const ThreadPrimitiveViewportProvider: import("vue").DefineSetupFnComponent<ThreadViewportProviderProps, {}, {}, ThreadViewportProviderProps & {}, import("vue").PublicProps>;
+//# sourceMappingURL=ThreadViewportProvider.d.ts.map

package/dist/context/providers/ThreadViewportProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewportProvider.d.ts","mappings":"AAIA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,6BAA0B;AAOjC,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,CAAC,EAAE,0BAA0B,GAAG,SAAS;CACjD;AAED,eAAO,MAAM,+BAA+B,wIA8B3C","names":[],"ignoreList":[],"sources":["../../../src/context/providers/ThreadViewportProvider.tsx"],"sourcesContent":[null]}

package/dist/context/providers/ThreadViewportProvider.js

@@ -0,0 +1,32 @@
+"use client";
+import { writableStore } from "../ReadonlyStore.js";
+import { makeThreadViewportStore } from "../stores/ThreadViewport.js";
+import { ThreadViewportContext, useThreadViewportStore } from "../vue/ThreadViewportContext.js";
+import { defineComponent, provide } from "vue";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+// src/context/providers/ThreadViewportProvider.tsx
+const ThreadPrimitiveViewportProvider = defineComponent(function ThreadPrimitiveViewportProvider(props, { slots }) {
+	const outerViewport = useThreadViewportStore({ optional: true });
+	const store = makeThreadViewportStore(props.options);
+	provide(ThreadViewportContext, { useThreadViewport: store });
+	useIsomorphicLayoutEffect(() => outerViewport?.getState().onScrollToBottom((config) => {
+		store.getState().scrollToBottom(config);
+	}), []);
+	useIsomorphicLayoutEffect(() => {
+		if (!outerViewport) return;
+		const synchronize = () => {
+			const isAtBottom = store.getState().isAtBottom;
+			if (outerViewport.getState().isAtBottom !== isAtBottom) writableStore(outerViewport).setState({ isAtBottom });
+		};
+		const release = store.subscribe(synchronize);
+		synchronize();
+		return release;
+	}, []);
+	return () => slots.default?.();
+}, {
+	name: "ThreadPrimitiveViewportProvider",
+	props: ["options"]
+});
+export { ThreadPrimitiveViewportProvider };
+
+//# sourceMappingURL=ThreadViewportProvider.js.map

package/dist/context/providers/ThreadViewportProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewportProvider.js","names":["defineComponent","provide","useIsomorphicLayoutEffect","makeThreadViewportStore","ThreadViewportStoreOptions","ThreadViewportContext","useThreadViewportStore","writableStore","ThreadViewportProviderProps","options","ThreadPrimitiveViewportProvider","props","slots","outerViewport","optional","store","useThreadViewport","getState","onScrollToBottom","config","scrollToBottom","synchronize","isAtBottom","setState","release","subscribe","default","name"],"sources":["../../../src/context/providers/ThreadViewportProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport { defineComponent, provide } from \"vue\";\nimport { useIsomorphicLayoutEffect } from \"@ulearning/ai-store/internal\";\nimport {\n  makeThreadViewportStore,\n  type ThreadViewportStoreOptions,\n} from \"../stores/ThreadViewport\";\nimport {\n  ThreadViewportContext,\n  useThreadViewportStore,\n} from \"../vue/ThreadViewportContext\";\nimport { writableStore } from \"../ReadonlyStore\";\n\nexport type ThreadViewportProviderProps = {\n  options?: ThreadViewportStoreOptions | undefined;\n};\n\nexport const ThreadPrimitiveViewportProvider = defineComponent(\n  function ThreadPrimitiveViewportProvider(\n    props: ThreadViewportProviderProps,\n    { slots },\n  ) {\n    const outerViewport = useThreadViewportStore({ optional: true });\n    // Options configure one viewport lifetime, without invalidating message selectors.\n    const store = makeThreadViewportStore(props.options);\n    provide(ThreadViewportContext, { useThreadViewport: store });\n    useIsomorphicLayoutEffect(\n      () =>\n        outerViewport?.getState().onScrollToBottom((config) => {\n          store.getState().scrollToBottom(config);\n        }),\n      [],\n    );\n    useIsomorphicLayoutEffect(() => {\n      if (!outerViewport) return;\n      const synchronize = () => {\n        const isAtBottom = store.getState().isAtBottom;\n        if (outerViewport.getState().isAtBottom !== isAtBottom)\n          writableStore(outerViewport).setState({ isAtBottom });\n      };\n      const release = store.subscribe(synchronize);\n      synchronize();\n      return release;\n    }, []);\n    return () => slots.default?.();\n  },\n  { name: \"ThreadPrimitiveViewportProvider\", props: [\"options\"] },\n);\n"],"mappings":";;;;;;;AAkBA,MAAaU,kCAAkCV,gBAC7C,SAASU,gCACPC,OACA,EAAEC,SACF;CACA,MAAMC,gBAAgBP,uBAAuB,EAAEQ,UAAU,KAAK,CAAC;CAE/D,MAAMC,QAAQZ,wBAAwBQ,MAAMF,OAAO;CACnDR,QAAQI,uBAAuB,EAAEW,mBAAmBD,MAAM,CAAC;CAC3Db,gCAEIW,eAAeI,SAAS,CAAC,CAACC,kBAAkBC,WAAW;EACrDJ,MAAME,SAAS,CAAC,CAACG,eAAeD,MAAM;CACxC,CAAC,GACH,CAAA,CACF;CACAjB,gCAAgC;EAC9B,IAAI,CAACW,eAAe;EACpB,MAAMQ,oBAAoB;GACxB,MAAMC,aAAaP,MAAME,SAAS,CAAC,CAACK;GACpC,IAAIT,cAAcI,SAAS,CAAC,CAACK,eAAeA,YAC1Cf,cAAcM,aAAa,CAAC,CAACU,SAAS,EAAED,WAAW,CAAC;EACxD;EACA,MAAME,UAAUT,MAAMU,UAAUJ,WAAW;EAC3CA,YAAY;EACZ,OAAOG;CACT,GAAG,CAAA,CAAE;CACL,aAAaZ,MAAMc,UAAU;AAC/B,GACA;CAAEC,MAAM;CAAmChB,OAAO,CAAC,SAAS;AAAE,CAChE"}

package/dist/context/stores/ThreadViewport.d.ts

@@ -0,0 +1,88 @@
+import type { Unsubscribe } from "@ulearning/ai-core";
+import { type ThreadViewportAutoScroll, type ThreadViewportAutoScrollOptions } from "@ulearning/ai-store/client";
+import type { ReadonlyStore } from "../ReadonlyStore.js";
+export type SizeHandle = {
+    /** Update the height */
+    setHeight: (height: number) => void;
+    /** Unregister this handle */
+    unregister: Unsubscribe;
+};
+export type ThreadViewportState = {
+    readonly isAtBottom: boolean;
+    readonly scrollToBottom: (config?: {
+        behavior?: ScrollBehavior | undefined;
+    }) => void;
+    readonly onScrollToBottom: (callback: ({ behavior }: {
+        behavior: ScrollBehavior;
+    }) => void) => Unsubscribe;
+    /** Controls scroll anchoring: "top" anchors user messages at top, "bottom" is classic behavior */
+    readonly turnAnchor: "top" | "bottom";
+    /** Clamps tall user messages so the assistant response stays in view. */
+    readonly topAnchorMessageClamp: {
+        readonly tallerThan: string;
+        readonly visibleHeight: string;
+    };
+    /** Raw height values from registered elements */
+    readonly height: {
+        /** Total viewport height */
+        readonly viewport: number;
+        /** Total content inset height (footer, anchor message, etc.) */
+        readonly inset: number;
+    };
+    /** Current DOM elements used for geometry-based top anchoring */
+    readonly element: {
+        readonly viewport: HTMLElement | null;
+        readonly anchor: HTMLElement | null;
+        readonly target: HTMLElement | null;
+    };
+    /** Numeric clamp configuration for the active top-anchor target message */
+    readonly targetConfig: {
+        readonly tallerThan: number;
+        readonly visibleHeight: number;
+    } | null;
+    /**
+     * The current top-anchor turn activated in this viewport session.
+     * History-loaded messages do not populate this; it is set when a run creates
+     * a live user/assistant pair and remains after the run completes.
+     */
+    readonly topAnchorTurn: {
+        readonly anchorId: string;
+        readonly targetId: string;
+    } | null;
+    /** Register a viewport and get a handle to update its height */
+    readonly registerViewport: () => SizeHandle;
+    /** Register a content inset (footer, anchor message, etc.) and get a handle to update its height */
+    readonly registerContentInset: () => SizeHandle;
+    /** Register the scroll viewport element */
+    readonly registerViewportElement: (element: HTMLElement | null) => Unsubscribe;
+    /** Register the current anchor user message element */
+    readonly registerAnchorElement: (element: HTMLElement | null) => Unsubscribe;
+    /**
+     * Register the current top-anchor target (last assistant response) element
+     * along with its numeric clamp configuration. When unregistered, both
+     * `element.target` and `targetConfig` clear together.
+     */
+    readonly registerAnchorTargetElement: (element: HTMLElement | null, config?: {
+        readonly tallerThan: number;
+        readonly visibleHeight: number;
+    }) => Unsubscribe;
+    readonly setTopAnchorTurn: (turn: {
+        readonly anchorId: string;
+        readonly targetId: string;
+    } | null) => void;
+};
+export type ThreadViewportStoreOptions = {
+    turnAnchor?: "top" | "bottom" | undefined;
+    topAnchorMessageClamp?: {
+        tallerThan?: string | undefined;
+        visibleHeight?: string | undefined;
+    } | undefined;
+};
+type ViewportAutoScroll = {
+    controller: ThreadViewportAutoScroll;
+    getOptions: () => ThreadViewportAutoScrollOptions;
+};
+export declare const getThreadViewportAutoScroll: (store: ReadonlyStore<ThreadViewportState>) => ViewportAutoScroll;
+export declare const makeThreadViewportStore: (options?: ThreadViewportStoreOptions) => import("zustand/vanilla").StoreApi<ThreadViewportState>;
+export {};
+//# sourceMappingURL=ThreadViewport.d.ts.map

package/dist/context/stores/ThreadViewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewport.d.ts","mappings":"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","names":[],"ignoreList":[],"sources":["../../../src/context/stores/ThreadViewport.ts"],"sourcesContent":[null]}

package/dist/context/stores/ThreadViewport.js

@@ -0,0 +1,130 @@
+"use client";
+import { createStore } from "zustand/vanilla";
+import { notifyEventListeners } from "@ulearning/ai-core/internal";
+import { createThreadViewportAutoScroll } from "@ulearning/ai-store/client";
+// src/context/stores/ThreadViewport.ts
+const createSizeRegistry = (onChange) => {
+	const entries = /* @__PURE__ */ new Map();
+	const recalculate = () => {
+		let total = 0;
+		for (const height of entries.values()) total += height;
+		onChange(total);
+	};
+	return { register: () => {
+		const id = Symbol();
+		entries.set(id, 0);
+		return {
+			setHeight: (height) => {
+				if (entries.get(id) !== height) {
+					entries.set(id, height);
+					recalculate();
+				}
+			},
+			unregister: () => {
+				entries.delete(id);
+				recalculate();
+			}
+		};
+	} };
+};
+const viewportAutoScroll = /* @__PURE__ */ new WeakMap();
+const getThreadViewportAutoScroll = (store) => viewportAutoScroll.get(store);
+const makeThreadViewportStore = (options = {}) => {
+	const scrollToBottomListeners = /* @__PURE__ */ new Set();
+	const viewportRegistry = createSizeRegistry((total) => {
+		store.setState({ height: {
+			...store.getState().height,
+			viewport: total
+		} });
+	});
+	const autoScroll = {
+		getOptions: () => ({
+			autoScroll: options.turnAnchor !== "top",
+			scrollToBottomOnInitialize: true,
+			scrollToBottomOnRunStart: options.turnAnchor !== "top",
+			scrollToBottomOnThreadSwitch: true
+		}),
+		controller: createThreadViewportAutoScroll({
+			getOptions: () => autoScroll.getOptions(),
+			onAtBottomChange: (isAtBottom) => store.setState({ isAtBottom }),
+			onContentInsetChange: (inset) => {
+				store.setState({ height: {
+					...store.getState().height,
+					inset
+				} });
+			}
+		})
+	};
+	const registerElementSlot = (key, element) => {
+		store.setState({ element: {
+			...store.getState().element,
+			[key]: element
+		} });
+		return () => {
+			if (store.getState().element[key] !== element) return;
+			store.setState({ element: {
+				...store.getState().element,
+				[key]: null
+			} });
+		};
+	};
+	const store = createStore(() => ({
+		isAtBottom: true,
+		scrollToBottom: ({ behavior = "auto" } = {}) => {
+			notifyEventListeners(scrollToBottomListeners, () => ({ behavior }), "Thread viewport");
+		},
+		onScrollToBottom: (callback) => {
+			scrollToBottomListeners.add(callback);
+			return () => {
+				scrollToBottomListeners.delete(callback);
+			};
+		},
+		turnAnchor: options.turnAnchor ?? "bottom",
+		topAnchorMessageClamp: {
+			tallerThan: options.topAnchorMessageClamp?.tallerThan ?? "10em",
+			visibleHeight: options.topAnchorMessageClamp?.visibleHeight ?? "6em"
+		},
+		height: {
+			viewport: 0,
+			inset: 0
+		},
+		element: {
+			viewport: null,
+			anchor: null,
+			target: null
+		},
+		targetConfig: null,
+		topAnchorTurn: null,
+		registerViewport: viewportRegistry.register,
+		registerContentInset: autoScroll.controller.registerContentInset,
+		registerViewportElement: (element) => registerElementSlot("viewport", element),
+		registerAnchorElement: (element) => registerElementSlot("anchor", element),
+		registerAnchorTargetElement: (element, config) => {
+			store.setState({
+				element: {
+					...store.getState().element,
+					target: element
+				},
+				targetConfig: element && config ? config : null
+			});
+			return () => {
+				if (store.getState().element.target !== element) return;
+				store.setState({
+					element: {
+						...store.getState().element,
+						target: null
+					},
+					targetConfig: null
+				});
+			};
+		},
+		setTopAnchorTurn: (topAnchorTurn) => {
+			store.setState({ topAnchorTurn });
+		}
+	}));
+	viewportAutoScroll.set(store, autoScroll);
+	return store;
+};
+export { getThreadViewportAutoScroll, makeThreadViewportStore };
+
+//# sourceMappingURL=ThreadViewport.js.map

package/dist/context/stores/ThreadViewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewport.js","names":[],"sources":["../../../src/context/stores/ThreadViewport.ts"],"sourcesContent":["\"use client\";\n\nimport { createStore } from \"zustand/vanilla\";\nimport type { Unsubscribe } from \"@ulearning/ai-core\";\nimport { notifyEventListeners } from \"@ulearning/ai-core/internal\";\nimport {\n  createThreadViewportAutoScroll,\n  type ThreadViewportAutoScroll,\n  type ThreadViewportAutoScrollOptions,\n} from \"@ulearning/ai-store/client\";\nimport type { ReadonlyStore } from \"../ReadonlyStore\";\n\nexport type SizeHandle = {\n  /** Update the height */\n  setHeight: (height: number) => void;\n  /** Unregister this handle */\n  unregister: Unsubscribe;\n};\n\ntype SizeRegistry = {\n  register: () => SizeHandle;\n};\n\nconst createSizeRegistry = (\n  onChange: (total: number) => void,\n): SizeRegistry => {\n  const entries = new Map<symbol, number>();\n\n  const recalculate = () => {\n    let total = 0;\n    for (const height of entries.values()) {\n      total += height;\n    }\n    onChange(total);\n  };\n\n  return {\n    register: () => {\n      const id = Symbol();\n      entries.set(id, 0);\n\n      return {\n        setHeight: (height: number) => {\n          if (entries.get(id) !== height) {\n            entries.set(id, height);\n            recalculate();\n          }\n        },\n        unregister: () => {\n          entries.delete(id);\n          recalculate();\n        },\n      };\n    },\n  };\n};\n\nexport type ThreadViewportState = {\n  readonly isAtBottom: boolean;\n  readonly scrollToBottom: (config?: {\n    behavior?: ScrollBehavior | undefined;\n  }) => void;\n  readonly onScrollToBottom: (\n    callback: ({ behavior }: { behavior: ScrollBehavior }) => void,\n  ) => Unsubscribe;\n\n  /** Controls scroll anchoring: \"top\" anchors user messages at top, \"bottom\" is classic behavior */\n  readonly turnAnchor: \"top\" | \"bottom\";\n\n  /** Clamps tall user messages so the assistant response stays in view. */\n  readonly topAnchorMessageClamp: {\n    readonly tallerThan: string;\n    readonly visibleHeight: string;\n  };\n\n  /** Raw height values from registered elements */\n  readonly height: {\n    /** Total viewport height */\n    readonly viewport: number;\n    /** Total content inset height (footer, anchor message, etc.) */\n    readonly inset: number;\n  };\n\n  /** Current DOM elements used for geometry-based top anchoring */\n  readonly element: {\n    readonly viewport: HTMLElement | null;\n    readonly anchor: HTMLElement | null;\n    readonly target: HTMLElement | null;\n  };\n\n  /** Numeric clamp configuration for the active top-anchor target message */\n  readonly targetConfig: {\n    readonly tallerThan: number;\n    readonly visibleHeight: number;\n  } | null;\n\n  /**\n   * The current top-anchor turn activated in this viewport session.\n   * History-loaded messages do not populate this; it is set when a run creates\n   * a live user/assistant pair and remains after the run completes.\n   */\n  readonly topAnchorTurn: {\n    readonly anchorId: string;\n    readonly targetId: string;\n  } | null;\n\n  /** Register a viewport and get a handle to update its height */\n  readonly registerViewport: () => SizeHandle;\n\n  /** Register a content inset (footer, anchor message, etc.) and get a handle to update its height */\n  readonly registerContentInset: () => SizeHandle;\n\n  /** Register the scroll viewport element */\n  readonly registerViewportElement: (\n    element: HTMLElement | null,\n  ) => Unsubscribe;\n\n  /** Register the current anchor user message element */\n  readonly registerAnchorElement: (element: HTMLElement | null) => Unsubscribe;\n\n  /**\n   * Register the current top-anchor target (last assistant response) element\n   * along with its numeric clamp configuration. When unregistered, both\n   * `element.target` and `targetConfig` clear together.\n   */\n  readonly registerAnchorTargetElement: (\n    element: HTMLElement | null,\n    config?: { readonly tallerThan: number; readonly visibleHeight: number },\n  ) => Unsubscribe;\n\n  readonly setTopAnchorTurn: (\n    turn: { readonly anchorId: string; readonly targetId: string } | null,\n  ) => void;\n};\n\nexport type ThreadViewportStoreOptions = {\n  turnAnchor?: \"top\" | \"bottom\" | undefined;\n  topAnchorMessageClamp?:\n    | {\n        tallerThan?: string | undefined;\n        visibleHeight?: string | undefined;\n      }\n    | undefined;\n};\n\ntype ViewportAutoScroll = {\n  controller: ThreadViewportAutoScroll;\n  getOptions: () => ThreadViewportAutoScrollOptions;\n};\n\nconst viewportAutoScroll = new WeakMap<\n  ReadonlyStore<ThreadViewportState>,\n  ViewportAutoScroll\n>();\n\nexport const getThreadViewportAutoScroll = (\n  store: ReadonlyStore<ThreadViewportState>,\n) => viewportAutoScroll.get(store)!;\n\nexport const makeThreadViewportStore = (\n  options: ThreadViewportStoreOptions = {},\n) => {\n  const scrollToBottomListeners = new Set<\n    (config: { behavior: ScrollBehavior }) => void\n  >();\n\n  const viewportRegistry = createSizeRegistry((total) => {\n    store.setState({\n      height: {\n        ...store.getState().height,\n        viewport: total,\n      },\n    });\n  });\n  const autoScroll: ViewportAutoScroll = {\n    getOptions: () => ({\n      autoScroll: options.turnAnchor !== \"top\",\n      scrollToBottomOnInitialize: true,\n      scrollToBottomOnRunStart: options.turnAnchor !== \"top\",\n      scrollToBottomOnThreadSwitch: true,\n    }),\n    controller: createThreadViewportAutoScroll({\n      getOptions: () => autoScroll.getOptions(),\n      onAtBottomChange: (isAtBottom) => store.setState({ isAtBottom }),\n      onContentInsetChange: (inset) => {\n        store.setState({ height: { ...store.getState().height, inset } });\n      },\n    }),\n  };\n  const registerElementSlot = (\n    key: \"viewport\" | \"anchor\",\n    element: HTMLElement | null,\n  ) => {\n    store.setState({\n      element: {\n        ...store.getState().element,\n        [key]: element,\n      },\n    });\n\n    return () => {\n      if (store.getState().element[key] !== element) return;\n      store.setState({\n        element: {\n          ...store.getState().element,\n          [key]: null,\n        },\n      });\n    };\n  };\n\n  const store = createStore<ThreadViewportState>(() => ({\n    isAtBottom: true,\n    scrollToBottom: ({ behavior = \"auto\" } = {}) => {\n      notifyEventListeners(\n        scrollToBottomListeners,\n        () => ({ behavior }),\n        \"Thread viewport\",\n      );\n    },\n    onScrollToBottom: (callback) => {\n      scrollToBottomListeners.add(callback);\n      return () => {\n        scrollToBottomListeners.delete(callback);\n      };\n    },\n\n    turnAnchor: options.turnAnchor ?? \"bottom\",\n    topAnchorMessageClamp: {\n      tallerThan: options.topAnchorMessageClamp?.tallerThan ?? \"10em\",\n      visibleHeight: options.topAnchorMessageClamp?.visibleHeight ?? \"6em\",\n    },\n\n    height: {\n      viewport: 0,\n      inset: 0,\n    },\n    element: {\n      viewport: null,\n      anchor: null,\n      target: null,\n    },\n    targetConfig: null,\n    topAnchorTurn: null,\n\n    registerViewport: viewportRegistry.register,\n    registerContentInset: autoScroll.controller.registerContentInset,\n    registerViewportElement: (element) =>\n      registerElementSlot(\"viewport\", element),\n    registerAnchorElement: (element) => registerElementSlot(\"anchor\", element),\n    registerAnchorTargetElement: (element, config) => {\n      store.setState({\n        element: {\n          ...store.getState().element,\n          target: element,\n        },\n        targetConfig: element && config ? config : null,\n      });\n\n      return () => {\n        if (store.getState().element.target !== element) return;\n        store.setState({\n          element: {\n            ...store.getState().element,\n            target: null,\n          },\n          targetConfig: null,\n        });\n      };\n    },\n    setTopAnchorTurn: (topAnchorTurn) => {\n      store.setState({ topAnchorTurn });\n    },\n  }));\n\n  viewportAutoScroll.set(store, autoScroll);\n  return store;\n};\n"],"mappings":"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"}

package/dist/context/vue/ThreadViewportContext.d.ts

@@ -0,0 +1,24 @@
+import type { InjectionKey } from "vue";
+import type { ReadonlyStore } from "../ReadonlyStore.js";
+import type { ThreadViewportState } from "../stores/ThreadViewport.js";
+export type ThreadViewportContextValue = {
+    useThreadViewport: ReadonlyStore<ThreadViewportState>;
+};
+export declare const ThreadViewportContext: InjectionKey<ThreadViewportContextValue | null>;
+export declare const useThreadViewport: {
+    (): Readonly<import("vue").ShallowRef<ThreadViewportState>>;
+    <S>(selector: (state: ThreadViewportState) => S): Readonly<import("vue").ShallowRef<S>>;
+    (options: {
+        optional: true;
+    }): Readonly<import("vue").ShallowRef<ThreadViewportState | null>>;
+    <S>(options: {
+        optional: true;
+        selector: (state: ThreadViewportState) => S;
+    }): Readonly<import("vue").ShallowRef<S | null>>;
+}, useThreadViewportStore: {
+    (): ReadonlyStore<ThreadViewportState>;
+    (options: {
+        optional: true;
+    }): ReadonlyStore<ThreadViewportState> | null;
+};
+//# sourceMappingURL=ThreadViewportContext.d.ts.map

package/dist/context/vue/ThreadViewportContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewportContext.d.ts","mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAkB;AAGrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA0B;AAEnE,MAAM,MAAM,0BAA0B,GAAG;IACvC,iBAAiB,EAAE,aAAa,CAAC,mBAAmB,CAAC;CACtD;AAED,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,0BAA0B,GAAG,IAAI,CACpD;AAO9B,eAAO,MAAQ,iBAAiB;;;;;;;;;;GAAE,sBAAsB;;;;;CACe","names":[],"ignoreList":[],"sources":["../../../src/context/vue/ThreadViewportContext.ts"],"sourcesContent":[null]}

package/dist/context/vue/ThreadViewportContext.js

@@ -0,0 +1,10 @@
+"use client";
+import { createContextHook } from "./utils/createContextHook.js";
+import { createContextStoreHook } from "./utils/createContextStoreHook.js";
+// src/context/vue/ThreadViewportContext.ts
+const ThreadViewportContext = Symbol("aui.ThreadViewport");
+const useThreadViewportContext = createContextHook(ThreadViewportContext, "ThreadPrimitive.Viewport");
+const { useThreadViewport, useThreadViewportStore } = createContextStoreHook(useThreadViewportContext, "useThreadViewport");
+export { ThreadViewportContext, useThreadViewport, useThreadViewportStore };
+
+//# sourceMappingURL=ThreadViewportContext.js.map

package/dist/context/vue/ThreadViewportContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewportContext.js","names":[],"sources":["../../../src/context/vue/ThreadViewportContext.ts"],"sourcesContent":["\"use client\";\n\nimport type { InjectionKey } from \"vue\";\nimport type { ReadonlyStore } from \"../ReadonlyStore\";\nimport { createContextHook } from \"./utils/createContextHook\";\nimport { createContextStoreHook } from \"./utils/createContextStoreHook\";\nimport type { ThreadViewportState } from \"../stores/ThreadViewport\";\n\nexport type ThreadViewportContextValue = {\n  useThreadViewport: ReadonlyStore<ThreadViewportState>;\n};\n\nexport const ThreadViewportContext: InjectionKey<ThreadViewportContextValue | null> =\n  Symbol(\"aui.ThreadViewport\");\n\nconst useThreadViewportContext = createContextHook(\n  ThreadViewportContext,\n  \"ThreadPrimitive.Viewport\",\n);\n\nexport const { useThreadViewport, useThreadViewportStore } =\n  createContextStoreHook(useThreadViewportContext, \"useThreadViewport\");\n"],"mappings":";;;;AAYA,MAAa,wBACX,OAAO,oBAAoB;AAE7B,MAAM,2BAA2B,kBAC/B,uBACA,0BACF;AAEA,MAAa,EAAE,mBAAmB,2BAChC,uBAAuB,0BAA0B,mBAAmB"}

package/dist/context/vue/utils/createContextHook.d.ts

@@ -0,0 +1,11 @@
+import { type InjectionKey } from "vue";
+/**
+ * Creates a context hook with optional support.
+ * @param context - The Vue injection key to consume.
+ * @param providerName - The name of the provider for error messages.
+ * @returns A hook function that provides the context value.
+ */
+export declare function createContextHook<T>(context: InjectionKey<T | null>, providerName: string): (options?: {
+    optional?: boolean | undefined;
+}) => T | null;
+//# sourceMappingURL=createContextHook.d.ts.map

package/dist/context/vue/utils/createContextHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextHook.d.ts","mappings":"AAEA,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,KAAK;AAEpE;;;;;;AAMA,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,EAC/B,YAAY,EAAE,MAAM,cAEc;IAChC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS;CAC/B,KAAG,CAAC,GAAG,IAAI","names":[],"ignoreList":[],"sources":["../../../../src/context/vue/utils/createContextHook.ts"],"sourcesContent":[null]}

package/dist/context/vue/utils/createContextHook.js

@@ -0,0 +1,20 @@
+"use client";
+import { hasInjectionContext, inject } from "vue";
+// src/context/vue/utils/createContextHook.ts
+/**
+* Creates a context hook with optional support.
+* @param context - The Vue injection key to consume.
+* @param providerName - The name of the provider for error messages.
+* @returns A hook function that provides the context value.
+*/
+function createContextHook(context, providerName) {
+	function useContextHook(options) {
+		const contextValue = hasInjectionContext() ? inject(context, null) : null;
+		if (!options?.optional && !contextValue) throw new Error(`This component must be used within ${providerName}.`);
+		return contextValue;
+	}
+	return useContextHook;
+}
+export { createContextHook };
+
+//# sourceMappingURL=createContextHook.js.map

package/dist/context/vue/utils/createContextHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextHook.js","names":[],"sources":["../../../../src/context/vue/utils/createContextHook.ts"],"sourcesContent":["\"use client\";\n\nimport { hasInjectionContext, inject, type InjectionKey } from \"vue\";\n\n/**\n * Creates a context hook with optional support.\n * @param context - The Vue injection key to consume.\n * @param providerName - The name of the provider for error messages.\n * @returns A hook function that provides the context value.\n */\nexport function createContextHook<T>(\n  context: InjectionKey<T | null>,\n  providerName: string,\n) {\n  function useContextHook(options?: {\n    optional?: boolean | undefined;\n  }): T | null {\n    const contextValue = hasInjectionContext() ? inject(context, null) : null;\n    if (!options?.optional && !contextValue) {\n      throw new Error(`This component must be used within ${providerName}.`);\n    }\n    return contextValue;\n  }\n\n  return useContextHook;\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,kBACd,SACA,cACA;CACA,SAAS,eAAe,SAEX;EACX,MAAM,eAAe,oBAAoB,IAAI,OAAO,SAAS,IAAI,IAAI;EACrE,IAAI,CAAC,SAAS,YAAY,CAAC,cACzB,MAAM,IAAI,MAAM,sCAAsC,aAAa,EAAE;EAEvE,OAAO;CACT;CAEA,OAAO;AACT"}

package/dist/context/vue/utils/createContextStoreHook.d.ts

@@ -0,0 +1,22 @@
+import { type ShallowRef } from "vue";
+import type { ReadonlyStore } from "../../ReadonlyStore.js";
+/** Vue selectors retain external snapshot identity and subscribe only while active. */
+export declare function createContextStoreHook<T, K extends keyof T & string>(contextHook: (options?: {
+    optional?: boolean;
+}) => T | null, contextKey: K): { [P in K]: {
+    (): Readonly<ShallowRef<T[K] extends ReadonlyStore<infer S> ? S : never>>;
+    <S>(selector: (state: T[K] extends ReadonlyStore<infer S_1> ? S_1 : never) => S): Readonly<ShallowRef<S>>;
+    (options: {
+        optional: true;
+    }): Readonly<ShallowRef<(T[K] extends ReadonlyStore<infer S> ? S : never) | null>>;
+    <S>(options: {
+        optional: true;
+        selector: (state: T[K] extends ReadonlyStore<infer S_1> ? S_1 : never) => S;
+    }): Readonly<ShallowRef<S | null>>;
+}; } & { [P in `${K}Store`]: {
+    (): ReadonlyStore<T[K] extends ReadonlyStore<infer S> ? S : never>;
+    (options: {
+        optional: true;
+    }): ReadonlyStore<T[K] extends ReadonlyStore<infer S> ? S : never> | null;
+}; };
+//# sourceMappingURL=createContextStoreHook.d.ts.map

package/dist/context/vue/utils/createContextStoreHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextStoreHook.d.ts","mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,KAAK;AAEZ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAqB;AAExD;AACA,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAClE,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO;CAAE,KAAK,CAAC,GAAG,IAAI,EAC3D,UAAU,EAAE,CAAC,GA4ER,GAAG,CAAC,IAAI,CAAC;QA9DW,QAAQ,CAAC,UAAU,kCAZM,CAAC,cAYI,CAAC;KAClC,CAAC,YACX,CAAC,KAAK,qDAAW,KAAK,CAAC,GAChC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;cACK;QAC7B,QAAQ,EAAE,IAAI;KACf,GAAG,QAAQ,CAAC,UAAU,CAAC,kCAlB0B,CAAC,iBAkBf,IAAI,CAAC,CAAC;KACpB,CAAC,WAAW;QAChC,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,CAAC,KAAK,qDAAW,KAAK,CAAC;KAClC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAoDI,GAAG,GACtC,CAAC,IAAI,GAAG,CAAC,OAAO;QA1EW,aAAa,kCADO,CAAC,cACG;cAClB;QAClC,QAAQ,EAAE,IAAI;KACf,GAAG,aAAa,kCAJiC,CAAC,cAIvB,GAAG,IAAI;IAwElC","names":[],"ignoreList":[],"sources":["../../../../src/context/vue/utils/createContextStoreHook.ts"],"sourcesContent":[null]}

package/dist/context/vue/utils/createContextStoreHook.js

@@ -0,0 +1,48 @@
+import { computed, shallowReadonly, shallowRef, watchEffect } from "vue";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+// src/context/vue/utils/createContextStoreHook.ts
+/** Vue selectors retain external snapshot identity and subscribe only while active. */
+function createContextStoreHook(contextHook, contextKey) {
+	function useStoreStoreHook(options) {
+		const context = contextHook(options);
+		return context ? context[contextKey] : null;
+	}
+	function useStoreHook(param) {
+		const optional = typeof param === "object" && !!param.optional;
+		const selector = typeof param === "function" ? param : param?.selector;
+		const context = contextHook({ optional });
+		const store = context ? context[contextKey] : null;
+		const snapshot = shallowRef(store?.getState() ?? null);
+		const failure = shallowRef();
+		watchEffect(() => {
+			if (failure.value) throw failure.value.error;
+		}, { flush: "sync" });
+		useIsomorphicLayoutEffect(() => {
+			if (!store) return;
+			let active = true;
+			const refresh = () => {
+				if (!active) return;
+				try {
+					snapshot.value = store.getState();
+					failure.value = void 0;
+				} catch (error) {
+					failure.value = { error };
+				}
+			};
+			const release = store.subscribe(refresh);
+			refresh();
+			return () => {
+				active = false;
+				release();
+			};
+		}, []);
+		return shallowReadonly(computed(() => snapshot.value === null ? null : selector ? selector(snapshot.value) : snapshot.value));
+	}
+	return {
+		[contextKey]: useStoreHook,
+		[`${contextKey}Store`]: useStoreStoreHook
+	};
+}
+export { createContextStoreHook };
+
+//# sourceMappingURL=createContextStoreHook.js.map

package/dist/context/vue/utils/createContextStoreHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextStoreHook.js","names":[],"sources":["../../../../src/context/vue/utils/createContextStoreHook.ts"],"sourcesContent":["import {\n  computed,\n  shallowReadonly,\n  shallowRef,\n  watchEffect,\n  type ShallowRef,\n} from \"vue\";\nimport { useIsomorphicLayoutEffect } from \"@ulearning/ai-store/internal\";\nimport type { ReadonlyStore } from \"../../ReadonlyStore\";\n\n/** Vue selectors retain external snapshot identity and subscribe only while active. */\nexport function createContextStoreHook<T, K extends keyof T & string>(\n  contextHook: (options?: { optional?: boolean }) => T | null,\n  contextKey: K,\n) {\n  type StateType = T[K] extends ReadonlyStore<infer S> ? S : never;\n  function useStoreStoreHook(): ReadonlyStore<StateType>;\n  function useStoreStoreHook(options: {\n    optional: true;\n  }): ReadonlyStore<StateType> | null;\n  function useStoreStoreHook(options?: {\n    optional?: boolean;\n  }): ReadonlyStore<StateType> | null {\n    const context = contextHook(options);\n    return context ? (context[contextKey] as ReadonlyStore<StateType>) : null;\n  }\n\n  function useStoreHook(): Readonly<ShallowRef<StateType>>;\n  function useStoreHook<S>(\n    selector: (state: StateType) => S,\n  ): Readonly<ShallowRef<S>>;\n  function useStoreHook(options: {\n    optional: true;\n  }): Readonly<ShallowRef<StateType | null>>;\n  function useStoreHook<S>(options: {\n    optional: true;\n    selector: (state: StateType) => S;\n  }): Readonly<ShallowRef<S | null>>;\n  function useStoreHook<S>(\n    param?:\n      | ((state: StateType) => S)\n      | { optional?: boolean; selector?: (state: StateType) => S },\n  ): Readonly<ShallowRef<S | StateType | null>> {\n    const optional = typeof param === \"object\" && !!param.optional;\n    const selector = typeof param === \"function\" ? param : param?.selector;\n    const context = contextHook({ optional });\n    const store = context\n      ? (context[contextKey] as ReadonlyStore<StateType>)\n      : null;\n    const snapshot = shallowRef(store?.getState() ?? null);\n    const failure = shallowRef<{ error: unknown }>();\n    watchEffect(\n      () => {\n        if (failure.value) throw failure.value.error;\n      },\n      { flush: \"sync\" },\n    );\n    useIsomorphicLayoutEffect(() => {\n      if (!store) return;\n      let active = true;\n      const refresh = () => {\n        if (!active) return;\n        try {\n          snapshot.value = store.getState();\n          failure.value = undefined;\n        } catch (error) {\n          failure.value = { error };\n        }\n      };\n      const release = store.subscribe(refresh);\n      refresh();\n      return () => {\n        active = false;\n        release();\n      };\n    }, []);\n    return shallowReadonly(\n      computed(() =>\n        snapshot.value === null\n          ? null\n          : selector\n            ? selector(snapshot.value)\n            : snapshot.value,\n      ),\n    );\n  }\n  return {\n    [contextKey]: useStoreHook,\n    [`${contextKey}Store`]: useStoreStoreHook,\n  } as { [P in K]: typeof useStoreHook } & {\n    [P in `${K}Store`]: typeof useStoreStoreHook;\n  };\n}\n"],"mappings":";;;;AAWA,SAAgB,uBACd,aACA,YACA;CAMA,SAAS,kBAAkB,SAES;EAClC,MAAM,UAAU,YAAY,OAAO;EACnC,OAAO,UAAW,QAAQ,cAA2C;CACvE;CAaA,SAAS,aACP,OAG4C;EAC5C,MAAM,WAAW,OAAO,UAAU,YAAY,CAAC,CAAC,MAAM;EACtD,MAAM,WAAW,OAAO,UAAU,aAAa,QAAQ,OAAO;EAC9D,MAAM,UAAU,YAAY,EAAE,SAAS,CAAC;EACxC,MAAM,QAAQ,UACT,QAAQ,cACT;EACJ,MAAM,WAAW,WAAW,OAAO,SAAS,KAAK,IAAI;EACrD,MAAM,UAAU,WAA+B;EAC/C,kBACQ;GACJ,IAAI,QAAQ,OAAO,MAAM,QAAQ,MAAM;EACzC,GACA,EAAE,OAAO,OAAO,CAClB;EACA,gCAAgC;GAC9B,IAAI,CAAC,OAAO;GACZ,IAAI,SAAS;GACb,MAAM,gBAAgB;IACpB,IAAI,CAAC,QAAQ;IACb,IAAI;KACF,SAAS,QAAQ,MAAM,SAAS;KAChC,QAAQ,QAAQ,KAAA;IAClB,SAAS,OAAO;KACd,QAAQ,QAAQ,EAAE,MAAM;IAC1B;GACF;GACA,MAAM,UAAU,MAAM,UAAU,OAAO;GACvC,QAAQ;GACR,aAAa;IACX,SAAS;IACT,QAAQ;GACV;EACF,GAAG,CAAC,CAAC;EACL,OAAO,gBACL,eACE,SAAS,UAAU,OACf,OACA,WACE,SAAS,SAAS,KAAK,IACvB,SAAS,KACjB,CACF;CACF;CACA,OAAO;GACJ,aAAa;GACb,GAAG,WAAW,SAAS;CAC1B;AAGF"}

package/dist/devtools/DevToolsHooks.d.ts

@@ -0,0 +1,32 @@
+import type { Unsubscribe } from "@ulearning/ai-core";
+import type { AssistantClient } from "@ulearning/ai-store";
+export interface EventLog {
+    time: Date;
+    event: string;
+    data: unknown;
+}
+interface DevToolsApiEntry {
+    api: Partial<AssistantClient>;
+    logs: EventLog[];
+}
+interface DevToolsHook {
+    apis: Map<number, DevToolsApiEntry>;
+    nextId: number;
+    listeners: Set<(apiId: number) => void>;
+}
+declare global {
+    interface Window {
+        __ASSISTANT_UI_DEVTOOLS_HOOK__?: DevToolsHook;
+    }
+}
+export declare class DevToolsHooks {
+    static subscribe(listener: () => void): Unsubscribe;
+    static clearEventLogs(apiId: number): void;
+    static getApis(): Map<number, DevToolsApiEntry>;
+}
+export declare class DevToolsProviderApi {
+    private static readonly MAX_EVENT_LOGS_PER_API;
+    static register(aui: Partial<AssistantClient>): Unsubscribe;
+}
+export {};
+//# sourceMappingURL=DevToolsHooks.d.ts.map

package/dist/devtools/DevToolsHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsHooks.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB;AAE1D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,OAAO;;AAGf,UAAU,gBAAgB;IACxB,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC;IAC7B,IAAI,EAAE,QAAQ,EAAE;;AAGlB,UAAU,YAAY;IACpB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACnC,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;;AAGzC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,8BAA8B,CAAC,EAAE,YAAY;;;AAsCjD,qBAAa,aAAa;IACxB,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW;IAQnD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS1C,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;;AAKjD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB;IAE9C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,WAAW","names":[],"ignoreList":[],"sources":["../../src/devtools/DevToolsHooks.ts"],"sourcesContent":[null]}