@assistant-ui/react 0.14.29 → 0.15.1

package/src/legacy-runtime/hooks/ComposerContext.ts

@@ -1,131 +0,0 @@
-"use client";
-
-import { useAui, useAuiState } from "@assistant-ui/store";
-import type { ComposerRuntime } from "../runtime/ComposerRuntime";
-import { createStateHookForRuntime } from "../../context/react/utils/createStateHookForRuntime";
-
-/**
- * @deprecated Use {@link useAui} with `aui.composer()` instead. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- *
- * Hook to access the ComposerRuntime from the current context.
- *
- * The ComposerRuntime provides access to composer state and actions for message
- * composition, including text input, attachments, and sending functionality.
- * This hook automatically resolves to either the message's edit composer or
- * the thread's main composer depending on the context.
- *
- * @param options Configuration options
- * @param options.optional Whether the hook should return null if no context is found
- * @returns The ComposerRuntime instance, or null if optional is true and no context exists
- *
- * @example
- * ```tsx
- * // Before:
- * function ComposerActions() {
- *   const runtime = useComposerRuntime();
- *   const handleSend = () => {
- *     if (runtime.getState().canSend) {
- *       runtime.send();
- *     }
- *   };
- *   const handleCancel = () => {
- *     if (runtime.getState().canCancel) {
- *       runtime.cancel();
- *     }
- *   };
- *   return (
- *     <div>
- *       <button onClick={handleSend}>Send</button>
- *       <button onClick={handleCancel}>Cancel</button>
- *     </div>
- *   );
- * }
- *
- * // After:
- * function ComposerActions() {
- *   const aui = useAui();
- *   const canSend = useAuiState((s) => s.composer.canSend);
- *   const canCancel = useAuiState((s) => s.composer.canCancel);
- *   const handleSend = () => {
- *     if (canSend) {
- *       aui.composer().send();
- *     }
- *   };
- *   const handleCancel = () => {
- *     if (canCancel) {
- *       aui.composer().cancel();
- *     }
- *   };
- *   return (
- *     <div>
- *       <button onClick={handleSend}>Send</button>
- *       <button onClick={handleCancel}>Cancel</button>
- *     </div>
- *   );
- * }
- * ```
- */
-export function useComposerRuntime(options?: {
-  optional?: false | undefined;
-}): ComposerRuntime;
-export function useComposerRuntime(options?: {
-  optional?: boolean | undefined;
-}): ComposerRuntime | null;
-export function useComposerRuntime(options?: {
-  optional?: boolean | undefined;
-}): ComposerRuntime | null {
-  const aui = useAui();
-  const runtime = useAuiState(() =>
-    aui.composer.source
-      ? (aui.composer().__internal_getRuntime?.() ?? null)
-      : null,
-  );
-  if (!runtime && !options?.optional) {
-    throw new Error("ComposerRuntime is not available");
-  }
-  return runtime;
-}
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.composer)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- *
- * Hook to access the current composer state.
- *
- * This hook provides reactive access to the composer's state, including text content,
- * attachments, editing status, and send/cancel capabilities.
- *
- * @param selector Optional selector function to pick specific state properties
- * @returns The selected composer state or the entire composer state if no selector provided
- *
- * @example
- * ```tsx
- * // Before:
- * function ComposerStatus() {
- *   const text = useComposer((state) => state.text);
- *   const canSend = useComposer((state) => state.canSend);
- *   const attachmentCount = useComposer((state) => state.attachments.length);
- *   return (
- *     <div>
- *       Text: {text.length} chars,
- *       Attachments: {attachmentCount},
- *       Can send: {canSend}
- *     </div>
- *   );
- * }
- *
- * // After:
- * function ComposerStatus() {
- *   const text = useAuiState((s) => s.composer.text);
- *   const canSend = useAuiState((s) => s.composer.canSend);
- *   const attachmentCount = useAuiState((s) => s.composer.attachments.length);
- *   return (
- *     <div>
- *       Text: {text.length} chars,
- *       Attachments: {attachmentCount},
- *       Can send: {canSend}
- *     </div>
- *   );
- * }
- * ```
- */
-export const useComposer = createStateHookForRuntime(useComposerRuntime);

package/src/legacy-runtime/hooks/MessageContext.ts

