@mplp/sdk-ts 1.0.2 → 1.0.4

package/schemas/mplp-dialog.schema.json

@@ -0,0 +1,204 @@
+{
+  "$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-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"
+      ]
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/mplp-extension.schema.json

@@ -0,0 +1,185 @@
+{
+  "$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-extension.schema.json",
+  "title": "MPLP Extension Module – Core Protocol v1.0",
+  "description": "Extension Module Core Protocol: Describes the minimal required semantics (Core Profile) for the MPLP plugin system, capability injection, and protocol enhancement points.",
+  "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
+    },
+    "extension_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the Extension."
+    },
+    "context_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Identifier of the Context this Extension belongs to."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Extension name (human-readable)."
+    },
+    "extension_type": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Extension type classification.",
+      "enum": [
+        "capability",
+        "policy",
+        "integration",
+        "transformation",
+        "validation",
+        "other"
+      ]
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+      "description": "[PROTOCOL-CORE] Extension version (SemVer format)."
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Extension status.",
+      "enum": [
+        "registered",
+        "active",
+        "inactive",
+        "deprecated"
+      ]
+    },
+    "config": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Extension configuration object (L2 safe, implementation details excluded).",
+      "additionalProperties": true
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Trace reference bound to this Extension."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events directly related to this Extension.",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "extension_id",
+    "context_id",
+    "name",
+    "extension_type",
+    "version",
+    "status"
+  ],
+  "$defs": {
+    "extension_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata."
+        },
+        "extension_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the Extension."
+        },
+        "context_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Identifier of the Context this Extension belongs to."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Extension name (human-readable)."
+        },
+        "extension_type": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Extension type classification.",
+          "enum": [
+            "capability",
+            "policy",
+            "integration",
+            "transformation",
+            "validation",
+            "other"
+          ]
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+          "description": "[PROTOCOL-CORE] Extension version (SemVer format)."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Extension status.",
+          "enum": [
+            "registered",
+            "active",
+            "inactive",
+            "deprecated"
+          ]
+        },
+        "config": {
+          "type": "object",
+          "description": "[PROTOCOL-CORE] Extension configuration object (L2 safe, implementation details excluded).",
+          "additionalProperties": true
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Trace reference bound to this Extension."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events directly related to this Extension.",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "extension_id",
+        "context_id",
+        "name",
+        "extension_type",
+        "version",
+        "status"
+      ]
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/mplp-network.schema.json

@@ -0,0 +1,236 @@
+{
+  "$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-network.schema.json",
+  "title": "MPLP Network Module – Core Protocol v1.0",
+  "description": "Network Module Core Protocol: Describes the minimal required semantics (Core Profile) for the topology and node collection of a multi-agent collaboration network.",
+  "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
+    },
+    "network_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the network."
+    },
+    "context_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Identifier of the Context this network belongs to."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Network name."
+    },
+    "description": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Brief description of the network."
+    },
+    "topology_type": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Network topology type.",
+      "enum": [
+        "single_node",
+        "hub_spoke",
+        "mesh",
+        "hierarchical",
+        "hybrid",
+        "other"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Network lifecycle status.",
+      "enum": [
+        "draft",
+        "provisioning",
+        "active",
+        "degraded",
+        "maintenance",
+        "retired"
+      ]
+    },
+    "nodes": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] Collection of core nodes in the network.",
+      "items": {
+        "$ref": "#/$defs/network_node_core"
+      }
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Trace reference associated with this network."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events related to this network.",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "network_id",
+    "context_id",
+    "name",
+    "topology_type",
+    "status"
+  ],
+  "$defs": {
+    "network_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata."
+        },
+        "network_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the network."
+        },
+        "context_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Identifier of the Context this network belongs to."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Network name."
+        },
+        "description": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Brief description of the network."
+        },
+        "topology_type": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Network topology type.",
+          "enum": [
+            "single_node",
+            "hub_spoke",
+            "mesh",
+            "hierarchical",
+            "hybrid",
+            "other"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Network lifecycle status.",
+          "enum": [
+            "draft",
+            "provisioning",
+            "active",
+            "degraded",
+            "maintenance",
+            "retired"
+          ]
+        },
+        "nodes": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] Collection of core nodes in the network.",
+          "items": {
+            "$ref": "#/$defs/network_node_core"
+          }
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Trace reference associated with this network."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events related to this network.",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "network_id",
+        "context_id",
+        "name",
+        "topology_type",
+        "status"
+      ]
+    },
+    "network_node_core": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Minimal required semantics for a network node.",
+      "additionalProperties": false,
+      "properties": {
+        "node_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Node identifier."
+        },
+        "name": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Node name."
+        },
+        "kind": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Node type.",
+          "enum": [
+            "agent",
+            "service",
+            "database",
+            "queue",
+            "external",
+            "other"
+          ]
+        },
+        "role_id": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Role identifier corresponding to this node (should correspond to role_id in Role module)."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Current status of the node.",
+          "enum": [
+            "active",
+            "inactive",
+            "degraded",
+            "unreachable",
+            "retired"
+          ]
+        }
+      },
+      "required": [
+        "node_id",
+        "kind",
+        "status"
+      ]
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}