From 5bc23408a2fb18c7dfb1314592f4e452c10ec5de Mon Sep 17 00:00:00 2001 From: Landon Cox Date: Thu, 21 May 2026 15:13:32 -0700 Subject: [PATCH 1/2] docs(spec): add port information to /reflect endpoint sections MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Clarify that GET /reflect is available on all provider ports (10000–10004), each returning reflection metadata for its own adapter. Note that port 10000 (OpenAI) is also the management port serving /health and /metrics. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/awf-config-spec.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/awf-config-spec.md b/docs/awf-config-spec.md index b2a6ed78..7fda5c5f 100644 --- a/docs/awf-config-spec.md +++ b/docs/awf-config-spec.md @@ -620,8 +620,13 @@ pending warning per subsequent request): ### 10.6 Introspection -When the API proxy `/reflect` endpoint is queried, the response MUST -include the current effective-token state: +The API proxy exposes a `GET /reflect` endpoint on every provider port +(10000–10004). Each port returns reflection metadata for its own provider +adapter. The management port (10000, OpenAI) additionally serves `/health` +and `/metrics`. + +When the `/reflect` endpoint is queried, the response MUST include the +current effective-token state: ```json { @@ -685,8 +690,8 @@ The API proxy MUST enforce the max-runs limit as follows: ### 11.3 Introspection -When the API proxy `/reflect` endpoint is queried, the response MUST include -the current max-runs state: +The `/reflect` endpoint (available on all provider ports 10000–10004; see +§10.6) MUST include the current max-runs state: ```json { From 562b71265b64aa4b59ce497d992c9f7718ed962a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 21 May 2026 22:21:39 +0000 Subject: [PATCH 2/2] docs(spec): correct /reflect endpoint behavior --- docs/awf-config-spec.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/awf-config-spec.md b/docs/awf-config-spec.md index 7fda5c5f..01664a75 100644 --- a/docs/awf-config-spec.md +++ b/docs/awf-config-spec.md @@ -621,9 +621,10 @@ pending warning per subsequent request): ### 10.6 Introspection The API proxy exposes a `GET /reflect` endpoint on every provider port -(10000–10004). Each port returns reflection metadata for its own provider -adapter. The management port (10000, OpenAI) additionally serves `/health` -and `/metrics`. +(10000–10004). Each port returns the same aggregate reflection payload, whose +`endpoints` array lists all provider adapters. Only the management port +(10000, OpenAI) serves `/metrics` and the aggregate `/health`; non-management +ports still serve provider-local `/health` responses. When the `/reflect` endpoint is queried, the response MUST include the current effective-token state: