Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
85d511f
feat!: Let a host append to a call from outside any turn
MatthewHsu1 Sep 11, 2026
b34531f
feat: Introduce ToolCallScope and enhance CallSession with call tracking
MatthewHsu1 Sep 12, 2026
a4b9985
feat: integrate Jint for script execution in drawing tools
MatthewHsu1 Sep 12, 2026
baf6d5e
feat: Introduce agent memory and file configurations
MatthewHsu1 Sep 12, 2026
aaa818e
feat: Implement AgentHarness and related tests for todos and mode swi…
MatthewHsu1 Sep 12, 2026
0236259
feat: add workspace management for call sessions
MatthewHsu1 Sep 12, 2026
c15f249
feat: add workspace root support for memory agents and enhance relate…
MatthewHsu1 Sep 13, 2026
40824d7
feat: implement file access and memory management for agent harness
MatthewHsu1 Sep 13, 2026
ceb1934
feat: enhance CallSessionState and related components to manage harne…
MatthewHsu1 Sep 13, 2026
0e293f7
feat: add shell tool provider
MatthewHsu1 Sep 13, 2026
7f2da84
feat: wire background agent to harness
MatthewHsu1 Sep 13, 2026
eff7aec
feat: implement background agent session management and release mecha…
MatthewHsu1 Sep 13, 2026
5e66489
feat: add AgentApproval class and corresponding tests for auto-approv…
MatthewHsu1 Sep 13, 2026
55a692e
feat: Implement approval handling for tool calls
MatthewHsu1 Sep 13, 2026
4eb9d38
Add TurnSources and related tests for managing turn-specific source r…
MatthewHsu1 Sep 13, 2026
3793467
feat: Add workflow state management to CallSession and related tests
MatthewHsu1 Sep 13, 2026
685b82d
refactor: use agent harness and remove async local implementation
MatthewHsu1 Sep 14, 2026
561618e
Implement graph state management and routing for guarded edges
MatthewHsu1 Sep 14, 2026
b4d0a16
chore: Update .gitignore to include .sonarqube and remove sonar-proje…
MatthewHsu1 Sep 14, 2026
8878f72
fix: Update regex instantiation to include timeout and suppress secur…
MatthewHsu1 Sep 14, 2026
b8964e9
fix: Add CancellationToken to async operations and improve property r…
MatthewHsu1 Sep 14, 2026
8f5b32e
refactor: enhance code quality across multiple files
MatthewHsu1 Sep 14, 2026
15387f8
refactor: consolidate collapsible state management into a reusable hook
MatthewHsu1 Sep 14, 2026
c35a6e3
feat: add responses api end point
MatthewHsu1 Sep 14, 2026
391cb25
refactor: remove demo folder
MatthewHsu1 Sep 14, 2026
243a2b4
feat: implement deletion of continuations alongside calls in memory a…
MatthewHsu1 Sep 14, 2026
7deb2bf
Refactor tests to use ResponsesHost instead of ChatCompletionsHost
MatthewHsu1 Sep 14, 2026
b02edd2
Remove obsolete tests for DrawingData, PresentTool, and ShippedAgentB…
MatthewHsu1 Sep 15, 2026
bee23c1
feat: introduce code execution capability and related tools
MatthewHsu1 Sep 15, 2026
524c1dc
feat: add support for unwrapped tools from earlier providers in Facet…
MatthewHsu1 Sep 15, 2026
b0904b7
feat: add entries for multi agent configuration
MatthewHsu1 Sep 16, 2026
f0bd755
test: improve assertion in RoundTrip_SaveGetDelete for continuation r…
MatthewHsu1 Sep 16, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
14 changes: 0 additions & 14 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -46,16 +46,6 @@ jobs:
with:
dotnet-version: '10.0.x'

- uses: actions/setup-node@v4
with:
node-version: '24'
cache: npm
cache-dependency-path: demo/chat-ui/package-lock.json

- name: Chat UI dependencies
run: npm ci
working-directory: demo/chat-ui

- name: Restore
run: |
dotnet restore
Expand All @@ -64,10 +54,6 @@ jobs:
- name: Build
run: dotnet build --no-restore -c Release

- name: Chat UI tests
run: npm test
working-directory: demo/chat-ui

- name: Unit tests
run: dotnet test --no-build -c Release
--filter "FullyQualifiedName!~AgentCore.Evals"
Expand Down
6 changes: 2 additions & 4 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -61,10 +61,8 @@ jobs:
- name: Restore
run: dotnet restore

# SkipClientAppBuild keeps the demo's npm target from running. It would build a browser
# bundle that no package contains, and it is the only reason this job would need Node.
- name: Build
run: dotnet build --no-restore -c Release -p:SkipClientAppBuild=true
run: dotnet build --no-restore -c Release

