intentkit-observe

Observability middleware for IntentKit — captures every function call with timing, errors, and events.

Install

npm install intentkit-observe

Usage

import { IntentRegistry } from 'intentkit';
import { createObserve } from 'intentkit-observe';

const registry = new IntentRegistry().register(/* your functions */);

// Create the observe instance
const observe = createObserve({
  storage: 'memory',         // or 'sqlite' for persistence
  // connectionString: './observe.db',  // required for sqlite
  // capturePayloads: true,             // capture input/output snapshots
  // maxPayloadSize: 1024,              // truncate snapshots
  // retentionDays: 30,                 // sqlite retention cleanup
});

// Register the middleware
registry.use(observe.middleware);

// Query telemetry data
const stats = await observe.query.functionStats();
const recent = await observe.query.recentCalls({ limit: 10, status: 'error' });
const errors = await observe.query.errorBreakdown({ since: '2026-03-01' });
const roles = await observe.query.roleStats();

// Cleanup on shutdown
await observe.destroy();

License

MIT