@openwop/spec-artifacts 2.0.0-rc.9 → 2.0.0

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.
Files changed (39) hide show
  1. package/CORPUS-STAMP.json +40 -37
  2. package/api/seams-v2.yaml +1 -1
  3. package/api/v2/asyncapi.yaml +1 -1
  4. package/api/v2/openapi.yaml +17 -19
  5. package/package.json +1 -1
  6. package/schemas/capabilities.schema.json +40 -1
  7. package/schemas/run-snapshot.schema.json +103 -33
  8. package/schemas/v2/agent-deployment-transition.schema.json +5 -6
  9. package/schemas/v2/agent-deployment.schema.json +8 -9
  10. package/schemas/v2/agent-eval-suite.schema.json +11 -12
  11. package/schemas/v2/artifact-type-pack-manifest.schema.json +22 -18
  12. package/schemas/v2/certification-bundle.schema.json +1 -1
  13. package/schemas/v2/chat-card-pack-manifest.schema.json +19 -15
  14. package/schemas/v2/debug-bundle.schema.json +6 -6
  15. package/schemas/v2/effect-ledger-projection.schema.json +4 -3
  16. package/schemas/v2/effect-seam-manifest.schema.json +30 -7
  17. package/schemas/v2/error-envelope.schema.json +185 -138
  18. package/schemas/v2/eval-summary.schema.json +17 -10
  19. package/schemas/v2/goal.schema.json +5 -5
  20. package/schemas/v2/ids.schema.json +120 -22
  21. package/schemas/v2/node-pack-manifest.schema.json +27 -31
  22. package/schemas/v2/proposal.schema.json +7 -8
  23. package/schemas/v2/run-event-payloads.schema.json +258 -245
  24. package/schemas/v2/run-event.schema.json +2 -126
  25. package/schemas/v2/run-options.schema.json +1 -1
  26. package/schemas/v2/run-snapshot.schema.json +34 -13
  27. package/schemas/v2/webhook-delivery.schema.json +26 -0
  28. package/schemas/v2/workflow-chain-pack-manifest.schema.json +41 -45
  29. package/schemas/v2/workflow-definition.schema.json +31 -36
  30. package/spec/v1/core-standard-manifest.json +2 -2
  31. package/spec/v1/deprecations.json +79 -67
  32. package/spec/v1/deprecations.schema.json +23 -7
  33. package/spec/v1/extensions.json +3 -2
  34. package/spec/v2/declaration.json +57 -33
  35. package/spec/v2/errors.json +421 -360
  36. package/spec/v2/id-field-bindings.json +105 -0
  37. package/spec/v2/profiles.json +31 -7
  38. package/spec/v2/release.json +3 -3
  39. package/spec/v2/retention-floors.json +35 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://openwop.dev/spec/v2/declaration.schema.json",
3
- "$comment": "RFC 0169 §B the one declaration file. Hand-reviewed source (generated FROM nothing, checked AGAINST everything by scripts/check-declaration.mjs). schemas/v2/capabilities.schema.json, spec/v2/profiles.json and spec/v2/peer-dependency-aliases.json are generated from it. Seeded 2026-09-03 (Phase 3, P3-A) from the v1 registries this file retires: every v1 root key is listed with an anchor (core | ext | deleted) so no slot is reserved-but-undefined (§B.3). Values marked planned:* are minted by the suite in P3-E (RFC 0178 precedent). adoption is re-derived from INTEROP-MATRIX bundle evidence at each RC (generator --check).",
3
+ "$comment": "RFC 0169 \u00a7B \u2014 the one declaration file. Hand-reviewed source (generated FROM nothing, checked AGAINST everything by scripts/check-declaration.mjs). schemas/v2/capabilities.schema.json, spec/v2/profiles.json and spec/v2/peer-dependency-aliases.json are generated from it. Seeded 2026-09-03 (Phase 3, P3-A) from the v1 registries this file retires: every v1 root key is listed with an anchor (core | ext | deleted) so no slot is reserved-but-undefined (\u00a7B.3). Values marked planned:* are minted by the suite in P3-E (RFC 0178 precedent). adoption is re-derived from INTEROP-MATRIX bundle evidence at each RC (generator --check).",
4
4
  "version": "2.0",
