@mplp/sdk-ts 1.0.2 → 1.0.4

package/schemas/mplp-confirm.schema.json

@@ -0,0 +1,232 @@
+{
+  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.mplp.dev/v1.0/mplp-confirm.schema.json",
+  "title": "MPLP Confirm Module – Core Protocol v1.0",
+  "description": "Confirm Module Core Protocol: Describes the minimal required semantics (Core Profile) for approval requests and decision records.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "$ref": "common/metadata.schema.json",
+      "description": "[PROTOCOL-CORE] MPLP protocol 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
+    },
+    "confirm_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the approval request."
+    },
+    "target_type": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Approval target type (type of the resource being approved).",
+      "enum": [
+        "context",
+        "plan",
+        "trace",
+        "extension",
+        "other"
+      ]
+    },
+    "target_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier of the resource being approved."
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Current status of the approval request.",
+      "enum": [
+        "pending",
+        "approved",
+        "rejected",
+        "cancelled"
+      ]
+    },
+    "requested_by_role": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Identifier of the role initiating the approval request (should correspond to role_id in Role module)."
+    },
+    "requested_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Approval request creation time (ISO 8601)."
+    },
+    "reason": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Reason for the request, for humans and Agents."
+    },
+    "decisions": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of decision records related to this Confirm request.",
+      "items": {
+        "$ref": "#/$defs/confirm_decision_core"
+      }
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Trace reference bound to this Confirm request (for cross-module tracing)."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events directly related to this Confirm request (creation, decision, cancellation, etc.).",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "confirm_id",
+    "target_type",
+    "target_id",
+    "status",
+    "requested_by_role",
+    "requested_at"
+  ],
+  "$defs": {
+    "confirm_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] MPLP protocol schema metadata (version, source, cross-cutting tags, etc.)."
+        },
+        "confirm_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the approval request."
+        },
+        "target_type": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Approval target type (type of the resource being approved).",
+          "enum": [
+            "context",
+            "plan",
+            "trace",
+            "extension",
+            "other"
+          ]
+        },
+        "target_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier of the resource being approved."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Current status of the approval request.",
+          "enum": [
+            "pending",
+            "approved",
+            "rejected",
+            "cancelled"
+          ]
+        },
+        "requested_by_role": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Identifier of the role initiating the approval request (should correspond to role_id in Role module)."
+        },
+        "requested_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Approval request creation time (ISO 8601)."
+        },
+        "reason": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Reason for the request, for humans and Agents."
+        },
+        "decisions": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of decision records related to this Confirm request.",
+          "items": {
+            "$ref": "#/$defs/confirm_decision_core"
+          }
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Trace reference bound to this Confirm request (for cross-module tracing)."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events directly related to this Confirm request (creation, decision, cancellation, etc.).",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "confirm_id",
+        "target_type",
+        "target_id",
+        "status",
+        "requested_by_role",
+        "requested_at"
+      ]
+    },
+    "confirm_decision_core": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Minimal required semantics for a single approval decision record.",
+      "additionalProperties": false,
+      "properties": {
+        "decision_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the decision record."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Decision result status.",
+          "enum": [
+            "approved",
+            "rejected",
+            "cancelled"
+          ]
+        },
+        "decided_by_role": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Identifier of the role making the decision (should correspond to role_id in Role module)."
+        },
+        "decided_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Decision time (ISO 8601)."
+        },
+        "reason": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Summary of the decision reason (optional)."
+        }
+      },
+      "required": [
+        "decision_id",
+        "status",
+        "decided_by_role",
+        "decided_at"
+      ]
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/mplp-context.schema.json

@@ -0,0 +1,252 @@
+{
+  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$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."
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/mplp-core.schema.json

@@ -0,0 +1,189 @@
+{
+  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$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"
+      ]
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}