@openwop/spec-artifacts 2.0.0-rc.0 → 2.0.0-rc.10
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/CORPUS-STAMP.json +21 -21
- package/api/seams-v2.yaml +216 -3
- package/api/v2/asyncapi.yaml +1 -1
- package/api/v2/openapi.yaml +1 -1
- package/package.json +18 -5
- package/schemas/certification-bundle-v2.schema.json +119 -27
- package/schemas/v2/capabilities.schema.json +66 -0
- package/schemas/v2/certification-bundle.schema.json +45 -4
- package/schemas/v2/error-envelope.schema.json +5 -1
- package/schemas/v2/ids.schema.json +118 -21
- package/schemas/v2/node-pack-manifest.schema.json +10 -0
- package/schemas/v2/registry-version-manifest.schema.json +9 -27
- package/schemas/v2/run-event-payloads.schema.json +1 -1
- package/schemas/v2/run-event.schema.json +4 -127
- package/schemas/v2/run-snapshot.schema.json +22 -1
- package/spec/v1/core-standard-manifest.json +2 -2
- package/spec/v1/gaps.json +20 -20
- package/spec/v2/declaration.json +8 -0
- package/spec/v2/errors.json +18 -0
- package/spec/v2/facets/webhooks.schema.json +24 -1
- package/spec/v2/release.json +2 -2
package/CORPUS-STAMP.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
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.0.0-rc.
|
|
4
|
+
"version": "2.0.0-rc.10",
|
|
5
5
|
"corpusTag": null,
|
|
6
6
|
"files": {
|
|
7
7
|
"api/.redocly.lint-ignore.yaml": "bf5a8350b88a72fa43f59605ed8d903ed24b6cfccda5e45509c9f6ed9ee4e712",
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
"api/grpc/openwop.proto": "c3e72bb17cba514ee98feb6434e6c9b6ea6795bfd086489ec69fd882dd1ad977",
|
|
10
10
|
"api/openapi.yaml": "39081c59fb696159806b0f2f9a42e7e9ff830d622fcf2ad4159b21357580a955",
|
|
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": "09450ae021c2230e440257875149337984f319b42a7808037130305e3c48390f",
|
|
13
|
+
"api/v2/asyncapi.yaml": "0dbb71b3832ee159e03f633cbb5464a14b565d2335b9f00ec8aee456bac950be",
|
|
14
|
+
"api/v2/openapi.yaml": "a5ad8b811af848060c62feaebc9be8450bc5ca113ba84158c3b97a3bdef66ad9",
|
|
15
15
|
"api/v2/redocly.yaml": "1e66b60e6118ad11a823bb620678be464d99dfe50a40e3e6f93ec9429b88b34c",
|
|
16
16
|
"schemas/README.md": "0c0b737ffcf8f30e7d2809cec8a498232de710f41443212922ad8337cdde0b51",
|
|
17
17
|
"schemas/a2a-task-state.schema.json": "c9365918f993f943b4b619d42551eb066a1ed33a08d895d51b395432a5b1f1bc",
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
"schemas/audit-verify-result.schema.json": "e8fd013fb610ba5db27ab0113ec2eb18e7da5f9310dd3de2dd3dc87a259c21fe",
|
|
33
33
|
"schemas/budget-policy.schema.json": "3d4fe30ae129fe136ab9ece395f2a2a42a76360786b1b9a1d5f1cbc753eb5b39",
|
|
34
34
|
"schemas/capabilities.schema.json": "e672c35d503532d8039b5552115f5ec150d60317f537f13180d830b0fe315947",
|
|
35
|
-
"schemas/certification-bundle-v2.schema.json": "
|
|
35
|
+
"schemas/certification-bundle-v2.schema.json": "2f85530dd04824a15810c94e96869362dee1e78396eca21fdd18e5501416bb7d",
|
|
36
36
|
"schemas/channel-presence-payload.schema.json": "f9d0ef4219814c2b765baf3e68cbe5eea2cb42379f516a93a0459dcd5f7db47e",
|
|
37
37
|
"schemas/channel-written-payload.schema.json": "54723a56bc5a35232f64544ca686ac1ac959a5fb05b32b2401facca6b3ef51a3",
|
|
38
38
|
"schemas/chat-card-pack-manifest.schema.json": "402f7e9081cc39857a52e772061f4e034a957dcbc17501fe6e8e0bcb3d337e42",
|
|
@@ -115,8 +115,8 @@
|
|
|
115
115
|
"schemas/v2/artifact-type-pack-manifest.schema.json": "c911757562e521cb4f31a47c097f562573b64087efe60c8acb81fd352367d300",
|
|
116
116
|
"schemas/v2/audit-verify-result.schema.json": "cb54c4d89ba5dfb73f49aa8959a980be65c2dc2a87a12f71ba36d3e836fe85da",
|
|
117
117
|
"schemas/v2/budget-policy.schema.json": "c7449daeb6e1d95e7a047b8c2814d3d54748697c27046972834874867d9b5f4c",
|
|
118
|
-
"schemas/v2/capabilities.schema.json": "
|
|
119
|
-
"schemas/v2/certification-bundle.schema.json": "
|
|
118
|
+
"schemas/v2/capabilities.schema.json": "792669b2cc7b1fd44ce9a4fd3e79696ad1277734e29299a4504b39eda15913ed",
|
|
119
|
+
"schemas/v2/certification-bundle.schema.json": "d441198893c01cd14d84abe9c5bf591b69f47554db749c01899512f36cea11fa",
|
|
120
120
|
"schemas/v2/channel-presence-payload.schema.json": "9475d46f358d21c19126e78204987a5633979917a2293653354ef5c5e044d54e",
|
|
121
121
|
"schemas/v2/channel-written-payload.schema.json": "ccecff3c71a3275ad8db035ac0e04db25e6f8d23cf091ddbcd5a60d1be1cbb6b",
|
|
122
122
|
"schemas/v2/chat-card-pack-manifest.schema.json": "566982ce509a96d1619d58a72e383eff0773fe43fc65e4bfc85a4fe158f4eaff",
|
|
@@ -141,7 +141,7 @@
|
|
|
141
141
|
"schemas/v2/envelopes/schema.request.schema.json": "be2c5f7aa881cdd252ccff47ac02193659e1393633a1541f4297383205d384a2",
|
|
142
142
|
"schemas/v2/envelopes/schema.response.schema.json": "d049a081267c06c28879c331b147f3ed821b14ccfd93005c67aff64db0a8c68e",
|
|
143
143
|
"schemas/v2/envelopes/ui.a2ui-surface.schema.json": "0a06fbbdc8ba797a6818c79336a98e211ac5ba5747945b4e4098072cd3974d79",
|
|
144
|
-
"schemas/v2/error-envelope.schema.json": "
|
|
144
|
+
"schemas/v2/error-envelope.schema.json": "d550beeab958b528c8734fd32e74c438006b99172c5c586f9e0af20ef4b2bee7",
|
|
145
145
|
"schemas/v2/eval-summary.schema.json": "dfc995c8481ed212e6f3d83de982547898a7938be8c891ddb0d3efe84352908d",
|
|
146
146
|
"schemas/v2/export-bundle.schema.json": "bd28905a7729437ab7f2ad8bb33e13a371b2bf5605a7eb2962a0d246de312d69",
|
|
147
147
|
"schemas/v2/form-content-pack-manifest.schema.json": "307884e57946703b6f86ec283034bf56beb68bea4a000743ebbc9eebeed31b07",
|
|
@@ -149,14 +149,14 @@
|
|
|
149
149
|
"schemas/v2/goal.schema.json": "d202ef21ed3dbff87c25fd4b553fa978862a3200999878d25c5918f6794b3060",
|
|
150
150
|
"schemas/v2/heartbeat-evaluated.schema.json": "4086b1ba1d0547c08b038dfb263ac89416a3e406430db1250156fb2f9b74f8d6",
|
|
151
151
|
"schemas/v2/heartbeat-state-changed.schema.json": "eb68d0082aa996650e3a6b8ccf32457f959cebc7e6728cc7c331b9d171a4bef6",
|
|
152
|
-
"schemas/v2/ids.schema.json": "
|
|
152
|
+
"schemas/v2/ids.schema.json": "dc6c99dea35a3416167b2b883ac08694794da1c7552bbfa48fc489c612d1cf97",
|
|
153
153
|
"schemas/v2/localized-content-language-settings.schema.json": "92240f19a2b4b2f05ab41a797f703485a28813848035478e72f395edd04c1d35",
|
|
154
154
|
"schemas/v2/localized-content-page-response.schema.json": "476b5f2775b42e35e679814a4ce846a7be1d5311d3a748c10df4275a78b0fb27",
|
|
155
155
|
"schemas/v2/localized-content-page.schema.json": "717bb51fbc64d0b34eb0a4b35c8b463d08d505267bf251b4cbc67e0a016a567a",
|
|
156
156
|
"schemas/v2/localized-content-section.schema.json": "29c7bad0ad9ebc6c45211282e8afb3fdb35a4ca075ce0404b6e2c29f35fa5313",
|
|
157
157
|
"schemas/v2/memory-entry.schema.json": "290576ae84f4fef4cdf975932b87963283b11c50ea3d2654b32cd96aa6537c3d",
|
|
158
158
|
"schemas/v2/memory-list-options.schema.json": "f66703bccb68efb28391c273abb66aa117ee5b5ce475c477846ed700c336afcd",
|
|
159
|
-
"schemas/v2/node-pack-manifest.schema.json": "
|
|
159
|
+
"schemas/v2/node-pack-manifest.schema.json": "771328fa73691e7f08fca3c628c4e8ba68fa4e43529faaf1a6358aecf26b13f2",
|
|
160
160
|
"schemas/v2/orchestrator-decision.schema.json": "2da17538e84cfbe70151eb118f1ccf670cff58b8697148e394074d32ac4af6b4",
|
|
161
161
|
"schemas/v2/org-chart-responsibility-view.schema.json": "ebac7d2889bfd659bcf30311efb0d6eb0c7e940b972b6b62da69c7351b5bb586",
|
|
162
162
|
"schemas/v2/pack-lockfile.schema.json": "2685417702c105146b780cd99154296a46578fbb10d81c8c713348ee26fea898",
|
|
@@ -165,15 +165,15 @@
|
|
|
165
165
|
"schemas/v2/prompt-ref.schema.json": "11538fa36a7a652c93100cac4f1857eb4130137b546e3d94890618636d44b729",
|
|
166
166
|
"schemas/v2/prompt-template.schema.json": "494fc83028cb3af5dbb8a943d0e83b2348f7775e9fa02369162bcb58a6f81559",
|
|
167
167
|
"schemas/v2/proposal.schema.json": "72623553611f00e87b4c7972d69ebeba73c2222b01ead75a44a0c2114b679fea",
|
|
168
|
-
"schemas/v2/registry-version-manifest.schema.json": "
|
|
168
|
+
"schemas/v2/registry-version-manifest.schema.json": "270704ebc6bae63be949efbf9503578938b103733db9da3cb8fcbee1cd7684dd",
|
|
169
169
|
"schemas/v2/residency.schema.json": "af2658a7104cbcacd0e20a91226271c4a77f91ef46ae97612768fe743e6091d8",
|
|
170
170
|
"schemas/v2/run-ancestry-response.schema.json": "907e36341ba83a2147a5d76963950b6dcd47506b663ecbccae9dfa553f3724d3",
|
|
171
171
|
"schemas/v2/run-diff-response.schema.json": "6ab6cd265dc7e0a2086c6659c46aa0e7b43e6302949f0adac5d7deb1c7c0ecd3",
|
|
172
|
-
"schemas/v2/run-event-payloads.schema.json": "
|
|
173
|
-
"schemas/v2/run-event.schema.json": "
|
|
172
|
+
"schemas/v2/run-event-payloads.schema.json": "bd5cb6687828a86fb4411d331893ec183dce2c52cb27c22035d4cd7a8bc3c1a2",
|
|
173
|
+
"schemas/v2/run-event.schema.json": "1a9946374af9323b71635d00fed22abe02c300fa2cf3ae3e9c30f3e553e408ec",
|
|
174
174
|
"schemas/v2/run-options.schema.json": "6d6052596ab0f17acfb00fdfc89907da7724f952e5ffbe1f81d94ba23d4c77cd",
|
|
175
175
|
"schemas/v2/run-orchestrator-decided-event.schema.json": "bb76e15ff72e669f12938684033b55dc567470e1a378e19ffc3fa0e4034ab5a7",
|
|
176
|
-
"schemas/v2/run-snapshot.schema.json": "
|
|
176
|
+
"schemas/v2/run-snapshot.schema.json": "01408d8dac93e2d08d8db30f9cd7a4d903dce882a60bc1d48c3e6b921267f2a3",
|
|
177
177
|
"schemas/v2/security-advisory.schema.json": "6a382f737730a738d634266315e9d335e5760020a0cdd9f30727c2f987a01770",
|
|
178
178
|
"schemas/v2/self-hosted-runner-dispatch-frame.schema.json": "d8129f11d4e731d17ea951e66faaea2086081d13958b62ceaaa359fd6637dd7d",
|
|
179
179
|
"schemas/v2/self-hosted-runner-registration.schema.json": "93d60003a668cacb0eeac37699ca2884c6b79332d9494cb9e0a1752ac8f8a16c",
|
|
@@ -198,21 +198,21 @@
|
|
|
198
198
|
"schemas/workspace-file.schema.json": "464de85c2a068243084ee9c1d969bc7cd5d8f7948574e58450d6493c38a0e1e4",
|
|
199
199
|
"spec/v1/alias-detectors.json": "fee4594ef49953953ffcd0b3813300067d16b3e65ebff2aac722034ac9b3f545",
|
|
200
200
|
"spec/v1/capability-declaration-classes.json": "e7729aed5c4b4e1dd02abab0530f14cc95f5d4070fe51fb139e7f5cccefa00c6",
|
|
201
|
-
"spec/v1/core-standard-manifest.json": "
|
|
201
|
+
"spec/v1/core-standard-manifest.json": "a9e4e6d32753d76974f1a61d5e31bd1fcde5ad0100cf3c7aae6770f3e6fca5c6",
|
|
202
202
|
"spec/v1/deprecations.json": "520d79927a8ed43ccf62c207a7cf6cf7b19b16e00bbbbdf0410667e939c19d85",
|
|
203
203
|
"spec/v1/deprecations.schema.json": "4cdbbb8eb9c0092913a5704c943880f0c8581bcf0f640a7df5a84105d53c8aee",
|
|
204
204
|
"spec/v1/event-codemap.json": "3da60d884157793a360da532a9fcbbfb5285636db325a74cec94b34622186d97",
|
|
205
205
|
"spec/v1/event-codemap.schema.json": "d52caf29071e3784d4c20259cdbd5a7b533986548a440bb632a80b82cadd7ea5",
|
|
206
206
|
"spec/v1/extensions.json": "4d7ba68bae7c7f50cc655b94646ad25945a5dd63b703d43c1d015470141cd668",
|
|
207
|
-
"spec/v1/gaps.json": "
|
|
207
|
+
"spec/v1/gaps.json": "96ca051cb20f1a669b355d67a89421c56fef28aa5e6710c9519f592f26af33a3",
|
|
208
208
|
"spec/v1/gaps.schema.json": "8fd83259f556553c9df0f53e7a82ca8c2a4771d471197f69b4e2ae0ceeacfd66",
|
|
209
209
|
"spec/v1/migrations.json": "8839497d6a4830b53fa7867014a8336f0d725ef2346352e54fb580b7947897af",
|
|
210
210
|
"spec/v1/migrations.schema.json": "886779aa6c22e646db097f5df210adb018a4dd14a7b815465a18c8a7056c8f72",
|
|
211
211
|
"spec/v1/operation-path-manifest.json": "5f5f4e3842669371730ebbd1aace3fb794192615f0018dc144f484ba5db82ac3",
|
|
212
212
|
"spec/v1/spec-gaps.json": "6cc9962c6b969f632e07a78b52a4f61447ff579e2990cbae989866f584a86042",
|
|
213
|
-
"spec/v2/declaration.json": "
|
|
213
|
+
"spec/v2/declaration.json": "52b8c24a2dd463d44086129bf792ad108746f5102778cbbf0ff469fa534eca48",
|
|
214
214
|
"spec/v2/declaration.schema.json": "b0881a76228dfbd1b85a2ec7b7259a60197f768344535cdb475db6ff719b0e54",
|
|
215
|
-
"spec/v2/errors.json": "
|
|
215
|
+
"spec/v2/errors.json": "ad1725dc7c11002450e8abc682858eb5c11952a0718ea8ef6bdb2fb5ae6e7e21",
|
|
216
216
|
"spec/v2/event-codemap.json": "37869a03cdfd8758b57e6f350641a6ebbd383231cebda51f5473ad85f94ab74c",
|
|
217
217
|
"spec/v2/event-codemap.schema.json": "ce2d0ca085d7668d7ef745d2560b385ec6881d24a6d4b47c49931986b2ba642d",
|
|
218
218
|
"spec/v2/ext/provider-idempotency/registry.json": "5b5fecad604fb4ab38da39f5abe697a4e57b05406c398f8afeb377331b2bd965",
|
|
@@ -224,11 +224,11 @@
|
|
|
224
224
|
"spec/v2/facets/mcp.schema.json": "f56609fe24ba6160ad29ae31aa16043354ff005e5cb6a0f3871c4d226087cc08",
|
|
225
225
|
"spec/v2/facets/replay.schema.json": "0a5aefb0108c708c6794fadd533cf256709704c4f16dbf44cd63fa8980c78018",
|
|
226
226
|
"spec/v2/facets/sandbox.schema.json": "e75f54486d387b2d089791aa93b5093cd1450f1920753a0f97fc23acdfe978ed",
|
|
227
|
-
"spec/v2/facets/webhooks.schema.json": "
|
|
227
|
+
"spec/v2/facets/webhooks.schema.json": "0b766033ef4b4c6c2ac6f9979a19843ba024d3a1d1576972dcb55aaba52f1b9a",
|
|
228
228
|
"spec/v2/path-manifest.json": "034152e09b1458c66810d4050e20a273b2b9b8fe2d92b66e8b819477de58a1be",
|
|
229
229
|
"spec/v2/peer-dependency-aliases.json": "d10299280abee08258502925bc327293ee413e0108cd6e6ec75ff6110653308d",
|
|
230
230
|
"spec/v2/profiles.json": "1f0ee40491131cf561ef19a0394c47ba476b4567514fe16befb6cada4a10a5a4",
|
|
231
|
-
"spec/v2/release.json": "
|
|
231
|
+
"spec/v2/release.json": "7eb5cd641f6bb4d3143b3ddf8602bb2d856efc3c2db80cca2f15fe3a4f78c7f3"
|
|
232
232
|
},
|
|
233
|
-
"corpusCommit": "
|
|
233
|
+
"corpusCommit": "f71d788362ba5a32f167c2c70a1e534ddebc4f31"
|
|
234
234
|
}
|
package/api/seams-v2.yaml
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
openapi: 3.1.0
|
|
2
2
|
info:
|
|
3
3
|
title: OpenWOP conformance seams profile (openwop-conformance-seams-v2)
|
|
4
|
-
version: 2.0.0-rc.
|
|
4
|
+
version: 2.0.0-rc.10
|
|
5
5
|
description: 'GENERATED by scripts/derive-v2-api.py. RFC 0168 §C: the seams are a versioned conformance profile with their
|
|
6
6
|
own document and path space (/conformance/seams/…), validated against the canonical v2 schemas with no tolerance path,
|
|
7
7
|
forbidden from the capability namespace (a host advertises the profile, never a testSeams flag). This document carries
|
|
8
|
-
the nine operations the v1 canonical document used to carry; the remaining host-sample-test-seams.md
|
|
9
|
-
the
|
|
8
|
+
the nine operations the v1 canonical document used to carry; the 2.0.0 suite driver (P3-E2) rewrites the remaining host-sample-test-seams.md
|
|
9
|
+
paths into this space, and P3-E3 adds the two RFC 0176 seams (event-log seed, inbound webhook receiver).'
|
|
10
10
|
servers:
|
|
11
11
|
- url: https://{host}
|
|
12
12
|
description: openwop-compliant server
|
|
@@ -514,6 +514,219 @@ paths:
|
|
|
514
514
|
application/json:
|
|
515
515
|
schema:
|
|
516
516
|
$ref: ../schemas/v2/error-envelope.schema.json
|
|
517
|
+
/conformance/seams/sample/event-log/seed:
|
|
518
|
+
post:
|
|
519
|
+
tags:
|
|
520
|
+
- Seams
|
|
521
|
+
operationId: seedEra2EventLog
|
|
522
|
+
summary: Persist a run whose event log is in v1 vocabulary (era 2) — RFC 0176 §A/§B/§C witnesses
|
|
523
|
+
description: 'The host MUST persist the rows verbatim (v1 `type` strings, the given `sequence` space, no era stamp:
|
|
524
|
+
the run reads as era `2` by the absent-⇒-`2` rule of persistence.md) and MUST NOT translate at write time; the read
|
|
525
|
+
projection is what the scenarios `v2-v1-events-translated`, `v2-unmapped-type-refused`, `v2-fork-a-v1-run` and `v2-pinned-run-disposition`
|
|
526
|
+
witness. `status` is the snapshot status the seeded run holds.'
|
|
527
|
+
requestBody:
|
|
528
|
+
required: true
|
|
529
|
+
content:
|
|
530
|
+
application/json:
|
|
531
|
+
schema:
|
|
532
|
+
type: object
|
|
533
|
+
additionalProperties: false
|
|
534
|
+
required:
|
|
535
|
+
- eventLogSchemaVersion
|
|
536
|
+
- status
|
|
537
|
+
- events
|
|
538
|
+
properties:
|
|
539
|
+
eventLogSchemaVersion:
|
|
540
|
+
const: 2
|
|
541
|
+
status:
|
|
542
|
+
type: string
|
|
543
|
+
enum:
|
|
544
|
+
- running
|
|
545
|
+
- completed
|
|
546
|
+
- failed
|
|
547
|
+
- cancelled
|
|
548
|
+
events:
|
|
549
|
+
type: array
|
|
550
|
+
minItems: 1
|
|
551
|
+
items:
|
|
552
|
+
type: object
|
|
553
|
+
additionalProperties: false
|
|
554
|
+
required:
|
|
555
|
+
- type
|
|
556
|
+
- sequence
|
|
557
|
+
- payload
|
|
558
|
+
properties:
|
|
559
|
+
type:
|
|
560
|
+
type: string
|
|
561
|
+
sequence:
|
|
562
|
+
type: integer
|
|
563
|
+
minimum: 0
|
|
564
|
+
payload:
|
|
565
|
+
type: object
|
|
566
|
+
timestamp:
|
|
567
|
+
type: string
|
|
568
|
+
format: date-time
|
|
569
|
+
causationId:
|
|
570
|
+
type: string
|
|
571
|
+
responses:
|
|
572
|
+
'201':
|
|
573
|
+
description: The seeded run.
|
|
574
|
+
content:
|
|
575
|
+
application/json:
|
|
576
|
+
schema:
|
|
577
|
+
type: object
|
|
578
|
+
additionalProperties: false
|
|
579
|
+
required:
|
|
580
|
+
- runId
|
|
581
|
+
properties:
|
|
582
|
+
runId:
|
|
583
|
+
$ref: ../schemas/v2/ids.schema.json#/$defs/runId
|
|
584
|
+
'400':
|
|
585
|
+
$ref: '#/components/responses/ValidationError'
|
|
586
|
+
'401':
|
|
587
|
+
$ref: '#/components/responses/Unauthenticated'
|
|
588
|
+
/conformance/seams/sample/effect-seams/fire:
|
|
589
|
+
post:
|
|
590
|
+
tags:
|
|
591
|
+
- Seams
|
|
592
|
+
operationId: fireEffectSeam
|
|
593
|
+
summary: Fire one named effect-seam manifest row inside a run — RFC 0173 §C no-re-fire witness
|
|
594
|
+
description: 'The host runs a workflow that drives the named seam once. The scenario then forks the run in `replay`
|
|
595
|
+
mode and reads `GET /runs/{runId}/effects` on the fork: a seam whose manifest row says `branchReFires: false` MUST
|
|
596
|
+
NOT produce a new effect attempt there. The witness is the host own Layer-2 ledger, so the leg needs no externally
|
|
597
|
+
reachable receiver. Without this seam the replay-suppression obligation is only claims-checkable.'
|
|
598
|
+
requestBody:
|
|
599
|
+
required: true
|
|
600
|
+
content:
|
|
601
|
+
application/json:
|
|
602
|
+
schema:
|
|
603
|
+
type: object
|
|
604
|
+
additionalProperties: false
|
|
605
|
+
required:
|
|
606
|
+
- seam
|
|
607
|
+
properties:
|
|
608
|
+
seam:
|
|
609
|
+
type: string
|
|
610
|
+
minLength: 1
|
|
611
|
+
description: The `seam` value of a row in GET /host/effect-seams.
|
|
612
|
+
receiverUrl:
|
|
613
|
+
type: string
|
|
614
|
+
format: uri
|
|
615
|
+
description: Optional destination for seams whose kind needs one. Omitted, the host uses its own unreachable
|
|
616
|
+
fixture destination — the witness is the effect ledger, not delivery.
|
|
617
|
+
responses:
|
|
618
|
+
'201':
|
|
619
|
+
description: The run that fired the seam.
|
|
620
|
+
content:
|
|
621
|
+
application/json:
|
|
622
|
+
schema:
|
|
623
|
+
type: object
|
|
624
|
+
additionalProperties: false
|
|
625
|
+
required:
|
|
626
|
+
- runId
|
|
627
|
+
properties:
|
|
628
|
+
runId:
|
|
629
|
+
$ref: ../schemas/v2/ids.schema.json#/$defs/runId
|
|
630
|
+
'400':
|
|
631
|
+
$ref: '#/components/responses/ValidationError'
|
|
632
|
+
'401':
|
|
633
|
+
$ref: '#/components/responses/Unauthenticated'
|
|
634
|
+
'404':
|
|
635
|
+
$ref: '#/components/responses/NotFound'
|
|
636
|
+
/conformance/seams/sample/test/idempotency/effect-retry:
|
|
637
|
+
post:
|
|
638
|
+
tags:
|
|
639
|
+
- Seams
|
|
640
|
+
operationId: forceEffectTransportRetry
|
|
641
|
+
summary: Drive one effect through the suite fixture provider with a forced transport retry — RFC 0173 §D.2 G4 witness
|
|
642
|
+
description: 'The host issues one outbound effect to `providerUrl` and retries it at the transport layer. The suite
|
|
643
|
+
fixture provider records the idempotency key of each attempt: a Layer-2 host MUST present the SAME business-identity
|
|
644
|
+
key across both attempts, so a provider that sees a changed key fails the leg. Without this seam the effect-identity
|
|
645
|
+
obligation is only claims-checkable.'
|
|
646
|
+
requestBody:
|
|
647
|
+
required: true
|
|
648
|
+
content:
|
|
649
|
+
application/json:
|
|
650
|
+
schema:
|
|
651
|
+
type: object
|
|
652
|
+
additionalProperties: false
|
|
653
|
+
required:
|
|
654
|
+
- providerUrl
|
|
655
|
+
properties:
|
|
656
|
+
providerUrl:
|
|
657
|
+
type: string
|
|
658
|
+
format: uri
|
|
659
|
+
description: The suite's fixture provider; it records each attempt's idempotency key.
|
|
660
|
+
responses:
|
|
661
|
+
'201':
|
|
662
|
+
description: The run and effect that were retried.
|
|
663
|
+
content:
|
|
664
|
+
application/json:
|
|
665
|
+
schema:
|
|
666
|
+
type: object
|
|
667
|
+
additionalProperties: false
|
|
668
|
+
required:
|
|
669
|
+
- runId
|
|
670
|
+
- effectId
|
|
671
|
+
properties:
|
|
672
|
+
runId:
|
|
673
|
+
$ref: ../schemas/v2/ids.schema.json#/$defs/runId
|
|
674
|
+
effectId:
|
|
675
|
+
type: string
|
|
676
|
+
minLength: 1
|
|
677
|
+
'400':
|
|
678
|
+
$ref: '#/components/responses/ValidationError'
|
|
679
|
+
'401':
|
|
680
|
+
$ref: '#/components/responses/Unauthenticated'
|
|
681
|
+
/conformance/seams/sample/webhooks/receive:
|
|
682
|
+
post:
|
|
683
|
+
tags:
|
|
684
|
+
- Seams
|
|
685
|
+
operationId: receiveWebhookDelivery
|
|
686
|
+
summary: Run a webhook delivery through the host's inbound receiver — RFC 0176 §D.2 witness
|
|
687
|
+
description: The v2 host as a subscriber. The host verifies `headers` + `body` with its production verifier using `secret`
|
|
688
|
+
as the subscription secret and reports the verdict; an `X-openwop-*`-only scheme-`v1` delivery over `{timestamp}.{rawBody}`
|
|
689
|
+
MUST be accepted (`v2-v1-signed-webhook-accepted`), and a tampered signature MUST be refused.
|
|
690
|
+
requestBody:
|
|
691
|
+
required: true
|
|
692
|
+
content:
|
|
693
|
+
application/json:
|
|
694
|
+
schema:
|
|
695
|
+
type: object
|
|
696
|
+
additionalProperties: false
|
|
697
|
+
required:
|
|
698
|
+
- secret
|
|
699
|
+
- headers
|
|
700
|
+
- body
|
|
701
|
+
properties:
|
|
702
|
+
secret:
|
|
703
|
+
type: string
|
|
704
|
+
minLength: 1
|
|
705
|
+
headers:
|
|
706
|
+
type: object
|
|
707
|
+
additionalProperties:
|
|
708
|
+
type: string
|
|
709
|
+
body:
|
|
710
|
+
type: string
|
|
711
|
+
responses:
|
|
712
|
+
'200':
|
|
713
|
+
description: The verifier verdict.
|
|
714
|
+
content:
|
|
715
|
+
application/json:
|
|
716
|
+
schema:
|
|
717
|
+
type: object
|
|
718
|
+
additionalProperties: false
|
|
719
|
+
required:
|
|
720
|
+
- accepted
|
|
721
|
+
properties:
|
|
722
|
+
accepted:
|
|
723
|
+
type: boolean
|
|
724
|
+
reason:
|
|
725
|
+
type: string
|
|
726
|
+
'400':
|
|
727
|
+
$ref: '#/components/responses/ValidationError'
|
|
728
|
+
'401':
|
|
729
|
+
$ref: '#/components/responses/Unauthenticated'
|
|
517
730
|
components:
|
|
518
731
|
securitySchemes:
|
|
519
732
|
ApiKeyAuth:
|
package/api/v2/asyncapi.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
asyncapi: 3.1.0
|
|
2
2
|
info:
|
|
3
3
|
title: OpenWOP v2 event streams
|
|
4
|
-
version: 2.0.0-rc.
|
|
4
|
+
version: 2.0.0-rc.10
|
|
5
5
|
description: GENERATED by scripts/derive-v2-api.py (RFC 0171 §E.1, RFC 0172 §C.2). One run-events channel whose address
|
|
6
6
|
is the OpenAPI path key; the server pathname is empty (bare origin). streamMode is a pattern over the closed set and its
|
|
7
7
|
comma-separated combinations (`values` never combines). hostEvents has a real address (RFC 0171 §E.1) — the documented
|
package/api/v2/openapi.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
openapi: 3.1.0
|
|
2
2
|
info:
|
|
3
3
|
title: OpenWOP v2 API
|
|
4
|
-
version: 2.0.0-rc.
|
|
4
|
+
version: 2.0.0-rc.10
|
|
5
5
|
summary: REST surface for declaring, executing, suspending, resuming, and observing multi-step workflows.
|
|
6
6
|
description: GENERATED by scripts/derive-v2-api.py from api/openapi.yaml and the RFC 0167 children (v2 charter Phase 3,
|
|
7
7
|
P3-C). Bare origin, unversioned path keys, negotiation by `OpenWOP-Version` + `protocolVersions[]` (RFC 0172 §A). No seam
|
package/package.json
CHANGED
|
@@ -1,10 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@openwop/spec-artifacts",
|
|
3
|
-
"version": "2.0.0-rc.
|
|
4
|
-
"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
|
|
3
|
+
"version": "2.0.0-rc.10",
|
|
4
|
+
"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 \u2014 published from the openwop/openwop corpus tag; the peer dependency @openwop/openwop-conformance digest-checks at start (RFC 0168 \u00a7D.2).",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
|
-
"repository": {
|
|
7
|
-
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/openwop/openwop.git",
|
|
9
|
+
"directory": "spec-artifacts"
|
|
10
|
+
},
|
|
11
|
+
"files": [
|
|
12
|
+
"api",
|
|
13
|
+
"schemas",
|
|
14
|
+
"spec",
|
|
15
|
+
"CORPUS-STAMP.json",
|
|
16
|
+
"README.md",
|
|
17
|
+
"LICENSE"
|
|
18
|
+
],
|
|
8
19
|
"sideEffects": false,
|
|
9
|
-
"publishConfig": {
|
|
20
|
+
"publishConfig": {
|
|
21
|
+
"access": "public"
|
|
22
|
+
}
|
|
10
23
|
}
|
|
@@ -5,26 +5,58 @@
|
|
|
5
5
|
"description": "A certification bundle that records what EXECUTED, not merely what passed.\n\nThe v1 bundle carried `{passed, failed, skipped}` scenario-file lists. Those three cannot express the distinction the whole program turns on: a scenario file counted as `passed` whether its assertions ran or its runner returned early, and a `skipped` entry could mean 'the operator excluded this', 'the requirement does not apply', or 'we could not check' — three claims with different consequences flattened into one word.\n\nv2 replaces the lists with per-requirement dispositions from RFC 0148 §A, and adds the counts §A.4 requires so a reader can tell a thorough run from a thin one without re-running it. `blocked` is its own total precisely because it is the one that invalidates a claim.",
|
|
6
6
|
"type": "object",
|
|
7
7
|
"additionalProperties": true,
|
|
8
|
-
"required": [
|
|
8
|
+
"required": [
|
|
9
|
+
"bundleVersion",
|
|
10
|
+
"suite",
|
|
11
|
+
"host",
|
|
12
|
+
"discovery",
|
|
13
|
+
"claimedProfiles",
|
|
14
|
+
"results",
|
|
15
|
+
"scenarioManifestSha256",
|
|
16
|
+
"targetConfigurationSha256"
|
|
17
|
+
],
|
|
9
18
|
"properties": {
|
|
10
|
-
"bundleVersion": {
|
|
19
|
+
"bundleVersion": {
|
|
20
|
+
"const": "2"
|
|
21
|
+
},
|
|
11
22
|
"suite": {
|
|
12
23
|
"type": "object",
|
|
13
24
|
"additionalProperties": false,
|
|
14
|
-
"required": [
|
|
25
|
+
"required": [
|
|
26
|
+
"package",
|
|
27
|
+
"version"
|
|
28
|
+
],
|
|
15
29
|
"properties": {
|
|
16
|
-
"package": {
|
|
17
|
-
|
|
30
|
+
"package": {
|
|
31
|
+
"type": "string",
|
|
32
|
+
"minLength": 1
|
|
33
|
+
},
|
|
34
|
+
"version": {
|
|
35
|
+
"type": "string",
|
|
36
|
+
"pattern": "^\\d+\\.\\d+\\.\\d+(-[0-9A-Za-z.-]+)?$",
|
|
37
|
+
"description": "The suite version that produced this bundle. A SemVer prerelease is admitted because RFC 0168 §D.3 makes the 2.x suite one package with `--target-major`: a v1 host measured by a prerelease 2.x suite legitimately emits a v2 bundle whose `suite.version` is `2.0.0-rc.N`. The original three-part-only pattern predates that decision and made such a bundle unvalidatable — found in Phase 4 when a host pinned to the RC line tried to certify."
|
|
38
|
+
}
|
|
18
39
|
}
|
|
19
40
|
},
|
|
20
41
|
"host": {
|
|
21
42
|
"type": "object",
|
|
22
43
|
"additionalProperties": true,
|
|
23
|
-
"required": [
|
|
44
|
+
"required": [
|
|
45
|
+
"name",
|
|
46
|
+
"version"
|
|
47
|
+
],
|
|
24
48
|
"properties": {
|
|
25
|
-
"name": {
|
|
26
|
-
|
|
27
|
-
|
|
49
|
+
"name": {
|
|
50
|
+
"type": "string",
|
|
51
|
+
"minLength": 1
|
|
52
|
+
},
|
|
53
|
+
"version": {
|
|
54
|
+
"type": "string",
|
|
55
|
+
"minLength": 1
|
|
56
|
+
},
|
|
57
|
+
"vendor": {
|
|
58
|
+
"type": "string"
|
|
59
|
+
},
|
|
28
60
|
"commit": {
|
|
29
61
|
"type": "string",
|
|
30
62
|
"minLength": 1,
|
|
@@ -40,41 +72,80 @@
|
|
|
40
72
|
"discovery": {
|
|
41
73
|
"type": "object",
|
|
42
74
|
"additionalProperties": true,
|
|
43
|
-
"required": [
|
|
75
|
+
"required": [
|
|
76
|
+
"sha256",
|
|
77
|
+
"document"
|
|
78
|
+
],
|
|
44
79
|
"properties": {
|
|
45
|
-
"url": {
|
|
46
|
-
|
|
47
|
-
|
|
80
|
+
"url": {
|
|
81
|
+
"type": "string"
|
|
82
|
+
},
|
|
83
|
+
"sha256": {
|
|
84
|
+
"type": "string",
|
|
85
|
+
"pattern": "^[0-9a-f]{64}$"
|
|
86
|
+
},
|
|
87
|
+
"document": {
|
|
88
|
+
"type": "object"
|
|
89
|
+
}
|
|
48
90
|
}
|
|
49
91
|
},
|
|
50
92
|
"claimedProfiles": {
|
|
51
93
|
"type": "array",
|
|
52
94
|
"minItems": 1,
|
|
53
95
|
"uniqueItems": true,
|
|
54
|
-
"items": {
|
|
96
|
+
"items": {
|
|
97
|
+
"type": "string",
|
|
98
|
+
"pattern": "^openwop-[a-z0-9-]+$"
|
|
99
|
+
},
|
|
55
100
|
"description": "RFC 0155 §E — canonical profile IDs only. Deprecated aliases go in `aliases`, never here, so a badge cannot be substantiated by a name that no longer means what it did."
|
|
56
101
|
},
|
|
57
102
|
"aliases": {
|
|
58
103
|
"type": "array",
|
|
59
104
|
"uniqueItems": true,
|
|
60
|
-
"items": {
|
|
105
|
+
"items": {
|
|
106
|
+
"type": "string"
|
|
107
|
+
}
|
|
61
108
|
},
|
|
62
109
|
"results": {
|
|
63
110
|
"type": "object",
|
|
64
111
|
"additionalProperties": false,
|
|
65
|
-
"required": [
|
|
112
|
+
"required": [
|
|
113
|
+
"totals",
|
|
114
|
+
"requirements"
|
|
115
|
+
],
|
|
66
116
|
"properties": {
|
|
67
117
|
"totals": {
|
|
68
118
|
"type": "object",
|
|
69
119
|
"additionalProperties": false,
|
|
70
|
-
"required": [
|
|
120
|
+
"required": [
|
|
121
|
+
"executedPass",
|
|
122
|
+
"executedFail",
|
|
123
|
+
"skipped",
|
|
124
|
+
"inapplicable",
|
|
125
|
+
"blocked"
|
|
126
|
+
],
|
|
71
127
|
"description": "RFC 0148 §A/§C. All five are REQUIRED — an omitted total is indistinguishable from zero, and `blocked: 0` asserted is a different claim from `blocked` unstated.",
|
|
72
128
|
"properties": {
|
|
73
|
-
"executedPass": {
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
"
|
|
129
|
+
"executedPass": {
|
|
130
|
+
"type": "integer",
|
|
131
|
+
"minimum": 0
|
|
132
|
+
},
|
|
133
|
+
"executedFail": {
|
|
134
|
+
"type": "integer",
|
|
135
|
+
"minimum": 0
|
|
136
|
+
},
|
|
137
|
+
"skipped": {
|
|
138
|
+
"type": "integer",
|
|
139
|
+
"minimum": 0
|
|
140
|
+
},
|
|
141
|
+
"inapplicable": {
|
|
142
|
+
"type": "integer",
|
|
143
|
+
"minimum": 0
|
|
144
|
+
},
|
|
145
|
+
"blocked": {
|
|
146
|
+
"type": "integer",
|
|
147
|
+
"minimum": 0
|
|
148
|
+
}
|
|
78
149
|
}
|
|
79
150
|
},
|
|
80
151
|
"requirements": {
|
|
@@ -84,17 +155,38 @@
|
|
|
84
155
|
"items": {
|
|
85
156
|
"type": "object",
|
|
86
157
|
"additionalProperties": false,
|
|
87
|
-
"required": [
|
|
158
|
+
"required": [
|
|
159
|
+
"requirementId",
|
|
160
|
+
"scenarioId",
|
|
161
|
+
"disposition"
|
|
162
|
+
],
|
|
88
163
|
"properties": {
|
|
89
|
-
"requirementId": {
|
|
90
|
-
|
|
91
|
-
|
|
164
|
+
"requirementId": {
|
|
165
|
+
"type": "string",
|
|
166
|
+
"minLength": 1
|
|
167
|
+
},
|
|
168
|
+
"scenarioId": {
|
|
169
|
+
"type": "string",
|
|
170
|
+
"minLength": 1
|
|
171
|
+
},
|
|
172
|
+
"disposition": {
|
|
173
|
+
"enum": [
|
|
174
|
+
"executed-pass",
|
|
175
|
+
"executed-fail",
|
|
176
|
+
"skipped",
|
|
177
|
+
"inapplicable",
|
|
178
|
+
"blocked"
|
|
179
|
+
]
|
|
180
|
+
},
|
|
92
181
|
"assertionCount": {
|
|
93
182
|
"type": "integer",
|
|
94
183
|
"minimum": 0,
|
|
95
184
|
"description": "How many assertions actually ran. `executed-pass` with `assertionCount: 0` is the vacuous pass this program exists to close, and a reader can now see it."
|
|
96
185
|
},
|
|
97
|
-
"witnessSha256": {
|
|
186
|
+
"witnessSha256": {
|
|
187
|
+
"type": "string",
|
|
188
|
+
"pattern": "^[0-9a-f]{64}$"
|
|
189
|
+
},
|
|
98
190
|
"detail": {
|
|
99
191
|
"type": "string",
|
|
100
192
|
"description": "Required by RFC 0148 §A for any disposition other than `executed-pass` — an unexplained `blocked` is an outcome nobody can act on."
|