@mplp/sdk-ts 1.0.1 → 1.0.3

package/schemas/learning/mplp-learning-sample-core.schema.json

@@ -0,0 +1,100 @@
+{
+  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-core.schema.json",
+  "title": "MPLP LearningSample Core v1.0",
+  "description": "Core structure for MPLP LearningSample entities - defines the universal format for learning samples generated from execution history",
+  "type": "object",
+  "properties": {
+    "sample_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier of the learning sample (UUID v4)"
+    },
+    "sample_family": {
+      "type": "string",
+      "description": "LearningSample family identifier - determines expected input/output structure",
+      "examples": [
+        "intent_resolution",
+        "delta_impact",
+        "pipeline_outcome",
+        "confirm_decision",
+        "graph_evolution",
+        "multi_agent_coordination"
+      ]
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when sample was generated"
+    },
+    "input": {
+      "type": "object",
+      "description": "Abstracted representation of input conditions, intent, context at sample creation time",
+      "additionalProperties": true
+    },
+    "state": {
+      "type": "object",
+      "description": "Snapshot of relevant system state before execution (PSG summary, config, roles, etc.)",
+      "additionalProperties": true
+    },
+    "output": {
+      "type": "object",
+      "description": "Abstracted representation of actual outcomes, decisions, changes, results",
+      "additionalProperties": true
+    },
+    "meta": {
+      "type": "object",
+      "description": "Metadata, labels, quality signals, provenance IDs, human feedback annotations",
+      "properties": {
+        "source_flow_id": {
+          "type": "string",
+          "description": "Optional: Flow ID that generated this sample (e.g., FLOW-01, SA-01, MAP-01)"
+        },
+        "source_event_ids": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "description": "Optional: Observability event IDs referenced by this sample"
+        },
+        "project_id": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Optional: Project context identifier"
+        },
+        "human_feedback_label": {
+          "type": "string",
+          "enum": [
+            "approved",
+            "rejected",
+            "not_reviewed"
+          ],
+          "description": "Optional: Human quality assessment"
+        },
+        "quality_score": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Optional: Automated quality score (0.0-1.0)"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "sample_id",
+    "sample_family",
+    "created_at",
+    "input",
+    "output"
+  ],
+  "additionalProperties": true,
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/learning/mplp-learning-sample-delta.schema.json

@@ -0,0 +1,143 @@
+{
+  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-delta.schema.json",
+  "title": "MPLP LearningSample – Delta Impact v1.0",
+  "description": "Specialized schema for delta_impact samples capturing change effect analysis and compensation planning",
+  "allOf": [
+    {
+      "$ref": "mplp-learning-sample-core.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "sample_family": {
+          "const": "delta_impact",
+          "description": "Must be 'delta_impact' for this sample type"
+        },
+        "input": {
+          "type": "object",
+          "properties": {
+            "delta_id": {
+              "type": "string",
+              "description": "Delta Intent identifier"
+            },
+            "intent_id": {
+              "type": "string",
+              "description": "Original intent being modified"
+            },
+            "delta_type": {
+              "type": "string",
+              "enum": [
+                "refinement",
+                "correction",
+                "expansion",
+                "reduction",
+                "pivot"
+              ],
+              "description": "Type of delta change"
+            },
+            "change_summary": {
+              "type": "string",
+              "description": "Abstracted summary of requested change"
+            }
+          },
+          "required": [
+            "delta_id",
+            "intent_id",
+            "change_summary"
+          ],
+          "additionalProperties": true
+        },
+        "state": {
+          "type": "object",
+          "properties": {
+            "affected_artifact_count": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Number of artifacts potentially affected"
+            },
+            "risk_level": {
+              "type": "string",
+              "enum": [
+                "low",
+                "medium",
+                "high",
+                "critical"
+              ],
+              "description": "Assessed risk level before change"
+            },
+            "psg_complexity_score": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Optional: PSG complexity metric before change"
+            }
+          },
+          "additionalProperties": true
+        },
+        "output": {
+          "type": "object",
+          "properties": {
+            "actual_impact_summary": {
+              "type": "string",
+              "description": "Summary of actual impact after analysis"
+            },
+            "impact_scope": {
+              "type": "string",
+              "enum": [
+                "local",
+                "module",
+                "system",
+                "global"
+              ],
+              "description": "Scope of detected impact"
+            },
+            "comp_plan_required": {
+              "type": "boolean",
+              "description": "Whether compensation plan was needed"
+            },
+            "comp_plan_applied": {
+              "type": "boolean",
+              "description": "Optional: Whether compensation was actually applied"
+            },
+            "rollback_used": {
+              "type": "boolean",
+              "description": "Optional: Whether rollback mechanism was triggered"
+            }
+          },
+          "required": [
+            "actual_impact_summary",
+            "impact_scope"
+          ],
+          "additionalProperties": true
+        },
+        "meta": {
+          "type": "object",
+          "properties": {
+            "impact_analysis_duration_ms": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Time spent on impact analysis"
+            },
+            "predicted_vs_actual_accuracy": {
+              "type": "string",
+              "enum": [
+                "accurate",
+                "underestimated",
+                "overestimated"
+              ],
+              "description": "Optional: Accuracy of impact prediction"
+            }
+          },
+          "additionalProperties": true
+        }
+      }
+    }
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/learning/mplp-learning-sample-intent.schema.json

