Core hooks, types, and utilities for building AI-powered agent interfaces.
npm install @arcteninc/coreCore hooks, types, and utilities for building AI-powered agent interfaces.
``bash`
npm install @arcteninc/coreor
yarn add @arcteninc/coreor
pnpm add @arcteninc/coreor
bun add @arcteninc/core
> Note: For the pre-built UI component (), install @arcteninc/ui instead. See @arcteninc/ui for details.
This package provides the headless building blocks for creating AI agent interfaces:
- useAgent - React hook for managing agent conversations, tool calls, and state
- useGenerate - React hook for one-off AI text/object generation
- Types - TypeScript types for tool definitions, conversations, and configurations
- Utilities - Helper functions like extractToolsMetadata
`tsx
import { useAgent } from "@arcteninc/core";
import type { UseAgentOptions } from "@arcteninc/core";
function MyCustomChat() {
const {
messages,
sendMessage,
status,
stop,
} = useAgent({
apiBaseUrl: "https://api.arcten.com",
user: { id: "user-123" },
tools: myTools,
});
return (
$3
`tsx
import { useGenerate } from "@arcteninc/core";function MyComponent() {
const { generateText, generateObject, isLoading } = useGenerate({
apiBaseUrl: "https://api.arcten.com",
});
const handleGenerate = async () => {
const result = await generateText({
prompt: "Write a haiku about coding",
});
console.log(result);
};
return ;
}
`Pre-built UI Component
If you want a ready-to-use chat interface, use the
@arcteninc/ui package:`bash
npm install @arcteninc/core @arcteninc/ui
``tsx
import { ArctenAgent } from "@arcteninc/ui";
import "@arcteninc/ui/styles";function App() {
return (
apiBaseUrl="https://api.arcten.com"
user={{ id: "user-123" }}
/>
);
}
`CLI Utilities
This package includes a utility for extracting tool metadata:
`bash
Extract tool types and metadata
npx arcten extract-typesOr specify a custom tools file
npx arcten extract-types --tools ./src/tools.ts
`Development
`bash
bun install # Install dependencies
bun run build # Build the package
bun run dev # Watch for changes
``