5
5
  "updated": "2026-09-03",
6
6
  "witnessClasses": [
@@ -62,7 +62,7 @@
62
62
  "key": "supportedTransports",
63
63
  "kind": "metadata",
64
64
  "schema": "metadata/supportedTransports",
65
- "note": "deleted: RFC 0175 §B.1",
65
+ "note": "deleted: RFC 0175 \u00a7B.1",
66
66
  "disposition": "deleted"
67
67
  },
68
68
  {
@@ -125,7 +125,7 @@
125
125
  "key": "signingKeys",
126
126
  "kind": "metadata",
127
127
  "schema": "metadata/signingKeys",
128
- "note": "host bundle-signing public keys (RFC 0168 §E.2); v2-only the surface the RFC named when it disposed of \"a signature nobody can check\"",
128
+ "note": "host bundle-signing public keys (RFC 0168 \u00a7E.2); v2-only \u2014 the surface the RFC named when it disposed of \"a signature nobody can check\"",
129
129
  "disposition": "kept"
130
130
  },
131
131
  {
@@ -139,7 +139,7 @@
139
139
  "key": "preferredVersion",
140
140
  "kind": "metadata",
141
141
  "schema": "metadata/preferredVersion",
142
- "note": "root preferredVersion (RFC 0172 §A.1; v1.x additive RFC 0179)",
142
+ "note": "root preferredVersion (RFC 0172 \u00a7A.1; v1.x additive RFC 0179)",
143
143
  "disposition": "kept"
144
144
  }
145
145
  ],
@@ -147,7 +147,7 @@
147
147
  {
148
148
  "key": "contractProvenance",
149
149
  "anchor": "deleted",
150
- "reason": "RFC 0169 §A.5 (unfalsifiable self-declaration)"
150
+ "reason": "RFC 0169 \u00a7A.5 (unfalsifiable self-declaration)"
151
151
  },
