@adonis-agora/agent/dist/src/react/index.js

Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.

/**
 * `@adonis-agora/agent/react` — the React layer for an AdonisJS app (Inertia or a separate SPA).
 *
 * The hooks, transport, and transcript model are implemented by this package.
 * Install React, `ai`, and `@ai-sdk/react` to use this entry.
 *
 * What is Adonis's own is the connection: {@link AgentProvider} and {@link createAgentClient} talk
 * to the routes the provider mounts (`/agent` unless `config/agent.ts` says otherwise) with the
 * session cookie, and send `@adonisjs/shield`'s CSRF token on every request — so the whole setup is
 *
 * ```tsx
 * import { AgentProvider, useAgentChat } from '@adonis-agora/agent/react'
 *
 * <AgentProvider><Chat /></AgentProvider>          // once, around the page
 * const chat = useAgentChat()                      // anywhere below it
 * ```
 */
import { createElement, useCallback, useRef } from 'react';
import { withCsrf } from './client.js';
import { AgentProvider as BaseAgentProvider } from './core/provider.js';
export { agUiBackend, agUiChatStream } from './ag-ui.js';
export { createAgentClient } from './client.js';
export * from './core/index.js';
export { csrfHeaders, readCookie } from './csrf.js';
/**
 * The agent connection, once, around whatever renders a chat. Every hook below it — `useAgentChat`,
 * `useThreads`, `useAttachments`, `useModels`, `useQuota`, `useToolCatalog`, `useMessageFeedback` —
 * talks to it.
 *
 * Takes everything the local React adapter's provider takes, with AdonisJS defaults: routes
 * under `/agent` (pass `path` when `config/agent.ts` sets another), the session cookie, and the
 * shield CSRF token added to `getHeaders` (yours are merged over it). A hook used OUTSIDE a provider
 * falls back to a plain client that sends no CSRF token, which shield refuses on every `POST` —
 * mount the provider.
 */
export function AgentProvider(props) {
    const { getHeaders, credentials, children, ...rest } = props;
    const own = useRef(getHeaders);
    own.current = getHeaders;
    const headers = useCallback(() => withCsrf(own.current), []);
    return createElement(BaseAgentProvider, { credentials: credentials ?? 'same-origin', ...rest, getHeaders: headers }, children);
}
//# sourceMappingURL=index.js.map