HoneyHive plugin

• Authentication: HoneyHive routes accept different key types, so the connection holds up to three keys, each sent as Authorization: Bearer <key>:
  • api_key: a classic project API key (hh_..., Settings > Project > API Keys > Project). Used by sessions, event ingestion and updates, metrics, configurations and the legacy (non-project-scoped) dataset, run and event routes.
  • data_plane_api_key (account field, optional): a data plane fine-grained key (hh_fgdp_...). Required by the project-scoped operations that take a project_id (datasets.list, experiments.getRun, events.search and the rest); HoneyHive rejects a classic key there.
  • control_plane_api_key (account field, optional): a control plane fine-grained key (hh_fgcp_..., Settings > Workspace > API Keys > Control Plane). Required by projects.*, which run on https://api.cp.us.honeyhive.ai.
  • A connection with only fine-grained keys works for the operations those keys cover; operations that need the classic key raise AuthMissingError instead of sending a fine-grained key.
• Dedicated or self-hosted data plane: set the base_url account field to your project’s Data plane URL (default https://api.dp1.us.honeyhive.ai, shown under Settings > Project > API Keys).
• Tracing & Sessions: Group multi-step agent and tool spans into sessions with sessions.create and stream event batches with sessions.createEventBatch or events.createBatch.
• Datasets & Experiments: Curate evaluation datasets and run automated test suites across prompts, configurations, and models.
• Evaluators & Metrics: Define custom metrics, deploy metric version snapshots, and run automated evaluations against trace events.

• 49 typed API operations

Setup

npm install corsair @corsair-dev/honeyhive better-sqlite3
npm install --save-dev @types/better-sqlite3

yarn add corsair @corsair-dev/honeyhive better-sqlite3
yarn add --dev @types/better-sqlite3

pnpm install corsair @corsair-dev/honeyhive better-sqlite3
pnpm install --save-dev @types/better-sqlite3

bun add corsair @corsair-dev/honeyhive better-sqlite3
bun add --dev @types/better-sqlite3

import Database from 'better-sqlite3';
import { createCorsair } from 'corsair';
import { honeyhive } from '@corsair-dev/honeyhive';

export const corsair = createCorsair({
	plugins: [
		honeyhive(),
	],
	database: new Database('corsair.db'),
	kek: process.env.CORSAIR_KEK!,
	multiTenancy: true,
	hub: {
		projectApiKey: process.env.CORSAIR_API_KEY!,
		signingSecret: process.env.CORSAIR_SIGNING_SECRET!,
	},
});

honeyhive()

const { connectUrl } = await corsair.manage.connect.createLink({
	plugin: 'honeyhive',
	tenantId: 'acme',
});
// redirect the user's browser to connectUrl

Example API calls

const tenant = corsair.withTenant('acme');
await tenant.honeyhive.api.metrics.list({});

const tenant = corsair.withTenant('acme');
await tenant.honeyhive.api.sessions.create({ session_name: 'customer-support-agent' });

What’s next