@mplp/schema 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,11 @@
+# @mplp/schema
+
+MPLP Protocol v1.0 JSON Schemas - All protocol schema definitions
+
+## Installation
+
+`npm i @mplp/schema`
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -1,14 +1,3 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
 import Ajv from 'ajv';
 /**
  * Schema loader and validator for MPLP Protocol v1.0

package/dist/index.js

@@ -1,15 +1,4 @@
 "use strict";
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -18,6 +7,13 @@ exports.SCHEMA_NAMES = void 0;
 exports.loadSchema = loadSchema;
 exports.createValidator = createValidator;
 exports.validate = validate;
+/**
+ * © 2025 邦士（北京）网络科技有限公司
+ * Licensed under the Apache License, Version 2.0.
+ *
+ * This file is part of the MPLP reference implementation.
+ * It is NOT part of the frozen protocol specification.
+ */
 const fs_1 = require("fs");
 const path_1 = require("path");
 const ajv_1 = __importDefault(require("ajv"));

package/package.json

@@ -1,12 +1,11 @@
 {
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
   "name": "@mplp/schema",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MPLP Protocol v1.0 JSON Schemas - All protocol schema definitions",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Coregentis/MPLP-Protocol.git",
+    "url": "https://github.com/coregentis/MPLP-Protocol.git",
     "directory": "packages/schema"
   },
   "keywords": [
@@ -14,7 +13,9 @@
     "schema",
     "json-schema",
     "protocol",
-    "validation"
+    "validation",
+    "MPLP",
+    "multi-agent"
   ],
   "publishConfig": {
     "access": "public"
@@ -32,6 +33,24 @@
   "devDependencies": {
     "typescript": "^5.0.0"
   },
+  "author": "邦士（北京）网络科技有限公司",
+  "copyright": "© 2025 邦士（北京）网络科技有限公司",
+  "mplp": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "governance": "MPGC"
+  },
+  "homepage": "https://github.com/coregentis/MPLP-Protocol",
+  "bugs": {
+    "url": "https://github.com/coregentis/MPLP-Protocol/issues"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "sideEffects": false,
   "scripts": {
     "build": "tsc -p tsconfig.json"
   }

package/schemas/common/common-types.schema.json

@@ -1,49 +1,49 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "$id": "https://schemas.mplp.dev/v1.0/common/common-types.schema.json",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "MPLP Common Types",
-  "description": "Common type definitions used across MPLP modules to ensure consistency and reduce duplication.",
-  "definitions": {
-    "MplpId": {
-      "$ref": "identifiers.schema.json"
-    },
-    "Ref": {
-      "type": "object",
-      "description": "A standard reference to another MPLP object.",
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/MplpId"
-        },
-        "module": {
-          "type": "string",
-          "enum": [
-            "context",
-            "plan",
-            "confirm",
-            "trace",
-            "role",
-            "extension",
-            "dialog",
-            "collab",
-            "core",
-            "network"
-          ],
-          "description": "The module name of the referenced object."
-        },
-        "description": {
-          "type": "string",
-          "description": "Optional description of the reference relationship."
-        }
-      },
-      "required": [
-        "id",
-        "module"
-      ],
-      "additionalProperties": false
-    },
-    "BaseMeta": {
-      "$ref": "metadata.schema.json"
-    }
-  }
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$id": "https://schemas.mplp.dev/v1.0/common/common-types.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MPLP Common Types",
+  "description": "Common type definitions used across MPLP modules to ensure consistency and reduce duplication.",
+  "definitions": {
+    "MplpId": {
+      "$ref": "identifiers.schema.json"
+    },
+    "Ref": {
+      "type": "object",
+      "description": "A standard reference to another MPLP object.",
+      "properties": {
+        "id": {
+          "$ref": "#/definitions/MplpId"
+        },
+        "module": {
+          "type": "string",
+          "enum": [
+            "context",
+            "plan",
+            "confirm",
+            "trace",
+            "role",
+            "extension",
+            "dialog",
+            "collab",
+            "core",
+            "network"
+          ],
+          "description": "The module name of the referenced object."
+        },
+        "description": {
+          "type": "string",
+          "description": "Optional description of the reference relationship."
+        }
+      },
+      "required": [
+        "id",
+        "module"
+      ],
+      "additionalProperties": false
+    },
+    "BaseMeta": {
+      "$ref": "metadata.schema.json"
+    }
+  }
+}

package/schemas/common/events.schema.json

