teckel-ai

TypeScript SDK for Teckel AI an agentic monitoring platform for tracking behavior and improving AI output.

Install

npm install teckel-ai

Quick Start

import { TeckelTracer } from 'teckel-ai';

const tracer = new TeckelTracer({ apiKey: process.env.TECKEL_API_KEY });

tracer.trace({
  query: "How do I reset my password?",
  response: "Go to Settings > Security...",
  documents: [{ id: "doc-1", name: "Password Guide", text: "To reset..." }]
});

// Serverless: flush before returning
await tracer.flush();

OpenTelemetry Integration

Capture detailed spans from AI SDK calls:

import { TeckelTracer } from 'teckel-ai';
import { TeckelSpanCollector } from 'teckel-ai/otel';

const tracer = new TeckelTracer({ apiKey: process.env.TECKEL_API_KEY });
const spanCollector = new TeckelSpanCollector();

const result = await generateText({
  model: openai('gpt-5-mini'),
  prompt: userQuery,
  experimental_telemetry: {
    isEnabled: true,
    tracer: spanCollector.getTracer()
  }
});

const spans = spanCollector.getSpans();

// Tokens auto-aggregated from spans!
tracer.trace({
  query: userQuery,
  response: result.text,
  spans
});

await spanCollector.shutdown();

Requires: npm install @opentelemetry/api @opentelemetry/sdk-trace-base

Documentation

Full documentation at docs.teckel.ai:

• Getting Started
• TypeScript SDK Reference
• OpenTelemetry Integration
• HTTP API Reference

License

MIT