AgentExperience.Core 0.1.0-preview.7

AgentExperience.Core

Preview — not production ready. This is a 0.1.0-preview package, and it claims no production readiness. Public APIs may change between previews. Read Known limits and documented boundaries before you rely on it.

The engine of AgentExperience.NET. It turns what an agent observably did into a verified, auditable lesson, keeps that lesson's lifecycle and confidence honest, and finds it again when similar work comes up. It does not talk to a database or a model itself: storage comes from an adapter such as AgentExperience.Storage.Postgres, and agent integration from AgentExperience.MicrosoftAgentFramework.

Dependencies: AgentExperience.Abstractions, Microsoft.Extensions.Compliance.Redaction, and Microsoft.Extensions.DependencyInjection.Abstractions (abstractions only — no container, no hosting). No Microsoft Agent Framework, EF Core, Npgsql, DbUp, OpenTelemetry SDK, or model-provider package. Targets net10.0.

What is in it

Wiring it

using AgentExperience.Core.DependencyInjection;

services.AddAgentExperienceCore(sanitizationOptions, captureLimits);
// -> ISanitizer, IExperienceCaptureService, IExperienceReflector,
//    ExperienceLifecycleService, ExperienceFinalizationService
services.AddSingleton(new ExperienceIndependenceOptions
{
    AssessmentTokenKey = secrets.AssessmentTokenKey,   // >= 32 random bytes, from your secret store
});                                                     // optional: without it, human evidence is refused
// AssessmentTokenIssuer is deliberately not registered: construct it in your review flow, where a person decides.
services.AddAgentExperienceIndexing();       // optional: needs an IExperienceEmbeddingIndex and generator
services.AddAgentExperienceRetrieval();      // ExperienceRetrievalService
// Optional seams, picked up from the container in any order (register as singletons):
//   IEnvironmentCompatibilityScorer  grades a request's PreferredEnvironmentAttributes
//   ConfidenceDecayPolicy            per-domain confidence half-lives, applied only when ranking
//   IExperienceConfidenceEngine      replaces the default (1+S)/(2+S+F) confidence heuristic
services.AddAgentExperienceReuseFeedback();  // needs an IExperienceReuseFeedbackStore

Every registration uses TryAdd, so a host's own implementation wins. The storage ports come from an adapter. The lifecycle service verifies confidence independence by default and counts the registered capture service's runs as known; ExperienceIndependenceOptions carries the assessment token key, the token lifetime (a day by default), the clock, and the opt-out. The full wiring for every package is in Deployment.

What Core never does

• It never decides policy on the host's behalf. Authorization (AuthorizationContext), the storage decision, and the injection risk decision all travel in the request; Core obeys them.
• It never throws for an expected outcome. Finalization, retrieval, indexing, and feedback return structured results; retrieval is bounded by a timeout (500 ms by default) that is never an exception.
• It never makes a completion score into reuse confidence. Confidence is a versioned score over independent evidence, by default the (1 + S) / (2 + S + F) heuristic (the engine is replaceable), — useful for ranking, not a calibrated probability.
• It never stores hidden reasoning. Only observable evidence, sanitized at capture.

Limits to know

Confidence independence is the one documented boundary that lives mostly in this package (KL-11): verification proves a run was given a lesson, not that the lesson mattered, and the library believes the host's own bookkeeping and key custody. IndependenceVerification.TrustHostSuppliedIdentifiers turns verification off for a host that cannot adopt it; what it admits is stored as HostTrusted and can be excluded on read. Read Confidence and independence before relying on a score.

Telemetry is emitted through the BCL's ActivitySource and Meter named AgentExperience.Core; the host subscribes and exports. Every span, instrument, dimension and attribute is in the telemetry contract.

The public surface of this package is pinned by an approval baseline in the repository, so any change to it is a reviewed diff. Breaking changes between previews are listed in the changelog.

More

• Documentation: guide and glossary
• License: Apache-2.0