@nadicodeai/ui 0.20.0 → 0.22.0

package/dist/styles/globals.css

@@ -15,9 +15,10 @@
 
 @import "tailwindcss";
 @import "tw-animate-css";
+@import "tw-shimmer";
+@import "@assistant-ui/react-markdown/styles/dot.css";
 @import "./shadcn.tailwind.css";
 @import "@nadicodeai/design-system/css";
-@import "@xyflow/react/dist/style.css" layer(components);
 
 /*
  * Tailwind v4's dark: variant defaults to an OS media query. Match shadcn's
@@ -55,216 +56,9 @@
 /*
  * The canonical design-system module owns raw --nc-* mode aliases, semantic
  * roles, and their Tailwind utility bridge for both root and scoped `.dark`
- * surfaces. This adapter owns only narrow technology integration such as ANSI
- * class translation below.
+ * surfaces.
  */
 
-/*
- * The design-system CSS components (.nc-chat-thread, .nc-chat-bubble-*,
- * .nc-artifact-preview, .nc-approval-gate, .nc-tool-call-trace,
- * .nc-usage-meter, .nc-run-timeline, .nc-memory-item, .nc-handoff-banner, …)
- * paint from the raw --nc-canvas/ink/body/line/canvas-soft/muted/warning
- * palette. The generated mode layer remaps that surface palette alongside every
- * other authored dark pair, so nc-* CSS components need no local mode selectors.
- */
-
-/*
- * ansi-to-react emits stable classes when Terminal enables `useClasses`.
- * Terminal is an intentionally fixed-dark technology surface, so this adapter
- * maps those protocol classes directly to canonical dark design tokens. It does
- * not declare a parallel product-token hierarchy.
- */
-[data-slot="terminal"] .ansi-black-fg {
-  color: var(--nc-dark-muted);
-}
-
-[data-slot="terminal"] .ansi-red-fg {
-  color: var(--nc-dark-error);
-}
-
-[data-slot="terminal"] .ansi-green-fg {
-  color: var(--nc-dark-success);
-}
-
-[data-slot="terminal"] .ansi-yellow-fg {
-  color: var(--nc-dark-warning);
-}
-
-[data-slot="terminal"] .ansi-blue-fg {
-  color: var(--nc-dark-info);
-}
-
-[data-slot="terminal"] .ansi-magenta-fg {
-  color: var(--nc-dark-chart-6);
-}
-
-[data-slot="terminal"] .ansi-cyan-fg {
-  color: var(--nc-dark-cyan);
-}
-
-[data-slot="terminal"] .ansi-white-fg {
-  color: var(--nc-dark-body);
-}
-
-[data-slot="terminal"] .ansi-bright-black-fg {
-  color: var(--nc-dark-body);
-}
-
-[data-slot="terminal"] .ansi-bright-red-fg {
-  color: var(--nc-dark-error-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-green-fg {
-  color: var(--nc-dark-link-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-yellow-fg {
-  color: var(--nc-dark-warning-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-blue-fg {
-  color: var(--nc-dark-info-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-magenta-fg {
-  color: var(--nc-dark-chart-seq-3);
-}
-
-[data-slot="terminal"] .ansi-bright-cyan-fg {
-  color: var(--nc-dark-cyan-soft);
-}
-
-[data-slot="terminal"] .ansi-bright-white-fg {
-  color: var(--nc-dark-ink);
-}
-
-[data-slot="terminal"] .ansi-black-bg {
-  background-color: var(--nc-dark-canvas);
-}
-
-[data-slot="terminal"] .ansi-red-bg {
-  background-color: var(--nc-dark-error);
-}
-
-[data-slot="terminal"] .ansi-green-bg {
-  background-color: var(--nc-dark-success);
-}
-
-[data-slot="terminal"] .ansi-yellow-bg {
-  background-color: var(--nc-dark-warning);
-}
-
-[data-slot="terminal"] .ansi-blue-bg {
-  background-color: var(--nc-dark-info);
-}
-
-[data-slot="terminal"] .ansi-magenta-bg {
-  background-color: var(--nc-dark-chart-6);
-}
-
-[data-slot="terminal"] .ansi-cyan-bg {
-  background-color: var(--nc-dark-cyan);
-}
-
-[data-slot="terminal"] .ansi-white-bg {
-  background-color: var(--nc-dark-body);
-}
-
-[data-slot="terminal"] .ansi-bright-black-bg {
-  background-color: var(--nc-dark-body);
-}
-
-[data-slot="terminal"] .ansi-bright-red-bg {
-  background-color: var(--nc-dark-error-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-green-bg {
-  background-color: var(--nc-dark-link-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-yellow-bg {
-  background-color: var(--nc-dark-warning-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-blue-bg {
-  background-color: var(--nc-dark-info-deep);
-}
-
-[data-slot="terminal"] .ansi-bright-magenta-bg {
-  background-color: var(--nc-dark-chart-seq-3);
-}
-
-[data-slot="terminal"] .ansi-bright-cyan-bg {
-  background-color: var(--nc-dark-cyan-soft);
-}
-
-[data-slot="terminal"] .ansi-bright-white-bg {
-  background-color: var(--nc-dark-ink);
-}
-
-[data-slot="terminal"] .ansi-black-bg:not([class*="-fg"]) {
-  color: var(--nc-dark-ink);
-}
-
-[data-slot="terminal"]
-  :is(
-    .ansi-red-bg,
-    .ansi-green-bg,
-    .ansi-yellow-bg,
-    .ansi-blue-bg,
-    .ansi-magenta-bg,
-    .ansi-cyan-bg,
-    .ansi-white-bg,
-    .ansi-bright-black-bg,
-    .ansi-bright-red-bg,
-    .ansi-bright-green-bg,
-    .ansi-bright-yellow-bg,
-    .ansi-bright-blue-bg,
-    .ansi-bright-magenta-bg,
-    .ansi-bright-cyan-bg,
-    .ansi-bright-white-bg
-  ):not([class*="-fg"]) {
-  color: var(--nc-dark-canvas);
-}
-
-[data-nc-code-block-body] {
-  background-color: var(--shiki-code-block-light-bg, var(--background));
-  color: var(--shiki-code-block-light-fg, var(--foreground));
-}
-
-.dark [data-nc-code-block-body] {
-  background-color: var(
-    --shiki-code-block-dark-bg,
-    var(--shiki-code-block-light-bg, var(--background))
-  );
-  color: var(--shiki-code-block-dark-fg, var(--shiki-code-block-light-fg, var(--foreground)));
-}
-
-[data-nc-code-token] {
-  background-color: var(--shiki-code-token-light-bg, transparent);
-  color: var(--shiki-code-token-light-color, var(--foreground));
-  font-style: var(--shiki-code-token-light-font-style, normal);
-  font-weight: var(--shiki-code-token-light-font-weight, normal);
-  text-decoration: var(--shiki-code-token-light-text-decoration, none);
-}
-
-.dark [data-nc-code-token] {
-  background-color: var(--shiki-code-token-dark-bg, var(--shiki-code-token-light-bg, transparent));
-  color: var(--shiki-code-token-dark-color, var(--shiki-code-token-light-color, var(--foreground)));
-  font-style: var(
-    --shiki-code-token-dark-font-style,
-    var(--shiki-code-token-light-font-style, normal)
-  );
-  font-weight: var(
-    --shiki-code-token-dark-font-weight,
-    var(--shiki-code-token-light-font-weight, normal)
-  );
-  text-decoration: var(
-    --shiki-code-token-dark-text-decoration,
-    var(--shiki-code-token-light-text-decoration, none)
-  );
-}
-
 .toaster [data-sonner-toast][data-styled="true"] [data-description] {
   color: var(--muted-foreground);
 }

package/docs/agents/nadicodeai-ui.md

@@ -10,22 +10,20 @@ authoritative interfaces without carrying a second copy of them.
 - Package/consumer boundary, styling invariants, admission rules, and
   accessibility: [`../contract.md`](../contract.md).
 - Current component modules and named exports: `src/components/`,
-  `src/index.ts`, `src/ai-elements.ts`, and `package.json` in a source checkout;
+  `src/index.ts` and `package.json` in a source checkout;
   package exports and declarations in an installed package.
-- Import examples, form-stack guidance, `SeamGrid` usage, and live shadcn/AI
-  Elements discovery commands: [`../../README.md`](../../README.md).
+- Import examples, form-stack guidance, `SeamGrid` usage, and live shadcn and
+  assistant-ui discovery commands: [`../../README.md`](../../README.md).
 
 Do not maintain component, chart, form, section, export, or registry inventories
 in agent prose. Follow the owning source or document above.
 
 ## Product work
 
-- Agent work surfaces: [`../agent-work-surfaces.md`](../agent-work-surfaces.md).
+- Agent UI ownership: [`../contract.md`](../contract.md).
 - Product compositions and sections:
   [`../product-compositions.md`](../product-compositions.md) and
   [`../product-sections.md`](../product-sections.md).
-- Terminal and TUI semantics:
-  [`../terminal-tui-semantics.md`](../terminal-tui-semantics.md).
 
 Routes, persistence, authentication, server state, runtime adapters,
 permissions, analytics, and product-specific copy stay in the consuming app.

package/docs/component-classification.md

@@ -2,7 +2,7 @@
 
 This file records the ownership class for U4 product compositions. The package may render standard product UI, but consuming apps own app behavior, data, persistence, and product-specific promises.
 
-If first-party shadcn or AI Elements registry source already covers the same
+If first-party shadcn or assistant-ui registry source already covers the same
 generic product UI, do not add a parallel NadicodeAI package API. Use the
 registry item in the consuming app and adapt it there with app-owned data,
 copy, and behavior.

package/docs/consuming-cross-repo.md

@@ -17,10 +17,16 @@ npm install @nadicodeai/ui@<exact-version> react@^19 react-dom@^19 tailwindcss@^
 dependency exactly. A React consumer does not declare that dependency directly
 just to use UI components or the UI stylesheet.
 
+The package installs its Agent UI implementation exactly. Consumers import
+presentation, runtime primitives, providers, hooks, and types through
+`@nadicodeai/ui/agents`; they do not install or import assistant-ui packages
+directly. A protocol-specific runtime adapter remains a direct consumer
+dependency because the application owns transport and message state.
+
 Declare `@nadicodeai/design-system` directly only when the app intentionally
-uses a separate public design-system API, such as a font/logo asset, the static
-CSS interface for a separate non-React surface, or the optional agent-chat
-enhancer. Pin that direct dependency to the version required by the installed
+uses a separate public design-system API, such as a font/logo asset or the
+static CSS interface for a separate non-React surface. Pin that direct
+dependency to the version required by the installed
 UI release:
 
 ```bash
@@ -51,6 +57,29 @@ winner. Import files under `@nadicodeai/design-system/assets/fonts/*` only when
 the consumer wants the faces without the CSS module; that is one of the
 intentional direct-API cases described above.
 
+## Strict ESLint interface
+
+The package exports the same design-system rules used by this repository. Add
+the flat config after the consumer's framework and TypeScript configs:
+
+```js
+import nadicodeai from "@nadicodeai/ui/eslint";
+
+export default [
+  // Framework, parser, and TypeScript configs first.
+  ...nadicodeai.configs["flat/strict"],
+];
+```
+
+Every rule in this config is an error. The config rejects generated `nc-*`
+utilities that do not exist in the installed design-system release, arbitrary
+radius values that exactly duplicate a generated token, source deep imports,
+raw design values, native visible controls, and appearance overrides on shared
+UI primitives. An arbitrary radius remains valid when no generated radius has
+the same value. Consumers may compose domain-specific components from the
+public UI package; the rules govern package boundaries and design values, not
+the shape of a consumer's JSX tree.
+
 ## NadicodeAI logo
 
 React surfaces that need both the mark and readable company name use the

package/docs/contract.md

@@ -12,20 +12,21 @@ The normative invariants for the `@nadicodeai/ui` package: what may live here, h
 ## Package Shape Invariants
 
 - **Source-authored, built package.** Components are authored as shadcn-style source in `src/`, then emitted to `dist/` for consumption by other apps. Package exports must point at built JS, declarations, and CSS, never raw `src/*.tsx`, and `npm pack --dry-run` must include only intentional consumer artifacts.
-- **Package surface is source-backed.** `src/components/` is intentionally flat shadcn-style source. Do not document folders or package namespaces that do not exist, and do not add top-level exports for recipes, blocks, agent, or terminal groupings unless a later package API decision adds concrete source, built files, docs, and tests in the same change.
-- **shadcn and AI Elements are package surface.** Installed shadcn and AI Elements modules under `src/components/` are intentional ready-to-use exports. The source tree owns the component inventory; `src/index.ts` and `src/ai-elements.ts` own the barrels, and `package.json` owns the public export shape. Guards derive the consumer surface from those owners. Prose routes to them instead of maintaining another component list.
+- **Package surface is source-backed.** Public components stay flat under `src/components/`. Reviewed registry source under `src/internal/` is implementation, not a package namespace. Do not add top-level exports for recipes, blocks, agent, terminal, or vendor groupings unless a later package API decision adds concrete public source, built files, docs, and tests in the same change.
+- **Agents is the public Agent UI interface.** `@nadicodeai/ui/agents` re-exports the complete `@assistant-ui/react` runtime and primitive API plus the reviewed, branded registry composition held under `src/internal/assistant-ui/`. Consumers receive Thread, attachments, Markdown, reasoning, tools, suggestions, providers, runtimes, hooks, and types from that one domain namespace. The vendor name is not a public NadicodeAI subpath, and the package does not rename, wrap, or rebuild assistant-ui behavior.
 - **Base UI is the active primitive base.** `components.json` must resolve through a Base style, currently `base-nova`, and `npx shadcn@latest info --json` must report `base: "base"`. Do not reintroduce `radix-ui`, `@radix-ui/*`, or `vaul` to package source, dependencies, or app optimizer configuration. Registry-owned shadcn primitives stay aligned with current `shadcn@latest` Base UI output; use Base UI `render` composition instead of Radix `asChild`. `cmdk` is allowed only for the stock shadcn Command component while the current `base-nova` registry declares that dependency; do not use it elsewhere or replace it without a shadcn/compatibility decision and tests.
 - **Named shadcn blocks stay named.** When a user, plan, or issue selects a shadcn block/example such as `login-02`, `signup-02`, `dashboard-01`, or `sidebar-*`, use that registry item as the source of truth through shadcn CLI/MCP. Do not replace it with a package-authored abstraction unless the plan explicitly records the substitution, the reason, and the true consumer route that proves it.
-- **Public surface changes require a release decision.** Any change to exported components, `src/index.ts`, `src/ai-elements.ts`, package `exports`, `globals.css`, theme behavior, package docs, package skills, or design-system token/CSS/theme output consumed by this package must end with an explicit npm release decision before handoff: bump the relevant version(s) and run `npm pack --dry-run -w @nadicodeai/ui` per `../../../docs/internal/npm-publishing.md`, or include a `[no-publish]` commit marker with the reason in the commit body. The pre-push gate requires one of the two. When the UI change depends on modified `@nadicodeai/design-system` output, bump and publish `@nadicodeai/design-system` first, then update this package's dependency and publish UI. Never claim a UI package change is shipped until `npm view @nadicodeai/ui version` reports the intended version.
+- **Public surface changes require a release decision.** Any change to exported components, `src/index.ts`, package `exports`, `globals.css`, theme behavior, package docs, package skills, or design-system token/CSS/theme output consumed by this package must end with an explicit npm release decision before handoff: bump the relevant version(s) and run `npm pack --dry-run -w @nadicodeai/ui` per `../../../docs/internal/npm-publishing.md`, or include a `[no-publish]` commit marker with the reason in the commit body. The pre-push gate requires one of the two. When the UI change depends on modified `@nadicodeai/design-system` output, bump and publish `@nadicodeai/design-system` first, then update this package's dependency and publish UI. Never claim a UI package change is shipped until `npm view @nadicodeai/ui version` reports the intended version.
 
 ## Admission Rules
 
-Agent work surfaces (chat, composer, tool approval, artifacts, threads, diffs, terminal/file preview, and the underlying agent state models) are NadicodeAI core domain. They belong in this package outright, not behind a named consumer. Any other new product composition (a shell, a settings surface, a generic section) is admitted only with a named consuming surface landing in the same change. Genuinely app-bespoke UI (window chrome, boot/install overlays, mascots, PTY/xterm embeds) stays in the consuming app; it never becomes a package abstraction. A component left unconsumed after its target migration ships gets removed.
+Agent presentation and runtime APIs enter through `@nadicodeai/ui/agents`; the consuming application still constructs the runtime and owns transport, persistence, permissions, tools, approvals, and failure policy. Shared non-Agent product components (a shell, a settings surface, a generic section, a diff, or a file preview) are admitted only with a named consuming surface landing in the same change. App-bespoke UI and behavior (window chrome, boot/install overlays, mascots, PTY/xterm embeds, queues, approvals, and persistence) stay in the consuming app; they never become package abstractions. A component left unconsumed after its target migration ships gets removed.
 
-- **Standard components, not app-owned product features.** This package ships primitives, standard UI components, AI Elements, brand adapters, React adapters, reusable sections, and presentational product components. It must not ship app-specific feature/use-case screens or names such as operator-login, portal activation, customer credential control, or customer management. Generic data tables, command palettes, and chart cards are app-owned shadcn registry adaptations. The source-backed `chart-*` package surface is the plan-approved exception per issue #166 and ADR 0010; chart cards remain app-owned. Every data-shaped chart exposes an equivalent non-visual data alternative. A component whose complete value is already available in visible text or `aria-valuetext` does not add a redundant table.
+- **Standard components, not app-owned product features.** This package ships primitives, standard UI components, assistant-ui compositions, brand adapters, React adapters, reusable sections, and presentational product components. It must not ship app-specific feature/use-case screens or names such as operator-login, portal activation, customer credential control, or customer management. Generic data tables, command palettes, and chart cards are app-owned shadcn registry adaptations. The source-backed `chart-*` package surface is the plan-approved exception per issue #166 and ADR 0010; chart cards remain app-owned. Every data-shaped chart exposes an equivalent non-visual data alternative. A component whose complete value is already available in visible text or `aria-valuetext` does not add a redundant table.
 - **Auth routes are consumer-owned shadcn block work.** Login, signup, OTP, two-factor, magic-link, and provider-button flows start from the selected shadcn block/example in the consuming app, with app-owned Better Auth behavior. Do not ship generic auth, signup, OTP, federated-login, or provider abstractions from this package unless a later explicit boundary decision replaces the selected shadcn block.
 - **Reusable sections and compositions live here after proof.** Bento grids, media mounts, demo surfaces, page frames, section intros, CTA bands, proof slots, benefits grids, generic shells, and homepage/use-case sections belong in `@nadicodeai/ui` when a second concrete consumer, a plan-approved shared component, or a named validation slice proves the package boundary. Website, portal, and sibling Nadia routes pass data and media children into existing compositions instead of rebuilding layout locally.
 - **Brand renderers live here for React consumers.** Logo geometry, asset generation, and usage semantics are owned by [`design-system/DESIGN.md`, "Brand media authority"](../../../design-system/DESIGN.md#brand-media-authority). `BrandLockup` supplies the approved horizontal lockup. `BrandMark` serves tight spaces and `BrandWordmark` serves placements where the name must read by itself. All three render the package's public neutral geometry seam with React-scoped SVG ids, dynamic theme paint, and accessible names. Consuming routes use these adapters; they never import raw logo assets, draw brand SVG inline, mask or recolor assets, or create another lockup rule.
+- **Third-party brand marks are generated, never hand-drawn and never hand-edited.** Other companies' marks live in `@nadicodeai/ui/src/components/brand-icons/`, emitted from an explicit allow-list by `@nadicodeai/ui/scripts/build-brand-icons.mjs` and exported through the `@nadicodeai/ui/components/brand-icons` subpath. They are identity images, not UI icons: a brand mark is exempt from the currentColor stroke system and from the raw-literal rule, it never stands in for a UI icon, and a UI icon never stands in for a brand. Marks drawn as one silhouette are stripped to `currentColor` by the generator; every other mark keeps its official colors verbatim. To add a brand, edit the generator's allow-list and run `npm run generate:brand-icons -w @nadicodeai/ui`; hand edits to the generated directory are lost and `@nadicodeai/ui/tests/guards/brand-icons-codegen.test.ts` fails on them. Use is nominative only — naming a platform, an integration, or a provider — never adjacent to endorsement or partnership wording. The full decision, including the licensing and trademark posture, is [ADR 0042](../../../docs/adr/0042-third-party-brand-marks-are-generated-identity-images.md).
 - **No fake proof APIs.** Components may support future testimonials, logos, stats, and proof slots, but they must render nothing public when the proof is absent. Do not ship placeholder customer names, metrics, or logos.
 
 ## Accessibility Invariant
@@ -38,8 +39,17 @@ The source tree, barrels, and package exports own the current reusable section v
 
 ## Consumer Boundary
 
-Consumers own routing, auth, app data, server actions, runtime adapters, permission decisions, analytics, and app-specific copy. The package owns the presentational structure and state vocabulary only. [`terminal-tui-semantics.md`](terminal-tui-semantics.md) owns TUI semantics.
+Consumers own routing, auth, app data, server actions, runtime construction and adapters, permission decisions, analytics, and app-specific copy. The package owns reusable React presentation and the public Agent UI dependency boundary. Agent state and behavior come through the Agents interface; non-React and TUI contracts belong to their consuming products.
 
 App source composes layout, data, behavior, and semantic content around package components. It does not restyle an imported component root: appearance changes enter through the component's typed variant or are added to the owning package component. App `className` values on package components are limited to structural layout and sizing. App source uses semantic roles such as `bg-background` and `text-foreground`; raw Tailwind palette colors and canonical `nc-*` color utilities stay behind package-owned primitives such as `BrandField`. Visible controls come from `@nadicodeai/ui`, while hidden inputs remain valid form transport. The root ESLint rules `nadicodeai/no-shadcn-appearance-override`, `nadicodeai/no-raw-color-utility`, and `nadicodeai/no-native-visible-control` enforce this boundary.
 
 When this package is read from an installed npm package, follow the [consumer setup guide](consuming-cross-repo.md) for setup and public import paths. The styling invariant above remains the authority for component implementation.
+
+The public strict ESLint config enforces only properties that can be decided
+from one source file and the installed generated tokens. It does not infer
+that two JSX trees represent the same product pattern. Repeated patterns stay
+governed by a named owning component, typed variants or slots, and explicit
+package or Portal-kit imports. A new repeated pattern is consolidated at its
+owner and pinned with a focused source or rendering test; generic JSX
+similarity warnings are outside this contract because they cannot distinguish
+valid domain composition from a fork without false positives.

package/docs/migration/base-ui-migration.md

@@ -10,7 +10,6 @@ Current invariants:
 - `@nadicodeai/ui/package.json` must not depend on `radix-ui`, `@radix-ui/react-use-controllable-state`, or `vaul`.
 - Website and portal Next config must optimize `@base-ui/react`, not `radix-ui`.
 - Public shadcn primitive usage follows the current Base UI registry API. Base UI composition uses `render`; do not add package-local `asChild` adapters for registry-owned primitives.
-- AI Elements use the package-local `useControllableState` helper instead of Radix's hook.
 
 ## Migration Catalog
 
@@ -26,16 +25,6 @@ Removed non-shadcn Radix carriers:
 
 - `command` stays backed by shadcn's stock `cmdk` implementation while the `base-nova` registry declares that dependency.
 - `drawer` replaces `vaul` with Base UI Drawer.
-- AI Elements replace `@radix-ui/react-use-controllable-state` with `src/hooks/use-controllable-state.ts`.
-
-AI Elements using the local controlled/uncontrolled helper:
-
-- `chain-of-thought`
-- `mic-selector`
-- `reasoning`
-- `stack-trace`
-- `transcription`
-- `voice-selector`
 
 ## Breaking in 0.5.0
 

package/docs/product-compositions.md

@@ -2,7 +2,7 @@
 
 U4 adds the first shared product compositions for NadicodeAI admin, settings, and agent-work surfaces. These components are presentational only: consumers own routing, persistence, server actions, mutations, analytics, auth providers, permissions, and product-specific page copy.
 
-When first-party shadcn or AI Elements registry source already covers the same
+When first-party shadcn or assistant-ui registry source already covers the same
 generic product UI, use that registry item in the consuming app instead of
 adding a parallel NadicodeAI package API. Data tables, command palettes, and
 chart cards follow this rule: use `@shadcn/data-table-demo`,

package/llms.txt

@@ -12,11 +12,11 @@ Use this file as a map; read the owning document before changing behavior.
 - Current component modules: `src/components/**/*.tsx` in the repository.
 - Current published subpaths: `package.json` `exports` plus the generated
   `dist/components/**/*.d.ts` declarations in an installed package.
-- Agent work surfaces: `docs/agent-work-surfaces.md`.
+- Public Agent UI interface: `src/agents.ts`, exported as `@nadicodeai/ui/agents`.
+- Maintained conversation implementation: `src/internal/assistant-ui/`.
 - Product compositions and sections: `docs/product-compositions.md` and
   `docs/product-sections.md`.
-- Terminal and TUI semantics: `docs/terminal-tui-semantics.md`.
-- Maintenance workflow and live shadcn or AI Elements discovery:
+- Maintenance workflow and live shadcn or assistant-ui discovery:
   `docs/agents/nadicodeai-ui.md`.
 
 The component inventory is source-backed and is not repeated in prose. Use the
@@ -29,14 +29,13 @@ Prefer explicit component subpaths:
 
 ```tsx
 import { Button } from "@nadicodeai/ui/components/button";
-import { Message } from "@nadicodeai/ui/components/ai-elements/message";
+import { AssistantRuntimeProvider, Thread } from "@nadicodeai/ui/agents";
 ```
 
-Use the root or AI Elements barrel when a barrel is more useful:
+Use the root barrel when it is more useful:
 
 ```tsx
 import { Button } from "@nadicodeai/ui";
-import { Message, PromptInput } from "@nadicodeai/ui/ai-elements";
 ```
 
 Read the generated declaration for the current export names and props. Do not

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/ui",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -14,22 +14,15 @@
       "import": "./dist/index.js"
     },
     "./globals.css": "./dist/styles/globals.css",
-    "./ai-elements": {
-      "types": "./dist/ai-elements.d.ts",
-      "import": "./dist/ai-elements.js"
+    "./eslint": "./dist/eslint/index.js",
+    "./agents": {
+      "types": "./dist/agents.d.ts",
+      "import": "./dist/agents.js"
     },
     "./hooks": {
       "types": "./dist/hooks/index.d.ts",
       "import": "./dist/hooks/index.js"
     },
-    "./lib/agent-contracts": {
-      "types": "./dist/lib/agent-contracts.d.ts",
-      "import": "./dist/lib/agent-contracts.js"
-    },
-    "./lib/agent-state": {
-      "types": "./dist/lib/agent-state.d.ts",
-      "import": "./dist/lib/agent-state.js"
-    },
     "./lib/utils": {
       "types": "./dist/lib/utils.d.ts",
       "import": "./dist/lib/utils.js"
@@ -53,8 +46,9 @@
   ],
   "scripts": {
     "dev": "node scripts/dev-build.mjs --watch",
-    "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/fix-dist-imports.mjs && node scripts/build-styles.mjs",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/fix-dist-imports.mjs && node scripts/build-styles.mjs && node scripts/build-eslint.mjs",
     "build:fast": "node scripts/dev-build.mjs",
+    "generate:brand-icons": "node scripts/build-brand-icons.mjs",
     "prepack": "npm run build",
     "lint": "eslint --max-warnings=0",
     "typecheck": "tsc --noEmit",
@@ -62,38 +56,28 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@assistant-ui/react": "0.15.1",
+    "@assistant-ui/react-markdown": "0.14.8",
     "@base-ui/react": "^1.6.0",
-    "@nadicodeai/design-system": "0.20.0",
-    "@rive-app/react-webgl2": "^4.29.1",
-    "@streamdown/cjk": "^1.0.3",
-    "@streamdown/code": "^1.1.1",
-    "@streamdown/math": "^1.0.2",
-    "@streamdown/mermaid": "^1.0.2",
-    "@xyflow/react": "^12.11.0",
-    "ai": "^6.0.208",
-    "ansi-to-react": "^6.2.6",
+    "@nadicodeai/design-system": "0.22.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "embla-carousel-react": "^8.6.0",
     "input-otp": "^1.4.2",
     "lucide-react": "1.21.0",
-    "media-chrome": "^4.19.2",
     "motion": "^12.40.0",
-    "nanoid": "^5.1.15",
     "next-themes": "^0.4.6",
     "react-day-picker": "^10.0.1",
     "react-hook-form": "^7.80.0",
-    "react-jsx-parser": "^2.4.1",
     "react-resizable-panels": "^4.11.2",
     "recharts": "^3.8.0",
-    "shiki": "^4.2.0",
     "sonner": "^2.0.7",
-    "streamdown": "^2.5.0",
+    "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.0.0",
-    "tokenlens": "^1.3.1",
     "tw-animate-css": "^1.4.0",
-    "use-stick-to-bottom": "^1.1.6"
+    "tw-shimmer": "0.4.12",
+    "zustand": "^5.0.14"
   },
   "peerDependencies": {
     "@tailwindcss/postcss": "^4.3.1",
@@ -102,6 +86,10 @@
     "tailwindcss": "^4.3.1"
   },
   "devDependencies": {
+    "@iconify-json/logos": "^1.2.11",
+    "@iconify/utils": "^3.1.4",
+    "@stryker-mutator/core": "9.6.1",
+    "@stryker-mutator/vitest-runner": "9.6.1",
     "@tailwindcss/postcss": "^4.3.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19",

package/skills/nadicodeai-ui/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: nadicodeai-ui
-description: Use when building or modifying NadicodeAI React UI with @nadicodeai/ui, shadcn components, or AI Elements.
+description: Use when building or modifying NadicodeAI React UI with @nadicodeai/ui, shadcn components, or assistant-ui.
 ---
 
 # NadicodeAI UI
 
-Use `@nadicodeai/ui` for shared NadicodeAI React UI. It ships built shadcn source components, Vercel AI Elements, React adapters over design-system grammar, reusable NadicodeAI marketing/section compositions, presentational product components, package CSS, and agent instructions. Product components are package surface only when source, public subpath exports, tests, and docs exist together.
+Use `@nadicodeai/ui` for shared NadicodeAI React UI. It ships built shadcn source components, the `@nadicodeai/ui/agents` interface, React adapters over design-system grammar, reusable NadicodeAI marketing/section compositions, presentational product components, package CSS, and agent instructions. Product components are package surface only when source, public subpath exports, tests, and docs exist together.
 
 The package is a flat shadcn-style source surface. Do not create or document
 folders or package namespaces that do not exist. Do not add top-level exports
@@ -27,29 +27,27 @@ Prefer direct subpaths:
 
 ```tsx
 import { Button } from "@nadicodeai/ui/components/button";
-import { Message } from "@nadicodeai/ui/components/ai-elements/message";
+import { AssistantRuntimeProvider, Thread, useLocalRuntime } from "@nadicodeai/ui/agents";
 ```
 
 Use barrels when helpful:
 
 ```tsx
 import { Button, PageFrame } from "@nadicodeai/ui";
-import { Message, PromptInput } from "@nadicodeai/ui/ai-elements";
 ```
 
 Product component imports:
 
 ```tsx
 import { DashboardShell } from "@nadicodeai/ui/components/dashboard-shell";
-import { AgentChat } from "@nadicodeai/ui/components/agent-chat";
+import { Thread } from "@nadicodeai/ui/agents";
 ```
 
 ## Product Components
 
-- Use package product components for shared settings, shell, installer, plugin-boundary, agent chat, artifact, file, diff, and redacted terminal summary UI.
+- Use `@nadicodeai/ui/agents` for Agent presentation, runtime primitives, providers, hooks, and types. Do not import assistant-ui packages directly or recreate their behavior.
 - Use first-party shadcn registry source in the consuming app for generic data tables, command palettes, and chart cards; do not import a NadicodeAI package abstraction for those patterns.
 - Keep routes, data, auth, server actions, persistence, permission decisions, runtime adapters, analytics, and product-specific copy in the consuming app.
-- Render TUI surfaces through `docs/terminal-tui-semantics.md`.
 - Fixtures must be synthetic or redacted and cover provider, model, plugin, approval, diff, terminal, installer recovery, queued, streaming, and interrupted states. Do not use generic SaaS/card-grid filler, secrets, environment values, raw terminal output, hidden reasoning, user memory, fake customers, or fake proof metrics.
 
 ## Forms

package/dist/ai-elements.d.ts

@@ -1,49 +0,0 @@
-export * from "./components/ai-elements/agent";
-export * from "./components/ai-elements/artifact";
-export * from "./components/ai-elements/attachments";
-export * from "./components/ai-elements/audio-player";
-export * from "./components/ai-elements/canvas";
-export * from "./components/ai-elements/chain-of-thought";
-export * from "./components/ai-elements/checkpoint";
-export * from "./components/ai-elements/code-block";
-export * from "./components/ai-elements/commit";
-export * from "./components/ai-elements/confirmation";
-export * from "./components/ai-elements/connection";
-export * from "./components/ai-elements/context";
-export * from "./components/ai-elements/controls";
-export * from "./components/ai-elements/conversation";
-export * from "./components/ai-elements/edge";
-export * from "./components/ai-elements/environment-variables";
-export * from "./components/ai-elements/file-tree";
-export * from "./components/ai-elements/image";
-export * from "./components/ai-elements/inline-citation";
-export * from "./components/ai-elements/jsx-preview";
-export * from "./components/ai-elements/message";
-export * from "./components/ai-elements/mic-selector";
-export * from "./components/ai-elements/model-selector";
-export * from "./components/ai-elements/node";
-export * from "./components/ai-elements/open-in-chat";
-export * from "./components/ai-elements/package-info";
-export * from "./components/ai-elements/panel";
-export * from "./components/ai-elements/persona";
-export * from "./components/ai-elements/plan";
-export * from "./components/ai-elements/prompt-input";
-export * from "./components/ai-elements/queue";
-export * from "./components/ai-elements/reasoning";
-export * from "./components/ai-elements/sandbox";
-export * from "./components/ai-elements/schema-display";
-export * from "./components/ai-elements/shimmer";
-export * from "./components/ai-elements/snippet";
-export * from "./components/ai-elements/sources";
-export * from "./components/ai-elements/speech-input";
-export * from "./components/ai-elements/stack-trace";
-export * from "./components/ai-elements/suggestion";
-export * from "./components/ai-elements/task";
-export * from "./components/ai-elements/terminal";
-export * from "./components/ai-elements/test-results";
-export * from "./components/ai-elements/tool";
-export * from "./components/ai-elements/toolbar";
-export * from "./components/ai-elements/transcription";
-export * from "./components/ai-elements/voice-selector";
-export * from "./components/ai-elements/web-preview";
-//# sourceMappingURL=ai-elements.d.ts.map