nex-protocol 0.1.0a1__tar.gz

nex_protocol-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kamyarghaderi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nex_protocol-0.1.0a1/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: nex-protocol
+Version: 0.1.0a1
+Summary: Nex: a deterministic language and protocol for agent understanding and alignment.
+Author: Nex Project contributors
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jsonschema>=4.18
+Requires-Dist: cryptography>=42
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov>=4; extra == "dev"
+Requires-Dist: hypothesis>=6; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Nex
+
+A deterministic language and protocol for agent understanding and alignment.
+
+**Status: alpha (0.1.0a1).** This repository is the Nex Alpha 1.0 reference protocol and runtime.
+It is a pre-release: not published to PyPI, and the quantum-related and network features are out of scope.
+
+## Quick start
+
+```
+pip install -e ".[dev]"
+pytest
+nex demo                          # signed two-agent handshake + request
+nex glyph Kamyar --format svg     # Nex-G glyph (also json | png | scene)
+nex error E709                    # describe an error code
+python benchmarks/bench.py        # simple benchmarks
+```
+
+## What is implemented
+
+- **Nex-J / Nex-T** parsing, strict JSON-Schema validation (cached validators), RFC 8785-style canonical JSON.
+- **Runtime**: handshake, sessions, Ed25519 signatures, nonce/replay protection, duplicate-id detection,
+  task state machine, error registry (E-codes) and ERROR responses, memory and SQLite stores, cleanup worker.
+- **Nex-G**: deterministic integer-only glyph geometry, SVG, PNG, and a deterministic **3D scene description**.
+- **Experimental (non-normative)**: ultrasonic symbol encoding, [NEP-0007](spec/NEP-0007-Ultrasonic-Symbols.md).
+  It never changes Nex-J, which stays canonical.
+- **Crypto agility**: documented in [NEP-0002](spec/NEP-0002-Nex-Protocol-1.1.md), including a reserved slot for a
+  future post-quantum signature algorithm. No post-quantum or quantum features are implemented.
+
+## Layout
+
+- `src/nex/` - reference implementation
+- `schemas/` - JSON schemas and registries (packaged with the wheel)
+- `spec/` - Nex Enhancement Proposals (NEP-0001 .. NEP-0007)
+- `docs/` - [Final specification](docs/NEX_FINAL_SPEC.md), [Master handoff](docs/MASTER_HANDOFF.md),
+  [Images note](docs/IMAGES_NOTE.txt), [Releasing](docs/RELEASING.md)
+- `tests/`, `benchmarks/`, `examples/`
+
+See [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md) and [CHANGELOG.md](CHANGELOG.md).

nex_protocol-0.1.0a1/README.md

@@ -0,0 +1,39 @@
+# Nex
+
+A deterministic language and protocol for agent understanding and alignment.
+
+**Status: alpha (0.1.0a1).** This repository is the Nex Alpha 1.0 reference protocol and runtime.
+It is a pre-release: not published to PyPI, and the quantum-related and network features are out of scope.
+
+## Quick start
+
+```
+pip install -e ".[dev]"
+pytest
+nex demo                          # signed two-agent handshake + request
+nex glyph Kamyar --format svg     # Nex-G glyph (also json | png | scene)
+nex error E709                    # describe an error code
+python benchmarks/bench.py        # simple benchmarks
+```
+
+## What is implemented
+
+- **Nex-J / Nex-T** parsing, strict JSON-Schema validation (cached validators), RFC 8785-style canonical JSON.
+- **Runtime**: handshake, sessions, Ed25519 signatures, nonce/replay protection, duplicate-id detection,
+  task state machine, error registry (E-codes) and ERROR responses, memory and SQLite stores, cleanup worker.
+- **Nex-G**: deterministic integer-only glyph geometry, SVG, PNG, and a deterministic **3D scene description**.
+- **Experimental (non-normative)**: ultrasonic symbol encoding, [NEP-0007](spec/NEP-0007-Ultrasonic-Symbols.md).
+  It never changes Nex-J, which stays canonical.
+- **Crypto agility**: documented in [NEP-0002](spec/NEP-0002-Nex-Protocol-1.1.md), including a reserved slot for a
+  future post-quantum signature algorithm. No post-quantum or quantum features are implemented.
+
+## Layout
+
+- `src/nex/` - reference implementation
+- `schemas/` - JSON schemas and registries (packaged with the wheel)
+- `spec/` - Nex Enhancement Proposals (NEP-0001 .. NEP-0007)
+- `docs/` - [Final specification](docs/NEX_FINAL_SPEC.md), [Master handoff](docs/MASTER_HANDOFF.md),
+  [Images note](docs/IMAGES_NOTE.txt), [Releasing](docs/RELEASING.md)
+- `tests/`, `benchmarks/`, `examples/`
+
+See [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md) and [CHANGELOG.md](CHANGELOG.md).

