@adonis-agora/agent
Version:
Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.
36 lines • 1.89 kB
TypeScript
/**
* `@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 { type ReactElement } from 'react';
import { type AgentProviderProps } from './core/provider.js';
export { type AgUiBackendOptions, 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 declare function AgentProvider(props: AgentProviderProps): ReactElement;
//# sourceMappingURL=index.d.ts.map