@agentskit/observability

When to reach for it

• You need console / LangSmith / OpenTelemetry logging.
• You want an offline HTML trace viewer.
• You want a hard dollar ceiling (costGuard).
• You want a tamper-evident audit log (SOC 2 / HIPAA friendly).
• You want a live devtools feed (browser extension compatible).

Install

npm install @agentskit/observability

Hello world

import { consoleLogger, costGuard } from '@agentskit/observability'
import { createRuntime } from '@agentskit/runtime'

const runtime = createRuntime({
  adapter,
  observers: [consoleLogger(), costGuard({ maxUsd: 0.5 })],
})

Surface

• Loggers: consoleLogger · langsmith · opentelemetry.
• Tracing: createTraceTracker · createFileTraceSink · buildTraceReport · renderTraceViewerHtml.
• Cost + tokens: costGuard · priceFor · computeCost · DEFAULT_PRICES · approximateCounter · countTokens · countTokensDetailed · createProviderCounter.
• Audit: createSignedAuditLog · createInMemoryAuditStore.
• Devtools: createDevtoolsServer · toSseFrame.

Recipes

• Cost-guarded chat
• Trace viewer
• Devtools server
• Audit log

Related

• Observability (deep dive)
• Security
• For agents: observability

Source

npm: @agentskit/observability · repo: packages/observability