@openwop/openwop-conformance 2.39.0 → 2.39.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +5 -0
- package/README.md +1 -1
- package/dist/spec-artifacts.lock.json +2 -2
- package/package.json +2 -2
- package/requirements.json +22 -14
- package/schemas/CORPUS-STAMP.json +9 -9
- package/src/scenarios/v2-a2a-push-delivery.test.ts +82 -37
- package/src/scenarios/v2-lane-issuer-advertised.test.ts +9 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# `@openwop/openwop-conformance` Changelog
|
|
2
2
|
|
|
3
|
+
## [2.39.1] — 2026-09-25 — the RFC 0214 delivery legs survive a tunnel, and each one leaves its own row
|
|
4
|
+
|
|
5
|
+
- **`v2-a2a-push-delivery` — every requirement now records a row, and the budgets fit a public front.** The 2.39.0 public push-on cut of the v2 reference host lost three legs (§A after-Delete, §B 3xx redirect, §D replay fork) to vitest's per-test timeout, not to an assertion — deliveries were arriving through the front (`no-openwop-signature` passed). Budgets now scale when `OPENWOP_WEBHOOK_RECEIVER_URL` is wired (arrival 60 s, settle 45 s, leg 240 s, fork leg 300 s; loopback unchanged), the #1537 precedent. Separately, `0214.a2a-push-delivery-authenticated` vanished from that bundle because its `it()` also cited `0214.a2a-push-no-openwop-signature` and the ledger keeps the LAST id an `it()` cites: the delivery is now made once and read by two legs, one id each, and when the delivery cannot be made the signature leg records `blocked` with the reason instead of disappearing.
|
|
6
|
+
- **`v2-lane-issuer-advertised` no longer fails a host whose anonymous lane omits `revocation`, as the schema and `identity.md` §2.2 allow.** openwop#1540 (2.38.0) made `revocation` optional on the `anonymous` lane, whose §2.2 row reads "—", but this scenario's `.members` leg still asserted `revocation` on every lane. A host that followed the schema and the prose therefore failed the published suite; openwop-app-ce measured it bumping openwop-app's pin. A "—" lane may now omit `revocation`; if it advertises one, it must still be a known member, so no new failure mode is added. `scripts/check-lane-revocation-rules.mjs` gains a fifth assertion, that the `.members` leg exempts the "—" lanes, which fails against the 2.38.0/2.39.0 scenario.
|
|
7
|
+
|
|
3
8
|
## [2.39.0] — 2026-09-24 — an A2A push is measured at a receiver the suite owns
|
|
4
9
|
|
|
5
10
|
- **RFC 0214 — the push legs land, and a host that advertises `a2a.pushNotifications` is now measured, not just the one that refuses.** `v2-a2a-operation-map` gains three legs gated on `pushNotifications: true`: `0214.a2a-push-register-ssrf` (a non-https, private, loopback or link-local destination is not registered), `0214.a2a-push-config-isolation` (a config read under another tenant's task, another of the caller's tasks, or an unknown id is answered byte-identically; a foreign delete deletes nothing; delete is idempotent) and `0214.a2a-push-secrets-not-returned` (the registered token and credentials are absent from Create/Get/List, `GetTask`, the run snapshot and the event log). New scenario `v2-a2a-push-delivery` measures delivery at a SUITE-OWNED scoped receiver behind the operator's public front (the RFC 0158 receiver): `0214.a2a-push-delivery-authenticated` (§A/§C — at least one POST, `Authorization: {scheme} {credentials}`, `application/a2a+json`, a `StreamResponse` naming the task), `0214.a2a-push-no-openwop-signature`, `0214.a2a-push-no-redirect` (§B — a 307 target receives nothing), `0214.a2a-push-discard-on-delete` (§A, with a live-config positive control) and `0214.a2a-push-fork-no-push` (§D). Every leg suspends its task at INPUT_REQUIRED BEFORE registering, so none can pass on a push nobody owed; without a public https front the legs record `blocked` (a conforming host refuses a loopback destination), never a pass and never a relaxed guard. Stated limit: the delivery-time DNS re-resolve arm is host-unit-tested; the suite does not control the host's resolver.
|
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
# --legacy-peer-deps is REQUIRED, not optional: the exact peer pin is what npm's
|
|
12
12
|
# default resolver refuses. npm 10.9 fails outright with
|
|
13
13
|
# "Cannot read properties of null (reading 'edgesOut')" — use npm >= 11.
|
|
14
|
-
npm install --legacy-peer-deps @openwop/openwop-conformance@2.39.
|
|
14
|
+
npm install --legacy-peer-deps @openwop/openwop-conformance@2.39.1 @openwop/spec-artifacts@2.39.1
|
|
15
15
|
# or run without install:
|
|
16
16
|
npx @openwop/openwop-conformance --base-url https://api.example.com --api-key hk_test_...
|
|
17
17
|
```
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@openwop/openwop-conformance",
|
|
3
|
-
"version": "2.39.
|
|
3
|
+
"version": "2.39.1",
|
|
4
4
|
"description": "Production-ready black-box conformance suite for OpenWOP v1.0 compliant servers.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -56,6 +56,6 @@
|
|
|
56
56
|
"@openwop/spec-artifacts": "file:../spec-artifacts"
|
|
57
57
|
},
|
|
58
58
|
"peerDependencies": {
|
|
59
|
-
"@openwop/spec-artifacts": "2.39.
|
|
59
|
+
"@openwop/spec-artifacts": "2.39.1"
|
|
60
60
|
}
|
|
61
61
|
}
|
package/requirements.json
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
"generatedFrom": "src/scenarios/*.test.ts",
|
|
4
4
|
"counts": {
|
|
5
5
|
"files": 633,
|
|
6
|
-
"tests":
|
|
7
|
-
"withStableId":
|
|
6
|
+
"tests": 2423,
|
|
7
|
+
"withStableId": 2423,
|
|
8
8
|
"interpolatedTitles": 0,
|
|
9
9
|
"explicitIds": 2304
|
|
10
10
|
},
|
|
@@ -27072,15 +27072,10 @@
|
|
|
27072
27072
|
{
|
|
27073
27073
|
"id": "openwop.it.v2-a2a-push-delivery.a-c-a-transition-after-registration-is-posted-to-the-registered-destination-with",
|
|
27074
27074
|
"file": "v2-a2a-push-delivery.test.ts",
|
|
27075
|
-
"line":
|
|
27076
|
-
"title": "§A/§C — a transition after registration is POSTed to the registered destination with the registered Authorization
|
|
27075
|
+
"line": 189,
|
|
27076
|
+
"title": "§A/§C — a transition after registration is POSTed to the registered destination with the registered Authorization",
|
|
27077
27077
|
"explicitId": null,
|
|
27078
27078
|
"citations": [
|
|
27079
|
-
{
|
|
27080
|
-
"section": "spec/v2/core/interop.md §\"A2A push delivery\" (RFC 0214)",
|
|
27081
|
-
"requirement": null,
|
|
27082
|
-
"interpolated": true
|
|
27083
|
-
},
|
|
27084
27079
|
{
|
|
27085
27080
|
"section": null,
|
|
27086
27081
|
"requirement": null,
|
|
@@ -27103,6 +27098,19 @@
|
|
|
27103
27098
|
"section": "A2A v1.0.1 §4.3.3 (StreamResponse)",
|
|
27104
27099
|
"requirement": null,
|
|
27105
27100
|
"interpolated": true
|
|
27101
|
+
}
|
|
27102
|
+
]
|
|
27103
|
+
},
|
|
27104
|
+
{
|
|
27105
|
+
"id": "openwop.it.v2-a2a-push-delivery.c-an-a2a-push-carries-no-openwop-signature",
|
|
27106
|
+
"file": "v2-a2a-push-delivery.test.ts",
|
|
27107
|
+
"line": 203,
|
|
27108
|
+
"title": "§C — an A2A push carries no OpenWOP signature",
|
|
27109
|
+
"explicitId": null,
|
|
27110
|
+
"citations": [
|
|
27111
|
+
{
|
|
27112
|
+
"section": "spec/v2/core/interop.md §\"A2A push delivery\" (RFC 0214)",
|
|
27113
|
+
"requirement": "positive control: at least one push arrived to read headers from"
|
|
27106
27114
|
},
|
|
27107
27115
|
{
|
|
27108
27116
|
"section": null,
|
|
@@ -27114,7 +27122,7 @@
|
|
|
27114
27122
|
{
|
|
27115
27123
|
"id": "openwop.it.v2-a2a-push-delivery.b-a-3xx-from-the-destination-is-a-failed-delivery-the-redirect-target-receives-n",
|
|
27116
27124
|
"file": "v2-a2a-push-delivery.test.ts",
|
|
27117
|
-
"line":
|
|
27125
|
+
"line": 215,
|
|
27118
27126
|
"title": "§B — a 3xx from the destination is a failed delivery: the redirect target receives nothing, credential or not",
|
|
27119
27127
|
"explicitId": null,
|
|
27120
27128
|
"citations": [
|
|
@@ -27138,7 +27146,7 @@
|
|
|
27138
27146
|
{
|
|
27139
27147
|
"id": "openwop.it.v2-a2a-push-delivery.a-after-delete-no-further-push-reaches-that-destination-while-a-live-config-on-t",
|
|
27140
27148
|
"file": "v2-a2a-push-delivery.test.ts",
|
|
27141
|
-
"line":
|
|
27149
|
+
"line": 237,
|
|
27142
27150
|
"title": "§A — after Delete no further push reaches that destination, while a live config on the same task still receives",
|
|
27143
27151
|
"explicitId": null,
|
|
27144
27152
|
"citations": [
|
|
@@ -27167,7 +27175,7 @@
|
|
|
27167
27175
|
{
|
|
27168
27176
|
"id": "openwop.it.v2-a2a-push-delivery.d-a-replay-fork-of-a-pushed-run-delivers-nothing-to-the-source-run-s-destination",
|
|
27169
27177
|
"file": "v2-a2a-push-delivery.test.ts",
|
|
27170
|
-
"line":
|
|
27178
|
+
"line": 263,
|
|
27171
27179
|
"title": "§D — a replay fork of a pushed run delivers nothing to the source run's destination",
|
|
27172
27180
|
"explicitId": null,
|
|
27173
27181
|
"citations": [
|
|
@@ -29648,7 +29656,7 @@
|
|
|
29648
29656
|
{
|
|
29649
29657
|
"id": "openwop.it.v2-lane-issuer-advertised.a-windowed-revocation-rule-advertises-revocationwindowseconds",
|
|
29650
29658
|
"file": "v2-lane-issuer-advertised.test.ts",
|
|
29651
|
-
"line":
|
|
29659
|
+
"line": 93,
|
|
29652
29660
|
"title": "a windowed revocation rule advertises revocationWindowSeconds",
|
|
29653
29661
|
"explicitId": "openwop.requirement.0170.lane-issuer-advertised.window",
|
|
29654
29662
|
"citations": [
|
|
@@ -29662,7 +29670,7 @@
|
|
|
29662
29670
|
{
|
|
29663
29671
|
"id": "openwop.it.v2-lane-issuer-advertised.a-lane-advertises-only-a-revocation-rule-its-identity-md-2-2-row-lists",
|
|
29664
29672
|
"file": "v2-lane-issuer-advertised.test.ts",
|
|
29665
|
-
"line":
|
|
29673
|
+
"line": 104,
|
|
29666
29674
|
"title": "a lane advertises only a revocation rule its identity.md §2.2 row lists",
|
|
29667
29675
|
"explicitId": "openwop.requirement.0170.lane-issuer-advertised.lane-rule",
|
|
29668
29676
|
"citations": [
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
{
|
|
2
2
|
"_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.",
|
|
3
3
|
"package": "@openwop/spec-artifacts",
|
|
4
|
-
"version": "2.39.
|
|
5
|
-
"corpusTag": "v2.39.
|
|
4
|
+
"version": "2.39.1",
|
|
5
|
+
"corpusTag": "v2.39.1",
|
|
6
6
|
"files": {
|
|
7
7
|
"api/.redocly.lint-ignore.yaml": "bf5a8350b88a72fa43f59605ed8d903ed24b6cfccda5e45509c9f6ed9ee4e712",
|
|
8
8
|
"api/asyncapi.yaml": "d5ecb9ee6114582be3b1f662c84bfac9ae96dae7bacb853e461168f70a8e1c7d",
|
|
9
9
|
"api/grpc/openwop.proto": "c3e72bb17cba514ee98feb6434e6c9b6ea6795bfd086489ec69fd882dd1ad977",
|
|
10
10
|
"api/openapi.yaml": "6366b5514be71098e9ea41fc81ff52bc39db1a547b353c0b344cc2a2bf5370aa",
|
|
11
11
|
"api/redocly.yaml": "b0604c89b2ca6d5076ec25725c539dad44a741a811fe524439ee6daef8baa09f",
|
|
12
|
-
"api/seams-v2.yaml": "
|
|
13
|
-
"api/v2/asyncapi.yaml": "
|
|
14
|
-
"api/v2/openapi.yaml": "
|
|
12
|
+
"api/seams-v2.yaml": "edff974e28c055f4d3f605078a32315475053cf4aeb4565f461ac6fe65462bdb",
|
|
13
|
+
"api/v2/asyncapi.yaml": "8dc0060855a0edf49a7f235016657f86ae3ba2d04bed99d0d9579d4f01f65c11",
|
|
14
|
+
"api/v2/openapi.yaml": "5c673efed4d9c350882b85d88f6c8e934793a2238b2f316ba66278ba7a75d121",
|
|
15
15
|
"api/v2/redocly.yaml": "1e66b60e6118ad11a823bb620678be464d99dfe50a40e3e6f93ec9429b88b34c",
|
|
16
16
|
"schemas/README.md": "0c0b737ffcf8f30e7d2809cec8a498232de710f41443212922ad8337cdde0b51",
|
|
17
17
|
"schemas/a2a-task-state.schema.json": "75d5049dea8bd873ff0e7546f1c60c8d36c219bec7084264360be54a8be30ae1",
|
|
@@ -204,7 +204,7 @@
|
|
|
204
204
|
"schemas/workspace-file.schema.json": "464de85c2a068243084ee9c1d969bc7cd5d8f7948574e58450d6493c38a0e1e4",
|
|
205
205
|
"spec/v1/alias-detectors.json": "2401fcb1c18cdd688c018b3d716ae6bca85c5e356220ee2b793bd9d81872412d",
|
|
206
206
|
"spec/v1/capability-declaration-classes.json": "e7729aed5c4b4e1dd02abab0530f14cc95f5d4070fe51fb139e7f5cccefa00c6",
|
|
207
|
-
"spec/v1/core-standard-manifest.json": "
|
|
207
|
+
"spec/v1/core-standard-manifest.json": "ffb07755718c26e734e30cd674469d232bdd9fca4e8743886090ab4a81df90a5",
|
|
208
208
|
"spec/v1/deprecations.json": "2d03f4729810280147ea08c630ea65434f2dc5370567d0aac41c3595f8337d40",
|
|
209
209
|
"spec/v1/deprecations.schema.json": "3e393c405d2a41b467d8c5e3c468549078df1ce6a6d2588fc488097b95d9b55b",
|
|
210
210
|
"spec/v1/event-codemap.json": "3da60d884157793a360da532a9fcbbfb5285636db325a74cec94b34622186d97",
|
|
@@ -292,9 +292,9 @@
|
|
|
292
292
|
"spec/v2/path-manifest.json": "ae9b56d03a701061fd48ad0b73cb0373493f6a4547da92763b422295b5e19535",
|
|
293
293
|
"spec/v2/peer-dependency-aliases.json": "d10299280abee08258502925bc327293ee413e0108cd6e6ec75ff6110653308d",
|
|
294
294
|
"spec/v2/profiles.json": "0636f19fceae625390003a347e70ef4797d84766b5c24ce8a02cea52aadebca4",
|
|
295
|
-
"spec/v2/release.json": "
|
|
295
|
+
"spec/v2/release.json": "c1c2d051b65444c959464ce385bf9851f3438a72a17a03405fc492421d454114",
|
|
296
296
|
"spec/v2/retention-floors.json": "eaf3722d95c79947af1d4269ef85117e126518c588cfcf1a2b21b97269f51624",
|
|
297
|
-
"spec/v2/surface-baseline.json": "
|
|
297
|
+
"spec/v2/surface-baseline.json": "648c5e22fea9eaae6c900d7de1656209af0b5a8f5fa76b64885c0e6ab7cc3089"
|
|
298
298
|
},
|
|
299
|
-
"corpusCommit": "
|
|
299
|
+
"corpusCommit": "64073df2c4d11a5b8a165ead4281d2557495e25b"
|
|
300
300
|
}
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
* @see spec/v2/core/interop.md §"A2A push delivery"
|
|
31
31
|
* @see spec/v2/core/security-defaults.md §"Onward hops"
|
|
32
32
|
*/
|
|
33
|
-
import { describe, it, expect } from 'vitest';
|
|
33
|
+
import { afterAll, describe, it, expect } from 'vitest';
|
|
34
34
|
import { randomBytes } from 'node:crypto';
|
|
35
35
|
import type { ServerResponse } from 'node:http';
|
|
36
36
|
import { driver } from '../lib/driver.js';
|
|
@@ -103,13 +103,26 @@ async function until(pred: () => boolean, ms: number): Promise<boolean> {
|
|
|
103
103
|
return pred();
|
|
104
104
|
}
|
|
105
105
|
const wait = (ms: number): Promise<void> => new Promise((ok) => setTimeout(ok, ms));
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Budgets. On a public cut every step crosses the operator's tunnel (suite → host
|
|
109
|
+
* front, host → receiver front), and the 2.39.0 public cut lost three legs to
|
|
110
|
+
* vitest's per-test timeout — not to an assertion — while deliveries were in
|
|
111
|
+
* fact arriving (#1537 precedent: the RFC 0199 state leg). Loopback keeps the
|
|
112
|
+
* tight budgets; a fronted run gets room for the round trips.
|
|
113
|
+
*/
|
|
114
|
+
const FRONTED = Boolean(process.env.OPENWOP_WEBHOOK_RECEIVER_URL);
|
|
115
|
+
const ARRIVAL_MS = FRONTED ? 60_000 : 20_000;
|
|
116
|
+
const SETTLE_MS = FRONTED ? 45_000 : 10_000;
|
|
117
|
+
const LEG_MS = FRONTED ? 240_000 : 60_000;
|
|
118
|
+
const FORK_LEG_MS = FRONTED ? 300_000 : 90_000;
|
|
106
119
|
const header = (h: ScopedHit, name: string): string | undefined => { const v = h.headers[name.toLowerCase()]; return Array.isArray(v) ? v.join(',') : v; };
|
|
107
120
|
|
|
108
121
|
async function runStatus(taskId: string): Promise<string | undefined> {
|
|
109
122
|
const r = await driver.get(`/runs/${encodeURIComponent(taskId)}`);
|
|
110
123
|
return r.status === 200 ? ((r.json as { status?: string }).status) : undefined;
|
|
111
124
|
}
|
|
112
|
-
async function settle(taskId: string, want: (s: string | undefined) => boolean, ms =
|
|
125
|
+
async function settle(taskId: string, want: (s: string | undefined) => boolean, ms = SETTLE_MS): Promise<string | undefined> {
|
|
113
126
|
const end = Date.now() + ms;
|
|
114
127
|
let s = await runStatus(taskId);
|
|
115
128
|
while (!want(s) && Date.now() < end) { await wait(150); s = await runStatus(taskId); }
|
|
@@ -136,36 +149,68 @@ function unmeasurable(rx: ScopedReceiver, created: Rpc): string | null {
|
|
|
136
149
|
return null;
|
|
137
150
|
}
|
|
138
151
|
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
152
|
+
/**
|
|
153
|
+
* One delivery, read by two legs. Each leg cites exactly one requirement id —
|
|
154
|
+
* the ledger keeps the LAST id an it() cites, so the 2.39.0 cut, whose single
|
|
155
|
+
* §A/§C it() cited both, recorded `no-openwop-signature` and silently dropped
|
|
156
|
+
* `delivery-authenticated`. The delivery runs once (lazily, in the first leg)
|
|
157
|
+
* and the second leg reads the same hits; when the delivery cannot be made the
|
|
158
|
+
* second leg records `blocked` with the reason instead of vanishing.
|
|
159
|
+
*/
|
|
160
|
+
type Delivery =
|
|
161
|
+
| { kind: 'measured'; hits: ScopedHit[]; taskId: string; cred: string; rx: ScopedReceiver }
|
|
162
|
+
| { kind: 'skip'; skip: 'inapplicable' | 'blocked'; reason: string };
|
|
163
|
+
let delivery: Promise<Delivery> | undefined;
|
|
164
|
+
let deliveryRx: ScopedReceiver | undefined;
|
|
165
|
+
function deliverOnce(id: string = R('a2a-push-delivery-authenticated')): Promise<Delivery> {
|
|
166
|
+
delivery ??= (async (): Promise<Delivery> => {
|
|
142
167
|
const g = await gate();
|
|
143
|
-
if (!g.ok) return
|
|
168
|
+
if (!g.ok) return { kind: 'skip', skip: g.kind, reason: g.reason };
|
|
144
169
|
const { rx, hits } = await receiver();
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
170
|
+
deliveryRx = rx;
|
|
171
|
+
const taskId = await suspendedTask(g.url, id);
|
|
172
|
+
const cred = `owpush${randomBytes(12).toString('hex')}`;
|
|
173
|
+
const created = await create(g.url, taskId, rx.url, { authentication: { scheme: 'Bearer', credentials: cred } });
|
|
174
|
+
const why = unmeasurable(rx, created);
|
|
175
|
+
if (why !== null) { await rpc(g.url, 'CancelTask', { id: taskId }); return { kind: 'skip', skip: 'blocked', reason: why }; }
|
|
176
|
+
expect(created.error, req(id, DOC, `Create on a suspended task with the public receiver MUST succeed (got ${JSON.stringify(created.error)})`)).toBeUndefined();
|
|
177
|
+
await rpc(g.url, 'SendMessage', { message: acceptMessage(taskId) });
|
|
178
|
+
await settle(taskId, (s) => s !== undefined && TERMINAL.has(s));
|
|
179
|
+
const arrived = await until(() => hits.length > 0, ARRIVAL_MS);
|
|
180
|
+
if (!arrived && absenceIsUnmeasured(rx)) return { kind: 'skip', skip: 'blocked', reason: noDeliveryCause(rx, 'A2A push') };
|
|
181
|
+
return { kind: 'measured', hits, taskId, cred, rx };
|
|
182
|
+
})();
|
|
183
|
+
return delivery;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
describe('RFC 0214 — v2-a2a-push-delivery (host POSTs A2A push to a suite-owned receiver)', () => {
|
|
187
|
+
afterAll(async () => { await deliveryRx?.close(); });
|
|
188
|
+
|
|
189
|
+
it('§A/§C — a transition after registration is POSTed to the registered destination with the registered Authorization', async () => {
|
|
190
|
+
const id = R('a2a-push-delivery-authenticated');
|
|
191
|
+
const d = await deliverOnce(id);
|
|
192
|
+
if (d.kind === 'skip') return softSkip(d.skip, d.reason);
|
|
193
|
+
const { hits, taskId, cred, rx } = d;
|
|
194
|
+
expect(hits.length, req(id, `${DOC} §C ("at least one attempt")`, `a transition after registration MUST be POSTed at least once to the registered destination — ${noDeliveryCause(rx, 'A2A push')}`)).toBeGreaterThan(0);
|
|
195
|
+
const h = hits[0]!;
|
|
196
|
+
expect(h.method, req(id, 'A2A v1.0.1 §4.3.3', 'a push is an HTTP POST')).toBe('POST');
|
|
197
|
+
expect(header(h, 'authorization'), req(id, `${DOC} §A (A2A v1.0.1 §4.3.3 "MUST include authentication credentials")`, 'the push MUST carry the registered credential as Authorization: {scheme} {credentials}')).toBe(`Bearer ${cred}`);
|
|
198
|
+
expect((header(h, 'content-type') ?? '').split(';')[0]!.trim(), req(id, 'A2A v1.0.1 §4.3.3', 'the push body is application/a2a+json')).toBe('application/a2a+json');
|
|
199
|
+
const body = JSON.parse(h.body || '{}') as { statusUpdate?: { taskId?: string; status?: { state?: string } } };
|
|
200
|
+
expect(body.statusUpdate?.taskId, req(id, 'A2A v1.0.1 §4.3.3 (StreamResponse)', `the push body MUST be a StreamResponse statusUpdate naming the task (got ${h.body.slice(0, 200)})`)).toBe(taskId);
|
|
201
|
+
}, LEG_MS);
|
|
202
|
+
|
|
203
|
+
it('§C — an A2A push carries no OpenWOP signature', async () => {
|
|
204
|
+
const id = R('a2a-push-no-openwop-signature');
|
|
205
|
+
let d: Delivery;
|
|
206
|
+
try { d = await deliverOnce(); }
|
|
207
|
+
catch (err) { return softSkip('blocked', `the delivery this leg reads was not made — the §A/§C leg failed first: ${err instanceof Error ? err.message.slice(0, 200) : String(err)}`); }
|
|
208
|
+
if (d.kind === 'skip') return softSkip(d.skip, d.reason);
|
|
209
|
+
expect(d.hits.length, req(id, DOC, 'positive control: at least one push arrived to read headers from')).toBeGreaterThan(0);
|
|
210
|
+
for (const x of d.hits) {
|
|
211
|
+
expect(header(x, 'openwop-signature'), req(id, `${DOC} §C ("no OpenWOP signature")`, 'an A2A push MUST NOT carry an OpenWOP-Signature — A2A defines no secret exchange to verify it')).toBeUndefined();
|
|
212
|
+
}
|
|
213
|
+
}, LEG_MS);
|
|
169
214
|
|
|
170
215
|
it('§B — a 3xx from the destination is a failed delivery: the redirect target receives nothing, credential or not', async () => {
|
|
171
216
|
const id = R('a2a-push-no-redirect');
|
|
@@ -181,13 +226,13 @@ describe('RFC 0214 — v2-a2a-push-delivery (host POSTs A2A push to a suite-owne
|
|
|
181
226
|
expect(created.error, req(id, DOC, `Create MUST succeed (got ${JSON.stringify(created.error)})`)).toBeUndefined();
|
|
182
227
|
await rpc(g.url, 'SendMessage', { message: acceptMessage(taskId) });
|
|
183
228
|
await settle(taskId, (s) => s !== undefined && TERMINAL.has(s));
|
|
184
|
-
const arrived = await until(() => origin.hits.length > 0,
|
|
229
|
+
const arrived = await until(() => origin.hits.length > 0, ARRIVAL_MS);
|
|
185
230
|
if (!arrived && absenceIsUnmeasured(origin.rx)) return softSkip('blocked', noDeliveryCause(origin.rx, 'A2A push'));
|
|
186
231
|
expect(origin.hits.length, req(id, DOC, `positive control: the registered destination MUST receive the push it then redirects — ${noDeliveryCause(origin.rx, 'A2A push')}`)).toBeGreaterThan(0);
|
|
187
232
|
await wait(4000); // any retry or followed redirect lands in this window
|
|
188
233
|
expect(target.hits.length, req(id, `${DOC} §B; webhooks.md §Egress ("refuse to follow redirects")`, 'the redirect target MUST receive nothing: a 3xx is a delivery failure and the credential MUST NOT be sent after a redirect')).toBe(0);
|
|
189
234
|
} finally { await origin.rx.close(); await target.rx.close(); }
|
|
190
|
-
},
|
|
235
|
+
}, LEG_MS);
|
|
191
236
|
|
|
192
237
|
it('§A — after Delete no further push reaches that destination, while a live config on the same task still receives', async () => {
|
|
193
238
|
const id = R('a2a-push-discard-on-delete');
|
|
@@ -207,13 +252,13 @@ describe('RFC 0214 — v2-a2a-push-delivery (host POSTs A2A push to a suite-owne
|
|
|
207
252
|
expect(del.error, req(id, DOC, `Delete of the caller's own config MUST succeed (got ${JSON.stringify(del.error)})`)).toBeUndefined();
|
|
208
253
|
await rpc(g.url, 'SendMessage', { message: acceptMessage(taskId) });
|
|
209
254
|
await settle(taskId, (s) => s !== undefined && TERMINAL.has(s));
|
|
210
|
-
const arrived = await until(() => kept.hits.length > 0,
|
|
255
|
+
const arrived = await until(() => kept.hits.length > 0, ARRIVAL_MS);
|
|
211
256
|
if (!arrived && absenceIsUnmeasured(kept.rx)) return softSkip('blocked', noDeliveryCause(kept.rx, 'A2A push'));
|
|
212
257
|
expect(kept.hits.length, req(id, DOC, `positive control: the config that was NOT deleted MUST still receive the push — ${noDeliveryCause(kept.rx, 'A2A push')}`)).toBeGreaterThan(0);
|
|
213
258
|
await wait(3000);
|
|
214
259
|
expect(dropped.hits.length, req(id, `${DOC} §A ("dropped when the config is deleted")`, 'a deleted config MUST receive nothing further — its destination credential is discarded with it')).toBe(0);
|
|
215
260
|
} finally { await kept.rx.close(); await dropped.rx.close(); }
|
|
216
|
-
},
|
|
261
|
+
}, LEG_MS);
|
|
217
262
|
|
|
218
263
|
it('§D — a replay fork of a pushed run delivers nothing to the source run\'s destination', async () => {
|
|
219
264
|
const id = R('a2a-push-fork-no-push');
|
|
@@ -230,7 +275,7 @@ describe('RFC 0214 — v2-a2a-push-delivery (host POSTs A2A push to a suite-owne
|
|
|
230
275
|
if (why !== null) { await rpc(g.url, 'CancelTask', { id: taskId }); return softSkip('blocked', why); }
|
|
231
276
|
await rpc(g.url, 'SendMessage', { message: acceptMessage(taskId) });
|
|
232
277
|
await settle(taskId, (s) => s !== undefined && TERMINAL.has(s));
|
|
233
|
-
const arrived = await until(() => hits.length > 0,
|
|
278
|
+
const arrived = await until(() => hits.length > 0, ARRIVAL_MS);
|
|
234
279
|
if (!arrived && absenceIsUnmeasured(rx)) return softSkip('blocked', noDeliveryCause(rx, 'A2A push'));
|
|
235
280
|
expect(hits.length, req(id, DOC, `positive control: the source run MUST have pushed before the fork — ${noDeliveryCause(rx, 'A2A push')}`)).toBeGreaterThan(0);
|
|
236
281
|
await wait(3000);
|
|
@@ -238,9 +283,9 @@ describe('RFC 0214 — v2-a2a-push-delivery (host POSTs A2A push to a suite-owne
|
|
|
238
283
|
const fork = await driver.post(`/runs/${encodeURIComponent(taskId)}:fork`, { mode: 'replay' });
|
|
239
284
|
if (fork.status < 200 || fork.status >= 300) return softSkip('blocked', `replay is advertised but forkRun answered ${fork.status} ${JSON.stringify(fork.json)} — the fork leg is unmeasured`);
|
|
240
285
|
const child = (fork.json as { runId?: string } | undefined)?.runId;
|
|
241
|
-
if (typeof child === 'string') await settle(child, (s) => s !== undefined && TERMINAL.has(s)
|
|
286
|
+
if (typeof child === 'string') await settle(child, (s) => s !== undefined && TERMINAL.has(s));
|
|
242
287
|
await wait(4000);
|
|
243
288
|
expect(hits.length, req(id, `${DOC} §D; replay.md §Suppression ("MUST NOT deliver events a replay re-emits")`, `a replay fork MUST NOT push to the source run's destination (deliveries ${before} before the fork, ${hits.length} after)`)).toBe(before);
|
|
244
289
|
} finally { await rx.close(); }
|
|
245
|
-
},
|
|
290
|
+
}, FORK_LEG_MS);
|
|
246
291
|
});
|
|
@@ -74,7 +74,15 @@ describe('v2 lane-issuer-advertised (RFC 0170 §B.2–§B.4)', () => {
|
|
|
74
74
|
expect(LANES.has(name), req('openwop.requirement.0170.lane-issuer-advertised.members', DOC, `auth.lanes[].lane MUST be one of the ten lanes (got ${name})`)).toBe(true);
|
|
75
75
|
const issuers = l['issuers'];
|
|
76
76
|
expect(Array.isArray(issuers) && issuers.length > 0 && issuers.every((i) => typeof i === 'string' && i.length > 0), req('openwop.requirement.0170.lane-issuer-advertised.members', 'spec/v2/core/identity.md §2.2', `lane ${name} MUST advertise its trust root in issuers[] (min 1, non-empty strings)`)).toBe(true);
|
|
77
|
-
|
|
77
|
+
// identity.md §2.2: a lane whose row reads "—" (`anonymous`) has no
|
|
78
|
+
// revocation rule, so it MAY omit `revocation` — the schema made it
|
|
79
|
+
// optional there in 2.38.0 (openwop#1540), and until 2.39.1 this leg
|
|
80
|
+
// still demanded it, failing a host that followed the schema and the
|
|
81
|
+
// prose (measured on openwop-app). If such a lane does advertise one,
|
|
82
|
+
// it must still be a known member. Every other lane MUST name its rule.
|
|
83
|
+
if (!(LANE_RULES[name] === null && l['revocation'] === undefined)) {
|
|
84
|
+
expect(REVOCATION.has(String(l['revocation'])), req('openwop.requirement.0170.lane-issuer-advertised.members', 'spec/v2/core/identity.md §2.2', `lane ${name} MUST name its revocation rule`)).toBe(true);
|
|
85
|
+
}
|
|
78
86
|
expect(ASSURANCE.has(String(l['minimumAssurance'])), req('openwop.requirement.0170.lane-issuer-advertised.members', 'spec/v2/core/identity.md §2.3', `lane ${name} MUST advertise minimumAssurance: bearer | sender-constrained | key-bound`)).toBe(true);
|
|
79
87
|
if (l['delegationProofs'] !== undefined) {
|
|
80
88
|
expect(Array.isArray(l['delegationProofs']) && (l['delegationProofs'] as unknown[]).every((p) => PROOFS.has(String(p))), req('openwop.requirement.0170.lane-issuer-advertised.members', 'spec/v2/core/identity.md §2.4', `lane ${name}: delegationProofs[] MUST be drawn from mtls-key-binding | dpop | svid-chain`)).toBe(true);
|