npm - @mplp/schema - Versions diffs - 1.0.0 - Mend

@mplp/schema 1.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 (38) hide show

package/LICENSE.txt +201 -0
package/dist/index.d.ts +45 -0
package/dist/index.js +63 -0
package/package.json +38 -0
package/schemas/common/common-types.schema.json +49 -0
package/schemas/common/events.schema.json +66 -0
package/schemas/common/identifiers.schema.json +13 -0
package/schemas/common/learning-sample.schema.json +194 -0
package/schemas/common/metadata.schema.json +113 -0
package/schemas/common/trace-base.schema.json +43 -0
package/schemas/events/mplp-event-core.schema.json +58 -0
package/schemas/events/mplp-graph-update-event.schema.json +58 -0
package/schemas/events/mplp-map-event.schema.json +147 -0
package/schemas/events/mplp-pipeline-stage-event.schema.json +56 -0
package/schemas/events/mplp-runtime-execution-event.schema.json +58 -0
package/schemas/events/mplp-sa-event.schema.json +109 -0
package/schemas/integration/mplp-ci-event.schema.json +130 -0
package/schemas/integration/mplp-file-update-event.schema.json +70 -0
package/schemas/integration/mplp-git-event.schema.json +98 -0
package/schemas/integration/mplp-tool-event.schema.json +83 -0
package/schemas/invariants/integration-invariants.yaml +143 -0
package/schemas/invariants/learning-invariants.yaml +102 -0
package/schemas/invariants/map-invariants.yaml +69 -0
package/schemas/invariants/observability-invariants.yaml +102 -0
package/schemas/invariants/sa-invariants.yaml +68 -0
package/schemas/learning/mplp-learning-sample-core.schema.json +94 -0
package/schemas/learning/mplp-learning-sample-delta.schema.json +137 -0
package/schemas/learning/mplp-learning-sample-intent.schema.json +119 -0
package/schemas/mplp-collab.schema.json +243 -0
package/schemas/mplp-confirm.schema.json +226 -0
package/schemas/mplp-context.schema.json +246 -0
package/schemas/mplp-core.schema.json +183 -0
package/schemas/mplp-dialog.schema.json +198 -0
package/schemas/mplp-extension.schema.json +179 -0
package/schemas/mplp-network.schema.json +230 -0
package/schemas/mplp-plan.schema.json +193 -0
package/schemas/mplp-role.schema.json +139 -0
package/schemas/mplp-trace.schema.json +216 -0

package/schemas/mplp-context.schema.json ADDED Viewed

