@openwop/spec-artifacts 2.21.0 → 2.23.0

package/CORPUS-STAMP.json

@@ -1,17 +1,17 @@
 {
   "_comment": "Provenance of @openwop/spec-artifacts (RFC 0168 §D.2). files: SHA-256 per file; the conformance suite compares the installed peer against dist/spec-artifacts.lock.json at start.",
   "package": "@openwop/spec-artifacts",
-  "version": "2.21.0",
-  "corpusTag": "v2.21.0",
+  "version": "2.23.0",
+  "corpusTag": "v2.23.0",
   "files": {
     "api/.redocly.lint-ignore.yaml": "bf5a8350b88a72fa43f59605ed8d903ed24b6cfccda5e45509c9f6ed9ee4e712",
     "api/asyncapi.yaml": "d5ecb9ee6114582be3b1f662c84bfac9ae96dae7bacb853e461168f70a8e1c7d",
     "api/grpc/openwop.proto": "c3e72bb17cba514ee98feb6434e6c9b6ea6795bfd086489ec69fd882dd1ad977",
     "api/openapi.yaml": "39081c59fb696159806b0f2f9a42e7e9ff830d622fcf2ad4159b21357580a955",
     "api/redocly.yaml": "b0604c89b2ca6d5076ec25725c539dad44a741a811fe524439ee6daef8baa09f",
-    "api/seams-v2.yaml": "dadb3a8246d1ce14a59327883bd9818c371c94426fd3677d9969570f53c15edf",
-    "api/v2/asyncapi.yaml": "04a2a3a1c3e7950cad5191cefcdf6dac4743057ae73cf552af38c269cb028952",
-    "api/v2/openapi.yaml": "c69dcb0485ce9df673d00908176e4a47cbcc8d1c7a3331e9b253ca237aa4fa60",
+    "api/seams-v2.yaml": "3d800d8f6845460af75a6f96db40a3b1419c9b7471e671e2bc44090871a02d68",
+    "api/v2/asyncapi.yaml": "f37bbe960632be29c8a86f0678fe39c16640a99bf91d767c02ce4a093c7004db",
+    "api/v2/openapi.yaml": "f2168eb8552cd21a0aaab004da4257578601867e73755e99de20ad9b771d9a72",
     "api/v2/redocly.yaml": "1e66b60e6118ad11a823bb620678be464d99dfe50a40e3e6f93ec9429b88b34c",
     "schemas/README.md": "0c0b737ffcf8f30e7d2809cec8a498232de710f41443212922ad8337cdde0b51",
     "schemas/a2a-task-state.schema.json": "c9365918f993f943b4b619d42551eb066a1ed33a08d895d51b395432a5b1f1bc",
@@ -201,13 +201,13 @@
     "schemas/workspace-file.schema.json": "464de85c2a068243084ee9c1d969bc7cd5d8f7948574e58450d6493c38a0e1e4",
     "spec/v1/alias-detectors.json": "40069d5976eeb6ba1384a648e57e5cfd673db3fce36175115fb8293bee9664d4",
     "spec/v1/capability-declaration-classes.json": "e7729aed5c4b4e1dd02abab0530f14cc95f5d4070fe51fb139e7f5cccefa00c6",
-    "spec/v1/core-standard-manifest.json": "d96d88f94b05df30f9c8829505d4706dba8fff7e3d11a4791744f7acd2b61fc0",
+    "spec/v1/core-standard-manifest.json": "4b924e0e83fb85b9a4ec9400b34239bca6826a3bd2aad0ff44eaf1e7aa23e6e5",
     "spec/v1/deprecations.json": "307083ce29c23fd406015951f99a30d78d6187ff061d38dc9732f62191b40f3f",
     "spec/v1/deprecations.schema.json": "18c87e78bedc210431f795ae44c5b5d202f2f3317850d5cf86867d4f1fa1cdfb",
     "spec/v1/event-codemap.json": "3da60d884157793a360da532a9fcbbfb5285636db325a74cec94b34622186d97",
     "spec/v1/event-codemap.schema.json": "d05933b2e88103aff51a2f774df97b9bda065e0fc88dbd9b114cc47a32189174",
     "spec/v1/extensions.json": "79a60754aa16cbdbdb604f8e5c00038af535a1690a4d07bd5ff7c38f0256a7bc",
-    "spec/v1/gaps.json": "2a659a2949031a2b4740f0874ec1fbbfd82c677d6abf315bf5c6e4c1834f00b6",
+    "spec/v1/gaps.json": "f0a99073fac443dade386fb06a9fbe888d24861babde4908551ad96f9cb6596f",
     "spec/v1/gaps.schema.json": "8fd83259f556553c9df0f53e7a82ca8c2a4771d471197f69b4e2ae0ceeacfd66",
     "spec/v1/migrations.json": "8839497d6a4830b53fa7867014a8336f0d725ef2346352e54fb580b7947897af",
     "spec/v1/migrations.schema.json": "886779aa6c22e646db097f5df210adb018a4dd14a7b815465a18c8a7056c8f72",
@@ -217,10 +217,12 @@
     "spec/v2/core/capabilities.md": "b3977e799d1d16c6ef9b306d5f07341f52259c19171c02c273a7e8a7a4b34473",
     "spec/v2/core/conformance.md": "a451c0a2ba79d93c55e540ccef480eba7de9602d59bbb03eead05daafde0beac",
     "spec/v2/core/connection-packs.md": "466bdb9dde79d85615ad8281dacfb7bf923ca22d7fb3ed219749e59574c753ed",
+    "spec/v2/core/conversation.md": "e425887c4ba199b8cdc5c99e792689f7bd7d46de492f28670de2e402fa6d9506",
     "spec/v2/core/errors.md": "6b6a1480ed889013172d8ce8c6985e321d2f4f73e1d9fae0bac9b961d0dd1a8c",
-    "spec/v2/core/events.md": "2fbf98662a72035afd7a3f811c30d4fe5f0ac823488a2cc9198a61cf6d27a049",
+    "spec/v2/core/events.md": "6fa2b5c43f096636d6d14e4a811aff396b51e9d56743fec21b750f6a224bbb62",
     "spec/v2/core/form-content-packs.md": "af3517dd7125106088249c0e32220b0b9fc3e9304c10378a6327cc8ad84b6bf1",
     "spec/v2/core/headers.md": "14cdf4ae9ee7d80eebfd426d7c3552e577baea0300915cd4bb3a68e8588195a8",
+    "spec/v2/core/host-services.md": "3753f1e034d325bb4bd5751ae6d321fbb16700d4e28032ab4e273d25eb134fc4",
     "spec/v2/core/idempotency.md": "e4edae1834101fd331379d84de77eaa9cead49383529c31f8bcd18322f67c965",
     "spec/v2/core/identity.md": "e44f34f7c2db1f12babb19ca8ee1e5b1401a89f38fd5c90d0c4b74c95f6e5d42",
     "spec/v2/core/interop.md": "6bd581556b9ab1a1509c01b9a1ec2bcb9e4a8300e68fb01570704417e70f20b9",
@@ -228,13 +230,13 @@
     "spec/v2/core/overview.md": "7dc00ace32d4e4ce929a383651f0029fc4b7091ec87487b1bf26ead1be209e0e",
     "spec/v2/core/packs.md": "cc06de2d49dd08410eececd5c279996ec839680553b332b4f33d6b31989b5757",
     "spec/v2/core/persistence.md": "9e241f84259e38848f4a2ad1c21debb0dffd5f8aafbad26408aa6cc8969bf93b",
-    "spec/v2/core/replay.md": "10cc01bf9e4e921fcfac740f3174b2e95cda7ba9a1e13e85cf371c8c2d0fa46a",
+    "spec/v2/core/replay.md": "b980a66e2543107240e3dc4f58131b9f4ff52478737e79ade6d5777b26ad1119",
     "spec/v2/core/runs.md": "136319842bacbbb300178980e4b83444917d5b193cc5fdd92e39a4902ba8d3c0",
     "spec/v2/core/security-defaults.md": "2a54ceaa4cef02c26ee0fbcf44f822ceeea79537c7d5a51ed300f21aa4fea576",
     "spec/v2/core/versioning.md": "27b88cde88f9060567ef7e46f4897b6be8892ade9f4a46c2ab16e314c515eabd",
     "spec/v2/core/webhooks.md": "46c1311c1897236f9bf9db5025c8af31dd84cd19208da3e5e9ff69eec9436965",
     "spec/v2/core/workflow-chain-packs.md": "df78b76dd79f2267fb6b72c08e0911e5f9d5bb1925c6efdd6deda62fe8a51dc8",
-    "spec/v2/declaration.json": "a7607376ecf493e9533861fccc69b4a7d0c9df427689d045e2747f5f0ba0da54",
+    "spec/v2/declaration.json": "ac333c957815380fe263bf22c58cf3a0a896ef29c2bb5a995f3aad670ecf83f7",
     "spec/v2/declaration.schema.json": "c86e3083fb9789c1958ecb4576cc6f71aa90e6f339521139238543ed08211dd4",
     "spec/v2/errors.json": "aac91b12f954cc90574d310070ae3c651b131055d4389d2c6155242763765195",
     "spec/v2/event-codemap.json": "37869a03cdfd8758b57e6f350641a6ebbd383231cebda51f5473ad85f94ab74c",
@@ -274,8 +276,8 @@
     "spec/v2/path-manifest.json": "c123c9fd77dc1b3f9c2e9346ace80cdae007e6511138894956abda01e61ec1c6",
     "spec/v2/peer-dependency-aliases.json": "d10299280abee08258502925bc327293ee413e0108cd6e6ec75ff6110653308d",
     "spec/v2/profiles.json": "0636f19fceae625390003a347e70ef4797d84766b5c24ce8a02cea52aadebca4",
-    "spec/v2/release.json": "68c7aa62eabbe783cc8c2e466659dd6fbe8d9beb41224c58d4cc948c79fd200b",
+    "spec/v2/release.json": "bdc9e689a96e66a06be04c38674d23a98d7947ca1fa93439f052a9268a3ab193",
     "spec/v2/retention-floors.json": "eaf3722d95c79947af1d4269ef85117e126518c588cfcf1a2b21b97269f51624"
   },
-  "corpusCommit": "d5c4ad17826358a4a1ee1f290d86e61af5dc3fd5"
+  "corpusCommit": "be9c4d375782d69004e55b14bd5fe3b6550d8c72"
 }