@@ -1,127 +0,0 @@
-"use client";
-
-import type { MessageRuntime } from "../runtime/MessageRuntime";
-import { useAui, useAuiState } from "@assistant-ui/store";
-import { createStateHookForRuntime } from "../../context/react/utils/createStateHookForRuntime";
-import type { EditComposerRuntime } from "@assistant-ui/core";
-
-/**
- * @deprecated Use {@link useAui} with `aui.message()` instead. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- *
- * Hook to access the MessageRuntime from the current context.
- *
- * The MessageRuntime provides access to message-level state and actions,
- * including message content, status, editing capabilities, and branching.
- *
- * @param options Configuration options
- * @param options.optional Whether the hook should return null if no context is found
- * @returns The MessageRuntime instance, or null if optional is true and no context exists
- *
- * @example
- * ```tsx
- * // Before:
- * function MessageActions() {
- *   const runtime = useMessageRuntime();
- *   const handleReload = () => {
- *     runtime.reload();
- *   };
- *   const handleEdit = () => {
- *     runtime.startEdit();
- *   };
- *   return (
- *     <div>
- *       <button onClick={handleReload}>Reload</button>
- *       <button onClick={handleEdit}>Edit</button>
- *     </div>
- *   );
- * }
- *
- * // After:
- * function MessageActions() {
- *   const aui = useAui();
- *   const handleReload = () => {
- *     aui.message().reload();
- *   };
- *   const handleEdit = () => {
- *     aui.message().startEdit();
- *   };
- *   return (
- *     <div>
- *       <button onClick={handleReload}>Reload</button>
- *       <button onClick={handleEdit}>Edit</button>
- *     </div>
- *   );
- * }
- * ```
- */
-export function useMessageRuntime(options?: {
-  optional?: false | undefined;
-}): MessageRuntime;
-export function useMessageRuntime(options?: {
-  optional?: boolean | undefined;
-}): MessageRuntime | null;
-export function useMessageRuntime(options?: {
-  optional?: boolean | undefined;
-}) {
-  const aui = useAui();
-  const runtime = useAuiState(() =>
-    aui.message.source
-      ? (aui.message().__internal_getRuntime?.() ?? null)
-      : null,
-  );
-  if (!runtime && !options?.optional) {
-    throw new Error("MessageRuntime is not available");
-  }
-  return runtime;
-}
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.message)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- *
- * Hook to access the current message state.
- *
- * This hook provides reactive access to the message's state, including content,
- * role, status, and other message-level properties.
- *
- * @param selector Optional selector function to pick specific state properties
- * @returns The selected message state or the entire message state if no selector provided
- *
- * @example
- * ```tsx
- * // Before:
- * function MessageContent() {
- *   const role = useMessage((state) => state.role);
- *   const content = useMessage((state) => state.content);
- *   const isLoading = useMessage((state) => state.status.type === "running");
- *   return (
- *     <div className={`message-${role}`}>
- *       {isLoading ? "Loading..." : content.map(part => part.text).join("")}
- *     </div>
- *   );
- * }
- *
- * // After:
- * function MessageContent() {
- *   const role = useAuiState((s) => s.message.role);
- *   const content = useAuiState((s) => s.message.content);
- *   const isLoading = useAuiState((s) => s.message.status.type === "running");
- *   return (
- *     <div className={`message-${role}`}>
- *       {isLoading ? "Loading..." : content.map(part => part.text).join("")}
- *     </div>
- *   );
- * }
- * ```
- */
-export const useMessage = createStateHookForRuntime(useMessageRuntime);
-
-const useEditComposerRuntime = (opt: {
-  optional: boolean | undefined;
-}): EditComposerRuntime | null => useMessageRuntime(opt)?.composer ?? null;
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.message.composer)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- */
-export const useEditComposer = createStateHookForRuntime(
-  useEditComposerRuntime,
-);

package/src/legacy-runtime/hooks/MessagePartContext.ts

@@ -1,32 +0,0 @@
-"use client";
-
-import type { MessagePartRuntime } from "../runtime/MessagePartRuntime";
-import { createStateHookForRuntime } from "../../context/react/utils/createStateHookForRuntime";
-import { useAui, useAuiState } from "@assistant-ui/store";
-
-/**
- * @deprecated Use {@link useAui} with `aui.part()` instead. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- */
-export function useMessagePartRuntime(options?: {
-  optional?: false | undefined;
-}): MessagePartRuntime;
-export function useMessagePartRuntime(options?: {
-  optional?: boolean | undefined;
-}): MessagePartRuntime | null;
-export function useMessagePartRuntime(options?: {
-  optional?: boolean | undefined;
-}) {
-  const aui = useAui();
-  const runtime = useAuiState(() =>
-    aui.part.source ? (aui.part().__internal_getRuntime?.() ?? null) : null,
-  );
-  if (!runtime && !options?.optional) {
-    throw new Error("MessagePartRuntime is not available");
-  }
-  return runtime;
-}
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.part)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- */
-export const useMessagePart = createStateHookForRuntime(useMessagePartRuntime);

package/src/legacy-runtime/hooks/ThreadContext.ts

