@mplp/sdk-ts 1.0.2 → 1.0.4

package/schemas/events/mplp-pipeline-stage-event.schema.json

@@ -0,0 +1,62 @@
+{
+  "$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/events/mplp-pipeline-stage-event.schema.json",
+  "title": "MPLP PipelineStageEvent v1.0",
+  "description": "**REQUIRED** - Pipeline stage transition events (MANDATORY for v1.0 compliance)",
+  "allOf": [
+    {
+      "$ref": "mplp-event-core.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "event_family": {
+          "const": "pipeline_stage",
+          "description": "Must be 'pipeline_stage' for this event type"
+        },
+        "pipeline_id": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Pipeline instance identifier"
+        },
+        "stage_id": {
+          "type": "string",
+          "description": "Stage identifier (e.g., 'import', 'analyze', 'execute')"
+        },
+        "stage_name": {
+          "type": "string",
+          "description": "Human-readable stage name"
+        },
+        "stage_status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "running",
+            "completed",
+            "failed",
+            "skipped"
+          ],
+          "description": "Current status of the pipeline stage"
+        },
+        "stage_order": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Sequential order of this stage in pipeline"
+        }
+      },
+      "required": [
+        "event_family",
+        "pipeline_id",
+        "stage_id",
+        "stage_status"
+      ]
+    }
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/events/mplp-runtime-execution-event.schema.json

@@ -0,0 +1,64 @@
+{
+  "$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/events/mplp-runtime-execution-event.schema.json",
+  "title": "MPLP RuntimeExecutionEvent v1.0",
+  "description": "Runtime execution lifecycle events (agents, tools, LLMs, workers)",
+  "allOf": [
+    {
+      "$ref": "mplp-event-core.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "event_family": {
+          "const": "runtime_execution",
+          "description": "Must be 'runtime_execution' for this event type"
+        },
+        "execution_id": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Execution instance identifier"
+        },
+        "executor_kind": {
+          "type": "string",
+          "enum": [
+            "agent",
+            "tool",
+            "llm",
+            "worker",
+            "external"
+          ],
+          "description": "Type of executor performing this execution"
+        },
+        "executor_role": {
+          "type": "string",
+          "description": "Role identifier (e.g., 'planner', 'reviewer', 'curl_executor')"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "running",
+            "completed",
+            "failed",
+            "cancelled"
+          ],
+          "description": "Current execution status"
+        }
+      },
+      "required": [
+        "event_family",
+        "execution_id",
+        "executor_kind",
+        "status"
+      ]
+    }
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/events/mplp-sa-event.schema.json

@@ -0,0 +1,115 @@
+{
+  "$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/events/mplp-sa-event.schema.json",
+  "title": "MPLP SA Event v1.0",
+  "description": "Events emitted by a Single Agent (SA) execution in MPLP v1.0 protocol",
+  "type": "object",
+  "properties": {
+    "event_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier for this event"
+    },
+    "event_type": {
+      "type": "string",
+      "enum": [
+        "SAInitialized",
+        "SAContextLoaded",
+        "SAPlanEvaluated",
+        "SAStepStarted",
+        "SAStepCompleted",
+        "SAStepFailed",
+        "SATraceEmitted",
+        "SACompleted"
+      ],
+      "description": "Type of SA lifecycle event"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when event occurred"
+    },
+    "sa_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Identifier of the SA instance emitting this event"
+    },
+    "context_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Context ID bound to this SA execution"
+    },
+    "plan_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Plan ID being executed by this SA"
+    },
+    "trace_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Trace ID where this event is recorded"
+    },
+    "payload": {
+      "type": "object",
+      "description": "Event-specific data payload",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "event_id",
+    "event_type",
+    "timestamp",
+    "sa_id"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "step_started_payload": {
+      "type": "object",
+      "properties": {
+        "step_id": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "agent_role": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "step_id"
+      ]
+    },
+    "step_completed_payload": {
+      "type": "object",
+      "properties": {
+        "step_id": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "completed",
+            "failed"
+          ]
+        },
+        "result": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "step_id",
+        "status"
+      ]
+    }
+  },
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/integration/mplp-ci-event.schema.json

