@openwop/spec-artifacts 2.0.0-rc.0

package/spec/v2/event-codemap.schema.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openwop.dev/spec/v2/event-codemap.schema.json",
+  "title": "OpenWOP v1→v2 event-type codemap",
+  "description": "Shape of spec/v1/event-codemap.json (v2 charter C.4/C.9, Phase 1 item 9): one row per RunEventType with its payload $def and a proposed v2 name. Data, not a wire artifact; kept out of schemas/. Generated by scripts/generate-event-codemap.mjs; the v2 C.4 child RFC edits it and every host backfills its event log from it.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema",
+    "$comment",
+    "version",
+    "updated",
+    "grammar",
+    "counts",
+    "rows"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "./event-codemap.schema.json"
+    },
+    "$comment": {
+      "type": "string"
+    },
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "updated": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "grammar": {
+      "type": "string"
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "rows",
+        "review",
+        "overridden"
+      ],
+      "properties": {
+        "rows": {
+          "type": "integer"
+        },
+        "review": {
+          "type": "integer"
+        },
+        "overridden": {
+          "type": "integer"
+        }
+      }
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "v1",
+          "v2",
+          "payloadDef",
+          "status",
+          "review",
+          "notes"
+        ],
+        "properties": {
+          "v1": {
+            "type": "string",
+            "minLength": 1
+          },
+          "v2": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*\\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+          },
+          "v2Override": {
+            "type": "string",
+            "description": "Hand-decided v2 name (C.4 decision); wins over the mechanical proposal and survives regeneration."
+          },
+          "payloadDef": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Key under run-event-payloads.schema.json $defs."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "proposed",
+              "decided"
+            ]
+          },
+          "review": {
+            "type": "boolean",
+            "description": "true when the mechanical proposal needs a semantic decision (tense, domain rename, reserved prefix)."
+          },
+          "notes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "note": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/spec/v2/ext/provider-idempotency/registry.json

@@ -0,0 +1,6 @@
+{
+  "$comment": "RFC 0173 \u00a7C.2 / RFC 0150 G3 \u2014 the provider registry: which providers expose a natural business-identity key for Layer-2 effect identity, and the activity-recipe fallback for those that do not. Seeded empty at P3-D; rows are added by the Phase 4 host legs from measured provider behavior, never asserted. A provider absent here keys by activity recipe.",
+  "version": "2.0",
+  "updated": "2026-09-03",
+  "providers": []
+}

package/spec/v2/facets/a2a.schema.json

@@ -0,0 +1,51 @@
+{
+  "$comment": "RFC 0175 §B.1/§C/§D",
+  "properties": {
+    "versions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^[0-9]+\\.[0-9]+$"
+      }
+    },
+    "preferredVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+$"
+    },
+    "minimumVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+$"
+    },
+    "refreshedAt": {
+      "type": "string",
+      "format": "date"
+    },
+    "profiles": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^a2a-[0-9]+\\.[0-9]+$"
+      }
+    },
+    "agentCardUrl": {
+      "type": "string",
+      "format": "uri"
+    },
+    "streaming": {
+      "type": "boolean"
+    },
+    "pushNotifications": {
+      "type": "boolean"
+    },
+    "durableTasks": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "versions",
+    "preferredVersion",
+    "minimumVersion",
+    "refreshedAt"
+  ]
+}

package/spec/v2/facets/aiProviders.schema.json

@@ -0,0 +1,56 @@
+{
+  "$comment": "RFC 0169 §A.2/§B.3 — supported: string[] becomes providers[]; imageGeneration/videoGeneration are facets",
+  "properties": {
+    "providers": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "byok": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "selfHosted": {
+      "type": "boolean"
+    },
+    "speechSynthesis": {
+      "type": "boolean"
+    },
+    "imageGeneration": {
+      "type": "boolean"
+    },
+    "videoGeneration": {
+      "type": "boolean"
+    },
+    "realtimeVoice": {
+      "type": "boolean"
+    },
+    "promptPrefixCache": {
+      "type": "boolean"
+    },
+    "maxInlineMediaBytes": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "authModes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "policies": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "input": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "providers"
+  ]
+}

package/spec/v2/facets/auth.schema.json

