@openwop/spec-artifacts 2.42.7 → 2.42.8

package/spec/v2/core/webhooks.md

@@ -13,11 +13,13 @@ A host that advertises `webhooks` ([capabilities.md](capabilities.md)) serves `r
 
 | Operation | Request | Response |
 | --- | --- | --- |
-| `registerWebhook` | `{ url, events[], secret?, tags?, signatureAlgorithms? }` | `201 { webhookId }` |
+| `registerWebhook` | `{ url, events[], secret?, tags?, signatureAlgorithms? }` | `201 { webhookId, secret? }` |
 | `unregisterWebhook` | path `webhookId` | `204`; `404` when unknown; `403` when the caller is outside the subscription's tenant |
 
 On `registerWebhook`, `url` MUST be `https://` and `events[]` MUST be non-empty v2 event type names ([events.md](events.md)).
 
+When `registerWebhook` omits `secret`, the host MUST generate one and return it as `secret` in the `201`. That response is the only one that carries it. A supplied secret MUST NOT be echoed.
+
 A `204` from `unregisterWebhook` ends the subscription's deliveries, including retries already scheduled (§Durability).
 
 A subscription MUST receive only events from runs within its tenant scope; cross-tenant delivery is a protocol violation whatever the filter says (invariant `webhook-cross-tenant-isolation`). `tags` narrows delivery to runs whose options carry an overlapping tag.

package/spec/v2/declaration.json

@@ -1624,7 +1624,7 @@
     {
       "key": "i18n",
       "kind": "family",
-      "normativeText": ["spec/v1/i18n.md"],
+      "normativeText": ["spec/v2/core/i18n.md"],
       "anchor": "core",
       "section": "core/capabilities.md#i18n",
       "peerDependencyId": "i18n",
@@ -1664,7 +1664,7 @@
     {
       "key": "portability",
       "kind": "family",
-      "normativeText": ["spec/v1/portability.md"],
+      "normativeText": ["spec/v2/core/portability.md"],
       "anchor": "core",
       "section": "core/capabilities.md#portability",
       "peerDependencyId": "portability",

package/spec/v2/errors.json

@@ -1001,13 +1001,23 @@
     },
     {
       "code": "client_version_unsupported",
-      "meaning": "The client is below the host's advertised minClientVersion.",
+      "meaning": "The client is below the host's advertised minClientVersion; details.minClientVersion, when present, names the floor.",
       "httpStatus": 426,
       "statusSource": "v2 decision",
       "retriable": false,
-      "details": null,
+      "details": {
+        "type": "object",
+        "properties": {
+          "minClientVersion": {
+            "type": "string",
+            "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$",
+            "description": "OPTIONAL. The host's advertised minClientVersion, so a client refused at discovery learns the floor (versioning.md §1.5)."
+          }
+        },
+        "additionalProperties": true
+      },
       "since": "2.0",
-      "source": "RFC 0172 row C5.8"
+      "source": "RFC 0172 row C5.8; details registered by RFC 0219"
     },
     {
       "code": "rate_limited",

package/spec/v2/ext/portability/README.md

@@ -2,6 +2,6 @@
 
 > **Status: Retired.**
 
-Superseded by: [capabilities.md § portability](../../core/capabilities.md#portability).
+Superseded by: [portability.md](../../core/portability.md).
 
 This page is not a declared extension family. `portability` is a core family, and its rules live there.

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.42.7",
-  "corpusTag": "v2.42.7",
+  "version": "2.42.8",
+  "corpusTag": "v2.42.8",
   "updated": "2026-09-27"
 }

package/spec/v2/surface-baseline.json

@@ -4,7 +4,7 @@
     "schemas/v2/**/*.json",
     "spec/v2/path-manifest.json"
   ],
-  "release": "2.42.7",
+  "release": "2.42.8",
   "kinds": {
     "union": [
       "channel",
@@ -18,7 +18,7 @@
       "type"
     ]
   },
-  "count": 8502,
+  "count": 8504,
   "surfaces": [
     "schemas/v2/a2a-task-state.schema.json#/contextId|type|string",
     "schemas/v2/a2a-task-state.schema.json#/interruptKind|enum-member|\"approval\"",
@@ -5254,6 +5254,7 @@
     "schemas/v2/envelopes/ui.a2ui-surface.schema.json#|type|object",
     "schemas/v2/error-envelope.schema.json#/details/keys/[]|type|string",
     "schemas/v2/error-envelope.schema.json#/details/keys|type|array",
+    "schemas/v2/error-envelope.schema.json#/details/minClientVersion|type|string",
     "schemas/v2/error-envelope.schema.json#/details/runStatus|type|string",
     "schemas/v2/error-envelope.schema.json#/details/sequence|type|integer",
     "schemas/v2/error-envelope.schema.json#/details/supported/[]|enum-member|\"debug\"",
@@ -5265,6 +5266,7 @@
     "schemas/v2/error-envelope.schema.json#/details/type|type|string",
     "schemas/v2/error-envelope.schema.json#/details|property|eventId",
     "schemas/v2/error-envelope.schema.json#/details|property|keys",
+    "schemas/v2/error-envelope.schema.json#/details|property|minClientVersion",
     "schemas/v2/error-envelope.schema.json#/details|property|runStatus",
     "schemas/v2/error-envelope.schema.json#/details|property|sequence",
     "schemas/v2/error-envelope.schema.json#/details|property|supported",