package/api/seams-v2.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OpenWOP conformance seams profile (openwop-conformance-seams-v2)
-  version: 2.21.0
+  version: 2.23.0
   description: 'GENERATED by scripts/derive-v2-api.py. RFC 0168 §C: the seams are a versioned conformance profile with their
     own document and path space (/conformance/seams/…), validated against the canonical v2 schemas with no tolerance path,
     forbidden from the capability namespace (a host advertises the profile, never a testSeams flag). This document carries

package/api/v2/asyncapi.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.1.0
 info:
   title: OpenWOP v2 event streams
-  version: 2.21.0
+  version: 2.23.0
   description: GENERATED by scripts/derive-v2-api.py (RFC 0171 §E.1, RFC 0172 §C.2). One run-events channel whose address
     is the OpenAPI path key; the server pathname is empty (bare origin). streamMode is a pattern over the closed set and its
     comma-separated combinations (`values` never combines). hostEvents has a real address (RFC 0171 §E.1) — the documented

package/api/v2/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OpenWOP v2 API
-  version: 2.21.0
+  version: 2.23.0
   summary: REST surface for declaring, executing, suspending, resuming, and observing multi-step workflows.
   description: GENERATED by scripts/derive-v2-api.py from api/openapi.yaml and the RFC 0167 children (v2 charter Phase 3,
     P3-C). Bare origin, unversioned path keys, negotiation by `OpenWOP-Version` + `protocolVersions[]` (RFC 0172 §A). No seam

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openwop/spec-artifacts",
-  "version": "2.21.0",
+  "version": "2.23.0",
   "description": "The OpenWOP machine-readable contract: api/ (OpenAPI, AsyncAPI, the seams profile), schemas/ (v1 and v2 JSON Schemas), the spec/v1 and spec/v2 registries (errors, event codemap, declaration, deprecations, migrations, gaps) and CORPUS-STAMP.json — published from the openwop/openwop corpus tag; the peer dependency @openwop/openwop-conformance digest-checks at start (RFC 0168 §D.2).",
   "license": "Apache-2.0",
   "repository": {

package/spec/v1/core-standard-manifest.json

@@ -4,7 +4,7 @@
   "provenance": {
     "suite": {
       "package": "@openwop/openwop-conformance",
-      "version": "2.21.0"
+      "version": "2.23.0"
     },
     "note": "Derived from the corpus at generation time. Regenerate with --write; verify with --check."
   },
@@ -419,5 +419,5 @@
       "$id": "https://openwop.dev/spec/v1/workspace-file.schema.json"
     }
   ],
