@frontal-labs/agents

Define, deploy, and observe AI agents with LangChain, LangGraph, and Vercel AI SDK integration.

Installation

npm install @frontal-labs/agents

@frontal-labs/core is included automatically as a dependency.

Quick Start

import { agents } from "@frontal-labs/agents";

const page = await agents.list({ limit: 10 });

The agents singleton reads FRONTAL_API_KEY and FRONTAL_AGENTS_API_URL from the environment.

Usage

Explicit config

import { createAgentsClient } from "@frontal-labs/agents";

const agents = createAgentsClient({
  apiKey: process.env.FRONTAL_API_KEY!,
  baseUrl: "https://api.frontal.dev/v1",
});

const agent = await agents.create({
  name: "order-ops",
  triggers: [{ event: "order.created" }],
  confidence: { autoExecuteAbove: 0.9, escalateBelow: 0.6 },
  memory: { type: "working" },
});

Shared client (multiple SDKs)

import { FrontalClient } from "@frontal-labs/core";
import { createAgentsClient } from "@frontal-labs/agents";

const client = new FrontalClient({
  apiKey: process.env.FRONTAL_API_KEY!,
  baseUrl: "https://api.frontal.dev/v1",
});

const agents = createAgentsClient(client);

Builder API

const agent = await agents
  .define("ticket-triager")
  .description("Classifies and routes support tickets")
  .trigger("support.ticket.created")
  .tags("support", "triage")
  .create();

Run and watch

// Starting a run returns the run; watch it via SSE.
const run = await agents.use(agent.id).message("support.ticket.created", {
  ticketId: "t_987",
  text: "Payment failed after plan upgrade",
});

for await (const event of agents.use(agent.id).watch(run.id)) {
  console.log(event.type, event.data);
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | FRONTAL_API_KEY | Yes | — | Frontal API authentication key | | FRONTAL_API_URL | No | https://api.frontal.dev/v1 | Base URL for the Frontal API | | FRONTAL_ENV | No | development | Runtime environment (development, test, production) | | FRONTAL_DEBUG | No | false | Enable debug logging |