`@anvia/lens`

@anvia/lens is the native adapter between an Anvia application and Lens. It sends traces, evaluation results, and runtime scores and reads versioned managed datasets with the same project credentials.

Install

bash

pnpm add @anvia/core @anvia/lens zod

Set the Lens connection in the server environment:

bash

ANVIA_LENS_BASE_URL=https://lens.example.com
ANVIA_LENS_PUBLIC_KEY=pk_...
ANVIA_LENS_SECRET_KEY=sk_...

Then attach the observer:

import { Agent } from '@anvia/core'
import { LensClient } from '@anvia/lens'

const lens = new LensClient({
  serviceName: 'support-api',
  environment: 'production',
})
const tracing = lens.observer({ captureMode: 'safe' })
const pipelineTracing = lens.pipelineObserver({ captureMode: 'safe' })

const agent = new Agent({
  id: 'support',
  model: model,
  observability: {
    observers: { lens: tracing },
    primaryTrace: 'lens',
  },
})

Attach pipelineTracing through a Pipeline's constructor. Use the same observer name as the Agent's primaryTrace to store one trace containing Pipeline stages, Agent runs, generations, and tools.

Evaluations and datasets

One LensClient can create matching Agent and Pipeline observers, an evaluation reporter, and a managed-dataset client.

const lens = new LensClient()
const observer = lens.observer()
const reporter = lens.evalReporter({ includeMetadata: true })

try {
  // Attach observer to the target and pass reporter to runEvalSuite().
} finally {
  await lens.close()
}

Runtime scoring

await lens.score({
  id: feedbackId,
  traceId,
  name: 'user-feedback',
  value: liked ? 1 : 0,
  dataType: 'BOOLEAN',
  source: 'end_user',
})

Use runtime scores for end-user feedback or production checks that should remain observable beside the originating trace without running an eval suite.

Operational patterns

Keep secret keys in server-only environment variables.
Begin with safe capture and enable full payloads only after reviewing data policy.
Add custom redaction patterns for application-specific identifiers.
Flush short-lived scripts before process exit; shut down long-lived services during graceful termination.
Pin a dataset version when a CI result must be reproducible.

Compatibility

@anvia/lens requires Node.js 24 or newer and peers with @anvia/core. It exports telemetry through HTTP and therefore needs network access to the configured Lens deployment.

@anvia/lens ​

Install ​

Evaluations and datasets ​

Runtime scoring ​

Operational patterns ​

Compatibility ​