- name: Unit tests
run: dotnet test --no-build -c Release
Expand All @@ -76,7 +74,7 @@ jobs:
run: dotnet pack --no-build -c Release -o artifacts

# IsPackable decides what becomes a package; this asserts that decision rather than trusting
# it. Five, not six, is what proves nothing under demo/ leaked into a release.
# it. Five packages ship as a set.
- name: Exactly five packages
run: |
count=$(ls artifacts/*.nupkg | wc -l)
Expand Down
15 changes: 6 additions & 9 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 +40,6 @@ bld/
# Uncomment if you have tasks that create the project's static files in wwwroot
#wwwroot/

# The demo's UI bundle. Vite writes it from demo/chat-ui on every build.
demo/AgentCore.Demo/wwwroot/

# Visual Studio 2017 auto generated files
Generated\ Files/

Expand Down Expand Up @@ -492,10 +489,11 @@ $RECYCLE.BIN/
!.env.example

# The real configuration document belongs to the consuming project.
# Only config/example.yaml and config/demo.yaml are committed here.
demo/AgentCore.Demo/config/config.yaml
demo/AgentCore.Demo/config/config.yml
demo/AgentCore.Demo/config/config.json
# Only config/example.yaml is committed here.
config/config.yaml
config/config.yml
config/config.json
config/local.yaml

# The evaluation store and the response cache. The store is a build output: it holds one run, and
# `dotnet aieval report` reads it. The committed inputs are golden/ inside tests/AgentCore.Evals.
Expand All @@ -509,6 +507,5 @@ CLAUDE.md
docs/
.superpowers/

demo/AgentCore.Demo/config/local.yaml

.serena
.sonarqube
33 changes: 19 additions & 14 deletions Directory.Packages.props
Original file line number Diff line number Diff line change
Expand Up @@ -7,35 +7,40 @@
<GlobalPackageReference Include="MinVer" Version="7.0.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="Microsoft.Extensions.Logging" Version="10.0.10" />
<PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.10" />
<PackageVersion Include="Microsoft.Extensions.FileSystemGlobbing" Version="10.0.10" />
<PackageVersion Include="Microsoft.Extensions.Logging" Version="10.0.12" />
<PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.12" />
<PackageVersion Include="Microsoft.Extensions.FileSystemGlobbing" Version="10.0.12" />
<PackageVersion Include="Microsoft.Extensions.Http" Version="10.0.2" />
<PackageVersion Include="Microsoft.Extensions.Http.Resilience" Version="10.2.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="Microsoft.Extensions.AI" Version="10.8.3" />
<PackageVersion Include="Microsoft.Extensions.AI.Abstractions" Version="10.8.3" />
<PackageVersion Include="Microsoft.Extensions.AI.OpenAI" Version="10.8.3" />
<PackageVersion Include="Microsoft.Extensions.AI" Version="10.10.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Abstractions" Version="10.10.0" />
<PackageVersion Include="Microsoft.Extensions.AI.OpenAI" Version="10.10.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="Microsoft.Agents.AI" Version="1.17.0" />
<PackageVersion Include="Microsoft.Agents.AI.Workflows" Version="1.17.0" />
<PackageVersion Include="Microsoft.Agents.AI" Version="1.21.0" />
<PackageVersion Include="Microsoft.Agents.AI.Workflows" Version="1.21.0" />
<PackageVersion Include="Microsoft.Agents.AI.Hosting" Version="1.21.0-preview.260911.1" />
<PackageVersion Include="Microsoft.Agents.AI.Hosting.OpenAI" Version="1.21.0-alpha.260911.1" />
<PackageVersion Include="Microsoft.Agents.AI.Tools.Shell" Version="1.21.0-preview.260911.1" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="ModelContextProtocol.Core" Version="2.2.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="OpenAI" Version="2.12.0" />
<PackageVersion Include="OpenAI" Version="2.13.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="Microsoft.Extensions.VectorData.Abstractions" Version="10.8.2" />
<PackageVersion Include="Microsoft.Extensions.VectorData.Abstractions" Version="10.10.0" />
<PackageVersion Include="Qdrant.Client" Version="1.19.0" />
<PackageVersion Include="CommunityToolkit.VectorData.Qdrant" Version="1.0.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="Stateless" Version="5.20.1" />
</ItemGroup>
<ItemGroup>
</ItemGroup>
<ItemGroup>
<PackageVersion Include="YamlDotNet" Version="18.1.0" />
<PackageVersion Include="JsonSchema.Net" Version="9.4.0" />
Expand All @@ -52,10 +57,10 @@
<PackageVersion Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.17.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation" Version="10.8.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="10.8.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Reporting" Version="10.8.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Console" Version="10.8.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation" Version="10.10.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="10.10.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Reporting" Version="10.10.0" />
<PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Console" Version="10.10.0" />
</ItemGroup>
<ItemGroup>
<PackageVersion Include="Microsoft.CodeAnalysis.PublicApiAnalyzers" Version="5.6.0" />
Expand Down
92 changes: 60 additions & 32 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,51 @@
# AgentCore

A .NET library for building voice and chat agents. You bring the host; AgentCore brings the turn
loop, the vendor seams, and the configuration document that drives them.

## Install

```
dotnet add package AgentCore.Hosting
A .NET library for building voice and chat agents. The agent is a configuration document; the host is two calls.

## 1. Describe the agent

`config/helper.yaml`:

```yaml
apiVersion: agentcore/v1
name: helper

agents:
defaults:
model: { ref: reply }
instructions: |
You are a helpful assistant. Answer plainly and briefly.
items:
- id: helper
instructions: |
Answer whatever the person asks.
tools: []

policy:
initial: talk
stages:
- id: talk
agent: helper
terminal: true

providers:
llm:
- { kind: openai, model: gpt-5.6-luna, as: reply }
call: { kind: telnyx-relay }
speech:
stt: { kind: telnyx-relay }
tts: { kind: telnyx-relay }
```

`AgentCore.Hosting` brings the rest of the set with it.
`agents` holds the instructions, `policy` holds the stages, `providers` binds the vendors. No C# changes to add a stage, a tool, or a model.
[`config/example.yaml`](https://github.com/MatthewHsu1/AgentCore/blob/main/config/example.yaml)
is the annotated tour of every key.

## Use
## 2. Wire up the host

```csharp
using AgentCore.Hosting;

var builder = WebApplication.CreateBuilder(args);
builder.AddAgentCoreHost();

Expand All @@ -22,11 +54,26 @@ app.MapAgentCoreHost();
app.Run();
```

AgentCore reads `config/example.yaml` unless `AgentCore__ConfigurationPath` names another document.
`AddAgentCoreHost` loads the document (`config/example.yaml` unless `AgentCore__ConfigurationPath` names another) and binds every vendor seam. `MapAgentCoreHost` serves the health check, the OpenAI-compatible Responses endpoint, and the call socket.
A document it cannot find is a startup failure, never a silent default.

[`demo/AgentCore.Demo/config/example.yaml`](https://github.com/MatthewHsu1/AgentCore/blob/main/demo/AgentCore.Demo/config/example.yaml)
is the annotated tour of every key.
## Install

```
dotnet add package AgentCore.Hosting
```

`AgentCore.Hosting` brings the rest of the set with it.

## 3. Talk to it

Over the OpenAI-compatible endpoint (`/v1/responses`), the document above holds this conversation:

```
User: Hello

Assistant: How can I help you today!
```

## The packages

Expand All @@ -35,30 +82,11 @@ is the annotated tour of every key.
| `AgentCore.Domain` | Pure domain records. Zero dependencies. |
| `AgentCore.Application` | Orchestration, configuration compilation, and every port interface. |
| `AgentCore.Infrastructure` | Outbound adapters: OpenAI, Zilliz, Telnyx call control, Postgres, B2, Git. |
| `AgentCore.AspNetCore` | Inbound adapters as `Map*` extensions: Telnyx Conversation Relay, Telnyx webhooks, chat completions. |
| `AgentCore.AspNetCore` | Inbound adapters as `Map*` extensions: Telnyx Conversation Relay, Telnyx webhooks, Responses. |
| `AgentCore.Hosting` | The batteries-included host: every vendor seam bound and every route mapped, in two calls. |

They share one version and ship as a set. Mixing versions across them is unsupported.

## The demo

[`demo/`](https://github.com/MatthewHsu1/AgentCore/tree/main/demo) holds a working host and a React
chat UI. Neither is published. It is how you watch the agent work, and the starting point you copy
when writing a UI of your own.

```
export OPENAI_API_KEY=sk-...
cd demo/AgentCore.Demo && dotnet run --launch-profile demo
```

The `demo` profile runs
[`config/demo.yaml`](https://github.com/MatthewHsu1/AgentCore/blob/main/demo/AgentCore.Demo/config/demo.yaml),
the smallest document that holds a real conversation: it needs only an OpenAI key. The `example`
profile runs the annotated reference instead, which names tools and vendors this repository cannot
give you a key for, and will not start.

Node is required to build the demo's UI.

## Licence

MIT
Loading
Loading