@@ -1,66 +1,66 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "$id": "https://schemas.mplp.dev/v1.0/common/events.schema.json",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "MPLP Base Event",
-  "description": "Base model for all event structures in MPLP. Designed based on CloudEvents v1.0 core fields, providing unified event identification, type, source, and timestamp. ExecutionEvent, StateTransitionEvent, etc., are extensions of this.",
-  "type": "object",
-  "properties": {
-    "event_id": {
-      "$ref": "identifiers.schema.json",
-      "description": "Unique identifier for the event (UUID v4)."
-    },
-    "event_type": {
-      "type": "string",
-      "description": "Event type identifier, e.g., execution.started / vsl.transition.applied / plan.created. Uses dot-separated namespace format.",
-      "pattern": "^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9]*)*$",
-      "examples": [
-        "execution.started",
-        "execution.completed",
-        "vsl.transition.applied",
-        "plan.created"
-      ]
-    },
-    "source": {
-      "type": "string",
-      "description": "Event source, typically a module or component identifier. Can be a module name (e.g., 'context') or component path (e.g., 'runtime.ael').",
-      "examples": [
-        "context",
-        "plan",
-        "runtime.ael",
-        "runtime.vsl"
-      ]
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Event occurrence time (ISO 8601 format).",
-      "examples": [
-        "2025-01-28T15:30:00.000Z"
-      ]
-    },
-    "trace_id": {
-      "description": "Optional trace ID to associate the event with a specific Trace.",
-      "$ref": "identifiers.schema.json"
-    },
-    "data": {
-      "anyOf": [
-        {
-          "type": "object",
-          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
-        },
-        {
-          "type": "null",
-          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
-        }
-      ]
-    }
-  },
-  "required": [
-    "event_id",
-    "event_type",
-    "source",
-    "timestamp"
-  ],
-  "additionalProperties": false
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$id": "https://schemas.mplp.dev/v1.0/common/events.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MPLP Base Event",
+  "description": "Base model for all event structures in MPLP. Designed based on CloudEvents v1.0 core fields, providing unified event identification, type, source, and timestamp. ExecutionEvent, StateTransitionEvent, etc., are extensions of this.",
+  "type": "object",
+  "properties": {
+    "event_id": {
+      "$ref": "identifiers.schema.json",
+      "description": "Unique identifier for the event (UUID v4)."
+    },
+    "event_type": {
+      "type": "string",
+      "description": "Event type identifier, e.g., execution.started / vsl.transition.applied / plan.created. Uses dot-separated namespace format.",
+      "pattern": "^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9]*)*$",
+      "examples": [
+        "execution.started",
+        "execution.completed",
+        "vsl.transition.applied",
+        "plan.created"
+      ]
+    },
+    "source": {
+      "type": "string",
+      "description": "Event source, typically a module or component identifier. Can be a module name (e.g., 'context') or component path (e.g., 'runtime.ael').",
+      "examples": [
+        "context",
+        "plan",
+        "runtime.ael",
+        "runtime.vsl"
+      ]
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Event occurrence time (ISO 8601 format).",
+      "examples": [
+        "2025-01-28T15:30:00.000Z"
+      ]
+    },
+    "trace_id": {
+      "description": "Optional trace ID to associate the event with a specific Trace.",
+      "$ref": "identifiers.schema.json"
+    },
+    "data": {
+      "anyOf": [
+        {
+          "type": "object",
+          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
+        },
+        {
+          "type": "null",
+          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
+        }
+      ]
+    }
+  },
+  "required": [
+    "event_id",
+    "event_type",
+    "source",
+    "timestamp"
+  ],
+  "additionalProperties": false
+}

package/schemas/common/identifiers.schema.json

@@ -1,13 +1,13 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "$id": "https://schemas.mplp.dev/v1.0/common/identifiers.schema.json",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "MPLP Identifier",
-  "description": "Unified identifier type used for contextId/planId/traceId/eventId, etc. Uses UUID v4 standard to ensure global uniqueness and collision-free generation in distributed environments.",
-  "type": "string",
-  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
-  "examples": [
-    "123e4567-e89b-12d3-a456-426614174000",
-    "550e8400-e29b-41d4-a716-446655440000"
-  ]
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$id": "https://schemas.mplp.dev/v1.0/common/identifiers.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MPLP Identifier",
+  "description": "Unified identifier type used for contextId/planId/traceId/eventId, etc. Uses UUID v4 standard to ensure global uniqueness and collision-free generation in distributed environments.",
+  "type": "string",
+  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+  "examples": [
+    "123e4567-e89b-12d3-a456-426614174000",
+    "550e8400-e29b-41d4-a716-446655440000"
+  ]
+}