@arcteninc/core

Core hooks, types, and utilities for building AI-powered agent interfaces.

Installation

``bash
npm install @arcteninc/core


or

> Note: For the pre-built UI component (), install @arcteninc/ui instead. See @arcteninc/ui for details.

What's in this package

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

Usage

$3

`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 (


`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 Generate;
}
`

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

`bash
bun install # Install dependencies
bun run build # Build the package
bun run dev # Watch for changes
``