@@ -0,0 +1,136 @@
+{
+  "$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/integration/mplp-ci-event.json",
+  "title": "MPLP CI Event v1.0",
+  "description": "CI pipeline execution status",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "ci_provider": {
+      "type": "string",
+      "minLength": 1,
+      "description": "CI platform identifier",
+      "examples": [
+        "github-actions",
+        "gitlab-ci",
+        "jenkins",
+        "circleci",
+        "travis-ci"
+      ]
+    },
+    "pipeline_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Pipeline or workflow identifier",
+      "examples": [
+        "build-and-test",
+        "deploy-production"
+      ]
+    },
+    "run_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Unique identifier for this pipeline run",
+      "examples": [
+        "123456789",
+        "run-2025-11-30-001"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "pending",
+        "running",
+        "succeeded",
+        "failed",
+        "cancelled"
+      ],
+      "description": "Current pipeline status"
+    },
+    "started_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Pipeline start timestamp (ISO 8601)"
+    },
+    "completed_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Pipeline completion timestamp (ISO 8601)"
+    },
+    "branch_name": {
+      "type": "string",
+      "description": "Git branch that triggered the pipeline"
+    },
+    "commit_id": {
+      "type": "string",
+      "description": "Commit SHA that triggered the pipeline"
+    },
+    "run_url": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to view pipeline run details"
+    },
+    "duration_ms": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Pipeline execution duration in milliseconds"
+    },
+    "stages": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "stage_name": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "running",
+              "succeeded",
+              "failed",
+              "cancelled",
+              "skipped"
+            ]
+          },
+          "duration_ms": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "stage_name",
+          "status"
+        ]
+      },
+      "description": "Pipeline stages and their statuses (optional)"
+    },
+    "trigger_kind": {
+      "type": "string",
+      "enum": [
+        "push",
+        "pull_request",
+        "schedule",
+        "manual",
+        "tag",
+        "other"
+      ],
+      "description": "What triggered the pipeline"
+    }
+  },
+  "required": [
+    "ci_provider",
+    "pipeline_id",
+    "run_id",
+    "status"
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/integration/mplp-file-update-event.schema.json

@@ -0,0 +1,76 @@
+{
+  "$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/integration/mplp-file-update-event.json",
+  "title": "MPLP File Update Event v1.0",
+  "description": "IDE file changes (save, refactor, batch modify)",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "file_path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Path to the file (absolute or workspace-relative)",
+      "examples": [
+        "src/components/App.tsx",
+        "/Users/dev/project/main.py"
+      ]
+    },
+    "change_type": {
+      "type": "string",
+      "enum": [
+        "created",
+        "modified",
+        "deleted",
+        "renamed"
+      ],
+      "description": "Type of file change"
+    },
+    "workspace_root": {
+      "type": "string",
+      "description": "Workspace root directory (for resolving relative paths)"
+    },
+    "change_summary": {
+      "type": "string",
+      "description": "Brief description of changes (e.g., 'Added error handling')"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the change occurred (ISO 8601)"
+    },
+    "lines_added": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of lines added (if applicable)"
+    },
+    "lines_removed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of lines removed (if applicable)"
+    },
+    "previous_path": {
+      "type": "string",
+      "description": "Previous path (for renamed files)"
+    },
+    "encoding": {
+      "type": "string",
+      "description": "File encoding (e.g., 'utf-8')"
+    },
+    "language": {
+      "type": "string",
+      "description": "Programming language or file type (e.g., 'typescript', 'python')"
+    }
+  },
+  "required": [
+    "file_path",
+    "change_type",
+    "timestamp"
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/integration/mplp-git-event.schema.json

@@ -0,0 +1,104 @@
+{
+  "$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/integration/mplp-git-event.json",
+  "title": "MPLP Git Event v1.0",
+  "description": "Git operations (commit, push, branch/merge/tag)",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "repo_url": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Repository URL or identifier",
+      "examples": [
+        "https://github.com/org/repo.git",
+        "git@github.com:org/repo.git"
+      ]
+    },
+    "commit_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Commit SHA or identifier",
+      "examples": [
+        "abc123def456",
+        "1a2b3c4d5e6f7g8h9i0j"
+      ]
+    },
+    "ref_name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Branch, tag, or ref name",
+      "examples": [
+        "refs/heads/main",
+        "refs/tags/v1.0.0",
+        "main"
+      ]
+    },
+    "event_kind": {
+      "type": "string",
+      "enum": [
+        "commit",
+        "push",
+        "merge",
+        "tag",
+        "branch_create",
+        "branch_delete"
+      ],
+      "description": "Type of Git operation"
+    },
+    "author_name": {
+      "type": "string",
+      "description": "Commit author name"
+    },
+    "author_email": {
+      "type": "string",
+      "format": "email",
+      "description": "Commit author email"
+    },
+    "commit_message": {
+      "type": "string",
+      "description": "Commit message (first line or summary)"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the Git operation occurred (ISO 8601)"
+    },
+    "files_changed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of files changed in commit"
+    },
+    "insertions": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total lines inserted"
+    },
+    "deletions": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total lines deleted"
+    },
+    "parent_commits": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Parent commit SHA(s) - multiple for merges"
+    }
+  },
+  "required": [
+    "repo_url",
+    "commit_id",
+    "ref_name",
+    "event_kind",
+    "timestamp"
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}

package/schemas/integration/mplp-tool-event.schema.json

@@ -0,0 +1,89 @@
+{
+  "$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/integration/mplp-tool-event.json",
+  "title": "MPLP Tool Event v1.0",
+  "description": "External tool invocation and results (formatters, linters, test runners, generators)",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "tool_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Unique identifier for the tool",
+      "examples": [
+        "eslint-v8.50.0",
+        "prettier-v3.0.0",
+        "black-v23.10.0"
+      ]
+    },
+    "tool_kind": {
+      "type": "string",
+      "enum": [
+        "formatter",
+        "linter",
+        "test_runner",
+        "generator",
+        "other"
+      ],
+      "description": "Category of tool"
+    },
+    "invocation_id": {
+      "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": "UUID v4 identifier for this specific invocation"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "pending",
+        "running",
+        "succeeded",
+        "failed",
+        "cancelled"
+      ],
+      "description": "Current execution status"
+    },
+    "started_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Invocation start timestamp (ISO 8601)"
+    },
+    "completed_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Invocation completion timestamp (ISO 8601)"
+    },
+    "exit_code": {
+      "type": "integer",
+      "description": "Tool process exit code (if applicable)"
+    },
+    "output_summary": {
+      "type": "string",
+      "description": "Brief summary of tool output or errors"
+    },
+    "args": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Command-line arguments passed to tool (optional)"
+    },
+    "working_directory": {
+      "type": "string",
+      "description": "Working directory where tool was executed (optional)"
+    }
+  },
+  "required": [
+    "tool_id",
+    "tool_kind",
+    "invocation_id",
+    "status"
+  ],
+  "x-mplp-meta": {
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "freezeDate": "2025-12-03",
+    "governance": "MPGC"
+  }
+}