152
152
  {
153
153
  "key": "supportedEnvelopes",
@@ -291,7 +291,7 @@
291
291
  {
292
292
  "key": "grpc",
293
293
  "anchor": "deleted",
294
- "reason": "RFC 0175 §A.1 (spec/v2/ext/grpc-transport/, not advertisable)"
294
+ "reason": "RFC 0175 \u00a7A.1 (spec/v2/ext/grpc-transport/, not advertisable)"
295
295
  },
296
296
  {
297
297
  "key": "nodePackRuntimes",
@@ -591,7 +591,7 @@
591
591
  "floorScenarios": [],
592
592
  "requirementIds": [],
593
593
  "owningRfc": "0037",
594
- "note": "RFC 0002–0008 surface; core anchor, facets carry the RFC 0092 requirement vocabulary"
594
+ "note": "RFC 0002\u20130008 surface; core anchor, facets carry the RFC 0092 requirement vocabulary"
595
595
  },
596
596
  {
597
597
  "key": "modelCapabilities",
@@ -659,7 +659,7 @@
659
659
  "floorScenarios": [],
660
660
  "requirementIds": [],
661
661
  "owningRfc": null,
662
- "note": "imageGeneration/videoGeneration are declared facets (RFC 0169 §B.3 with RFC 0177 §B.1: facet paths are not identifiers; peerDependenciesMeta.aiProviders.facets[])",
662
+ "note": "imageGeneration/videoGeneration are declared facets (RFC 0169 \u00a7B.3 with RFC 0177 \u00a7B.1: facet paths are not identifiers; peerDependenciesMeta.aiProviders.facets[])",
663
663
  "facetsFrom": "spec/v2/facets/aiProviders.schema.json"
664
664
  },
665
665
  {
@@ -697,7 +697,7 @@
697
697
  "floorScenarios": [],
698
698
  "requirementIds": [],
699
699
  "owningRfc": "0002",
700
- "note": "RFC 0002–0008 surface; core anchor, facets carry the RFC 0092 requirement vocabulary"
700
+ "note": "RFC 0002\u20130008 surface; core anchor, facets carry the RFC 0092 requirement vocabulary"
701
701
  },
702
702
  {
703
703
  "key": "memory",
@@ -724,7 +724,7 @@
724
724
  "floorScenarios": [],
725
725
  "requirementIds": [],
726
726
  "owningRfc": "0004",
727
- "note": "RFC 0002–0008 surface; core anchor, facets carry the RFC 0092 requirement vocabulary"
727
+ "note": "RFC 0002\u20130008 surface; core anchor, facets carry the RFC 0092 requirement vocabulary"
728
728
  },
729
729
  {
730
730
  "key": "conversationPrimitive",
@@ -1408,7 +1408,7 @@
1408
1408
  "requirementIds": [],
1409
1409
  "owningRfc": "0035",
1410
1410
  "disposition": "externally-gated",
1411
- "reason": "RFC 0169 §C.4 / RFC 0035 non-steward tripwire; status experimental with until = the review date, never stable",
1411
+ "reason": "RFC 0169 \u00a7C.4 / RFC 0035 non-steward tripwire; status experimental with until = the review date, never stable",
1412
1412
  "facetsFrom": "spec/v2/facets/sandbox.schema.json"
1413
1413
  },
1414
1414
  {
@@ -1430,7 +1430,7 @@
1430
1430
  "floorScenarios": [],
1431
1431
  "requirementIds": [],
1432
1432
  "owningRfc": "0151",
1433
- "reason": "RFC 0173 §B core obligation with a declared witness; ext/ only by §D.1 at the cut"
1433
+ "reason": "RFC 0173 \u00a7B core obligation with a declared witness; ext/ only by \u00a7D.1 at the cut"
1434
1434
  },
1435
1435
  {
1436
1436
  "key": "idempotency",
@@ -1606,7 +1606,7 @@
1606
1606
  "floorScenarios": [],
1607
1607
  "requirementIds": [],
1608
1608
  "owningRfc": "0115",
1609
- "reason": "RFC 0169 §C.5 (claims-check; ext/ unless a behavioral witness lands)"
1609
+ "reason": "RFC 0169 \u00a7C.5 (claims-check; ext/ unless a behavioral witness lands)"
1610
1610
  },
1611
1611
  {
1612
1612
  "key": "a2uiSurface",
@@ -1625,7 +1625,7 @@
1625
1625
  "floorScenarios": [],
1626
1626
  "requirementIds": [],
1627
1627
  "owningRfc": "0114",
1628
- "reason": "RFC 0169 §C.5 (deltaTransport claims-check; ext/ unless a behavioral witness lands)"
1628
+ "reason": "RFC 0169 \u00a7C.5 (deltaTransport claims-check; ext/ unless a behavioral witness lands)"
1629
1629
  },
1630
1630
  {
1631
1631
  "key": "brand",
@@ -1642,7 +1642,7 @@
1642
1642
  "floorScenarios": [],
1643
1643
  "requirementIds": [],
1644
1644
  "owningRfc": "0144",
1645
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1645
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1646
1646
  },
1647
1647
  {
1648
1648
  "key": "canvas",
@@ -1659,7 +1659,7 @@
1659
1659
  "floorScenarios": [],
1660
1660
  "requirementIds": [],
1661
1661
  "owningRfc": "0144",
1662
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1662
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1663
1663
  },
1664
1664
  {
1665
1665
  "key": "chat",
@@ -1676,7 +1676,7 @@
1676
1676
  "floorScenarios": [],
1677
1677
  "requirementIds": [],
1678
1678
  "owningRfc": "0144",
1679
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1679
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1680
1680
  },
1681
1681
  {
1682
1682
  "key": "coordination",
@@ -1693,7 +1693,7 @@
1693
1693
  "floorScenarios": [],
1694
1694
  "requirementIds": [],
1695
1695
  "owningRfc": "0144",
1696
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1696
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1697
1697
  },
1698
1698
  {
1699
1699
  "key": "dataIntegration",
@@ -1710,7 +1710,7 @@
1710
1710
  "floorScenarios": [],
1711
1711
  "requirementIds": [],
1712
1712
  "owningRfc": "0144",
1713
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1713
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1714
1714
  },
1715
1715
  {
1716
1716
  "key": "entities",
@@ -1727,7 +1727,7 @@
1727
1727
  "floorScenarios": [],
1728
1728
  "requirementIds": [],
1729
1729
  "owningRfc": "0144",
1730
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1730
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1731
1731
  },
1732
1732
  {
1733
1733
  "key": "kanban",
@@ -1744,7 +1744,7 @@
1744
1744
  "floorScenarios": [],
1745
1745
  "requirementIds": [],
1746
1746
  "owningRfc": "0144",
1747
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1747
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1748
1748
  },
1749
1749
  {
1750
1750
  "key": "knowledge",
@@ -1761,7 +1761,7 @@
1761
1761
  "floorScenarios": [],
1762
1762
  "requirementIds": [],
1763
1763
  "owningRfc": "0144",
1764
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1764
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1765
1765
  },
1766
1766
  {
1767
1767
  "key": "launchStudio",
@@ -1778,7 +1778,7 @@
1778
1778
  "floorScenarios": [],
1779
1779
  "requirementIds": [],
1780
1780
  "owningRfc": "0144",
1781
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1781
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1782
1782
  },
1783
1783
  {
1784
1784
  "key": "messaging",
@@ -1795,7 +1795,7 @@
1795
1795
  "floorScenarios": [],
1796
1796
  "requirementIds": [],
1797
1797
  "owningRfc": "0144",
1798
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1798
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1799
1799
  },
1800
1800
  {
1801
1801
  "key": "webResearch",
@@ -1812,7 +1812,7 @@
1812
1812
  "floorScenarios": [],
1813
1813
  "requirementIds": [],
1814
1814
  "owningRfc": "0144",
1815
- "reason": "RFC 0169 §B.3 (RFC 0144 extension class; prose-only §host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1815
+ "reason": "RFC 0169 \u00a7B.3 (RFC 0144 extension class; prose-only \u00a7host.* section in v1; served under extensions.openwop-app.* by the one host that has it)"
1816
1816
  }
1817
1817
  ],
