Anvia

@anvia/lens API reference ​

ts
import {
  LensClient,
  LensDatasetError,
  resolveLensConfig,
  createLensRedactor,
  DEFAULT_PATTERNS,
} from '@anvia/lens'

LensClient ​

ts
const lens = new LensClient(options)
const observer = lens.observer(observerOptions)
const pipelineObserver = lens.pipelineObserver(observerOptions)
const reporter = lens.evalReporter<Input, Output, Expected>(reporterOptions)
const datasets = lens.datasetClient(datasetOptions)
await lens.score(scoreArgs)

await lens.flush()
await lens.close()

Client options include baseUrl, publicKey, secretKey, serviceName, environment, release, timeoutMs, captureMode, captureMaxBytes, redactInputs, redactOutputs, redactErrors, redactMetadata, custom redaction, and optional. baseUrl is validated eagerly as an absolute HTTP(S) URL without a query or fragment. The readonly enabled flag is false only when optional mode has no configured connection.

observer() returns an AgentObserver. pipelineObserver() returns a PipelineObserver and shares the client's lazy provider and capture defaults. Both accessors return disabled no-op observers in optional mode and reject new work after the client closes.

evalReporter() returns an Anvia EvalReporter. It inherits the client's capture and redaction policy and accepts those settings as per-reporter overrides alongside traceObserver, publishInvalid, includeMetadata, includePayloads, and onMissingTrace.

score() accepts LensScoreArgs, validates the score, and queues a trace-correlated evaluation log through the client-owned logs provider. A disabled optional client treats it as a no-op. See Runtime scoring.

Managed datasets ​

ts
const dataset = await lens.datasetClient({ pageSize: 50 }).getDataset<Input, Expected>({
  name: 'support-cases',
  version: 'v2',
})

The returned LensDataset contains name, version, optional description and metadata, and normalized items. LensDatasetError exposes status and a stable code.

Redaction ​

createLensRedactor(options) returns the package redactor. Supplying custom patterns replaces DEFAULT_PATTERNS; include the defaults explicitly when both sets are required.

Public types ​

The package exports client, Agent and Pipeline observer, capture, redaction, evaluation-reporter, runtime-scoring, and dataset option/result types named with the Lens* prefix, including LensObserverOptions, LensPipelineObserverOptions, and LensScoreArgs.

Built for Anvia.