nex_protocol-0.1.0a1/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nex-protocol"
+version = "0.1.0a1"
+description = "Nex: a deterministic language and protocol for agent understanding and alignment."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Nex Project contributors" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = ["jsonschema>=4.18", "cryptography>=42"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "pytest-cov>=4", "hypothesis>=6", "build", "twine"]
+
+[project.scripts]
+nex = "nex.cli:main"
+
+[tool.setuptools]
+packages = [
+    "nex",
+    "nex.stores",
+    "nex.schemas",
+    "nex.schemas.payloads",
+    "nex.schemas.registries",
+]
+
+[tool.setuptools.package-dir]
+"" = "src"
+"nex.schemas" = "schemas"
+"nex.schemas.payloads" = "schemas/payloads"
+"nex.schemas.registries" = "schemas/registries"
+
+[tool.setuptools.package-data]
+"nex.schemas" = ["*.json"]
+"nex.schemas.payloads" = ["*.json"]
+"nex.schemas.registries" = ["*.json"]

nex_protocol-0.1.0a1/schemas/__init__.py

@@ -0,0 +1 @@
+"""Nex JSON schemas (data package)."""

nex_protocol-0.1.0a1/schemas/nex-error-1.1.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/nex-error-1.1.schema.json",
+  "title": "Nex Error Object 1.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["code", "message", "severity", "recovery", "details"],
+  "properties": {
+    "code": {"type": "string", "pattern": "^E[0-9]{3}$", "not": {"const": "E505"}},
+    "message": {"type": "string", "pattern": "^[A-Z][A-Z0-9_]*$"},
+    "severity": {"enum": ["INFO", "MINOR", "MAJOR", "CRITICAL"]},
+    "recovery": {"enum": ["NONE", "FIX_SYNTAX", "FIX_MESSAGE", "RETRY", "REHANDSHAKE", "REAUTHENTICATE", "RESYNC", "ESCALATE", "ABORT"]},
+    "details": {}
+  }
+}

nex_protocol-0.1.0a1/schemas/nex-error-message-1.1.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/nex-error-message-1.1.schema.json",
+  "title": "Nex Error Message 1.1",
+  "description": "A Nex-J message whose command is ERROR.",
+  "allOf": [
+    {"$ref": "nex-message-1.1.schema.json"},
+    {
+      "type": "object",
+      "properties": {
+        "header": {"properties": {"message_type": {"const": "ERROR"}}},
+        "body": {"properties": {"command": {"const": "ERROR"}}}
+      }
+    }
+  ]
+}