@@ -0,0 +1,246 @@
+{
+  "$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.",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.mplp.dev/v1.0/mplp-context.schema.json",
+  "title": "MPLP Context Module – Core Protocol v1.0",
+  "description": "Context Module Core Protocol: Describes the context resources and their minimal required semantics (Core Profile) for a multi-agent collaboration project/session.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "$ref": "common/metadata.schema.json",
+      "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata (version, source, cross-cutting tags, etc.)."
+    },
+    "governance": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Governance metadata for lifecycle management, truth domain authority, and locking status.",
+      "properties": {
+        "lifecyclePhase": {
+          "type": "string",
+          "description": "Current phase in the lifecycle fence (e.g., 'design', 'implementation', 'review')."
+        },
+        "truthDomain": {
+          "type": "string",
+          "description": "The truth domain this object belongs to (e.g., 'requirements', 'architecture')."
+        },
+        "locked": {
+          "type": "boolean",
+          "description": "If true, this object cannot be modified except by specific governance overrides."
+        },
+        "lastConfirmRef": {
+          "$ref": "common/common-types.schema.json#/definitions/Ref",
+          "description": "Reference to the last Confirm decision that validated this state."
+        }
+      },
+      "additionalProperties": false
+    },
+    "context_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the Context."
+    },
+    "root": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Context root node definition (business domain, environment, entry point resources, etc.).",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Business domain identifier."
+        },
+        "environment": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Runtime environment identifier (e.g., development, production)."
+        },
+        "entry_point": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Entry point resource identifier."
+        }
+      },
+      "required": [
+        "domain",
+        "environment"
+      ],
+      "additionalProperties": true
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Context title, used for human and Agent identification of the project/session."
+    },
+    "summary": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Brief summary of the Context (background, scope, etc.)."
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Current lifecycle status of the Context.",
+      "enum": [
+        "draft",
+        "active",
+        "suspended",
+        "archived",
+        "closed"
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of tags for classification and retrieval.",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "language": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Primary working language of the Context (e.g., en, zh-CN)."
+    },
+    "owner_role": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Identifier of the primary owner role (should correspond to role_id in Role module)."
+    },
+    "constraints": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Key constraints for the Context, such as security boundaries, compliance requirements, budget, or deadlines.",
+      "additionalProperties": true
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Context creation time (ISO 8601)."
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Context last update time (ISO 8601)."
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Main Trace reference bound to this Context (for global tracing)."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events directly related to this Context (creation, status change, archiving, etc.).",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "context_id",
+    "root",
+    "title",
+    "status"
+  ],
+  "$defs": {
+    "context_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata (version, source, cross-cutting tags, etc.)."
+        },
+        "context_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the Context."
+        },
+        "root": {
+          "type": "object",
+          "description": "[PROTOCOL-CORE] Context root node definition (business domain, environment, entry point resources, etc.).",
+          "properties": {
+            "domain": {
+              "type": "string",
+              "description": "[PROTOCOL-CORE] Business domain identifier."
+            },
+            "environment": {
+              "type": "string",
+              "description": "[PROTOCOL-CORE] Runtime environment identifier (e.g., development, production)."
+            },
+            "entry_point": {
+              "type": "string",
+              "description": "[PROTOCOL-CORE] Entry point resource identifier."
+            }
+          },
+          "required": [
+            "domain",
+            "environment"
+          ],
+          "additionalProperties": true
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Context title, used for human and Agent identification of the project/session."
+        },
+        "summary": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Brief summary of the Context (background, scope, etc.)."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Current lifecycle status of the Context.",
+          "enum": [
+            "draft",
+            "active",
+            "suspended",
+            "archived",
+            "closed"
+          ]
+        },
+        "tags": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of tags for classification and retrieval.",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "language": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Primary working language of the Context (e.g., en, zh-CN)."
+        },
+        "owner_role": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Identifier of the primary owner role (should correspond to role_id in Role module)."
+        },
+        "constraints": {
+          "type": "object",
+          "description": "[PROTOCOL-CORE] Key constraints for the Context, such as security boundaries, compliance requirements, budget, or deadlines.",
+          "additionalProperties": true
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Context creation time (ISO 8601)."
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Context last update time (ISO 8601)."
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Main Trace reference bound to this Context (for global tracing)."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events directly related to this Context (creation, status change, archiving, etc.).",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "context_id",
+        "root",
+        "title",
+        "status"
+      ]
+    },
+    "uuid": {
+      "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}$",
+      "description": "[DEPRECATED] Please use common/identifiers.schema.json. This definition is retained for backward compatibility only and is no longer recommended for reference."
+    }
+  }
+}

package/schemas/mplp-core.schema.json ADDED Viewed

@@ -0,0 +1,183 @@
+{
+  "$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.",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.mplp.dev/v1.0/mplp-core.schema.json",
+  "title": "MPLP Core Module – Core Protocol v1.0",
+  "description": "Core Module Core Protocol: Describes the minimal required semantics (Core Profile) for an MPLP protocol instance's version, enabled modules, and overall state.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "$ref": "common/metadata.schema.json",
+      "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata."
+    },
+    "governance": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Governance metadata for lifecycle management, truth domain authority, and locking status.",
+      "properties": {
+        "lifecyclePhase": {
+          "type": "string",
+          "description": "Current phase in the lifecycle fence (e.g., 'design', 'implementation', 'review')."
+        },
+        "truthDomain": {
+          "type": "string",
+          "description": "The truth domain this object belongs to (e.g., 'requirements', 'architecture')."
+        },
+        "locked": {
+          "type": "boolean",
+          "description": "If true, this object cannot be modified except by specific governance overrides."
+        },
+        "lastConfirmRef": {
+          "$ref": "common/common-types.schema.json#/definitions/Ref",
+          "description": "Reference to the last Confirm decision that validated this state."
+        }
+      },
+      "additionalProperties": false
+    },
+    "core_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the current Core instance."
+    },
+    "protocol_version": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Major version number of the current MPLP protocol instance (e.g., 1.0.0)."
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Lifecycle status of the current Core instance.",
+      "enum": [
+        "draft",
+        "active",
+        "deprecated",
+        "archived"
+      ]
+    },
+    "modules": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of L2 modules enabled in the current protocol instance.",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/core_module_descriptor"
+      }
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Main Trace reference bound to this Core instance, used for auditing Core layer configuration changes."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events related to this Core instance (version upgrades, module enable/disable, etc.).",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "core_id",
+    "protocol_version",
+    "status",
+    "modules"
+  ],
+  "$defs": {
+    "core_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json"
+        },
+        "core_id": {
+          "$ref": "common/identifiers.schema.json"
+        },
+        "protocol_version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "draft",
+            "active",
+            "deprecated",
+            "archived"
+          ]
+        },
+        "modules": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/core_module_descriptor"
+          }
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "core_id",
+        "protocol_version",
+        "status",
+        "modules"
+      ]
+    },
+    "core_module_descriptor": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] L2 module descriptor (used to declare which modules are enabled in the current instance).",
+      "additionalProperties": false,
+      "properties": {
+        "module_id": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Module identifier.",
+          "enum": [
+            "context",
+            "plan",
+            "confirm",
+            "trace",
+            "role",
+            "extension",
+            "dialog",
+            "collab",
+            "core",
+            "network"
+          ]
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Protocol version used by this module in the current instance (SemVer recommended)."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Status of this module in the current instance.",
+          "enum": [
+            "enabled",
+            "disabled",
+            "experimental",
+            "deprecated"
+          ]
+        },
+        "required": {
+          "type": "boolean",
+          "description": "[PROTOCOL-CORE] Whether this module is mandatory for the current instance."
+        },
+        "description": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Brief description of the module, for humans and Agents."
+        }
+      },
+      "required": [
+        "module_id",
+        "version",
+        "status"
+      ]
+    }
+  }
+}