@@ -0,0 +1,125 @@
+{
+  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-intent.schema.json",
+  "title": "MPLP LearningSample – Intent Resolution v1.0",
+  "description": "Specialized schema for intent_resolution samples capturing user intent clarification and plan generation",
+  "allOf": [
+    {
+      "$ref": "mplp-learning-sample-core.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "sample_family": {
+          "const": "intent_resolution",
+          "description": "Must be 'intent_resolution' for this sample type"
+        },
+        "input": {
+          "type": "object",
+          "properties": {
+            "intent_id": {
+              "type": "string",
+              "description": "Intent identifier from IntentEvent or Plan.intent_model"
+            },
+            "raw_request_summary": {
+              "type": "string",
+              "description": "Abstracted summary of original user request (PII-scrubbed if needed)"
+            },
+            "constraints_summary": {
+              "type": "string",
+              "description": "Optional: Key constraints mentioned (timeline, budget, resources, etc.)"
+            },
+            "dialog_turns_count": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Number of dialog exchanges before intent resolution"
+            }
+          },
+          "required": [
+            "intent_id",
+            "raw_request_summary"
+          ],
+          "additionalProperties": true
+        },
+        "state": {
+          "type": "object",
+          "properties": {
+            "project_phase": {
+              "type": "string",
+              "description": "Optional: Project state (greenfield, brownfield, maintenance, etc.)"
+            },
+            "psg_node_count": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: PSG size before intent application"
+            },
+            "existing_plan_count": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Number of existing plans in context"
+            }
+          },
+          "additionalProperties": true
+        },
+        "output": {
+          "type": "object",
+          "properties": {
+            "final_intent_summary": {
+              "type": "string",
+              "description": "Refined/clarified intent after resolution process"
+            },
+            "plan_id": {
+              "type": "string",
+              "format": "uuid",
+              "description": "Optional: Generated Plan identifier (if plan created)"
+            },
+            "plan_step_count": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Number of steps in generated plan"
+            },
+            "resolution_quality_label": {
+              "type": "string",
+              "enum": [
+                "good",
+                "acceptable",
+                "bad",
+                "unknown"
+              ],
+              "description": "Assessment of intent resolution quality"
+            }
+          },
+          "required": [
+            "final_intent_summary"
+          ],
+          "additionalProperties": true
+        },
+        "meta": {
+          "type": "object",
+          "properties": {
+            "clarification_rounds": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Clarification rounds needed before resolution"
+            },
+            "ambiguity_flags": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Optional: Detected ambiguity types (vague_scope, missing_constraints, etc.)"
+            }
+          },
+          "additionalProperties": true
+        }
+      }
+    }
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/mplp-collab.schema.json

@@ -0,0 +1,249 @@
+{
+  "$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-collab.schema.json",
+  "title": "MPLP Collab Module – Core Protocol v1.0",
+  "description": "Collab Module Core Protocol: Describes the minimal required semantics (Core Profile) for multi-agent / multi-role collaboration sessions.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "$ref": "common/metadata.schema.json",
+      "description": "[PROTOCOL-CORE] 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
+    },
+    "collab_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the collaboration session."
+    },
+    "context_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Identifier of the Context this collaboration session belongs to."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Collaboration session title."
+    },
+    "purpose": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Description of the purpose/goal of the collaboration."
+    },
+    "mode": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Collaboration mode (broadcast, round_robin, orchestrated, etc.).",
+      "enum": [
+        "broadcast",
+        "round_robin",
+        "orchestrated",
+        "swarm",
+        "pair"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Collaboration session status.",
+      "enum": [
+        "draft",
+        "active",
+        "suspended",
+        "completed",
+        "cancelled"
+      ]
+    },
+    "participants": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of roles/Agents participating in the collaboration.",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/collab_participant_core"
+      }
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Creation time (ISO 8601)."
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Last update time (ISO 8601)."
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Trace reference bound to this collaboration session."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events directly related to this collaboration.",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "collab_id",
+    "context_id",
+    "title",
+    "purpose",
+    "mode",
+    "status",
+    "participants",
+    "created_at"
+  ],
+  "$defs": {
+    "collab_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] Protocol and schema metadata."
+        },
+        "collab_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the collaboration session."
+        },
+        "context_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Identifier of the Context this collaboration session belongs to."
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Collaboration session title."
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Description of the purpose/goal of the collaboration."
+        },
+        "mode": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Collaboration mode (broadcast, round_robin, orchestrated, etc.).",
+          "enum": [
+            "broadcast",
+            "round_robin",
+            "orchestrated",
+            "swarm",
+            "pair"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Collaboration session status.",
+          "enum": [
+            "draft",
+            "active",
+            "suspended",
+            "completed",
+            "cancelled"
+          ]
+        },
+        "participants": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of roles/Agents participating in the collaboration.",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/collab_participant_core"
+          }
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Creation time (ISO 8601)."
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Last update time (ISO 8601)."
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Trace reference bound to this collaboration session."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events directly related to this collaboration.",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "collab_id",
+        "context_id",
+        "title",
+        "purpose",
+        "mode",
+        "status",
+        "participants",
+        "created_at"
+      ]
+    },
+    "collab_participant_core": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Minimal required semantics for a collaboration participant.",
+      "additionalProperties": false,
+      "properties": {
+        "participant_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Participant identifier (can be Role/Agent/External ID)."
+        },
+        "role_id": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Role ID bound to this participant (corresponds to role_id in Role module)."
+        },
+        "kind": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Participant type.",
+          "enum": [
+            "agent",
+            "human",
+            "system",
+            "external"
+          ]
+        },
+        "display_name": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Display name (for human identification)."
+        }
+      },
+      "required": [
+        "participant_id",
+        "kind"
+      ]
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}