@fairway-kit/client

The frontend half of fairway, a dev kit for building local, agent-backed applications with durable, resumable chat. Depends on @fairway-kit/protocol for the shared event types and fold.

import { AgentChatClient } from "@fairway-kit/client";
import { ChatProvider, ChatPanel, ChatInput } from "@fairway-kit/client/react";
import "@fairway-kit/client/react/styles.css"; // optional default look

const client = new AgentChatClient("/api/chat");

export function Chat({ sessionId }: { sessionId: string }) {
  return (
    <ChatProvider client={client} sessionId={sessionId}>
      <div style={{ flex: 1, minHeight: 0 }}>
        <ChatPanel />
      </div>
      <ChatInput />
    </ChatProvider>
  );
}

Out of the box: token-level streaming, tool-call pills, inline tool-approval cards, a typing indicator, stick-to-bottom scrolling, optimistic sends, automatic reattach to in-flight responses on refresh, and stop. The components are headless (stable data-fairway-* attributes, optional stylesheet) with per-item-type render overrides, and the core (fold, SSE stream client, REST client) is framework-free. React is an optional peer dependency.

Pairs with the fairway-kit Python package (import fairway) on the backend. Full docs and a complete example app live in the repository.