@assistant-ui/store

Tap-based state container with React Context integration. Bridges @assistant-ui/tap resources into React via useAui, useAuiState, AuiConfig, and <AuiProvider>.

store powers the runtime layer of assistant-ui. Most users do not install it directly; reach for @assistant-ui/react instead.

Framework-neutral entry

@assistant-ui/store/client exposes createAssistantClient, which builds the same client inside a standalone tap root with no React renderer. Non-React bindings consume the store through this entry; react-less consumers additionally alias react to @assistant-ui/tap/standalone-shim in their bundler. The react peer dependency is optional for exactly this configuration.

Installation

npm install @assistant-ui/store @assistant-ui/tap

Usage

import { resource } from "@assistant-ui/tap";
import { useState } from "react";
import {
  useAui,
  useAuiState,
  AuiProvider,
  AuiConfig,
  type ClientOutput,
} from "@assistant-ui/store";

declare module "@assistant-ui/store" {
  interface ScopeRegistry {
    counter: {
      methods: {
        getState: () => { count: number };
        increment: () => void;
      };
    };
  }
}

const useCounterClient = (): ClientOutput<"counter"> => {
  const [state, setState] = useState({ count: 0 });
  return {
    getState: () => state,
    increment: () => setState({ count: state.count + 1 }),
  };
};

const CounterClient = resource(useCounterClient);

function App() {
  const config = AuiConfig({ counter: CounterClient() });
  return (
    <AuiProvider config={config}>
      <Counter />
    </AuiProvider>
  );
}

function Counter() {
  const count = useAuiState((s) => s.counter.count);
  const aui = useAui();
  return <button onClick={() => aui.counter().increment()}>{count}</button>;
}

Full API reference (clients, derived clients, events, useClientLookup, useClientList) at assistant-ui.com/docs/store/api-reference.