-  "digest": "be88eefc234ed3fbb67e12675f04afd00af841f588efe4745bf3f4863eb050bd"
+  "digest": "bffe6b840b0bcaabf41fd1d546bd2a32e7b9e6ff9740aafdd8d6dba8d336b094"
 }

package/spec/v1/gaps.json

@@ -10518,6 +10518,57 @@
         }
       ]
     },
+    {
+      "id": "openwop.gap.0189.14",
+      "rfc": "0189",
+      "local": "G14",
+      "section": "§B(c)",
+      "surface": "A BULLET LIST is not one paragraph either. G4 split tables so a MUST in row 15 could not satisfy a family named in row 6; it left bullet lists fused, and the same exploit lives one syntax down. `spec/v1/ai-envelope.md`'s `envelopeContracts.advertised` bullet carries NO 2119 keyword and passed §B(c) only because the ADJACENT `envelopeStrictness` bullet says \"MUST cause refusal\". That declaration SHIPPED in 2.21.0 — hand-read, right about the family, wrong about the anchor — and the §D fallback would have asserted it at end-of-support.",
+      "witness": "unclassified",
+      "requirementId": null,
+      "disposition": "closed",
+      "target": null,
+      "sources": [
+        {
+          "file": "RFCS/registers/0189-normative-home.gaps.md",
+          "token": "G14"
+        }
+      ]
+    },
+    {
+      "id": "openwop.gap.0189.15",
+      "rfc": "0189",
+      "local": "G15",
+      "section": "§B(d)",
+      "surface": "PROPOSED AND REJECTED ON MEASUREMENT. The proposal was to strip fenced code blocks from the facet arm as G12 does for the obligation arm, on the claim it costs zero declared families. Measured: it breaks SIXTEEN facets — `credentials.encryptionAtRest`, `oauth.grants`, `kvStorage.maxTtlSeconds` and thirteen more — every one named in a JSON ADVERTISEMENT EXAMPLE, which is precisely how a facet is legitimately named.",
+      "witness": "unclassified",
+      "requirementId": null,
+      "disposition": "closed",
+      "target": null,
+      "sources": [
+        {
+          "file": "RFCS/registers/0189-normative-home.gaps.md",
+          "token": "G15"
+        }
+      ]
+    },
+    {
+      "id": "openwop.gap.0189.16",
+      "rfc": "0189",
+      "local": "G16",
+      "section": "§A",
+      "surface": "A conformance-seam catalog could be a normative home. `spec/v1/host-sample-test-seams.md` banners \"observation seams, not application endpoints\", and its `multiPartyConversation` bullet says in its own matched text that RFC 0101 \"mints no normative client wire-route\" — so the paragraph that would have satisfied §B(c) is the paragraph disclaiming the contract. G13's informative-banner refusal does not catch it, because the document is genuinely `Stable` and genuinely normative ABOUT SEAMS.",
+      "witness": "unclassified",
+      "requirementId": null,
+      "disposition": "closed",
+      "target": null,
+      "sources": [
+        {
+          "file": "RFCS/registers/0189-normative-home.gaps.md",
+          "token": "G16"
+        }
+      ]
+    },
     {
       "id": "openwop.gap.0190.1",
       "rfc": "0190",

package/spec/v2/core/conversation.md

@@ -0,0 +1,20 @@
+# Conversation surfaces
+
+> **Status: Stable · v2.0 · RFC 0101, 0109, 0110.** Normative contract for the multi-party conversation families.
+> **Normative home:** `multiPartyConversation`, `channelPresence`, `conversationTurnModelProvenance`.
+
+## Why this exists
+
+RFC 0101 and RFC 0110 are `Accepted`, their wire shapes are frozen in `schemas/v2/`, and conformance covers them — but each deliberately mints no client route for opening a conversation, and so neither was ever given an operative home. The obligation an advertising host takes on is real regardless of who routes the call; it is stated here.
+
+## `multiPartyConversation`
+
+A host advertising `multiPartyConversation` MUST accept an optional `participants` array of agent references on conversation creation, and MUST refuse a turn from a principal absent from that roster rather than silently accepting it. It MUST refuse a roster that exceeds `multiPartyConversation.maxParticipants` at creation rather than truncating it.
+
+## `channelPresence`
+
+A host advertising `channelPresence` MUST report present members as a subset of the channel's roster, and MUST NOT include a subject that is not a member. The payload is closed: it carries opaque, non-PII subject references and nothing else.
+
+## `conversationTurnModelProvenance`
+
+A host that stamps model provenance on an agent turn MUST advertise `conversationTurnModelProvenance`. The stamp is non-secret and non-PII — provider and model identifiers only — and a host MUST NOT place prompt or completion content in it.

package/spec/v2/core/events.md

@@ -1,7 +1,7 @@
 # Events
 
 > **Status: Stable · RFC 0171 §A, §E; RFC 0176 §A.**
-> **Normative home:** `heartbeat`.
+> **Normative home:** `heartbeat`, `envelopeContracts`, `envelopes`, `feedback`, `providerUsage`.
 
 ## Why this exists
 
@@ -113,3 +113,27 @@ The response is `{ runId, events, lastSequence, status, isTerminal }` (closed):
 ## Era-2 logs
 
 An `eventLogSchemaVersion` of `2` means v1-written. Every reader (poll, stream, fork, diff, debug bundle) MUST translate each event through `spec/v2/event-codemap.json` at storage — `type` is mapped, the payload projected; `sequence` (including `0`), `eventId`, `timestamp`, `causationId` pass through. A type the codemap does not name, carrying no vendor org, MUST fail the read `500 event_type_unmapped`. A host MUST NOT carry a private mapping, nor rewrite era-2 rows in place. **A projection MUST NOT silently drop a property**: carry or fail `500 payload_unprojectable` (hatch `^(openwop-|x-|vendor\.)`; RFC 0185). Fork and replay over an era-2 parent: replay.md.
+
+## Envelope contracts
+
+`envelopeContracts` advertises that a host enforces per-node envelope permission
+sets. A host advertising `envelopeContracts.advertised` MUST refuse a node whose
+emitted envelope `type` is neither universal nor listed in that node's accepted
+set, and MUST refuse it distinctly from the capability-gated `typeId` refusal —
+the two stack rather than substitute.
+
+## Envelope, feedback and usage facets
+
+`envelopes.tierOneSubsetCompliance` advertises that the host accepts the Tier 1
+structured-output subset shared across major providers; a host advertising it MUST
+accept an envelope restricted to that subset from any provider it advertises, rather
+than refusing on provider-specific grounds.
+
+`feedback.targets` names the resources an annotation may be attached to. A host MUST
+refuse an annotation whose target is outside the advertised set, and MUST NOT write it
+to the replayable run event log.
+
+`providerUsage.costEstimates` advertises that the host stamps a derived cost on the
+`provider.usage` event. That figure is an estimate from the host's own rate table, and
+a consumer MUST NOT treat it as a billed amount.
+

package/spec/v2/core/host-services.md

@@ -0,0 +1,20 @@
+# Host services
+
+> **Status: Stable · v2.0 · RFC 0144.** Normative contract for the advertised `host.*` service surfaces a node pack invokes through `ctx`.
+> **Normative home:** `aiEnvelope`, `promptLibrary`, `agentRuntime`.
+
+## Why this exists
+
+`spec/v1/host-capabilities.md` describes these three surfaces with a TypeScript sketch, a `**Required methods:**` label and a failure-mode list, and — unlike its sibling sections, which reach for `MUST` constantly — states no obligation. A lowercase section label is not an RFC 2119 keyword, so the contract a host takes on by advertising these families was never written down. v1 is frozen, so it is written here.
+
+## `aiEnvelope`
+
+A host advertising `aiEnvelope` MUST expose `ctx.aiEnvelope.generate` to pack code, and MUST refuse a node whose `typeId` requires the family when it does not advertise it. It MUST expose `ctx.aiEnvelope.await` when, and only when, it advertises `aiEnvelope.await`.
+
+## `promptLibrary`
+
+A host advertising `promptLibrary` MUST expose `ctx.promptLibrary.get`, MUST return a pinned version verbatim so that a replayed run resolves the same template, and MUST fail the calling node rather than substitute an unpinned one.
+
+## `agentRuntime`
+
+A host advertising `agentRuntime` MUST expose `spawn`, `delegate`, `consensus` and `messageSend`, and MUST satisfy `agents.manifestRuntime`, which advertising it implies.

package/spec/v2/core/replay.md

@@ -1,7 +1,7 @@
 # Replay and Fork
 
 > **Status: Stable · RFC 0140, 0041, 0173 §C, 0176 §A.5.**
-> **Normative home:** `eventLog`, `replay`.
+> **Normative home:** `eventLog`, `replay`, `nondeterminismPolicy`.
 
 ## Why this exists
 
@@ -115,3 +115,12 @@ and the cross-region claim does not apply.
 A host advertising `replay` MUST document retention for source snapshots, source logs, the invocation records replay depends on, and forked runs; `retention.days` MAY advertise the window. When the range `fromSeq` needs has expired, the host MUST reject the fork with `410` or `422`; `details` SHOULD carry `sourceRunId`, `fromSeq`, and the boundary.
 
 See also: events.md, runs.md, persistence.md, security-defaults.md.
+
+## Declared nondeterminism
+
+`nondeterminismPolicy` is the host's statement of which nondeterministic sources it
+declares rather than suppresses. A host advertising `nondeterminismPolicy.declared`
+MUST record every declared source in the run's event log at the point it is read, so
+a fork replays the recorded value rather than re-drawing it; a source the host neither
+declares nor suppresses is a replay defect, not a policy choice.
+

package/spec/v2/declaration.json

@@ -250,7 +250,7 @@
     {
       "key": "envelopeContracts",
       "kind": "family",
-      "normativeText": ["spec/v1/ai-envelope.md"],
+      "normativeText": ["spec/v2/core/events.md"],
       "anchor": "core",
       "section": "core/capabilities.md#envelopeContracts",
       "peerDependencyId": "envelopeContracts",
@@ -269,6 +269,7 @@
     {
       "key": "envelopes",
       "kind": "family",
+      "normativeText": ["spec/v1/ai-envelope.md", "spec/v2/core/events.md"],
       "anchor": "core",
       "section": "core/capabilities.md#envelopes",
       "peerDependencyId": "envelopes",
@@ -289,6 +290,7 @@
     {
       "key": "prompts",
       "kind": "family",
+      "normativeText": ["spec/v1/prompts.md", "spec/v1/capabilities.md"],
       "anchor": "core",
       "section": "core/capabilities.md#prompts",
       "peerDependencyId": "prompts",
@@ -321,6 +323,7 @@
     {
       "key": "nodePackRuntimes",
       "kind": "family",
+      "normativeText": ["spec/v1/node-packs.md"],
       "anchor": "core",
       "section": "core/capabilities.md#nodePackRuntimes",
       "peerDependencyId": "nodePackRuntimes",
@@ -483,6 +486,7 @@
     {
       "key": "feedback",
       "kind": "family",
+      "normativeText": ["spec/v1/observability.md", "spec/v2/core/events.md"],
       "anchor": "core",
       "section": "core/capabilities.md#feedback",
       "peerDependencyId": "feedback",
@@ -566,6 +570,7 @@
     {
       "key": "multiPartyConversation",
       "kind": "family",
+      "normativeText": ["spec/v2/core/conversation.md"],
       "anchor": "core",
       "section": "core/capabilities.md#multiPartyConversation",
       "peerDependencyId": "multiPartyConversation",
@@ -584,6 +589,7 @@
     {
       "key": "conversationTurnModelProvenance",
       "kind": "family",
+      "normativeText": ["spec/v2/core/conversation.md"],
       "anchor": "core",
       "section": "core/capabilities.md#conversationTurnModelProvenance",
       "peerDependencyId": "conversationTurnModelProvenance",
@@ -600,6 +606,7 @@
     {
       "key": "channelPresence",
       "kind": "family",
+      "normativeText": ["spec/v2/core/conversation.md"],
       "anchor": "core",
       "section": "core/capabilities.md#channelPresence",
       "peerDependencyId": "channelPresence",
@@ -656,6 +663,7 @@
     {
       "key": "providerUsage",
       "kind": "family",
+      "normativeText": ["spec/v1/observability.md", "spec/v2/core/events.md"],
       "anchor": "core",
       "section": "core/capabilities.md#providerUsage",
       "peerDependencyId": "providerUsage",
@@ -1055,6 +1063,7 @@
     {
       "key": "aiEnvelope",
       "kind": "family",
+      "normativeText": ["spec/v2/core/host-services.md"],
       "anchor": "core",
       "section": "core/capabilities.md#aiEnvelope",
       "peerDependencyId": "aiEnvelope",
@@ -1073,6 +1082,7 @@
     {
       "key": "promptLibrary",
       "kind": "family",
+      "normativeText": ["spec/v2/core/host-services.md"],
       "anchor": "core",
       "section": "core/capabilities.md#promptLibrary",
       "peerDependencyId": "promptLibrary",
@@ -1089,6 +1099,7 @@
     {
       "key": "agentRuntime",
       "kind": "family",
+      "normativeText": ["spec/v2/core/host-services.md"],
       "anchor": "core",
       "section": "core/capabilities.md#agentRuntime",
       "peerDependencyId": "agentRuntime",
@@ -1220,6 +1231,7 @@
     {
       "key": "nondeterminismPolicy",
       "kind": "family",
+      "normativeText": ["spec/v2/core/replay.md"],
       "anchor": "core",
       "section": "core/capabilities.md#nondeterminismPolicy",
       "peerDependencyId": "nondeterminismPolicy",

package/spec/v2/release.json

@@ -1,6 +1,6 @@
 {
   "$comment": "RFC 0172 §D.1 — the one release identity the v2 artifacts derive from. `version` is the next corpus tag `v<version>` (the publish workflow's coordinated-release tag pattern `v*`; RFC 0172's `openwop/v2.<minor>.<patch>` spelling is amended to this at its flip). api/v2/*.yaml info.version, the suite's 2.x version and @openwop/spec-artifacts read it. Bumped by the release PR that cuts the tag, never by hand elsewhere.",
-  "version": "2.21.0",
-  "corpusTag": "v2.21.0",
+  "version": "2.23.0",
+  "corpusTag": "v2.23.0",
   "updated": "2026-09-18"
 }