[dotnet-port-api] Document Agent Hooks protocol gap

[github-actions]

Summary

Updated docs/dotnet-go-sdk-feature-comparison.md to record the new upstream Microsoft.Agents.AI.AgentHooks public feature as a current Go parity gap. The doc now adds an Agent Hooks matrix row, calls out the missing first-class AGENT-HOOKS protocol package in the runtime misalignment notes, adds the .NET package to the checklist, and raises Agent Hooks support in the prioritized parity opportunities.

This was selected from recent upstream .NET API changes because microsoft/agent-framework#7564 introduced a new public package and options surface (AgentHooksOptions, AsAIAgentWithAgentHooks) while the Go SDK currently exposes only lower-level middleware, history-provider, and context-provider seams.

Ported .NET PRs

None. This is a Go misalignment documentation update prompted by microsoft/agent-framework#7564 and upstream commit 10bf8d7d9ef56304cb6936452e64c90c99850f6c, rather than a runtime/code port.

Breaking Changes

No.

Tests and Examples

• None added; this is a docs-only comparison update.

Notes

• Upstream head inspected: microsoft/agent-framework@c3a8aec098c6ef150dbe83ea6626ba27b75e393d.
• Also checked recent upstream public-surface candidates already covered or in progress in Go nightly work, including concurrent tool invocation, feature-usage telemetry, Responses reasoning include control, and Foundry hosted session/user identity parity.

Generated by .NET to Go API Porting Agent · gpt54 · 352.3 AIC · ⌖ 10.7 AIC · ⊞ 24.4K · ◷

---

Note

This was originally intended as a pull request, but GitHub Actions is not permitted to create or approve pull requests in this repository.
The changes have been pushed to branch dotnet-port-api-agent-hooks-gap-20260902-a66b51a6614e2b39.

Click here to create the pull request

To fix the permissions issue, go to Settings → Actions → General and enable Allow GitHub Actions to create and approve pull requests. See also: gh-aw FAQ

Show patch preview (79 of 79 lines)

From 273014abe2f5b02d47145cc691a8f7a0d11ac237 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Wed, 2 Sep 2026 05:46:02 +0000
Subject: [PATCH] [dotnet-port-api] Document Agent Hooks protocol gap

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/dotnet-go-sdk-feature-comparison.md | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/docs/dotnet-go-sdk-feature-comparison.md b/docs/dotnet-go-sdk-feature-comparison.md
index 67416fbd5..b51265f62 100644
--- a/docs/dotnet-go-sdk-feature-comparison.md
+++ b/docs/dotnet-go-sdk-feature-comparison.md
@@ -2,7 +2,7 @@
 
 Feature inventory date: July 2, 2026
 
-Contract parity update: August 31, 2026
+Contract parity update: September 2, 2026
 
 This document compares the .NET SDK at `microsoft/agent-framework/dotnet` with the Go SDK in this repository. The updated overlapping API contracts use .NET baseline `microsoft/agent-framework@5996105a1bf2726918101adc6e9c9857b7f68b98`; the broader package, sample, and feature inventory remains based on July 2, 2026. The workflow source and test delta was also checked through `microsoft/agent-framework@6a0773ba2180e8036d138dbb9794ae64ec2d978b`; no workflow code or test changes followed the baseline.
 
@@ -19,7 +19,7 @@ This document compares the .NET SDK at `microsoft/agent-framework/dotnet` with t
 
 The Go SDK covers the core agent and workflow model: agents, sessions, history, context providers, streaming response updates, structured output, function tools, shell execution with environment-aware context, tool auto-calling and approvals, initial harness utilities, A2A, AGUI, MCP, skills, compaction, in-process workflows, checkpoint/resume, human-in-the-loop request ports, state, and workflow-as-agent/agent-in-workflow adapters.
 
-The .NET SDK has a much wider integration and product layer. The largest gaps are DevUI/Aspire, evaluation, declarative agents/workflow
... (truncated)

[michelle-clayton-work]

Pull request #995 is linked to this issue and will close it when merged.