nex_protocol-0.1.0a1/schemas/nex-message-1.1.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/nex-message-1.1.schema.json",
+  "title": "Nex Message 1.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["header", "body", "signature"],
+  "properties": {
+    "header": {"$ref": "#/$defs/header"},
+    "body": {"$ref": "#/$defs/body"},
+    "signature": {"$ref": "#/$defs/signature"}
+  },
+  "$defs": {
+    "agent_id": {"type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$"},
+    "timestamp": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]{1,9})?Z$"
+    },
+    "header": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["message_id", "correlation_id", "session_id", "reply_to", "sender", "receiver", "timestamp", "expires_at", "protocol_version", "message_type", "nonce"],
+      "properties": {
+        "message_id": {"type": "string", "pattern": "^MSG-[A-Za-z0-9_-]{1,96}$"},
+        "correlation_id": {"type": "string", "pattern": "^CORR-[A-Za-z0-9_-]{1,96}$"},
+        "session_id": {"type": ["string", "null"], "pattern": "^SES-[A-Za-z0-9_-]{1,96}$"},
+        "reply_to": {"type": ["string", "null"], "pattern": "^MSG-[A-Za-z0-9_-]{1,96}$"},
+        "sender": {"$ref": "#/$defs/agent_id"},
+        "receiver": {"$ref": "#/$defs/agent_id"},
+        "timestamp": {"$ref": "#/$defs/timestamp"},
+        "expires_at": {"$ref": "#/$defs/timestamp"},
+        "protocol_version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+$"},
+        "message_type": {"$ref": "#/$defs/command"},
+        "nonce": {"type": ["string", "null"], "pattern": "^[A-Za-z0-9_-]{8,128}$"}
+      }
+    },
+    "command": {"enum": ["HANDSHAKE", "REQUEST", "REPORT", "PLAN", "ACT", "VERIFY", "SYNC", "ERROR"]},
+    "body": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["command", "payload"],
+      "properties": {
+        "command": {"$ref": "#/$defs/command"},
+        "payload": {"type": "object"}
+      },
+      "allOf": [
+        {"if": {"required": ["command"], "properties": {"command": {"const": "HANDSHAKE"}}}, "then": {"properties": {"payload": {"$ref": "payloads/handshake.schema.json"}}}},
+        {"if": {"required": ["command"], "properties": {"command": {"const": "REQUEST"}}}, "then": {"properties": {"payload": {"$ref": "payloads/request.schema.json"}}}},
+        {"if": {"required": ["command"], "properties": {"command": {"const": "REPORT"}}}, "then": {"properties": {"payload": {"$ref": "payloads/report.schema.json"}}}},
+        {"if": {"required": ["command"], "properties": {"command": {"const": "PLAN"}}}, "then": {"properties": {"payload": {"$ref": "payloads/plan.schema.json"}}}},
+        {"if": {"required": ["command"], "properties": {"command": {"const": "ACT"}}}, "then": {"properties": {"payload": {"$ref": "payloads/act.schema.json"}}}},
+        {"if": {"required": ["command"], "properties": {"command": {"const": "VERIFY"}}}, "then": {"properties": {"payload": {"$ref": "payloads/verify.schema.json"}}}},
+        {"if": {"required": ["command"], "properties": {"command": {"const": "SYNC"}}}, "then": {"properties": {"payload": {"$ref": "payloads/sync.schema.json"}}}},
+        {"if": {"required": ["command"], "properties": {"command": {"const": "ERROR"}}}, "then": {"properties": {"payload": {"$ref": "payloads/error.schema.json"}}}}
+      ]
+    },
+    "signature": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["algorithm", "key_id", "value"],
+      "properties": {
+        "algorithm": {"enum": ["NONE", "ED25519"]},
+        "key_id": {"type": ["string", "null"], "pattern": "^KEY-[A-Za-z0-9_-]{1,96}$"},
+        "value": {"type": ["string", "null"], "pattern": "^[A-Za-z0-9_-]{86}$"}
+      },
+      "allOf": [
+        {"if": {"required": ["algorithm"], "properties": {"algorithm": {"const": "NONE"}}}, "then": {"properties": {"key_id": {"type": "null"}, "value": {"type": "null"}}}},
+        {"if": {"required": ["algorithm"], "properties": {"algorithm": {"const": "ED25519"}}}, "then": {"properties": {"key_id": {"type": "string"}, "value": {"type": "string"}}}}
+      ]
+    }
+  }
+}

nex_protocol-0.1.0a1/schemas/payloads/__init__.py

@@ -0,0 +1 @@
+"""Nex payload schemas (data package)."""

nex_protocol-0.1.0a1/schemas/payloads/act.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/act.schema.json",
+  "title": "ACT payload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["action", "target", "authorization_id"],
+  "properties": {
+    "action": {"type": "string", "minLength": 1},
+    "target": {"type": "string", "minLength": 1},
+    "destination": {"type": "string", "minLength": 1},
+    "authorization_id": {"type": "string", "pattern": "^AUTH-[A-Za-z0-9_-]{1,96}$"}
+  }
+}

