SharpClaw.Modules.DotNetSidecarHost 0.1.4-alpha

This is a prerelease version of SharpClaw.Modules.DotNetSidecarHost.
dotnet add package SharpClaw.Modules.DotNetSidecarHost --version 0.1.4-alpha
                    
NuGet\Install-Package SharpClaw.Modules.DotNetSidecarHost -Version 0.1.4-alpha
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SharpClaw.Modules.DotNetSidecarHost" Version="0.1.4-alpha" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SharpClaw.Modules.DotNetSidecarHost" Version="0.1.4-alpha" />
                    
Directory.Packages.props
<PackageReference Include="SharpClaw.Modules.DotNetSidecarHost" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SharpClaw.Modules.DotNetSidecarHost --version 0.1.4-alpha
                    
#r "nuget: SharpClaw.Modules.DotNetSidecarHost, 0.1.4-alpha"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SharpClaw.Modules.DotNetSidecarHost@0.1.4-alpha
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SharpClaw.Modules.DotNetSidecarHost&version=0.1.4-alpha&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=SharpClaw.Modules.DotNetSidecarHost&version=0.1.4-alpha&prerelease
                    
Install as a Cake Tool

SharpClaw.Modules.DotNetSidecarHost

SharpClaw.Modules.DotNetSidecarHost runs a compiled SharpClaw .NET module in the sidecar process model. The host process starts this executable with the module directory and control endpoint in environment variables, then talks to it over the SharpClaw foreign-module protocol. The sidecar host loads the module entry assembly through ModuleLoadContext, validates the module identity from module.json, exposes lifecycle and tool endpoints, and proxies host capabilities such as task execution, provider calls, module storage, and agent operations back to the parent SharpClaw runtime.

Reference this package from SharpClaw runtime or packaging code that needs to ship the .NET sidecar executable next to module-loading infrastructure. A normal module implementation does not reference this package directly; module projects normally reference SharpClaw.Contracts for ISharpClawCoreModule and related DTOs. Use the sidecar host package when you are assembling the runtime payload that launches .NET modules out of process.

At runtime the parent host provides the environment values identified by ForeignModuleProtocol.ModuleDirectoryEnv, ForeignModuleProtocol.ControlAddressEnv, and ForeignModuleProtocol.ControlTokenEnv. The module directory must contain module.json and the entry assembly named by that manifest. A sidecar-compatible .NET module manifest sets runtime.name to dotnet and runtime.hostMode to sidecar, then points entryAssembly at the module DLL.

{
  "id": "sample_module",
  "displayName": "Sample Module",
  "version": "1.0.0",
  "toolPrefix": "sample",
  "entryAssembly": "Sample.Module.dll",
  "runtime": {
    "name": "dotnet",
    "hostMode": "sidecar"
  }
}

The sidecar executable is not a general CLI surface. It is launched by SharpClaw with a private control token, loads exactly one module directory, and stops when the host sends the shutdown protocol request.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.4-alpha 66 7/5/2026
0.1.3-alpha 51 7/5/2026