Repository navigation
HPD AI Framework 0.9.5
HPD-Agent 0.9.5
Release status
HPD-Agent 0.9.5 is a pre-1.0 stabilization release for additional compatibility
testing. The documented public API, serialized event contracts, persistence
formats, hosted DTOs and route names, and TUI integration contracts are candidates
for 1.0, but breaking changes remain possible before 1.0.0 is released.
Highlights
- OpenAPI 3.1-driven SDK generation for C#, TypeScript, Python, and Go, backed
by a deterministic, versioned SDK IR, conformance fixtures, and the invariant
HPD-Agent.Clientruntime for retries, resumable SSE, typed client tools, and
AOT-safe serialization. - Runtime extension schemas for tenant/application live events, durable events,
and trusted inputs, including persistent schema discovery, authorized schema
management, bounded JSON-schema validation, and typed generated SDK payloads. - Builder-owned agent and provider lifecycles.
- Source-generated application composition shared by ASP.NET and Native AOT hosts.
- Immutable event catalogs with explicit durable replay facts and live-only
diagnostics. - Builder-selected event durability overrides with required-durable protection
for recovery and authorization facts. - JSON-shape contract digests, canonical
SUBAGENT_*discriminators, and
store-independent delta coalescing. - Durable runtime extension events.
- Unified permission authorization and sandbox capability escalation.
- Bounded native tool-output projection and retrieval.
- Explicit native tool-output offloading through
[Offload], with immutable
session/thread-owned content bundles, sensitivity classification, and bounded
retrieval through the generatedContenttool. - Completed ToolHarness construction, middleware lifecycle, and retry contracts.
OnErrorAsyncobserves terminal model, function, iteration, turn, input,
runtime, and thread-fork failures exactly once.- Skill instances and script capabilities use validated factories, while
projection, generated-reference, and content-source plumbing stays internal. - Skill activation lasts for the current message turn; unsupported lifetime
modes and configuration were removed before the planned 1.0 freeze. - Configured middleware fails agent construction when a registry entry,
dependency, or constructor cannot be resolved. - Function, ToolHarness, and skill middleware scopes apply consistently to
function wrappers as well as before/after function hooks. - Provider-composition merging for packages that contribute different client
families to the same provider backend. - Managed
HPD-Agent.Audio.LiveKitpackaging with verifiedosx-arm64native
assets. - Structured
ProviderErrorInfodiagnostics for realtime user-transcript
failures. - A closed, checked-in audio public API inventory with no exported
V1/V2
type names. - Runtime/test plumbing such as fake providers, clocks, deterministic runners,
and in-memory sinks is internal toHPD-Agent.Audio. - A test-gated NuGet release path covering the client, provider-neutral MultiAgent
ASP.NET Core routes, and ASP.NET Core OpenAPI and evaluation integrations. - The coordinated package train releases HPD-Auth Core and ControlPlane before
HPD Base, then completes the remaining Auth, Base, Graph, and Agent packages
in dependency order. - Evaluation consumers get a reduced 1.0-candidate API surface, explicit structured-input
formatting, interpretation-aware pass rates, interpretation-aware CI policy
gates, factory-backed deterministic and red-team implementations, consistent
live evaluator policy defaults, persistence-failure diagnostics, stable
generated event-module names, and package-level quickstarts for batch, live,
storage, and hosted evaluation workflows. - MCP and OpenAPI packages expose only their documented consumer surfaces.
Generated-code bridges remain public for source generation but are hidden from
consumer IntelliSense; raw MCP runtimes and projection serializers are internal. - MCP and OpenAPI packages ship runnable setup, permission, authentication, and
response-shaping guidance instead of placeholder package documentation, plus a
central integration and public-API-boundary guide. - OpenAPI loading emits structured skipped-operation warnings and fails fast when
a source produces no operations, with explicitAllowEmptyCatalogopt-in. - Retry middleware now uses the selected provider's error handler for model
failures and package-owned handlers for function sources; OpenAPI responses use
their status andRetry-Afterclassification automatically. - Native AOT MCP publish-and-run validation is a dedicated CI gate.
- Backend-neutral Agent sandbox composition for Host Process, Host Containers,
and Apple Virtual Machine backends, with operating-system enforcement and
workspace access owned by HPD Environment. - Environment-owned verified ripgrep bundles for macOS arm64/x64 and Linux
x64/arm64, provisioned through the same process boundary as other workspace
commands with managed search as a compatibility fallback. - Bot adapters now preserve complete webhook responses, support mixed-host
registry mapping, expose consistent logging, and ship package-level setup guides. - Skill names are validated against cross-provider function-name constraints,
and malformed directory metadata reports the exact script and field. - Optional
net10.0HPD Base adapters provide restart-durable agent
definitions, session/thread journals, streaming-delta recovery, evaluation
scores and runs, immutable dataset versions, SCD-2 case history, and diffs.
Dataset persistence uses explicit AOT-safe codecs rather than reflection.
Error detail visibility
ErrorHandlingConfig.IncludeDetailedErrorsInChat defaults to true. Function and
model errors therefore include exception detail intended to help the model recover.
Production-facing agents whose tools can produce secrets, filesystem paths,
connection strings, or sensitive implementation details should explicitly set the
option to false.
Deliberate package exclusions
HPD-Agent.Studiofollows the separate Studio release process.HPD-Agent.Audio.LiveKitcurrently supports only the qualifiedosx-arm64
runtime. Unsupported runtime identifiers are packaged but fail closed.
Prerelease upstream dependencies
HPD-Agent.Providers.OpenAI and HPD-Agent.Providers.AzureAI retain
Azure.AI.OpenAI 2.9.0-beta.1. The latest stable Azure SDK, 2.1.0, does not
provide the service-version and pipeline options exposed by these providers.
HPD-Agent.Evaluations retains
Microsoft.Extensions.AI.Evaluation.NLP 10.11.0-preview.1.26513.7 because no
stable release of that package exists. These upstream prerelease dependencies
are intentional for 0.9.5 and the planned 1.0.0 release. HPD-owned public
contracts remain documented but pre-1.0.
Deprecated packages
HPD-Agent.ToolHarness.FileSystemis deprecated. It remains available for a
migration window but is not a supported workspace-isolation or
command-execution security boundary. Public harness types emit compiler
warningCS0618. UseHPD-Agent.ToolHarness.Codingfor trusted coding
workspaces or an HPD sandbox runtime for untrusted workloads.
Upgrade
Applications should create agents through AgentBuilder. Consumers using the
former public direct constructor must migrate provider, middleware, content-store,
and resource ownership to builder-owned construction.
The NuGet package identifiers for HPD Base use the reserved-safe HPD-Base.*
family, for example HPD-Base, HPD-Base.AspNetCore, and HPD-Base.Auth.
Assembly names and HPD.Base namespaces are unchanged.
Sandbox packages were reorganized around HPD Environment providers:
HPD-Agent.Sandbox.CoreandHPD-Agent.Sandbox.Localwere removed.- Use
HPD-Agent.Sandboxfor backend-neutral composition and capability
admission. - Use
HPD-Agent.Sandbox.HostProcess,HPD-Agent.Sandbox.HostContainers, or
HPD-Agent.Sandbox.VirtualMachinefor a concrete Environment backend. - The former
HPD-Agent.Sandbox.AppleVirtualizationpackage is now
HPD-Agent.Sandbox.VirtualMachine.
Environment package identities also changed:
HPD-Environment.Abstractionsis nowHPD-Environment.Contracts.HPD-Environment.AppleVirtualizationis now
HPD-Environment.Virtualization.Apple, with dedicated
HPD-Environment.Virtualization.Contractsand
HPD-Environment.Virtualization.GuestAgentpackages.HPD-Environment.Localwas replaced by separate
HPD-Environment.HostProcessandHPD-Environment.HostContainersproviders.
The durable ITERATION_CONTEXT_SNAPSHOT event was removed before the 1.0
freeze. It was diagnostic-only and did not participate in compaction recovery
or thread projection. Existing journals that contain this discriminator
intentionally fail closed rather than carrying a compatibility decoder into
1.0. Use model/provider logs or application-defined live diagnostics when the
provider-bound context must be observed.
Audio consumers should remove V1 and V2 suffixes from HPD audio type names.
For example, use LiveAudioSessionStartRequest,
EndpointDecisionProjection, and VoiceActivityRequest instead of their former
version-suffixed spellings. These are source-level renames: serialized event,
payload, and schema version identifiers are unchanged.
Consumers of runtime extension durable events should include
HPD.Agent.RuntimeAgentDurableEvent in their application event composition and
persistence compatibility decisions.
Applications that previously relied on every core diagnostic entering the
thread journal must subscribe to those live events or define their own durable
audit events. Retry, snapshot, skill progress, content-storage mechanics, and
other re-derivable diagnostics no longer inflate canonical thread history.