1818
1818
  "profiles": [
@@ -1826,9 +1826,11 @@
1826
1826
  ]
1827
1827
  },
1828
1828
  "floorScenarios": [
1829
- "planned:capabilities-root-closed"
1829
+ "v2-capabilities-root-closed",
1830
+ "v2-preferred-version-default",
1831
+ "v2-version-header-honored"
1830
1832
  ],
1831
- "note": "discovery only; the alias openwop-core is deleted (row C2.3)"
1833
+ "note": "discovery only; the alias openwop-core is deleted (row C2.3). Floor minted rc.45: the closed root, the preferredVersion default, and the header honoured-or-refused \u2014 each unaided. v2-well-known-one-resource is deliberately absent: it is inapplicable by design for a host advertising one major, which every host becomes at v1 end-of-support, and a floor that expires is not a floor."
1832
1834
  },
1833
1835
  {
1834
1836
  "id": "openwop-core-standard",
@@ -1841,23 +1843,45 @@
1841
1843
  "eventLog"
1842
1844
  ]
1843
1845
  },
1844
- "floorScenarios": [],
1846
+ "floorScenarios": [
1847
+ "v2-interrupt-token-scheme",
1848
+ "v2-effect-seam-manifest",
1849
+ "v2-webhook-durable-delivery",
1850
+ "v2-idempotency-key-grammar",
1851
+ "v2-era-key",
1852
+ "v2-era-stamp-universal",
1853
+ "v2-event-type-closed",
1854
+ "v2-poll-cursor-v2",
1855
+ "v2-run-cancel",
1856
+ "v2-run-bulk-cancel",
1857
+ "v2-run-pause-resume",
1858
+ "v2-run-options-limits",
1859
+ "v2-sse-last-event-id"
1860
+ ],
1845
1861
  "requirementIds": [],
