agentfootprint/dist/esm/observability-providers.d.ts

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

/**
 * observability-providers — vendor observability strategies.
 *
 * Grouped subpath following the parallel-providers pattern v2.5
 * established for `llm-providers` / `tool-providers` /
 * `memory-providers`. Adding a new vendor adds an export here, NOT
 * a new subpath — keeps `package.json#exports` from sprawling.
 *
 * Each adapter lazy-imports its vendor SDK via `lib/lazyRequire.ts`,
 * so consumers who never call a particular factory don't have to
 * install that SDK. Peer-deps are declared in package.json with
 * `peerDependenciesMeta.{name}.optional = true`.
 *
 * @example
 * ```ts
 * import { agentcoreObservability } from 'agentfootprint/observe';
 * import { microtaskBatchDriver } from 'footprintjs/detach';
 *
 * agent.enable.observability({
 *   strategy: agentcoreObservability({
 *     region: 'us-east-1',
 *     logGroupName: '/agentfootprint/my-agent',
 *   }),
 *   // Recommended — keeps the agent loop unblocked by network latency.
 *   detach: { driver: microtaskBatchDriver, mode: 'forget' },
 * });
 * ```
 *
 * Roadmap:
 *   - agentcoreObservability   ← v2.8.1
 *   - cloudwatchObservability  ← v2.8.2
 *   - xrayObservability        ← v2.8.3
 *   - otelObservability        ← v2.9.0
 *   - fileObservability        ← 9.8.0 (no vendor at all — NDJSON on disk,
 *                                 for the on-premises shop with no collector)
 *
 * Note: `datadogObservability` was on the v2.9 roadmap, but Datadog
 * APM accepts OTLP — point your OTel SDK at Datadog's OTLP endpoint
 * and `otelObservability` covers the Datadog use case. We'll ship a
 * dedicated `dd-trace`-based adapter only if real-world feedback
 * demands the native Datadog APM client.
 *
 * Not an import path of its own since 9.0.0. This is the implementation barrel
 * behind `agentfootprint/observe`, which re-exports every name here — same
 * symbols, one door. Import from the door.
 */
export { agentcoreObservability, agentCoreEvaluationSpans, AGENTCORE_EVALUATIONS_SCOPE_NAME, type AgentcoreObservabilityOptions, } from './adapters/observability/agentcore.js';
export { cloudwatchObservability, type CloudwatchObservabilityOptions, } from './adapters/observability/cloudwatch.js';
export { xrayObservability, type XrayObservabilityOptions, type XRayLikeClient, } from './adapters/observability/xray.js';
export { otelObservability, type OtelObservabilityOptions, type OtelObservabilityStrategy, type OtelDecisionEvidenceRecorder, type OtelTracerLike, type OtelSpanLike, type OtelSpanOptions, type OtelAttributeValue, } from './adapters/observability/otel.js';
export { fileObservability, type FileObservabilityOptions, type FileSinkFs, } from './adapters/observability/file.js';
export { auditExport, verifyAuditBundle, AUDIT_BUNDLE_FORMAT, AUDIT_GENESIS_EVENT_TYPE, AUDIT_ZERO_HASH, type AuditBundle, type AuditBundleHeader, type AuditExportOptions, type AuditExportStrategy, type AuditRecord, type AuditVerifyResult, } from './adapters/observability/audit.js';
export { canonicalJson, CANONICAL_JSON_VERSION } from './lib/canonicalJson.js';
export { githubBugReporter, type BugReporter, type FiledBugReport, type GithubBugReporterOptions, } from './adapters/observability/githubBugReporter.js';
export { githubDeviceSignIn, type GithubDeviceIdentity, type GithubDeviceSignIn, type GithubDeviceSignInOptions, } from './adapters/observability/githubDeviceSignIn.js';