@@ -0,0 +1,91 @@
+{
+  "$comment": "RFC 0170 §B.2–§B.5; the fourteen gate flags and subjectLinking are gone (RFC 0173 §A.1, RFC 0170 §C.2)",
+  "properties": {
+    "lanes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "lane",
+          "issuers",
+          "revocation",
+          "minimumAssurance"
+        ],
+        "properties": {
+          "lane": {
+            "type": "string",
+            "enum": [
+              "api-key",
+              "oauth2",
+              "oidc",
+              "mtls",
+              "saml",
+              "scim",
+              "ldap",
+              "workload",
+              "session",
+              "anonymous"
+            ]
+          },
+          "issuers": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "revocation": {
+            "type": "string",
+            "enum": [
+              "next-request",
+              "exp-and-recheck",
+              "crl",
+              "ocsp",
+              "short-lived",
+              "not-on-or-after",
+              "bound-connection",
+              "rebind",
+              "delegation-expiry"
+            ]
+          },
+          "revocationWindowSeconds": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "minimumAssurance": {
+            "type": "string",
+            "enum": [
+              "bearer",
+              "sender-constrained",
+              "key-bound"
+            ]
+          },
+          "delegationProofs": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "mtls-key-binding",
+                "dpop",
+                "svid-chain"
+              ]
+            }
+          }
+        }
+      }
+    },
+    "subjectLinkKey": {
+      "type": "string",
+      "enum": [
+        "opaque-idp",
+        "configured-immutable"
+      ]
+    }
+  },
+  "required": [
+    "lanes"
+  ]
+}

package/spec/v2/facets/heartbeat.schema.json

@@ -0,0 +1,20 @@
+{
+  "$comment": "RFC 0171 §E.1 — the hostEvents channel address is declared here",
+  "properties": {
+    "minIntervalSec": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "maxRuntimeMs": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "deliveryChannel": {
+      "type": "string",
+      "pattern": "^/[A-Za-z0-9._~/{}-]+$"
+    }
+  },
+  "required": [
+    "deliveryChannel"
+  ]
+}

package/spec/v2/facets/interrupt.schema.json

@@ -0,0 +1,29 @@
+{
+  "$comment": "RFC 0173 §B — approver enforcement binds with the fields; refKinds stays a facet",
+  "properties": {
+    "refKinds": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "principal",
+          "group",
+          "role"
+        ]
+      }
+    },
+    "tokenAlgs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "enum": [
+          "hs256"
+        ]
+      }
+    }
+  },
+  "required": [
+    "tokenAlgs"
+  ]
+}

package/spec/v2/facets/mcp.schema.json

@@ -0,0 +1,81 @@
+{
+  "$comment": "RFC 0175 §B.1/§D/§E",
+  "properties": {
+    "revisions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "format": "date"
+      }
+    },
+    "preferredVersion": {
+      "type": "string",
+      "format": "date"
+    },
+    "minimumRevision": {
+      "type": "string",
+      "format": "date"
+    },
+    "refreshedAt": {
+      "type": "string",
+      "format": "date"
+    },
+    "profiles": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^mcp-[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+      }
+    },
+    "features": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "serverUrls": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "format": "uri"
+      }
+    },
+    "serverMount": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "transports": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "stdio",
+              "streamable-http"
+            ]
+          }
+        }
+      }
+    },
+    "mrtr": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "maxRounds"
+      ],
+      "properties": {
+        "maxRounds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 16
+        }
+      }
+    }
+  },
+  "required": [
+    "revisions",
+    "preferredVersion",
+    "minimumRevision",
+    "refreshedAt"
+  ]
+}

package/spec/v2/facets/replay.schema.json

@@ -0,0 +1,34 @@
+{
+  "$comment": "RFC 0173 §A.1/§C — sideEffectSuppression is not a flag; suppression binds with replay and is witnessed by the effect-seam manifest at GET /host/effect-seams",
+  "properties": {
+    "modes": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "enum": [
+          "replay",
+          "branch"
+        ]
+      },
+      "description": "Fork modes (POST /runs/{runId}:fork `mode`): replay = deterministic re-execution with suppression; branch = divergent execution (branchReFires seams re-fire, RFC 0140 G6)."
+    },
+    "retention": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "days": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "effectSeamsManifest": {
+      "const": "/host/effect-seams"
+    }
+  },
+  "required": [
+    "modes",
+    "effectSeamsManifest"
+  ]
+}

package/spec/v2/facets/sandbox.schema.json

@@ -0,0 +1,31 @@
+{
+  "$comment": "RFC 0173 §B — isolation binds with pack execution; node:vm is not a value",
+  "properties": {
+    "isolationModel": {
+      "type": "string",
+      "enum": [
+        "wasm",
+        "process",
+        "container",
+        "vm"
+      ]
+    },
+    "allowedHostCalls": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "memoryLimitBytes": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "wallClockLimitMs": {
+      "type": "integer",
+      "minimum": 1
+    }
+  },
+  "required": [
+    "isolationModel"
+  ]
+}

package/spec/v2/facets/webhooks.schema.json

@@ -0,0 +1,18 @@
+{
+  "$comment": "RFC 0173 §B — durable delivery binds with webhooks; no durable flag",
+  "properties": {
+    "signatureAlgorithms": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "enum": [
+          "v1"
+        ]
+      }
+    }
+  },
+  "required": [
+    "signatureAlgorithms"
+  ]
+}