From 1f959d782d0531e9ab8ff7c74943b54ca3085a78 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 11 Jun 2026 14:00:08 +0000 Subject: [PATCH 1/2] docs: add blocked-request-diag.jsonl to Runtime JSONL Schemas table MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The §13.6 section already documents the blocked-request-diag.jsonl format introduced in #4678, but the Runtime JSONL Schemas reference table at the end of the spec was missing an entry for it. Added a row consistent with the existing inline-reference pattern used for token-diag.jsonl. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/awf-config-spec.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/awf-config-spec.md b/docs/awf-config-spec.md index d44ddd284..055afefca 100644 --- a/docs/awf-config-spec.md +++ b/docs/awf-config-spec.md @@ -1405,6 +1405,7 @@ a corresponding JSON Schema in the `schemas/` directory: | [`schemas/otel-span.schema.json`](../schemas/otel-span.schema.json) | `otel.jsonl` | OpenTelemetry span records emitted by the local file exporter | | [`schemas/cli-proxy-access.schema.json`](../schemas/cli-proxy-access.schema.json) | `access.jsonl` (cli-proxy) | CLI proxy request audit records | | *(inline, see §13.2)* | `token-diag.jsonl` | Model alias resolution steps and diagnostic events (opt-in via `apiProxy.logging.debugTokens`) | +| *(inline, see §13.6)* | `blocked-request-diag.jsonl` | Body-shape diagnostics for guard-blocked requests (opt-in via `apiProxy.diagnostics.captureBlockedRequests`) | ### Versioning From 91bc4231f5262a188801915222e8201124f6fb3b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 11 Jun 2026 16:55:17 +0000 Subject: [PATCH 2/2] docs: clarify Runtime JSONL Schemas intro to cover inline-documented formats --- docs/awf-config-spec.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/awf-config-spec.md b/docs/awf-config-spec.md index 055afefca..638cbb4eb 100644 --- a/docs/awf-config-spec.md +++ b/docs/awf-config-spec.md @@ -1395,8 +1395,9 @@ Each record follows the `blocked-request-diag/v` schema: ## Runtime JSONL Schemas -AWF emits structured JSONL artifact files at runtime. Each record type has -a corresponding JSON Schema in the `schemas/` directory: +AWF emits structured JSONL artifact files at runtime. Most record types have +a corresponding JSON Schema in the `schemas/` directory; opt-in diagnostic +formats are documented inline in this spec instead: | Schema | JSONL file | Description | |--------|------------|-------------|