@mplp/schema 1.0.1 → 1.0.2

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
  1. package/README.md +11 -0
  2. package/dist/index.d.ts +0 -11
  3. package/dist/index.js +7 -11
  4. package/package.json +23 -4
  5. package/schemas/common/common-types.schema.json +49 -49
  6. package/schemas/common/events.schema.json +66 -66
  7. package/schemas/common/identifiers.schema.json +13 -13
  8. package/schemas/common/learning-sample.schema.json +194 -194
  9. package/schemas/common/metadata.schema.json +113 -113
  10. package/schemas/common/trace-base.schema.json +43 -43
  11. package/schemas/events/mplp-event-core.schema.json +58 -58
  12. package/schemas/events/mplp-graph-update-event.schema.json +58 -58
  13. package/schemas/events/mplp-map-event.schema.json +147 -147
  14. package/schemas/events/mplp-pipeline-stage-event.schema.json +56 -56
  15. package/schemas/events/mplp-runtime-execution-event.schema.json +58 -58
  16. package/schemas/events/mplp-sa-event.schema.json +109 -109
  17. package/schemas/integration/mplp-ci-event.schema.json +130 -130
  18. package/schemas/integration/mplp-file-update-event.schema.json +70 -70
  19. package/schemas/integration/mplp-git-event.schema.json +98 -98
  20. package/schemas/integration/mplp-tool-event.schema.json +83 -83
  21. package/schemas/invariants/integration-invariants.yaml +12 -8
  22. package/schemas/invariants/learning-invariants.yaml +12 -8
  23. package/schemas/invariants/map-invariants.yaml +12 -8
  24. package/schemas/invariants/observability-invariants.yaml +12 -8
  25. package/schemas/invariants/sa-invariants.yaml +12 -8
  26. package/schemas/learning/mplp-learning-sample-core.schema.json +94 -94
  27. package/schemas/learning/mplp-learning-sample-delta.schema.json +137 -137
  28. package/schemas/learning/mplp-learning-sample-intent.schema.json +119 -119
  29. package/schemas/mplp-collab.schema.json +243 -243
  30. package/schemas/mplp-confirm.schema.json +226 -226
  31. package/schemas/mplp-context.schema.json +246 -246
  32. package/schemas/mplp-core.schema.json +183 -183
  33. package/schemas/mplp-dialog.schema.json +198 -198
  34. package/schemas/mplp-extension.schema.json +179 -179
  35. package/schemas/mplp-network.schema.json +230 -230
  36. package/schemas/mplp-plan.schema.json +193 -193
  37. package/schemas/mplp-role.schema.json +139 -139
  38. package/schemas/mplp-trace.schema.json +216 -216