nex_protocol-0.1.0a1/schemas/payloads/error.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/error.schema.json",
+  "title": "ERROR payload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["code", "message", "severity", "recovery"],
+  "properties": {
+    "code": {"type": "string", "pattern": "^E[0-9]{3}$", "not": {"const": "E505"}},
+    "message": {"type": "string", "pattern": "^[A-Z][A-Z0-9_]*$"},
+    "severity": {"enum": ["INFO", "MINOR", "MAJOR", "CRITICAL"]},
+    "recovery": {"enum": ["NONE", "FIX_SYNTAX", "FIX_MESSAGE", "RETRY", "REHANDSHAKE", "REAUTHENTICATE", "RESYNC", "ESCALATE", "ABORT"]},
+    "details": {}
+  }
+}

nex_protocol-0.1.0a1/schemas/payloads/handshake.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/handshake.schema.json",
+  "title": "HANDSHAKE payload",
+  "type": "object",
+  "oneOf": [
+    {
+      "title": "HANDSHAKE request",
+      "additionalProperties": false,
+      "required": ["identity", "version", "capabilities", "ontology_modules", "security_algorithms", "intent"],
+      "properties": {
+        "identity": {"type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$"},
+        "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+$"},
+        "capabilities": {"type": "array", "items": {"enum": ["HANDSHAKE", "REQUEST", "REPORT", "PLAN", "ACT", "VERIFY", "SYNC", "ERROR"]}, "uniqueItems": true},
+        "ontology_modules": {"type": "array", "items": {"type": "string", "minLength": 1}, "minItems": 1, "uniqueItems": true},
+        "security_algorithms": {"type": "array", "items": {"enum": ["NONE", "ED25519"]}, "minItems": 1, "uniqueItems": true},
+        "intent": {"enum": ["ASSIST", "INFORM", "COORDINATE", "VERIFY", "PROTECT", "DISCOVER", "NEGOTIATE"]}
+      }
+    },
+    {
+      "title": "HANDSHAKE response",
+      "additionalProperties": false,
+      "required": ["identity", "version", "accepted", "session_id", "capabilities"],
+      "properties": {
+        "identity": {"type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$"},
+        "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+$"},
+        "accepted": {"type": "boolean"},
+        "session_id": {"type": ["string", "null"], "pattern": "^SES-[A-Za-z0-9_-]{1,96}$"},
+        "capabilities": {"type": "array", "items": {"enum": ["HANDSHAKE", "REQUEST", "REPORT", "PLAN", "ACT", "VERIFY", "SYNC", "ERROR"]}, "uniqueItems": true},
+        "reason": {"type": "string"}
+      },
+      "allOf": [
+        {"if": {"properties": {"accepted": {"const": true}}}, "then": {"properties": {"session_id": {"type": "string"}}}}
+      ]
+    }
+  ]
+}

nex_protocol-0.1.0a1/schemas/payloads/plan.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/plan.schema.json",
+  "title": "PLAN payload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["goal", "steps"],
+  "properties": {
+    "goal": {"type": "string", "minLength": 1},
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["step_id", "action"],
+        "properties": {
+          "step_id": {"type": "string", "pattern": "^STEP-[A-Za-z0-9_-]{1,96}$"},
+          "action": {"type": "string", "minLength": 1},
+          "target": {"type": "string", "minLength": 1},
+          "destination": {"type": "string", "minLength": 1},
+          "depends_on": {"type": "array", "items": {"type": "string", "pattern": "^STEP-[A-Za-z0-9_-]{1,96}$"}, "uniqueItems": true}
+        }
+      }
+    }
+  }
+}