1846
- "note": "seeded from spec/v1/core-standard-manifest.json at P3-B; the floor is minted with the 2.0.0 scenarios (planned)"
1862
+ "note": "rc.59: five unaided run-surface witnesses joined the floor \u2014 v2-run-cancel (runs.md \u00a7Cancel: 409 run_terminal on a terminal run), v2-run-bulk-cancel (\u00a7Cancel: per-entry envelopes, id_tenant_mismatch / not_found, details.maxRunIds), v2-run-pause-resume (\u00a7Pause and resume: 409 run_terminal / run_state_conflict, the literal drainPolicy echo, the immediate cut), v2-run-options-limits (capabilities.md limits metadata honoured on create), v2-sse-last-event-id (events.md \u00a7SSE frames: Last-Event-ID resumes at the next sequence, never re-emits the resumption point). cancelRun, bulkCancelRuns and pauseRun are core operations by the runs.md surface table (only ancestry, annotations and eval-summary are 404-when-unadvertised), so a host that omits one is blocked, not inapplicable, and the floor refuses it \u2014 the prose's outcome. Their optional legs (values mode, the conformance-delay / conformance-cancellable fixtures) record inapplicable with the reason and the file row stays a witnessed pass. Measured before the change: the reference host passes all five (rc.58, 179 / 0 / 0 / 42); neither production host satisfies this predicate, so no existing claim moves. seeded from spec/v1/core-standard-manifest.json at P3-B; floor minted rc.45, one or more unaided witnesses per predicate family: interrupt (token scheme), replay (the effect-seam manifest \u2014 its seam-driven no-re-fire leg lives in v2-effect-seam-no-refire on the seams floor), webhooks (durable delivery), idempotency (Layer-1 key grammar), eventLog (era key, era stamp, closed event type, poll cursor). Deliberately absent: v2-pinned-run-disposition (seam-gated and opt-in), v2-v1-signed-webhook-accepted (a coexistence scenario, driven through the seam; the cut gate is its home), v2-effect-identity-business-key (retry leg seam-driven), v2-approver-enforced (conditional on the refKinds facet)."
1847
1863
  },
1848
1864
  {
1849
1865
  "id": "openwop-conformance-seams-v2",
1850
1866
  "predicate": {
1851
- "families": []
1867
+ "families": [],
1868
+ "metadata": [
1869
+ "conformance"
1870
+ ]
1852
1871
  },
1853
- "floorScenarios": [],
1854
- "note": "RFC 0168 §C.1 — the seams profile; its own api/seams-v2.yaml; forbidden from the capability namespace"
1872
+ "floorScenarios": [
1873
+ "v2-fork-a-v1-run",
1874
+ "v2-effect-identity-business-key",
1875
+ "v2-v1-signed-webhook-accepted",
1876
+ "v2-effect-seam-no-refire"
1877
+ ],
1878
+ "note": "RFC 0168 \u00a7C.1 \u2014 the seams profile; its own api/seams-v2.yaml; forbidden from the capability namespace. Floor minted rc.45: the four scenarios driven through a seam. rc.62 CLAIM FIX: the predicate now requires `conformance` at the discovery root. Until rc.62 the predicate was EMPTY, and `claimedProfilesForV2` treats an empty predicate as vacuously satisfied, so this profile was CLAIMED BY EVERY v2 HOST \u2014 including two production hosts that never advertised it and carried it at `certified: false`. A profile claimed by a host that never advertised it is a claim the host did not make. The predicate is deliberately NECESSARY, not sufficient: it tests that a `conformance` block exists, while the exact advert (`conformance.seamsProfile === openwop-conformance-seams-v2`) is tested per scenario by `seamsProfileAdvertised`. The two compose honestly \u2014 no conformance block means NOT CLAIMED; a block naming some other profile means claimed, every floor row `inapplicable`, witnessCount 0, and therefore not certified and not blocked. This profile is the instrument, not a capability predicate: each floor file is ALSO gated on the family it witnesses (fork-a-v1-run and effect-seam-no-refire on replay, effect-identity-business-key on idempotency, v1-signed-webhook-accepted on webhooks), records `inapplicable` when that family is absent, and the profile certifies only on a witnessed pass \u2014 a seams host advertising none of those families witnesses nothing through the seam and certifies nothing."
1855
1879
  }
1856
1880
  ],
1857
1881
  "aliases": {
1858
1882
  "host.webSearch": {
1859
1883
  "family": "webResearch",
1860
- "note": "two spellings of one §host.* section in published manifests (1 use); the section is webResearch"
1884
+ "note": "two spellings of one \u00a7host.* section in published manifests (1 use); the section is webResearch"
1861
1885
  },
1862
1886
  "host.campaignMessaging": {
1863
1887
  "family": "messaging",