Publish Agent Framework as rc4 package

Author: KSemenenko

.github/workflows/release.yml

@@ -16,6 +16,7 @@ jobs:
 
     outputs:
       version: ${{ steps.version.outputs.version }}
+      agent_framework_version: ${{ steps.version.outputs.agent_framework_version }}
 
     steps:
     - name: Checkout
@@ -40,20 +41,33 @@ jobs:
       id: version
       run: |
         VERSION=$(grep -oPm1 "(?<=<Version>)[^<]+" Directory.Build.props)
+        AGENT_FRAMEWORK_SUFFIX=$(grep -oPm1 "(?<=<AgentFrameworkPackageVersionSuffix>)[^<]+" Directory.Build.props)
         if [ -z "$VERSION" ]; then
           echo "Failed to resolve package version from Directory.Build.props"
           exit 1
         fi
+        if [ -z "$AGENT_FRAMEWORK_SUFFIX" ]; then
+          echo "Failed to resolve Agent Framework package suffix from Directory.Build.props"
+          exit 1
+        fi
+        AGENT_FRAMEWORK_VERSION="$VERSION-$AGENT_FRAMEWORK_SUFFIX"
         echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+        echo "agent_framework_version=$AGENT_FRAMEWORK_VERSION" >> "$GITHUB_OUTPUT"
         echo "Version from Directory.Build.props: $VERSION"
+        echo "Agent Framework package version: $AGENT_FRAMEWORK_VERSION"
 
     - name: Validate semantic version
       run: |
         VERSION="${{ steps.version.outputs.version }}"
+        AGENT_FRAMEWORK_VERSION="${{ steps.version.outputs.agent_framework_version }}"
         if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$ ]]; then
           echo "Version '$VERSION' is not a valid semantic version."
           exit 1
         fi
