wasmagent-protocol 0.1.0__py3-none-any.whl

wasmagent_protocol/schemas/compliance/rollout-wire.schema.json

@@ -0,0 +1,267 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wasmagent.dev/schemas/compliance/rollout-wire.schema.json",
+  "title": "Rollout Wire Format",
+  "description": "Intermediate JSONL formats in the wasmagent → evomerge data pipeline. Contains three related record types at different pipeline stages. NOT the final training record format — see training-record.schema.json. Validate individual records against the named entry schemas below: rollout-wire/v1/branch, rollout-wire/v1/dpo, rollout-wire/v1/ppo.",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/RolloutBranchRecord"
+    },
+    {
+      "$ref": "#/$defs/DpoRecord"
+    },
+    {
+      "$ref": "#/$defs/PpoRecord"
+    }
+  ],
+  "$defs": {
+    "RolloutBranchRecord": {
+      "description": "Layer 1: RolloutBranchResult serialized to JSONL by RolloutForkRunner. Consumed by evomerge load_rollouts().",
+      "type": "object",
+      "required": [
+        "rollout_id",
+        "task",
+        "branch_index",
+        "temperature",
+        "session_id",
+        "tool_call_sequence",
+        "final_answer"
+      ],
+      "additionalProperties": true,
+      "properties": {
+        "rollout_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "task": {
+          "type": "string",
+          "minLength": 1
+        },
+        "branch_index": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "temperature": {
+          "type": "number"
+        },
+        "session_id": {
+          "type": "string"
+        },
+        "tool_call_sequence": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        "final_answer": {
+          "type": "string"
+        },
+        "build_result": {
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "objective_score": {
+          "type": "integer",
+          "enum": [
+            0,
+            1
+          ]
+        },
+        "objective_status": {
+          "type": "string",
+          "enum": [
+            "pass",
+            "fail",
+            "unknown"
+          ],
+          "description": "Semantic label for objective_score. unknown = build not triggered (do not use in DPO pairs)."
+        },
+        "rank": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "total_score": {
+          "type": "number",
+          "description": "Raw RolloutRanker totalScore, NOT normalized to [0,1]. Normalized by evomerge _compute_reward()."
+        }
+      }
+    },
+    "DpoProvenance": {
+      "description": "Layer 2 DPO: provenance block from toDpoRecord().",
+      "type": "object",
+      "required": [
+        "source",
+        "rollout_id",
+        "chosen_branch",
+        "rejected_branch",
+        "objective_score",
+        "exported_at_ms",
+        "n_gram_hash"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "source": {
+          "type": "string",
+          "const": "wasmagent-rollout"
+        },
+        "rollout_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "chosen_branch": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "rejected_branch": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "objective_score": {
+          "type": "object",
+          "required": [
+            "chosen",
+            "rejected"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "chosen": {
+              "type": "integer",
+              "enum": [
+                0,
+                1
+              ]
+            },
+            "rejected": {
+              "type": "integer",
+              "enum": [
+                0,
+                1
+              ]
+            }
+          }
+        },
+        "exported_at_ms": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "n_gram_hash": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{16}$"
+        }
+      }
+    },
+    "PpoProvenance": {
+      "description": "Layer 2 PPO: provenance block from toPpoRecords().",
+      "type": "object",
+      "required": [
+        "source",
+        "rollout_id",
+        "branch_index",
+        "objective_score",
+        "exported_at_ms",
+        "n_gram_hash"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "source": {
+          "type": "string",
+          "const": "wasmagent-rollout"
+        },
+        "rollout_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "branch_index": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "objective_score": {
+          "type": "integer",
+          "enum": [
+            0,
+            1
+          ]
+        },
+        "exported_at_ms": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "n_gram_hash": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{16}$"
+        }
+      }
+    },
+    "DpoRecord": {
+      "description": "Layer 2 DPO: output of toDpoRecord(). Intermediate format before evomerge rebuilds messages.",
+      "type": "object",
+      "required": [
+        "prompt",
+        "chosen",
+        "rejected",
+        "tool_call_sequence",
+        "provenance"
+      ],
+      "additionalProperties": true,
+      "properties": {
+        "prompt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "chosen": {
+          "type": "string",
+          "minLength": 1
+        },
+        "rejected": {
+          "type": "string",
+          "minLength": 1
+        },
+        "tool_call_sequence": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        "provenance": {
+          "$ref": "#/$defs/DpoProvenance"
+        }
+      }
+    },
+    "PpoRecord": {
+      "description": "Layer 2 PPO: output of toPpoRecords(). Intermediate format before evomerge rebuilds messages.",
+      "type": "object",
+      "required": [
+        "prompt",
+        "completion",
+        "reward",
+        "tool_call_sequence",
+        "provenance"
+      ],
+      "additionalProperties": true,
+      "properties": {
+        "prompt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "completion": {
+          "type": "string"
+        },
+        "reward": {
+          "type": "number",
+          "description": "Raw totalScore from RolloutRanker, NOT normalized. Normalized to [0,1] by evomerge _compute_reward()."
+        },
+        "tool_call_sequence": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        "provenance": {
+          "$ref": "#/$defs/PpoProvenance"
+        }
+      }
+    }
+  }
+}

