@lumin-io/sdk

TypeScript SDK for Lumin — the local-first AI agent observability stack.

import { trace, span, session } from '@lumin-io/sdk';

const myAgent = trace(async (q: string) => {
  // your agent code
  return result;
}, { name: 'my_agent' });

Install

npm install @lumin-io/sdk

Framework integrations

For Mastra users:

npm install @lumin-io/mastra

See the @lumin-io/mastra package for usage. Drop-in replacement for @mastra/langfuse if you want local-first observability without sending data to a hosted SaaS.

For Anthropic Claude users (extended thinking visualization):

import Anthropic from '@anthropic-ai/sdk';
import { instrumentAnthropic } from '@lumin-io/sdk/integrations/anthropic';

const client = new Anthropic();
instrumentAnthropic(client);

License

Apache-2.0.