From 2ee94894b81573241364df66aec8f9983fd4cb5d Mon Sep 17 00:00:00 2001 From: fabbrik <22822543+fabbrik@users.noreply.github.com> Date: Fri, 13 Nov 2026 15:14:25 -0600 Subject: [PATCH] release: 0.1.0-preview.19 Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01GcMT2DEkA15jsvD2sbRRD8 --- CHANGELOG.md | 4 ++++ Directory.Build.props | 2 +- README.md | 4 ++-- docs/architecture/reflective-execution-design.md | 6 +++--- docs/guide/README.md | 2 +- go/inmemory/go.mod | 2 +- go/maf/go.mod | 8 ++++---- go/postgres/go.mod | 2 +- go/postgres/pgtest/go.mod | 4 ++-- go/telemetry/go.mod | 6 +++--- python/pyproject.toml | 2 +- python/uv.lock | 2 +- 12 files changed, 24 insertions(+), 20 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5262dfd..58d3fca 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,10 @@ AgentExperience.NET is a **preview**. It is not production ready, and public API ## Unreleased +## 0.1.0-preview.19 + +This preview adds an experimental, off-by-default reflective execution loop. The same tag releases the eight NuGet packages, the Python distribution and the Go modules at this version, as before. + ### Added - **Reflective execution (experimental, off by default).** An optional loop that evaluates an attempt, proposes a diff --git a/Directory.Build.props b/Directory.Build.props index f722c15..fdbffa5 100644 --- a/Directory.Build.props +++ b/Directory.Build.props @@ -27,7 +27,7 @@ it. Without this property `dotnet pack` would silently emit 1.0.0. --> 0.1.0 - preview.18 + preview.19 diff --git a/README.md b/README.md index 83b5f29..da95cde 100644 --- a/README.md +++ b/README.md @@ -63,7 +63,7 @@ await agent.RunAsync("Ticket #4977: a refund is stuck on a lock again. Triage it Agents outside the Agent Framework (Claude Code, Codex, Cursor, a script) get the same loop through `aexp`, a .NET tool that is both a command line and an MCP stdio server, over a local SQLite file by default (published from the next -preview, `0.1.0-preview.18`; until then, [build it from this repository](dogfood/README.md)): +preview, `0.1.0-preview.19`; until then, [build it from this repository](dogfood/README.md)): ```bash dotnet tool install --global AgentExperience.Cli --prerelease @@ -318,7 +318,7 @@ Read [Concepts in five minutes](docs/guide/concepts.md) for the whole model and ## Status -`0.1.0-preview.18` is a preview: it claims no production readiness, and public APIs may change between previews (each +`0.1.0-preview.19` is a preview: it claims no production readiness, and public APIs may change between previews (each change is a reviewed diff against a checked-in API baseline). Stable enough to evaluate: the capture, verify, store, retrieve and inject loop, the PostgreSQL schema (with journaled migrations and upgrade tests from every published preview), and the tenant-isolation and sanitization rules. Supported: .NET 10, PostgreSQL 15 to 18, and diff --git a/docs/architecture/reflective-execution-design.md b/docs/architecture/reflective-execution-design.md index 71c008c..1f4e99d 100644 --- a/docs/architecture/reflective-execution-design.md +++ b/docs/architecture/reflective-execution-design.md @@ -140,7 +140,7 @@ has a result. and the wrapper closes the run itself when the loop stops sooner. - **Closing sooner needed one internal addition**, `OpenRunRegistry.CloseRunAsync`, which completes the run with the **last attempt's** status. Reusing the duration bound's close would have recorded the run as `Cancelled`, a wrong outcome. -- **No telemetry instruments yet.** Reflection reports through `OnEvent`; OpenTelemetry names are a follow-up (they are - generated from tests and listed in `docs/telemetry-names.json`). -- **Tokens are not measured** by the wrapper. +- **Telemetry** is four counters on their own experimental meter, outside `docs/telemetry-names.json` because that file is + shared with the Python and Go ports, which do not have this feature. `OnEvent` also reports each step. +- **Tokens** are counted from the provider's reported usage only; a provider that reports none leaves `MaxTokens` unenforced. - **Python, Go, CLI and MCP are untouched**, as intended. diff --git a/docs/guide/README.md b/docs/guide/README.md index 12637a5..6e99b35 100644 --- a/docs/guide/README.md +++ b/docs/guide/README.md @@ -8,7 +8,7 @@ expected did not reach the agent, [Troubleshooting](troubleshooting.md) is the o AgentExperience.NET is a **preview**. Read [Known limits and documented boundaries](../known-limits.md) before you rely on any guarantee described here. -These pages describe the `main` branch, which the published `0.1.0-preview.18` packages match; anything added to +These pages describe the `main` branch, which the published `0.1.0-preview.19` packages match; anything added to `main` after that release is listed in the [changelog's Unreleased section](../../CHANGELOG.md#unreleased). Code snippets use placeholder variables (`authorization`, `scope`, `hostScope`, `sanitizationOptions`, `captureLimits`, `logger`, …) for values you build as in the [explicit wiring](deployment.md#explicit-wiring). The [quick start](../../README.md#quick-start) diff --git a/go/inmemory/go.mod b/go/inmemory/go.mod index 17441f1..ac6e0cd 100644 --- a/go/inmemory/go.mod +++ b/go/inmemory/go.mod @@ -2,7 +2,7 @@ module github.com/fabbrik/AgentExperience.NET/go/inmemory go 1.25.0 -require github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.18 +require github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.19 require golang.org/x/text v0.41.0 diff --git a/go/maf/go.mod b/go/maf/go.mod index c873679..21f0528 100644 --- a/go/maf/go.mod +++ b/go/maf/go.mod @@ -3,10 +3,10 @@ module github.com/fabbrik/AgentExperience.NET/go/maf go 1.26.0 require ( - github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.18 - github.com/fabbrik/AgentExperience.NET/go/inmemory v0.1.0-preview.18 - github.com/fabbrik/AgentExperience.NET/go/postgres v0.1.0-preview.18 - github.com/fabbrik/AgentExperience.NET/go/postgres/pgtest v0.1.0-preview.18 + github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.19 + github.com/fabbrik/AgentExperience.NET/go/inmemory v0.1.0-preview.19 + github.com/fabbrik/AgentExperience.NET/go/postgres v0.1.0-preview.19 + github.com/fabbrik/AgentExperience.NET/go/postgres/pgtest v0.1.0-preview.19 github.com/jackc/pgx/v5 v5.11.0 github.com/microsoft/agent-framework-go v0.1.1 github.com/openai/openai-go/v3 v3.74.0 diff --git a/go/postgres/go.mod b/go/postgres/go.mod index fbb0ad4..3173745 100644 --- a/go/postgres/go.mod +++ b/go/postgres/go.mod @@ -3,7 +3,7 @@ module github.com/fabbrik/AgentExperience.NET/go/postgres go 1.25.0 require ( - github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.18 + github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.19 github.com/jackc/pgx/v5 v5.11.0 github.com/santhosh-tekuri/jsonschema/v6 v6.0.3 ) diff --git a/go/postgres/pgtest/go.mod b/go/postgres/pgtest/go.mod index 38a5834..ef0f7c7 100644 --- a/go/postgres/pgtest/go.mod +++ b/go/postgres/pgtest/go.mod @@ -3,8 +3,8 @@ module github.com/fabbrik/AgentExperience.NET/go/postgres/pgtest go 1.26.0 require ( - github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.18 - github.com/fabbrik/AgentExperience.NET/go/postgres v0.1.0-preview.18 + github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.19 + github.com/fabbrik/AgentExperience.NET/go/postgres v0.1.0-preview.19 github.com/jackc/pgx/v5 v5.11.0 github.com/testcontainers/testcontainers-go v0.44.0 github.com/testcontainers/testcontainers-go/modules/postgres v0.44.0 diff --git a/go/telemetry/go.mod b/go/telemetry/go.mod index ccecd25..e082e80 100644 --- a/go/telemetry/go.mod +++ b/go/telemetry/go.mod @@ -3,9 +3,9 @@ module github.com/fabbrik/AgentExperience.NET/go/telemetry go 1.26.0 require ( - github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.18 - github.com/fabbrik/AgentExperience.NET/go/inmemory v0.1.0-preview.18 - github.com/fabbrik/AgentExperience.NET/go/maf v0.1.0-preview.18 + github.com/fabbrik/AgentExperience.NET/go v0.1.0-preview.19 + github.com/fabbrik/AgentExperience.NET/go/inmemory v0.1.0-preview.19 + github.com/fabbrik/AgentExperience.NET/go/maf v0.1.0-preview.19 github.com/microsoft/agent-framework-go v0.1.1 go.opentelemetry.io/otel v1.47.0 go.opentelemetry.io/otel/metric v1.47.0 diff --git a/python/pyproject.toml b/python/pyproject.toml index d2856d1..ce32acd 100644 --- a/python/pyproject.toml +++ b/python/pyproject.toml @@ -3,7 +3,7 @@ name = "agenticexperience" # Derived from Directory.Build.props, never set on its own: 0.1.0-preview.N there is 0.1.0aN here (an explicit PEP 440 # alpha; "preview" would normalise to rc), and a version with no suffix is the same here. RELEASING.md bumps both, and a # release test and release.yml fail when they disagree. -version = "0.1.0a18" +version = "0.1.0a19" description = "Verified agent experience for Python: a pure-Python core that passes the AgentExperience.NET language-neutral contract 1.11." readme = "README.md" license = "Apache-2.0" diff --git a/python/uv.lock b/python/uv.lock index f5d4736..13e5d14 100644 --- a/python/uv.lock +++ b/python/uv.lock @@ -27,7 +27,7 @@ wheels = [ [[package]] name = "agenticexperience" -version = "0.1.0a18" +version = "0.1.0a19" source = { editable = "." } [package.optional-dependencies]