@agentskit/observability — for agents

Install

npm install @agentskit/observability

Primary exports

Loggers / tracers

• consoleLogger(config?) — local dev logging.
• langsmith(config) — LangSmith observer.
• opentelemetry(config) — OTel observer.
• createTraceTracker({ onSpanStart, onSpanEnd }) — low-level span lifecycle.

Guards + counters

• costGuard(options) — dollar ceiling per run.
• priceFor, computeCost, DEFAULT_PRICES.
• approximateCounter, countTokens, countTokensDetailed, createProviderCounter.

Local trace viewer

• createFileTraceSink(dir), buildTraceReport, renderTraceViewerHtml. See Trace viewer.

Devtools server

• createDevtoolsServer, toSseFrame. See Devtools server.

Signed audit log

• createSignedAuditLog, createInMemoryAuditStore. Hash-chain + HMAC. See Audit log.

Minimal example

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

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

Related

• @agentskit/eval
• @agentskit/runtime

Source

• npm: https://www.npmjs.com/package/@agentskit/observability
• repo: https://github.com/AgentsKit-io/agentskit/tree/main/packages/observability