@@ -1,120 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import type { ThreadRuntime } from "../runtime/ThreadRuntime";
-import type { ModelContext } from "@assistant-ui/core";
-import { createStateHookForRuntime } from "../../context/react/utils/createStateHookForRuntime";
-import type { ThreadComposerRuntime } from "@assistant-ui/core";
-import { useAui, useAuiEvent, useAuiState } from "@assistant-ui/store";
-
-/**
- * @deprecated Use {@link useAui} with `aui.thread()` instead. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- *
- * Hook to access the ThreadRuntime from the current context.
- *
- * The ThreadRuntime provides access to thread-level state and actions,
- * including message management, thread state, and composer functionality.
- *
- * @param options Configuration options
- * @param options.optional Whether the hook should return null if no context is found
- * @returns The ThreadRuntime instance, or null if optional is true and no context exists
- *
- * @example
- * ```tsx
- * // Before:
- * function MyComponent() {
- *   const runtime = useThreadRuntime();
- *   const handleSendMessage = (text: string) => {
- *     runtime.append({ role: "user", content: [{ type: "text", text }] });
- *   };
- *   return <button onClick={() => handleSendMessage("Hello!")}>Send</button>;
- * }
- *
- * // After:
- * function MyComponent() {
- *   const aui = useAui();
- *   const handleSendMessage = (text: string) => {
- *     aui.thread().append({ role: "user", content: [{ type: "text", text }] });
- *   };
- *   return <button onClick={() => handleSendMessage("Hello!")}>Send</button>;
- * }
- * ```
- */
-export function useThreadRuntime(options?: {
-  optional?: false | undefined;
-}): ThreadRuntime;
-export function useThreadRuntime(options?: {
-  optional?: boolean | undefined;
-}): ThreadRuntime | null;
-export function useThreadRuntime(options?: { optional?: boolean | undefined }) {
-  const aui = useAui();
-  const runtime = useAuiState(() =>
-    aui.thread.source ? (aui.thread().__internal_getRuntime?.() ?? null) : null,
-  );
-  if (!runtime && !options?.optional) {
-    throw new Error("ThreadRuntime is not available");
-  }
-  return runtime;
-}
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.thread)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- *
- * Hook to access the current thread state.
- *
- * This hook provides reactive access to the thread's state, including messages,
- * running status, capabilities, and other thread-level properties.
- *
- * @param selector Optional selector function to pick specific state properties
- * @returns The selected thread state or the entire thread state if no selector provided
- *
- * @example
- * ```tsx
- * // Before:
- * function ThreadStatus() {
- *   const isRunning = useThread((state) => state.isRunning);
- *   const messageCount = useThread((state) => state.messages.length);
- *   return <div>Running: {isRunning}, Messages: {messageCount}</div>;
- * }
- *
- * // After:
- * function ThreadStatus() {
- *   const isRunning = useAuiState((s) => s.thread.isRunning);
- *   const messageCount = useAuiState((s) => s.thread.messages.length);
- *   return <div>Running: {isRunning}, Messages: {messageCount}</div>;
- * }
- * ```
- */
-export const useThread = createStateHookForRuntime(useThreadRuntime);
-
-const useThreadComposerRuntime = (opt: {
-  optional: boolean | undefined;
-}): ThreadComposerRuntime | null => useThreadRuntime(opt)?.composer ?? null;
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.thread.composer)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- */
-export const useThreadComposer = createStateHookForRuntime(
-  useThreadComposerRuntime,
-);
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.thread.modelContext)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- */
-export function useThreadModelContext(options?: {
-  optional?: false | undefined;
-}): ModelContext;
-export function useThreadModelContext(options?: {
-  optional?: boolean | undefined;
-}): ModelContext | null;
-export function useThreadModelContext(options?: {
-  optional?: boolean | undefined;
-}): ModelContext | null {
-  const [, rerender] = useState({});
-
-  const runtime = useThreadRuntime(options);
-  useAuiEvent("thread.modelContextUpdate", () => rerender({}));
-
-  if (!runtime) return null;
-  return runtime?.getModelContext();
-}

package/src/legacy-runtime/hooks/ThreadListItemContext.ts

@@ -1,36 +0,0 @@
-"use client";
-
-import type { ThreadListItemRuntime } from "../runtime/ThreadListItemRuntime";
-import { createStateHookForRuntime } from "../../context/react/utils/createStateHookForRuntime";
-import { useAui, useAuiState } from "@assistant-ui/store";
-
-/**
- * @deprecated Use {@link useAui} with `aui.threadListItem()` instead. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- */
-export function useThreadListItemRuntime(options?: {
-  optional?: false | undefined;
-}): ThreadListItemRuntime;
-export function useThreadListItemRuntime(options?: {
-  optional?: boolean | undefined;
-}): ThreadListItemRuntime | null;
-export function useThreadListItemRuntime(options?: {
-  optional?: boolean | undefined;
-}) {
-  const aui = useAui();
-  const runtime = useAuiState(() =>
-    aui.threadListItem.source
-      ? (aui.threadListItem().__internal_getRuntime?.() ?? null)
-      : null,
-  );
-  if (!runtime && !options?.optional) {
-    throw new Error("ThreadListItemRuntime is not available");
-  }
-  return runtime;
-}
-
-/**
- * @deprecated Use {@link useAuiState}: `useAuiState((s) => s.threadListItem)`. See the {@link https://assistant-ui.com/docs/migrations/v0-12 migration guide}.
- */
-export const useThreadListItem = createStateHookForRuntime(
-  useThreadListItemRuntime,
-);