+        if [[ ! "$AGENT_FRAMEWORK_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$ ]]; then
+          echo "Agent Framework version '$AGENT_FRAMEWORK_VERSION' is not a valid semantic version."
+          exit 1
+        fi
 
     - name: Restore dependencies
       run: dotnet restore ManagedCode.CodexSharpSDK.slnx
@@ -67,8 +81,18 @@ jobs:
     - name: Codex CLI smoke tests
       run: dotnet test --project CodexSharpSDK.Tests/CodexSharpSDK.Tests.csproj --configuration Release --no-build -- --treenode-filter "/*/*/*/CodexCli_Smoke_*"
 
-    - name: Pack NuGet package
-      run: dotnet pack CodexSharpSDK/CodexSharpSDK.csproj --configuration Release --no-build -p:IncludeSymbols=false -p:SymbolPackageFormat=snupkg --output ./artifacts
+    - name: Pack NuGet packages
+      run: |
+        mkdir -p ./artifacts
+        dotnet pack CodexSharpSDK/CodexSharpSDK.csproj --configuration Release --no-build -p:IncludeSymbols=false -p:SymbolPackageFormat=snupkg --output ./artifacts
+        dotnet pack CodexSharpSDK.Extensions.AgentFramework/CodexSharpSDK.Extensions.AgentFramework.csproj --configuration Release --no-build -p:IncludeSymbols=false -p:SymbolPackageFormat=snupkg --output ./artifacts
+
+    - name: Validate packed artifacts
+      run: |
+        VERSION="${{ steps.version.outputs.version }}"
+        AGENT_FRAMEWORK_VERSION="${{ steps.version.outputs.agent_framework_version }}"
+        test -f "./artifacts/ManagedCode.CodexSharpSDK.$VERSION.nupkg"
+        test -f "./artifacts/ManagedCode.CodexSharpSDK.Extensions.AgentFramework.$AGENT_FRAMEWORK_VERSION.nupkg"
 
     - name: Upload artifacts
       uses: actions/upload-artifact@v4
@@ -86,6 +110,7 @@ jobs:
     outputs:
       published: ${{ steps.publish.outputs.published }}
       version: ${{ needs.build.outputs.version }}
+      agent_framework_version: ${{ needs.build.outputs.agent_framework_version }}
 
     steps:
     - name: Checkout
@@ -193,6 +218,7 @@ jobs:
       id: release_notes
       run: |
         VERSION="${{ needs.publish-nuget.outputs.version }}"
+        AGENT_FRAMEWORK_VERSION="${{ needs.publish-nuget.outputs.agent_framework_version }}"
         CURRENT_TAG="v$VERSION"
         PREVIOUS_TAG="${{ steps.prev_tag.outputs.previous_tag }}"
 
@@ -229,9 +255,10 @@ jobs:
         fi
 
         echo "" >> release_notes.md
-        echo "## NuGet Package" >> release_notes.md
+        echo "## NuGet Packages" >> release_notes.md
         echo "" >> release_notes.md
         echo "- [ManagedCode.CodexSharpSDK v$VERSION](https://www.nuget.org/packages/ManagedCode.CodexSharpSDK/$VERSION)" >> release_notes.md
+        echo "- [ManagedCode.CodexSharpSDK.Extensions.AgentFramework v$AGENT_FRAMEWORK_VERSION](https://www.nuget.org/packages/ManagedCode.CodexSharpSDK.Extensions.AgentFramework/$AGENT_FRAMEWORK_VERSION)" >> release_notes.md
 
         echo "" >> release_notes.md
         echo "---" >> release_notes.md

CodexSharpSDK.Extensions.AgentFramework/CodexSharpSDK.Extensions.AgentFramework.csproj

@@ -1,9 +1,12 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <Description>.NET Microsoft Agent Framework adapter for CodexSharpSDK, providing AIAgent registration helpers.</Description>
+    <PackageDescription>$(Description)</PackageDescription>
     <PackageId>ManagedCode.CodexSharpSDK.Extensions.AgentFramework</PackageId>
     <RootNamespace>ManagedCode.CodexSharpSDK.Extensions.AgentFramework</RootNamespace>
     <AssemblyName>ManagedCode.CodexSharpSDK.Extensions.AgentFramework</AssemblyName>
+    <PackageVersion>$(Version)-$(AgentFrameworkPackageVersionSuffix)</PackageVersion>
+    <Version>$(PackageVersion)</Version>
     <PackageTags>codex;openai;sdk;ai;agent;cli;microsoft-agent-framework;aiagent</PackageTags>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <NoWarn>$(NoWarn);CS1591</NoWarn>

Directory.Build.props

@@ -32,6 +32,7 @@
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
     <EmbedUntrackedSources>true</EmbedUntrackedSources>
     <EnablePackageValidation>true</EnablePackageValidation>
+    <AgentFrameworkPackageVersionSuffix>rc4</AgentFrameworkPackageVersionSuffix>
     <Version>1.1.0</Version>
     <PackageVersion>$(Version)</PackageVersion>
   </PropertyGroup>

README.md

@@ -393,9 +393,11 @@ See [docs/Features/meai-integration.md](https://github.com/managedcode/CodexShar
 An optional adapter package lets you use CodexSharpSDK with Microsoft Agent Framework `AIAgent`.
 
 ```bash
-dotnet add package ManagedCode.CodexSharpSDK.Extensions.AgentFramework
+dotnet add package ManagedCode.CodexSharpSDK.Extensions.AgentFramework --prerelease
 ```
 
+This package currently ships as a prerelease because it depends on `Microsoft.Agents.AI` `1.0.0-rc4`.
+
 ### Basic usage
 
 ```csharp

docs/ADR/004-microsoft-agent-framework-integration.md

@@ -39,6 +39,7 @@ Key points:
 1. Keep MAF dependency out of core SDK and out of `ManagedCode.CodexSharpSDK.Extensions.AI`.
 2. Reuse the existing `IChatClient` adapter instead of creating a bespoke Codex-specific `AIAgent`.
 3. Expose DI helpers for both non-keyed and keyed `AIAgent` registration to make the integration first-class for host applications.
+4. Keep the package itself on a prerelease version track while `Microsoft.Agents.AI` is prerelease so NuGet packaging remains valid.
 
 ## Diagram
 
@@ -169,7 +170,7 @@ Mitigation:
 ## Rollout and migration
 
 - Migration steps:
-  - consumers that want MAF install `ManagedCode.CodexSharpSDK.Extensions.AgentFramework`
+  - consumers that want MAF install `ManagedCode.CodexSharpSDK.Extensions.AgentFramework` as a prerelease package
   - optionally continue using `CodexChatClient` directly with `AsAIAgent(...)`
 - Backwards compatibility:
   - no breaking changes to existing public APIs

docs/Features/agent-framework-integration.md

@@ -60,6 +60,7 @@ Enable CodexSharpSDK consumers to use Microsoft Agent Framework (`AIAgent`) on t
 4. `AddKeyedCodexAIAgent()` MUST register keyed `IChatClient` and keyed `AIAgent` using the same service key.
 5. Agent configuration supplied through `ChatClientAgentOptions` MUST flow into the created agent without mutating Codex-specific chat client defaults.
 6. Codex provider metadata exposed through `ChatClientMetadata` MUST remain available from the agent-resolved chat client.
+7. `ManagedCode.CodexSharpSDK.Extensions.AgentFramework` MUST publish as a prerelease package while its `Microsoft.Agents.AI` dependency remains prerelease, and consumer install docs MUST use prerelease-aware instructions.
 
 ---
 
@@ -181,6 +182,7 @@ flowchart LR
 ## Definition of Done
 
 - `ManagedCode.CodexSharpSDK.Extensions.AgentFramework` exists as a separate opt-in package.
+- `ManagedCode.CodexSharpSDK.Extensions.AgentFramework` uses a project-specific prerelease package version aligned to the current `Microsoft.Agents.AI` RC dependency.
 - Direct `CodexChatClient` + `AsAIAgent(...)` usage is documented in `README.md`.
 - DI helpers register non-keyed and keyed `AIAgent` instances over Codex chat clients.
 - Automated tests cover happy path and keyed-edge path registration behaviour.

docs/Features/release-and-sync-automation.md

@@ -39,7 +39,8 @@ Keep package quality and upstream Codex CLI parity automatically verified throug
 - Release workflow must build/test before pack/publish.
 - Release workflow must read package version from `Directory.Build.props`.
 - Release workflow must validate semantic version format before packaging.
-- Release workflow must fail if the produced `.nupkg` version does not match `Directory.Build.props`.
+- Release workflow must fail if the produced core `.nupkg` version does not match `Directory.Build.props`.
+- Release workflow must also pack `ManagedCode.CodexSharpSDK.Extensions.AgentFramework` and use the project-specific prerelease suffix from `Directory.Build.props`.
 - Release workflow must use generated GitHub release notes.
 - Release workflow must create/push git tag `v<version>` before publishing GitHub release.
 - Codex CLI watch runs daily and opens issue when upstream `openai/codex` changed since pinned submodule SHA.
@@ -75,6 +76,7 @@ flowchart LR
 - `dotnet build ManagedCode.CodexSharpSDK.slnx -c Release -warnaserror`
 - `dotnet test --solution ManagedCode.CodexSharpSDK.slnx -c Release`
 - `dotnet pack CodexSharpSDK/CodexSharpSDK.csproj -c Release --no-build -o artifacts`
+- `dotnet pack CodexSharpSDK.Extensions.AgentFramework/CodexSharpSDK.Extensions.AgentFramework.csproj -c Release --no-build -o artifacts`
 
 ### Workflow mapping