wasmagent_protocol/schemas/compliance/task-spec.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wasmagent.dev/schemas/compliance/task-spec.schema.json",
+  "title": "TaskSpec",
+  "description": "Public contract for a compliance run. One TaskSpec → one run → one ComplianceEvalRecord.",
+  "type": "object",
+  "required": [
+    "id",
+    "intent",
+    "language",
+    "constraints",
+    "priority_hierarchy"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "intent": {
+      "type": "string",
+      "minLength": 1
+    },
+    "language": {
+      "type": "string",
+      "minLength": 1,
+      "description": "BCP-47 language tag (e.g. 'zh-CN', 'en')."
+    },
+    "audience": {
+      "type": "string"
+    },
+    "constraints": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "constraint-ir.schema.json"
+      }
+    },
+    "priority_hierarchy": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "enum": [
+          "system_policy",
+          "user_explicit_constraints",
+          "task_package_constraints",
+          "tool_output_constraints",
+          "history_constraints",
+          "style_preferences"
+        ]
+      }
+    },
+    "tools": {
+      "type": "object",
+      "required": [
+        "allowed"
+      ],
+      "properties": {
+        "allowed": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "denied": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "repair": {
+      "type": "object",
+      "required": [
+        "max_rounds",
+        "default_strategy"
+      ],
+      "properties": {
+        "max_rounds": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "default_strategy": {
+          "type": "string",
+          "enum": [
+            "patch",
+            "insert_section",
+            "regenerate_region",
+            "full"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "trace": {
+      "type": "object",
+      "required": [
+        "record_constraint_eval",
+        "record_tool_calls",
+        "record_repairs"
+      ],
+      "properties": {
+        "record_constraint_eval": {
+          "type": "boolean"
+        },
+        "record_tool_calls": {
+          "type": "boolean"
+        },
+        "record_repairs": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

wasmagent_protocol/schemas/index.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "protocol": "AEP",
+  "description": "Registry of canonical WasmAgent protocol schemas. This is the single source of truth for every cross-repository contract in the org. Downstream repos consume these via the versioned npm (@wasmagent/protocol) and pip (wasmagent-protocol) packages and MUST NOT keep local copies.",
+  "canonical_host": "https://wasmagent.dev/schemas/",
+  "schemas": [
+    {
+      "id": "aep-record",
+      "title": "AEPRecord",
+      "path": "schemas/aep/aep-record.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/aep/aep-record.schema.json",
+      "version": "aep/v0.2",
+      "stability": "evolving",
+      "owners": ["wasmagent-protocol"],
+      "consumers": ["wasmagent-js", "wasmagent-proxy", "trace-pipeline", "wasmagent-train-replay", "open-agent-audit"],
+      "summary": "Runtime action evidence and run provenance record — the core Agent Evidence Protocol contract."
+    },
+    {
+      "id": "constraint-ir",
+      "title": "ConstraintIR",
+      "path": "schemas/compliance/constraint-ir.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/compliance/constraint-ir.schema.json",
+      "version": "compliance/v1",
+      "stability": "evolving",
+      "owners": ["wasmagent-protocol"],
+      "consumers": ["wasmagent-js", "trace-pipeline"],
+      "summary": "Typed, repairable, prioritised constraint — superset of @wasmagent/core Criterion."
+    },
+    {
+      "id": "constraint-violation",
+      "title": "ConstraintViolation",
+      "path": "schemas/compliance/constraint-violation.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/compliance/constraint-violation.schema.json",
+      "version": "compliance/v1",
+      "stability": "evolving",
+      "owners": ["wasmagent-protocol"],
+      "consumers": ["wasmagent-js", "trace-pipeline"],
+      "summary": "A failed constraint plus its location in the artifact."
+    },
+    {
+      "id": "repair-trace",
+      "title": "RepairTrace",
+      "path": "schemas/compliance/repair-trace.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/compliance/repair-trace.schema.json",
+      "version": "compliance/v1",
+      "stability": "evolving",
+      "owners": ["wasmagent-protocol"],
+      "consumers": ["wasmagent-js", "trace-pipeline"],
+      "summary": "Per-round repair record. Supersedes trace-pipeline's repair-trace-entry naming."
+    },
+    {
+      "id": "task-spec",
+      "title": "TaskSpec",
+      "path": "schemas/compliance/task-spec.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/compliance/task-spec.schema.json",
+      "version": "compliance/v1",
+      "stability": "evolving",
+      "owners": ["wasmagent-protocol"],
+      "consumers": ["wasmagent-js", "trace-pipeline"],
+      "summary": "Public contract for a compliance run. One TaskSpec -> one run -> one ComplianceEvalRecord."
+    },
+    {
+      "id": "compliance-eval-record",
+      "title": "ComplianceEvalRecord",
+      "path": "schemas/compliance/compliance-eval-record.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/compliance/compliance-eval-record.schema.json",
+      "version": "compliance-eval-record/v1",
+      "stability": "evolving",
+      "owners": ["wasmagent-protocol"],
+      "consumers": ["wasmagent-js", "trace-pipeline"],
+      "summary": "One record per compliance run."
+    },
+    {
+      "id": "rollout-wire",
+      "title": "Rollout Wire Format",
+      "path": "schemas/compliance/rollout-wire.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/compliance/rollout-wire.schema.json",
+      "version": "rollout-wire/v1",
+      "stability": "evolving",
+      "owners": ["wasmagent-protocol"],
+      "consumers": ["wasmagent-js", "trace-pipeline"],
+      "summary": "Intermediate JSONL formats in the wasmagent -> evomerge data pipeline (branch/dpo/ppo records)."
+    }
+  ]
+}

wasmagent_protocol-0.1.0.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: wasmagent-protocol
+Version: 0.1.0
+Summary: Canonical JSON Schemas for the WasmAgent Agent Evidence Protocol (AEP) and compliance contracts. Single source of truth across the WasmAgent org.
+Project-URL: Homepage, https://github.com/WasmAgent/wasmagent-protocol
+Project-URL: Issues, https://github.com/WasmAgent/wasmagent-protocol/issues
+Author: WasmAgent
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: aep,agent-evidence-protocol,compliance,json-schema,provenance,wasmagent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Provides-Extra: validate
+Requires-Dist: jsonschema>=4.0; extra == 'validate'
+Description-Content-Type: text/markdown
+
+# wasmagent-protocol
+
+> **Canonical source of truth for every cross-repository contract in the
+> [WasmAgent](https://github.com/WasmAgent) org.** One public schema → one
+> canonical source.
+
+WasmAgent is open infrastructure for _provable_ AI agents. Proving an agent ran
+correctly requires that every repository — the runtime, the gateway, the
+evidence pipelines, the audit product — speak the **same** evidence and
+compliance vocabulary. `wasmagent-protocol` is where that vocabulary is defined,
+versioned, and published, so no repository has to keep its own copy.
+
+This repository holds **specifications only**. It contains no business logic,
+no runtime, and no product code — only JSON Schemas, conformance fixtures, and
+thin loader packages that expose the schemas to JavaScript and Python
+consumers.
+
+## Why this repository exists
+
+The Agent Evidence Protocol (AEP) and the compliance schemas were originally
+authored inside `wasmagent-js` and independently copied into `trace-pipeline`.
+By the time this repository was extracted, those copies had **drifted**: five
+shared schemas differed (one had a copy-paste `title` bug, and the same logical
+schema carried two conflicting `$id` URLs). Drift in a shared contract silently
+breaks cross-repo evidence validation — exactly the failure mode WasmAgent
+exists to prevent.
+
+Per the org [repository boundary policy](https://github.com/WasmAgent/.github/blob/main/docs/repository-boundaries.md):
+**one public schema has exactly one canonical source.** That source is here.
+
+## What's in scope
+
+Only contracts that genuinely cross a repository boundary:
+
+| Schema | Version | Consumers |
+| --- | --- | --- |
+| `aep-record` | `aep/v0.2` | wasmagent-js, wasmagent-proxy, trace-pipeline, wasmagent-train-replay, open-agent-audit |
+| `constraint-ir` | `compliance/v1` | wasmagent-js, trace-pipeline |
+| `constraint-violation` | `compliance/v1` | wasmagent-js, trace-pipeline |
+| `repair-trace` | `compliance/v1` | wasmagent-js, trace-pipeline |
+| `task-spec` | `compliance/v1` | wasmagent-js, trace-pipeline |
+| `compliance-eval-record` | `compliance-eval-record/v1` | wasmagent-js, trace-pipeline |
+| `rollout-wire` | `rollout-wire/v1` | wasmagent-js, trace-pipeline |
+
+The machine-readable registry is [`schemas/index.json`](schemas/index.json).
+
+**Out of scope:** schemas owned by a single repository (e.g. trace-pipeline's
+`*-training-record` output formats, open-agent-audit's `audit-run`). A schema
+belongs here only when two or more repositories must agree on it.
+
+## Consuming the schemas
+
+Downstream repositories **must not** copy schema JSON. Depend on the published
+package instead.
+
+### JavaScript / TypeScript
+
+```bash
+npm install @wasmagent/protocol
+```
+
+```ts
+import { schemas, getSchema } from "@wasmagent/protocol";
+
+const aep = getSchema("aep-record"); // parsed JSON Schema object
+```
+
+### Python
+
+```bash
+pip install wasmagent-protocol
+```
+
+```python
+from wasmagent_protocol import get_schema, schema_path
+
+aep = get_schema("aep-record")        # parsed dict
+path = schema_path("aep-record")      # pathlib.Path to the .json file
+```
+
+## Versioning & stability
+
+- Each schema carries a `version` string (see the registry).
+- **Additive** changes (new optional field) → minor package bump.
+- **Breaking** changes (removed/renamed field, tightened `required`) → major
+  package bump **and** a new `version` value, announced in the
+  [org release ledger](https://github.com/WasmAgent/.github/blob/main/releases/public-release-ledger.yml)
+  before merge.
+- Every schema has at least one valid and one invalid conformance fixture under
+  [`tests/fixtures/`](tests/fixtures/). CI rejects any schema without both.
+
+See [`docs/CONTRACT-CHANGE-PROCESS.md`](docs/CONTRACT-CHANGE-PROCESS.md) for the
+full change workflow and [`docs/GOVERNANCE.md`](docs/GOVERNANCE.md) for
+maintainer and exit-condition policy.
+
+## Development
+
+```bash
+# validate every schema is well-formed and every fixture conforms
+python3 -m pip install jsonschema
+python3 tests/conformance.py
+```
+
+## License
+
+[Apache-2.0](LICENSE).

wasmagent_protocol-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+wasmagent_protocol/__init__.py,sha256=17K8zv8lkaUXFLVVg25gCUlefGl6lJYAyzA2uVfkJvU,2194
+wasmagent_protocol/schemas/index.json,sha256=NRz2NUyS6_rNfyMSPTMp5xr3cGKpoVQMN_WXwJ0Xt74,3928
+wasmagent_protocol/schemas/aep/aep-record.schema.json,sha256=moZThjKP89UaKcoaHdyHE1l_xh3uXpd0imoM3NVhpoU,6125
+wasmagent_protocol/schemas/compliance/compliance-eval-record.schema.json,sha256=IfMVP2fxO_x4agSGwYAQb1Cx-YyKl0nJeOrvRxaK-GM,3624
+wasmagent_protocol/schemas/compliance/constraint-ir.schema.json,sha256=yPplwECbtlOP7rkeHHy1k6LXURTVVxP3OY7CiCNjA9o,1839
+wasmagent_protocol/schemas/compliance/constraint-violation.schema.json,sha256=2Cn5hqlCXk885wPJjYAxhrQlYq2UsmBCKiwj2PzfsRY,2171
+wasmagent_protocol/schemas/compliance/repair-trace.schema.json,sha256=X1Yub2AQS8rI9Go9SHcSjz16cOxF6VLVI-sOlJ4QvDY,1856
+wasmagent_protocol/schemas/compliance/rollout-wire.schema.json,sha256=WTHzm5_SM-09vuO0CEd0u7mYnfw9J22u_GwLeO6mRGU,6731
+wasmagent_protocol/schemas/compliance/task-spec.schema.json,sha256=t3tzPxNJlvAlOjunHrzJI6cve3H17VdxWOIwgR8_F_g,2597
+wasmagent_protocol-0.1.0.dist-info/METADATA,sha256=NdTKlwsZTc2N4U9sHjs3EYAcxpABDFvheAj8Dj0Uhls,4984
+wasmagent_protocol-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+wasmagent_protocol-0.1.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+wasmagent_protocol-0.1.0.dist-info/RECORD,,

wasmagent_protocol-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any