@@ -1,56 +1,56 @@
1
- {
2
- "$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.",
3
- "$schema": "http://json-schema.org/draft-07/schema#",
4
- "$id": "https://mplp.dev/schemas/v1.0/events/mplp-pipeline-stage-event.schema.json",
5
- "title": "MPLP PipelineStageEvent v1.0",
6
- "description": "**REQUIRED** - Pipeline stage transition events (MANDATORY for v1.0 compliance)",
7
- "allOf": [
8
- {
9
- "$ref": "mplp-event-core.schema.json"
10
- },
11
- {
12
- "type": "object",
13
- "properties": {
14
- "event_family": {
15
- "const": "pipeline_stage",
16
- "description": "Must be 'pipeline_stage' for this event type"
17
- },
18
- "pipeline_id": {
19
- "type": "string",
20
- "format": "uuid",
21
- "description": "Pipeline instance identifier"
22
- },
23
- "stage_id": {
24
- "type": "string",
25
- "description": "Stage identifier (e.g., 'import', 'analyze', 'execute')"
26
- },
27
- "stage_name": {
28
- "type": "string",
29
- "description": "Human-readable stage name"
30
- },
31
- "stage_status": {
32
- "type": "string",
33
- "enum": [
34
- "pending",
35
- "running",
36
- "completed",
37
- "failed",
38
- "skipped"
39
- ],
40
- "description": "Current status of the pipeline stage"
41
- },
42
- "stage_order": {
43
- "type": "integer",
44
- "minimum": 0,
45
- "description": "Sequential order of this stage in pipeline"
46
- }
47
- },
48
- "required": [
49
- "event_family",
50
- "pipeline_id",
51
- "stage_id",
52
- "stage_status"
53
- ]
54
- }
55
- ]
56
- }
1
+ {
2
+ "$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.",
3
+ "$schema": "http://json-schema.org/draft-07/schema#",
4
+ "$id": "https://mplp.dev/schemas/v1.0/events/mplp-pipeline-stage-event.schema.json",
5
+ "title": "MPLP PipelineStageEvent v1.0",
6
+ "description": "**REQUIRED** - Pipeline stage transition events (MANDATORY for v1.0 compliance)",
7
+ "allOf": [
8
+ {
9
+ "$ref": "mplp-event-core.schema.json"
10
+ },
11
+ {
12
+ "type": "object",
13
+ "properties": {
14
+ "event_family": {
15
+ "const": "pipeline_stage",
16
+ "description": "Must be 'pipeline_stage' for this event type"
17
+ },
18
+ "pipeline_id": {
19
+ "type": "string",
20
+ "format": "uuid",
21
+ "description": "Pipeline instance identifier"
22
+ },
23
+ "stage_id": {
24
+ "type": "string",
25
+ "description": "Stage identifier (e.g., 'import', 'analyze', 'execute')"
26
+ },
27
+ "stage_name": {
28
+ "type": "string",
29
+ "description": "Human-readable stage name"
30
+ },
31
+ "stage_status": {
32
+ "type": "string",
33
+ "enum": [
34
+ "pending",
35
+ "running",
36
+ "completed",
37
+ "failed",
38
+ "skipped"
39
+ ],
40
+ "description": "Current status of the pipeline stage"
41
+ },
42
+ "stage_order": {
43
+ "type": "integer",
44
+ "minimum": 0,
45
+ "description": "Sequential order of this stage in pipeline"
46
+ }
47
+ },
48
+ "required": [
49
+ "event_family",
50
+ "pipeline_id",
51
+ "stage_id",
52
+ "stage_status"
53
+ ]
54
+ }
55
+ ]
56
+ }
@@ -1,58 +1,58 @@
1
- {
2
- "$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.",
3
- "$schema": "http://json-schema.org/draft-07/schema#",
4
- "$id": "https://mplp.dev/schemas/v1.0/events/mplp-runtime-execution-event.schema.json",
5
- "title": "MPLP RuntimeExecutionEvent v1.0",
6
- "description": "Runtime execution lifecycle events (agents, tools, LLMs, workers)",
7
- "allOf": [
8
- {
9
- "$ref": "mplp-event-core.schema.json"
10
- },
11
- {
12
- "type": "object",
13
- "properties": {
14
- "event_family": {
15
- "const": "runtime_execution",
16
- "description": "Must be 'runtime_execution' for this event type"
17
- },
18
- "execution_id": {
19
- "type": "string",
20
- "format": "uuid",
21
- "description": "Execution instance identifier"
22
- },
23
- "executor_kind": {
24
- "type": "string",
25
- "enum": [
26
- "agent",
27
- "tool",
28
- "llm",
29
- "worker",
30
- "external"
31
- ],
32
- "description": "Type of executor performing this execution"
33
- },
34
- "executor_role": {
35
- "type": "string",
36
- "description": "Role identifier (e.g., 'planner', 'reviewer', 'curl_executor')"
37
- },
38
- "status": {
39
- "type": "string",
40
- "enum": [
41
- "pending",
42
- "running",
43
- "completed",
44
- "failed",
45
- "cancelled"
46
- ],
47
- "description": "Current execution status"
48
- }
49
- },
50
- "required": [
51
- "event_family",
52
- "execution_id",
53
- "executor_kind",
54
- "status"
55
- ]
56
- }
57
- ]
58
- }
1
+ {
2
+ "$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.",
3
+ "$schema": "http://json-schema.org/draft-07/schema#",
4
+ "$id": "https://mplp.dev/schemas/v1.0/events/mplp-runtime-execution-event.schema.json",
5
+ "title": "MPLP RuntimeExecutionEvent v1.0",
6
+ "description": "Runtime execution lifecycle events (agents, tools, LLMs, workers)",
7
+ "allOf": [
8
+ {
9
+ "$ref": "mplp-event-core.schema.json"
10
+ },
11
+ {
12
+ "type": "object",
13
+ "properties": {
14
+ "event_family": {
15
+ "const": "runtime_execution",
16
+ "description": "Must be 'runtime_execution' for this event type"
17
+ },
18
+ "execution_id": {
19
+ "type": "string",
20
+ "format": "uuid",
21
+ "description": "Execution instance identifier"
22
+ },
23
+ "executor_kind": {
24
+ "type": "string",
25
+ "enum": [
26
+ "agent",
27
+ "tool",
28
+ "llm",
29
+ "worker",
30
+ "external"
31
+ ],
32
+ "description": "Type of executor performing this execution"
33
+ },
34
+ "executor_role": {
35
+ "type": "string",
36
+ "description": "Role identifier (e.g., 'planner', 'reviewer', 'curl_executor')"
37
+ },
38
+ "status": {
39
+ "type": "string",
40
+ "enum": [
41
+ "pending",
42
+ "running",
43
+ "completed",
44
+ "failed",
45
+ "cancelled"
46
+ ],
47
+ "description": "Current execution status"
48
+ }
49
+ },
50
+ "required": [
51
+ "event_family",
52
+ "execution_id",
53
+ "executor_kind",
54
+ "status"
55
+ ]
56
+ }
57
+ ]
58
+ }
@@ -1,109 +1,109 @@
1
- {
2
- "$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.",
3
- "$schema": "http://json-schema.org/draft-07/schema#",
4
- "$id": "https://mplp.dev/schemas/v1.0/events/mplp-sa-event.schema.json",
5
- "title": "MPLP SA Event v1.0",
6
- "description": "Events emitted by a Single Agent (SA) execution in MPLP v1.0 protocol",
7
- "type": "object",
8
- "properties": {
9
- "event_id": {
10
- "type": "string",
11
- "format": "uuid",
12
- "description": "Unique identifier for this event"
13
- },
14
- "event_type": {
15
- "type": "string",
16
- "enum": [
17
- "SAInitialized",
18
- "SAContextLoaded",
19
- "SAPlanEvaluated",
20
- "SAStepStarted",
21
- "SAStepCompleted",
22
- "SAStepFailed",
23
- "SATraceEmitted",
24
- "SACompleted"
25
- ],
26
- "description": "Type of SA lifecycle event"
27
- },
28
- "timestamp": {
29
- "type": "string",
30
- "format": "date-time",
31
- "description": "ISO 8601 timestamp when event occurred"
32
- },
33
- "sa_id": {
34
- "type": "string",
35
- "format": "uuid",
36
- "description": "Identifier of the SA instance emitting this event"
37
- },
38
- "context_id": {
39
- "type": "string",
40
- "format": "uuid",
41
- "description": "Context ID bound to this SA execution"
42
- },
43
- "plan_id": {
44
- "type": "string",
45
- "format": "uuid",
46
- "description": "Plan ID being executed by this SA"
47
- },
48
- "trace_id": {
49
- "type": "string",
50
- "format": "uuid",
51
- "description": "Trace ID where this event is recorded"
52
- },
53
- "payload": {
54
- "type": "object",
55
- "description": "Event-specific data payload",
56
- "additionalProperties": true
57
- }
58
- },
59
- "required": [
60
- "event_id",
61
- "event_type",
62
- "timestamp",
63
- "sa_id"
64
- ],
65
- "additionalProperties": false,
66
- "$defs": {
67
- "step_started_payload": {
68
- "type": "object",
69
- "properties": {
70
- "step_id": {
71
- "type": "string",
72
- "format": "uuid"
73
- },
74
- "agent_role": {
75
- "type": "string"
76
- },
77
- "description": {
78
- "type": "string"
79
- }
80
- },
81
- "required": [
82
- "step_id"
83
- ]
84
- },
85
- "step_completed_payload": {
86
- "type": "object",
87
- "properties": {
88
- "step_id": {
89
- "type": "string",
90
- "format": "uuid"
91
- },
92
- "status": {
93
- "type": "string",
94
- "enum": [
95
- "completed",
96
- "failed"
97
- ]
98
- },
99
- "result": {
100
- "type": "object"
101
- }
102
- },
103
- "required": [
104
- "step_id",
105
- "status"
106
- ]
107
- }
108
- }
109
- }
1
+ {
2
+ "$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.",
3
+ "$schema": "http://json-schema.org/draft-07/schema#",
4
+ "$id": "https://mplp.dev/schemas/v1.0/events/mplp-sa-event.schema.json",
5
+ "title": "MPLP SA Event v1.0",
6
+ "description": "Events emitted by a Single Agent (SA) execution in MPLP v1.0 protocol",
7
+ "type": "object",
8
+ "properties": {
9
+ "event_id": {
10
+ "type": "string",
11
+ "format": "uuid",
12
+ "description": "Unique identifier for this event"
13
+ },
14
+ "event_type": {
15
+ "type": "string",
16
+ "enum": [
17
+ "SAInitialized",
18
+ "SAContextLoaded",
19
+ "SAPlanEvaluated",
20
+ "SAStepStarted",
21
+ "SAStepCompleted",
22
+ "SAStepFailed",
23
+ "SATraceEmitted",
24
+ "SACompleted"
25
+ ],
26
+ "description": "Type of SA lifecycle event"
27
+ },
28
+ "timestamp": {
29
+ "type": "string",
30
+ "format": "date-time",
31
+ "description": "ISO 8601 timestamp when event occurred"
32
+ },
33
+ "sa_id": {
34
+ "type": "string",
35
+ "format": "uuid",
36
+ "description": "Identifier of the SA instance emitting this event"
37
+ },
38
+ "context_id": {
39
+ "type": "string",
40
+ "format": "uuid",
41
+ "description": "Context ID bound to this SA execution"
42
+ },
43
+ "plan_id": {
44
+ "type": "string",
45
+ "format": "uuid",
46
+ "description": "Plan ID being executed by this SA"
47
+ },
48
+ "trace_id": {
49
+ "type": "string",
50
+ "format": "uuid",
51
+ "description": "Trace ID where this event is recorded"
52
+ },
53
+ "payload": {
54
+ "type": "object",
55
+ "description": "Event-specific data payload",
56
+ "additionalProperties": true
57
+ }
58
+ },
59
+ "required": [
60
+ "event_id",
61
+ "event_type",
62
+ "timestamp",
63
+ "sa_id"
64
+ ],
65
+ "additionalProperties": false,
66
+ "$defs": {
67
+ "step_started_payload": {
68
+ "type": "object",
69
+ "properties": {
70
+ "step_id": {
71
+ "type": "string",
72
+ "format": "uuid"
73
+ },
74
+ "agent_role": {
75
+ "type": "string"
76
+ },
77
+ "description": {
78
+ "type": "string"
79
+ }
80
+ },
81
+ "required": [
82
+ "step_id"
83
+ ]
84
+ },
85
+ "step_completed_payload": {
86
+ "type": "object",
87
+ "properties": {
88
+ "step_id": {
89
+ "type": "string",
90
+ "format": "uuid"
91
+ },
92
+ "status": {
93
+ "type": "string",
94
+ "enum": [
95
+ "completed",
96
+ "failed"
97
+ ]
98
+ },
99
+ "result": {
100
+ "type": "object"
101
+ }
102
+ },
103
+ "required": [
104
+ "step_id",
105
+ "status"
106
+ ]
107
+ }
108
+ }
109
+ }