nex_protocol-0.1.0a1/schemas/payloads/report.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/report.schema.json",
+  "title": "REPORT payload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["state"],
+  "properties": {
+    "state": {"enum": ["UNKNOWN", "OBSERVED", "INFERRED", "PLANNED", "ACTIVE", "COMPLETED", "VERIFIED", "FAILED", "INVALID"]},
+    "task_id": {"type": "string", "pattern": "^TASK-[A-Za-z0-9_-]{1,96}$"},
+    "details": {"type": ["string", "object", "null"]},
+    "evidence": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "failure_cause": {"type": "string"},
+    "understanding_status": {"enum": ["NOT_EVALUATED", "PARTIAL", "UNDERSTOOD", "MISUNDERSTOOD", "CLARIFICATION_REQUIRED"]},
+    "consent_status": {"enum": ["NOT_REQUIRED", "REQUESTED", "GRANTED", "DENIED", "REVOKED"]},
+    "alignment_status": {"enum": ["UNKNOWN", "ALIGNED", "PARTIALLY_ALIGNED", "CONFLICTING"]},
+    "uncertainty": {"type": "number", "minimum": 0, "maximum": 1}
+  }
+}

nex_protocol-0.1.0a1/schemas/payloads/request.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/request.schema.json",
+  "title": "REQUEST payload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["goal"],
+  "properties": {
+    "goal": {"type": "string", "minLength": 1},
+    "target": {"type": "string", "minLength": 1},
+    "destination": {"type": "string", "minLength": 1},
+    "deadline": {"$ref": "../nex-message-1.1.schema.json#/$defs/timestamp"},
+    "priority": {"type": "integer", "minimum": 0, "maximum": 9},
+    "intent": {"enum": ["ASSIST", "INFORM", "COORDINATE", "VERIFY", "PROTECT", "DISCOVER", "NEGOTIATE"]},
+    "expected_impact": {"enum": ["POSITIVE", "NEUTRAL", "NEGATIVE", "UNKNOWN"]},
+    "confidence": {"type": "number", "minimum": 0, "maximum": 1},
+    "constraints": {"type": "array", "items": {}}
+  }
+}

nex_protocol-0.1.0a1/schemas/payloads/sync.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/sync.schema.json",
+  "title": "SYNC payload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["objects"],
+  "properties": {
+    "objects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["object_id", "state", "version"],
+        "properties": {
+          "object_id": {"type": "string", "minLength": 1},
+          "state": {"enum": ["UNKNOWN", "OBSERVED", "INFERRED", "PLANNED", "ACTIVE", "COMPLETED", "VERIFIED", "FAILED", "INVALID"]},
+          "version": {"type": "integer", "minimum": 0}
+        }
+      }
+    }
+  }
+}

nex_protocol-0.1.0a1/schemas/payloads/verify.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nex.example/schemas/payloads/verify.schema.json",
+  "title": "VERIFY payload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["target", "method"],
+  "properties": {
+    "target": {"type": "string", "minLength": 1},
+    "expected_state": {"type": "object"},
+    "method": {"type": "string", "minLength": 1},
+    "evidence": {"type": "array", "items": {"type": "string", "minLength": 1}}
+  }
+}

nex_protocol-0.1.0a1/schemas/registries/__init__.py

@@ -0,0 +1 @@
+"""Nex registries (data package)."""

nex_protocol-0.1.0a1/schemas/registries/nex-command-registry-1.1.json

@@ -0,0 +1,46 @@
+{
+  "commands": [
+    {
+      "description": "compatibility, identity, capabilities, secure session",
+      "id": "NX-C-0001",
+      "name": "HANDSHAKE"
+    },
+    {
+      "description": "contribution or action toward a goal",
+      "id": "NX-C-0002",
+      "name": "REQUEST"
+    },
+    {
+      "description": "status, result, observation, or task state",
+      "id": "NX-C-0003",
+      "name": "REPORT"
+    },
+    {
+      "description": "ordered or dependency-aware operations",
+      "id": "NX-C-0004",
+      "name": "PLAN"
+    },
+    {
+      "description": "requests or records authorized execution",
+      "id": "NX-C-0005",
+      "name": "ACT"
+    },
+    {
+      "description": "requests or reports verification",
+      "id": "NX-C-0006",
+      "name": "VERIFY"
+    },
+    {
+      "description": "aligns semantic and operational state",
+      "id": "NX-C-0007",
+      "name": "SYNC"
+    },
+    {
+      "description": "protocol, validation, execution, security, or runtime failure",
+      "id": "NX-C-0008",
+      "name": "ERROR"
+    }
+  ],
+  "registry": "NEX-COMMANDS",
+  "version": "1.1"
+}