Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

1.9 KB
Raw Blame

Compatibility

Peer and dependency ranges for @truefoundry/trueforge-ui (see package.json for authoritative versions).

Status: this package is 0.x and APIs may change.

Required peers

Package Range
react / react-dom ^18 || ^19

Install once at the app root.

Bundled dependencies (installed with the SDK)

Package Range
@assistant-ui/core ^0.2.22
@assistant-ui/react ^0.14.24
@truefoundry/trueforge-assistant-ui-runtime workspace release
lucide-react ^0.562.0

@assistant-ui/* are also listed as optional peers so hosts that install them directly for customization stay on a compatible range.

The runtime is wired by TrueForgeChatProvider and re-exported for advanced use. lucide-react supplies default UI icons via IconRegistry; hosts may override via theme.icons or register custom SVGR components.

Optional direct install (customization)

Chrome hooks (useAui, useAuiState, useTheme) are re-exported from @truefoundry/trueforge-ui — prefer those so the host shares the SDK instance.

When importing deep @assistant-ui/react primitives or @assistant-ui/core from host code, also add them as direct dependencies at versions within the ranges above so resolution is app-rooted. Force a singleton (Vite dedupe, Yarn resolutions, npm overrides) so the SDK and host share one copy — see README Troubleshooting.

Singletons

These must resolve to one physical copy in the dependency graph:

  • react / react-dom
  • @assistant-ui/core / @assistant-ui/react / @assistant-ui/store