package/schemas/mplp-dialog.schema.json ADDED Viewed

@@ -0,0 +1,198 @@
+{
+  "$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.",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.mplp.dev/v1.0/mplp-dialog.schema.json",
+  "title": "MPLP Dialog Module – Core Protocol v1.0",
+  "description": "Dialog Module Core Protocol: Describes the dialog interaction semantics in multi-agent systems, adopting Minimal Protocol Format aligned with OpenAI/Anthropic standards.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "$ref": "common/metadata.schema.json",
+      "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata."
+    },
+    "governance": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Governance metadata for lifecycle management, truth domain authority, and locking status.",
+      "properties": {
+        "lifecyclePhase": {
+          "type": "string",
+          "description": "Current phase in the lifecycle fence (e.g., 'design', 'implementation', 'review')."
+        },
+        "truthDomain": {
+          "type": "string",
+          "description": "The truth domain this object belongs to (e.g., 'requirements', 'architecture')."
+        },
+        "locked": {
+          "type": "boolean",
+          "description": "If true, this object cannot be modified except by specific governance overrides."
+        },
+        "lastConfirmRef": {
+          "$ref": "common/common-types.schema.json#/definitions/Ref",
+          "description": "Reference to the last Confirm decision that validated this state."
+        }
+      },
+      "additionalProperties": false
+    },
+    "dialog_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the Dialog."
+    },
+    "context_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Associated Context ID."
+    },
+    "thread_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Dialog thread ID (for multi-turn dialog grouping)."
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Dialog status.",
+      "enum": [
+        "active",
+        "paused",
+        "completed",
+        "cancelled"
+      ]
+    },
+    "messages": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] Dialog message list (Minimal Protocol Format).",
+      "items": {
+        "$ref": "#/$defs/dialog_message_core"
+      }
+    },
+    "started_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Dialog start time (ISO 8601)."
+    },
+    "ended_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Dialog end time (ISO 8601)."
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Audit trace reference associated with this dialog."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events directly related to this dialog.",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "dialog_id",
+    "context_id",
+    "status",
+    "messages"
+  ],
+  "$defs": {
+    "dialog_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata."
+        },
+        "dialog_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the Dialog."
+        },
+        "context_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Associated Context ID."
+        },
+        "thread_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Dialog thread ID (for multi-turn dialog grouping)."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Dialog status.",
+          "enum": [
+            "active",
+            "paused",
+            "completed",
+            "cancelled"
+          ]
+        },
+        "messages": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] Dialog message list (Minimal Protocol Format).",
+          "items": {
+            "$ref": "#/$defs/dialog_message_core"
+          }
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Dialog start time (ISO 8601)."
+        },
+        "ended_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Dialog end time (ISO 8601)."
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Audit trace reference associated with this dialog."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events directly related to this dialog.",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "dialog_id",
+        "context_id",
+        "status",
+        "messages"
+      ]
+    },
+    "dialog_message_core": {
+      "type": "object",
+      "description": "Minimal Protocol Format - Aligned with OpenAI/Anthropic standards",
+      "additionalProperties": false,
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "Message sender role.",
+          "enum": [
+            "user",
+            "assistant",
+            "system",
+            "agent"
+          ]
+        },
+        "content": {
+          "type": "string",
+          "description": "Message content (plain text)."
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Message timestamp (ISO 8601)."
+        },
+        "event": {
+          "$ref": "common/events.schema.json",
+          "description": "Optional L1 Event reference (for deep integration with Trace module)."
+        }
+      },
+      "required": [
+        "role",
+        "content",
+        "timestamp"
+      ]
+    }
+  }
+}