Repository navigation
Releases
HPD 0.9.6
HPD-Agent 0.9.6
Release status
HPD-Agent 0.9.6 is a pre-1.0 stabilization release. Public APIs, serialized
events, persistence formats, hosted DTOs and routes, generated SDK contracts,
and TUI integration contracts remain compatibility candidates for 1.0.
Breaking changes remain possible until 1.0.0 is released.
Highlights
- The session-first TypeScript SDK now covers the generated runtime surface,
including stored agents, sessions, threads, content, executions, subagents,
evaluations, observations, history projection, and client tools. - Portable OpenAPI authoring schemas preserve generated component types instead
of exposing broad untyped policy and operation fields. - Agent definitions support partial updates with explicit field clearing,
metadata clearing, and closed unknown-field handling. - Tool-harness builder configuration and named executable policies materialize
into durable policy and runtime configuration. - Client-tool harness and definition aliases now derive from generated models,
including provider-authentication discriminants and reusable client-family
configuration. - Headless thread state exposes extensible projections, tool work parts,
timeline and revision controls, branch navigation, and fork controls. - HPD-OS validates the framework against a real downstream application and now
builds against the current framework main.
Breaking changes
- HPD-Agent runtime packages now target .NET 10 LTS and .NET 11 STS. .NET 8 and
.NET 9 are no longer supported because they reached end of support on
2026-11-10. - Generated SDK models use the normalized server contract. Consumers should use
the exported generated definitions and helpers instead of maintaining
parallel portable interfaces. AgentRunConfigis the one execution configuration surface. Durable agent
behavior belongs to serialized agent definitions.
SDKs
The TypeScript client continues to expose the session-first API while its model
and service layers come from SDK IR generated from the hosted OpenAPI document.
Generated C#, Python, and Go clients use the same normalized contract.
The TypeScript client-tool runtime continues to provide automatic invocation
handling, responder routing, replay validation, and background operation fields.
Typed tool-schema authoring and first-class background continuation helpers are
planned for a later pre-1.0 release.
Validation
The 0.9.6 release gate covers:
- .NET 10 and .NET 11 solution builds.
- Windows, macOS, and Linux verification jobs.
- The agent and environment test suites.
- Generated API-surface checks.
- C#, TypeScript, Python, and Go SDK generation and conformance.
- TypeScript runtime, type, and conformance tests.
- Headless UI and Svelte checks.
- NuGet package identity, contents, dependency, and availability validation.
Release train
The combined Release HPD Agent and Dependencies workflow publishes the
release-train dependencies in dependency order, then validates and publishes the
Agent packages against those exact versions.
Deprecated packages
HPD-Agent.ToolHarness.FileSystemremains deprecated and is not a supported
workspace-isolation or command-execution boundary.
Upgrade
Applications targeting .NET 8 or .NET 9 must retarget to net10.0 or
net11.0. Applications with local copies of portable tool, harness, client, or
provider-authentication shapes should use the generated public types exported by
HPD-Agent and the generated clients.
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.
HPD AI Framework 0.9.2
Added
- Declarative MCP server and OAuth configuration through
AgentConfig. - Source-generated permission descriptors and MCP capability-to-permission resolution.
- Inheritable tool-harness capabilities with centralized activation and sub-agent configuration overrides.
- Function-level capability collapsing through generated metadata and selectors.
- Unified declarative workflow runtime with typed output contracts, graph-host bindings, recovery validation, and node result metadata.
- Structured-output resolution and canonical tool-argument handling across nested agent projections.
- Scoped command, debugging, exploration, and tool-call activity state, including turn-scoped sandbox capability approval.
- A single-input
Release HPD Agent and Dependenciesworkflow that publishes the complete Agent dependency train in dependency order.
Changed
- HPD-Environment now owns process-isolation planning contracts, sandbox plans, domain-pattern parsing, and the sandbox isolation compiler/planner implementation.
- HPD-Agent now consumes those contracts from HPD-Environment; Environment no longer depends on Agent packages or Agent build targets.
- Environment Apple Virtualization packages now have a clean dependency direction: Environment must be published before Agent.
- Agent configuration serialization now shares the framework YAML/JSON configuration bridge.
Fixed
- Workflow execution now drains pending event inboxes before reporting completion.
- Execute-command completion and output handling now preserve terminal results during streaming and completion transitions.
- YAML and JSON configuration serialization now use a consistent document and bridge representation.
Breaking
- Sandbox planning contracts including
SandboxExecutionContext,SandboxEnforcementLocation,SandboxPlanEnvelope,ISandboxPlanner, andSandboxIsolationPlanmoved fromHPD.Agent.Sandbox.ProcessIsolationtoHPD.Environment.Contracts. DomainPatternandDomainPatternKindmoved fromHPD.Agent.Sandbox.PolicytoHPD.Environment.Contracts.SandboxIsolationPlannerandSandboxIsolationCompilermoved fromHPD.Agent.Sandbox.ProcessIsolationtoHPD.Environment.Runtime.- Consumers of those types must update namespace imports and publish HPD-Environment before HPD-Agent.
- The serialized sandbox-plan schema identifier remains
hpd.agent.sandbox.planfor wire compatibility.
v0.9.1
HPD-Agent 0.9.1
Fix
- Fixed
InMemoryAgentTuiRuntimeso the Agent allocates and journals each
execution identity instead of the TUI adapter supplying one before admission. - Removed duplicate TUI lifecycle events; Agent execution journaling is now the
authoritative start/finish record. - Failed or rejected submissions release the adapter admission slot without
leaving a ghost execution or blocking the next input.
Upgrade
Applications using the in-process TUI runtime should upgrade all HPD-Agent
package references from 0.9.0 to 0.9.1.
Validation
- Cross-target TUI runtime regression tests: passed.
- Single-file file reviewer restored, built, launched its TUI, and exited cleanly
against the published0.9.1packages.
The 0.9.0 packages remain available but contain the execution-identity defect.
v0.9.0
HPD-AI Framework 0.9.0
Release candidate: 50e47820a1676457f8f332a991dfb870012cc831
Comparison base: v0.8.1
This release contains 897 commits across 4,165 files compared with v0.8.1
(562,759 insertions and 109,069 deletions). It is a coordinated framework
milestone rather than a small patch release.
Release Scope
- The primary release is the HPD-Agent package train and the foundation
packages required by its tested dependency graph. - HPD-Agent.Studio has a separate Studio release path.
- HPD.Payments remains a separate
0.1.0product track and is not published by
the Agent 0.9.0 workflow. - HPD-Agent.MultiAgent.AspNetCore remains blocked until HPD-Base.AspNetCore and
HPD-Graph.Base are published. - The package version metadata is now
0.9.0. Bothv0.8.0andv0.8.1
containedVersionPrefix0.6.0, so this change also corrects the stale
package-version baseline.
Highlights
HPD-Agent
- Replaced mutable event registration with source-generated, authoritative
event composition. Library event modules now compose automatically when an
application does not provide a composition. - Added durable goals, planning, questions, explicit subagent results, and
context handoffs. - Added hierarchical subagent policy and event delivery, durable fork and
continuation receipts, authority attenuation, retry recovery, and
crash-safe restart behavior. - Unified capability and operation lifecycles, action admission, operation
ownership, action-scoped authority, canonical schemas, and audit records. - Ported execution-owned ToolHarness v9, including generated registries,
cross-assembly activation, local action references, and Native AOT coverage. - Unified provider authentication, Codex OAuth, provider usage accounting,
per-model-call usage, and model valuation. - Added managed speech and audio sessions over LiveKit, including streaming
speech input, committed turn delivery, interruption flow, Silero VAD, and
ElevenLabs streaming transcription. - Added bot integrations for Discord, Slack, Teams, Telegram, and WhatsApp.
- Added the FileSystem ToolHarness and expanded coding, language-server,
debugging, MCP 2, OpenAPI, evaluation, sandbox, and provider coverage.
HPD-TUI
- Introduced a retained display-command compositor with revisioned component
trees, bounded damage tracking, incremental rasterization, frame pacing, and
structured performance diagnostics. - Replaced the streaming Markdown path with a source-backed projection that
preserves source spans, layout identity, and preview metadata during
incremental updates. - Added a managed terminal publication state machine with backpressure,
transactional component lifecycle, scrollback separation, resize recovery,
and resize-safe shutdown. - Added conformance, differential ANSI, randomized raster, scaling-budget, and
interactive subagent-action coverage.
HPD-Base, Auth, and Graph
- Hardened HPD-Base's graph-owned mutation and transaction authority, durable
activations, generated indexes, vector execution, SQLite persistence,
serializer identities, schema ledgers, and Native AOT boundaries. - Migrated HPD-Auth persistence and activation toward HPD-Base graph contracts;
expanded authentication, authorization, 2FA, OAuth, admin, audit, Studio,
and Native AOT coverage. - Replaced process-local graph workflow and checkpoint authority, added graph
runtime admission and replacement replay, and consolidated connectors,
scheduling, Studio adapters, and generated activation contracts.
HPD-Gateway and Studio
- Added a product-neutral HPD Studio core and unified Studio host/adapters
across Base, Auth, Graph, Gateway, and Agent. - Expanded HPD-Gateway with standalone and managed hosting surfaces, secured
admin/auth integration, YARP forwarding, Microsoft service discovery,
SQLite control-plane persistence, and Redis-backed distributed admission. - Added TypeScript Gateway client generation, generated Studio contracts, and
React Base client foundations.
HPD-Environment, Media, and Payments
- Added local environment provider host authority, allowlisted executable
roots, rootless/rootful Podman socket classification, container-host
readiness, participant lifecycle coordination, and recovery coverage. - Consolidated realtime media and audio projects, repaired cross-project and
AOT references, and qualified LiveKit native assets for all six RIDs. - Landed the separate HPD-Payments product track with formal ledger authority,
embedded and distributed profiles, SQLite/Postgres/InMemory adapters,
Stripe and simulator connectors, out-of-process extensions, generators,
workers, conformance tests, and Native AOT checks.
Other Package Families
- Updated HPD-RAG ingestion, retrieval, reranking, evaluation, and provider
integration around the new shared foundations. - Updated HPD-Extract and HPD-ML dependency and project graphs. HPD-ML removed
its PJRT and XLA integration. - Expanded HPD-Events, HPD-OpenApi.Core, HPD-VCS, HPD-RealtimeMedia, and
serialization compatibility coverage.
Migration and Compatibility
- Supported modern targets remain
net8.0,net9.0, andnet10.0. Legacy
netstandard2.0andnet472support remains disabled. - HPD.Payments currently requires
net10.0and C# 14.0. - Event consumers and custom event modules must use the generated project-level
event composition. The mutable global event registry is no longer the
source of truth. - Tool action schemas are closed by default. Review generated action unions,
permission-to-authority migrations, invocation modes, and ToolHarness v9
registration. - Input interruption has been replaced by explicit execution control. Queued
input and steering now share the user-input delivery lifecycle. - Global provider discovery has been removed. Use explicit provider
registration, the immutable provider catalog, and supported environment or
dependency-injection authentication. - OpenAPI consumers must use the OpenAPI.NET v3 model namespace and
IOpenApiMediaTypecontent contracts. - Markdown consumers must use the source-backed projection contracts rather
than the former streaming/reparse path. - Graph, Auth, and Base persistence/activation contracts contain hard
pre-1.0 cutovers. Review the subsystem migration tests and generated schema
ledgers when upgrading persisted applications.
Dependency Changes
- Migrated OpenAPI support to
Microsoft.OpenApiand
Microsoft.OpenApi.YamlReader3.11.0. - Updated the
Microsoft.Extensions.*platform family to 10.0.13. - Updated the
Microsoft.Extensions.AIfamily to 10.11.0. - Updated ModelContextProtocol to 2.2.0 and OpenAI to 2.14.0.
- Updated Microsoft.Agents, CodeAnalysis, Graph, Anthropic, DashScope, AWS
runtime, and other provider/tooling package families. - Updated ONNX Runtime to 1.31.0, ONNX Runtime GenAI to 0.18.0, PDFiumCore to
157.0.8100, NLayer to 3.0.0, Markdig to 1.4.2, and LiveKit to 0.1.4. - Replaced deprecated
AWSSDK.Extensions.Bedrock.MEAIwith
AWS.Bedrock.MEAI1.1.1. Microsoft.Extensions.AI.Evaluation.NLPremains on preview package
10.11.0-preview.1.26513.7because no stable release exists.Azure.AI.OpenAIremains on explicit prerelease exception2.9.0-beta.1.
Package Coverage
- The Agent release workflow now includes the bot packages, FileSystem
ToolHarness, and LiveKit native assets. - LiveKit retains the
livekit-ffi/v0.12.60archives. All six RID library
hashes were re-qualified;osx-arm64is the execution-qualified platform. - Package identity validation and package-content checks remain release gates.
- Publishing is manually dispatched through
publish-agent-nuget.yml.
Creating the Git tag alone does not publish the NuGet packages.
Validation
The 0.9.0 milestone recorded green net10, net8, and net9 Agent sets; green
HPD-RAG, HPD-TUI, and PDF extraction suites; a zero-known-vulnerability
package audit; and successfully produced Agent and foundation release
packages.
Before publishing, rerun the release gate at the exact tag commit:
- GitHub Actions "Build and Test" for net10, net9, net8, Windows, and macOS.
dotnet/eng/nuget/validate-package-identities.shfor the release project set.- Release package build and content validation.
- A final NuGet audit against the exact release dependency graph.
v0.8.1
Merge pull request #11 from HPD-AI/feat/provider-env-and-registration Feat/provider env and registration
v0.8.0
Merge pull request #10 from HPD-AI/feat/apple-virtualization-runtime Feat/apple virtualization runtime/hpd abse hardening/hpd auth hardening/hpd gateway addition
v0.7.0
HPD AI Framework 0.7.0
This release introduces a durable, journal-driven Agent runtime, committed and resumable SSE streaming, checkpoint-driven compaction, durable subagent threads, a substantially expanded TUI form system, and stronger request/response coordination in HPD Events.
HPD-Agent 0.7.0
Added
- Added canonical per-thread journals with atomic batch appends, optimistic cursor checks, journal generations, bounded reads, catch-up/live observation, and atomic journal replacement.
- Added
ThreadKey,ThreadJournalCursor,ThreadDescriptor,ThreadEventBatch,ThreadProjectionReader, and explicit append, cursor, deletion, and journal-replacement conflict errors. - Added
FileSessionStoreas the file-backed implementation of the canonical journal contract. - Added committed, resumable SSE observation with cursor-based reconnect and replay.
- Added authoritative thread runtime snapshots containing projected history, the observed cursor, pending requests, and the active backend-owned run.
- Added structured input submission results with runtime run IDs and start timestamps, plus expected-run cancellation checks.
- Added checkpoint-driven compaction through
IThreadCompactionEngineandThreadCompactionEngine. - Added automatic, manual, fork, and selected-boundary compaction using explicit
CompactionSpecificationvalues. - Added thread-context usage estimation for compaction and user-interface reporting.
- Added durable, resumable subagent threads with runtime child descriptors, task names, configuration materialization, and started/completed/failed/cancelled lifecycle events.
- Added
IAgentRuntimeResolverand stored, supplied, and parent-inherited subagent configuration sources. - Added a unified structured input-dispatch pipeline and consistent per-run configuration propagation across runtime, middleware, functions, and background work.
- Added
AgentPermissionModewith secureAskdefaults and explicitFullAccessoperation. - Added subagent tools and lifecycle rendering to the coding harness and Agent TUI.
- Added journal acceptance/performance coverage and extensive lifecycle, replay, compaction, subagent, hosting, TUI, and TypeScript SDK tests.
Changed
- Reworked
ISessionStorearound canonical journal append, replace, descriptor, read, and observation operations. - Reworked Agent hosting, ASP.NET endpoints, TUI runtimes, audio projection, evaluations, bots, multi-agent workflows, and FFI integration around journal projection.
- Standardized hosted runtime transport on committed SSE and made backend execution state authoritative.
- Reworked compaction from middleware-owned cached state into cursor-checked journal rewriting.
- Reworked thread forking to use polymorphic compaction policies and explicit journal lineage.
- Reworked subagent execution so child work has durable session/thread identity and can be resumed and observed.
- Updated model resolution so provider and model choices can be supplied consistently per run.
- Updated middleware contexts to expose the effective
AgentRunConfigthroughout the execution lifecycle. - Updated coding command execution, permission handling, process handles, language-server events, and persisted file mutations.
- Updated the NuGet workflow to publish all supported provider projects, including Cerebras, Cohere, DashScope, DeepInfra, DeepSeek, Fireworks, Groq, Hyperbolic, LM Studio, MiniMax, Moonshot, Nebius, Nscale, NVIDIA NIM, OpenAI Compatible, OVHcloud, Perplexity, Replicate, SambaNova, Scaleway, SiliconFlow, Together, Venice, xAI, and Z.AI.
Removed
- Removed
JsonSessionStoreand the legacy monolithic thread-event document persistence path. - Removed legacy
LoadThreadAsync,LoadThreadDocumentAsync, single-event append, and thread-ID listing operations fromISessionStore. - Removed WebSocket streaming from the ASP.NET runtime and TypeScript Agent client.
- Removed the old
CompactionState,CompactionResult, andThreadHistoryCompactionlifecycle. - Removed obsolete thread-run service methods and legacy ASP.NET integration surfaces.
- Removed separate coding-harness edit/write implementations in favor of the canonical file-mutation path.
Fixed
- Fixed soft-compaction cache replay, hard mid-turn checkpoints, post-compaction replay, and compaction summary model selection.
- Fixed hosted lifecycle recovery and reconnection behavior around active runs.
- Fixed stale cancellation requests so they cannot cancel a newer runtime run.
- Fixed subagent visibility, runtime reconstruction, and reflection-based capability collapsing.
- Fixed execute-command lifecycle, permission, and persisted-event behavior.
- Fixed bot text flushing, audio output projection, and evaluation reconstruction against committed events.
- Fixed TUI cancellation safety by requiring deliberate double-Escape cancellation during active runs.
HPD-Events 0.7.0
Added
- Added hierarchical pending-request discovery through
GetPendingRequests()andPendingRequestSnapshot. - Added
RegisterRequest<TRequest,TResponse>()so request sessions can be registered before a caller-controlled durable publication boundary. - Added asynchronous response completion with a caller-supplied commit boundary through
RespondAsync(...). - Added atomic request-resolution reservation so cancellation, expiration, and response completion cannot race across a durable commit.
Changed
- Event coordinators no longer mutate domain events to assign global sequence numbers.
- Replay ordering now relies on timestamp, priority, source ordinal, and source sequence instead of coordinator-assigned event sequence numbers.
- Request cancellation, expiration, disposal, and response completion now use atomic terminal-state transitions.
Removed
- Removed
SequenceNumberfromIEventandEvent. - Removed
EventSequenceNumberfromReplayKey.
HPD-TUI 0.7.0
Added
- Added a generic
FormField<T>model with explicit field interactions, value-change notifications, descriptions, and asynchronous pending-change support. - Added
ActionFormField<T>,ChoiceFormField<T>,MultiChoiceFormField<T>, andLongFormField. - Added inline and picker choice presentations, disabled choices, multi-selection limits, and searchable/filterable selection behavior.
- Added
FormUpdateSessionfor safely applying live form changes and restoring state when editing is cancelled. - Added autocomplete dismissal and focus-aware Escape handling for dialogs.
- Added robust terminal paste detection and coverage.
Changed
- Reworked form models, controllers, and views for live editing, richer descriptions, validation, async field activation, and clearer interaction hints.
- Expanded integer, decimal, and text fields with stronger editing and validation behavior.
- Updated selection views and prompt controllers for improved keyboard traversal and filtering.
- Markdown parsing is now lazy and invalidates cached layout state when its source changes.
Removed
- Removed the old
BooleanFormField,EnumFormField<T>, andSelectFormField<T>implementations in favor of generic choice fields.
HPD-Graph 0.7.0
Changed
- Aligned Graph test coordinators with the new HPD Events pending-request contract.
- Removed the obsolete coordinator-assigned
sequenceNumberfield from connector SSE event payloads.
TypeScript Agent SDK, ACP, Headless UI, and Studio
Added
- Added resumable journal cursors, authoritative thread execution state, context-usage types, runtime-run submission results, and subagent lifecycle event types.
- Added snapshot hydration and cursor-aware catch-up to the SSE client.
- Added runtime-child and semantic fork information to headless thread projections and branch navigation.
Changed
- Updated the Agent SDK, ACP adapter, headless UI, Svelte bindings, and Studio API integration for the canonical journal and backend-owned run lifecycle.
- Updated thread controllers, projections, revisions, selectors, and fork controls to handle journal generations and authoritative runtime state.
Removed
- Removed the TypeScript WebSocket transport and its public exports. SSE is now the sole runtime lifecycle transport.
Migration Notes
- Custom
ISessionStoreimplementations must adopt the new descriptor and journal contract. Migrate file-backed use fromJsonSessionStoretoFileSessionStore. - Streaming clients must migrate from WebSockets to resumable SSE and persist the full
(generation, sequenceNumber)cursor. - Clients should hydrate from the authoritative thread-state snapshot and use returned runtime run IDs for cancellation.
- Replace
CompactionState,CompactionResult, andThreadHistoryCompactionintegrations withIThreadCompactionEngineandCompactionSpecification. - Replace
ThreadForkCompactionIntentwithInheritThreadForkCompaction,DisableThreadForkCompaction, orApplyThreadForkCompaction. - HPD Events consumers must stop reading or assigning
Event.SequenceNumber; durable domain ordering should come from the owning journal or source. - Implementations of
IEventCoordinatororIRequestResponseBusmust add pending-request discovery, request registration, and asynchronous response completion. - HPD TUI consumers should replace boolean, enum, and select fields with
ChoiceFormField<T>orMultiChoiceFormField<T>and update custom fields for the new generic form-field contract. - Graph connector consumers should no longer expect
sequenceNumberin connector SSE metadata.
Release Scope
- 29 commits
- 426 files changed
- 27,154 additions and 17,991 deletions
- Full comparison: v0.6.0...v0.7.0
v0.6.0
HPD-Agent 0.6.0
Added
- Added a new background invocation model with
AgentInvocationMode, background invocation receipts/results, background handles, and notification policies. - Added live client tool provider support, including provider registration, heartbeat/disconnect tracking, binding leases, wire messages, and background operation tracking.
- Added ASP.NET endpoints for client tool providers:
GET /client-tool-providersGET /client-tool-providers/{clientRuntimeId}GET /client-tool-providers/connect
- Added MCP OAuth runtime hooks, process isolation transport, live update events, and runtime-backed MCP tool invocation.
- Added support for exposing MCP resources, prompts, and tasks as callable AI functions.
- Added many new provider packages, including Cerebras, Cohere, DashScope, DeepInfra, DeepSeek, Fireworks, Groq, Hyperbolic, LM Studio, MiniMax, Moonshot, Nebius, Nscale, Nvidia NIM, OVHcloud, Perplexity, Replicate, SambaNova, Scaleway, SiliconFlow, Together, Venice, xAI, and Z.ai.
- Added a shared OpenAI-compatible provider base package.
- Added command permission middleware and process handles to the coding harness.
- Added richer coding TUI handlers for permission requests, command results, sandbox capability requests, and harness tool calls.
- Added
HPD-Agent.MultiAgent.AspNetCorewith endpoints for workflow discovery, run management, run streaming, suspended-node inspection, and approval responses. - Added evaluation convenience APIs, including the
Evalfactory and quick agent evaluation extension methods. - Added
HPD-Agent.Studiopackaging support.
Changed
- Reworked background task registration and notification APIs.
- Consolidated provider configuration around shared provider behavior and request-option types.
- Upgraded
ModelContextProtocolfrom1.4.0to2.0.0-preview.1. - Reworked MCP configuration around runtime-owned OAuth and process-isolation hooks.
- Updated event emission to include trace, session, and thread scope more consistently.
- Updated evaluation tracing to record permission request/response pairs.
- Updated coding harness text encoding detection from
Ude.NetStandardtoUTF.Unknown. - Updated package publishing behavior so release builds validate against published HPD dependency packages via
UsePublishedHpdDependencies=true.
Removed
- Removed the old in-agent environment runtime surface. Environment runtime concerns now live outside the Agent package boundary.
- Removed older provider-specific test layouts in favor of shared provider behavior/configuration test coverage.
Fixed
- Fixed background response and lifecycle behavior around pending notification batches.
- Fixed bot streaming so text updates flush before completion.
- Fixed client tool provider binding behavior for active leases.
- Fixed package vulnerability warnings by updating affected dependency references where applicable.
Migration Notes
- Code using the old background task APIs may need to move to the new
AgentInvocationMode,BackgroundTaskContext, and background handle contracts. - Code using the old in-agent environment runtime APIs should migrate to the standalone HPD Environment packages.
- MCP consumers should review configuration changes caused by the
ModelContextProtocol2.x preview upgrade. - Provider configuration code may need updates because several provider-specific config types were simplified or moved toward request-option based configuration.
- Package release builds now intentionally fail if HPD-Agent depends on unpublished changes in another HPD framework package.
HPD-Graph 0.5.6
HPD-Graph 0.5.6 focuses on hosting separation, Studio packaging, and release alignment for Agent 0.6.0.
Added
- Added
HPD-Graph.Studioas a packable Studio module. - Added
AddGraphStudio()module registration. - Added
GraphHostingServiceCollectionExtensionsinHPD-Graph.Hosting.
Changed
- Moved Graph hosting service registration into
HPD-Graph.Hosting. HPD-Graph.AspNetCorenow delegates hosting setup toservices.AddHPDGraphHosting().- Graph hosting now uses
services.AddHPDEvents()for centralized event registration. - Added direct hosting dependencies on
Microsoft.Extensions.DependencyInjection.AbstractionsandMicrosoft.Extensions.Hosting.Abstractions.
Migration Notes
- Some hosting extension methods moved from
HPD.Graph.AspNetCore.DependencyInjectiontoHPD.Graph.Hosting.DependencyInjection. - Consumers may need to add or update a reference to
HPD-Graph.Hostingand adjustusingstatements.
v0.5.5
HPD-Agent v0.5.5
This release formalizes the current conversation architecture: sessions contain durable threads, and thread event streams are now the source of truth for conversation history.
Highlights
- Renamed the conversation model from branches to threads across core APIs, hosting, ASP.NET routes, TUI, bots, audio projection, evaluations, and sub-agent flows.
- Added thread-scoped ASP.NET routes, including thread listing, fork, metadata updates, deletion, content APIs, events, and thread graph endpoints.
- Reworked session persistence around thread event documents, with session metadata stored separately from durable thread event streams.
- Removed
UncommittedTurn; in-flight and recovery state now come from thread run events and projections. - Added semantic thread fork graph support for rendering alternate conversation paths.
- Updated middleware hooks and state scopes from branch naming to thread naming.
- Added TUI v2 transcript composition with transcript cells, renderer registration, and package-specific renderers.
- Added catalog-driven TUI provider/model selection via
IAgentTuiModelCatalog. - Replaced provider
AdditionalPropertiesstorage with typedProviderOptionshelpers. - Updated sub-agent execution policies to use session/thread terminology.
- Expanded tests and benchmarks for thread APIs, event storage, fork graphs, TUI composition, transcript rendering, coding TUI rendering, OpenRouter, and JSON agent storage.
Migration Notes
This is a pre-1.0 API evolution release. Users moving from v0.5.0 should update branch APIs to thread APIs, move /branches calls to /threads, update custom ISessionStore implementations for thread event documents, replace StateScope.Branch with StateScope.Thread, and migrate stored provider config to ProviderOptions.