@mplp/schema 1.0.1 → 1.0.3

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 +61 -0
  2. package/dist/index.d.ts +0 -11
  3. package/dist/index.js +7 -11
  4. package/package.json +24 -5
  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,194 +1,194 @@
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://schemas.mplp.dev/v1.0/common/learning-sample.schema.json",
5
- "title": "MPLP Learning Sample – Schema v2.0",
6
- "description": "Structured learning sample for MPLP v1.0 runtimes.",
7
- "type": "object",
8
- "additionalProperties": false,
9
- "properties": {
10
- "sample_id": {
11
- "$ref": "identifiers.schema.json",
12
- "description": "Unique identifier for this learning sample."
13
- },
14
- "project_id": {
15
- "type": "string",
16
- "description": "Project identifier this sample belongs to."
17
- },
18
- "intent_before": {
19
- "type": "object",
20
- "description": "Structured representation of the original intent (can reference Context/Plan).",
21
- "additionalProperties": true
22
- },
23
- "plan": {
24
- "type": "object",
25
- "description": "Structured representation of the plan used (can reference Plan module).",
26
- "additionalProperties": true
27
- },
28
- "delta_intents": {
29
- "type": "array",
30
- "description": "Array of delta intents proposed/applied.",
31
- "items": {
32
- "type": "object",
33
- "additionalProperties": true
34
- }
35
- },
36
- "graph_before": {
37
- "type": "object",
38
- "description": "Optional snapshot or summary of the knowledge graph before the change.",
39
- "additionalProperties": true
40
- },
41
- "graph_after": {
42
- "type": "object",
43
- "description": "Optional snapshot or summary of the knowledge graph after the change.",
44
- "additionalProperties": true
45
- },
46
- "pipeline_path": {
47
- "type": "array",
48
- "description": "Sequence of pipeline stages traversed.",
49
- "items": {
50
- "type": "string"
51
- }
52
- },
53
- "success_flag": {
54
- "type": "boolean",
55
- "description": "Whether the action/intent succeeded."
56
- },
57
- "error_info": {
58
- "type": "object",
59
- "description": "Error details if action failed.",
60
- "additionalProperties": false,
61
- "properties": {
62
- "error_code": {
63
- "type": "string"
64
- },
65
- "error_message": {
66
- "type": "string"
67
- },
68
- "stack_trace": {
69
- "type": "string"
70
- }
71
- }
72
- },
73
- "token_usage": {
74
- "type": "object",
75
- "description": "LLM token consumption metrics.",
76
- "additionalProperties": false,
77
- "properties": {
78
- "total_tokens": {
79
- "type": "number",
80
- "minimum": 0
81
- },
82
- "prompt_tokens": {
83
- "type": "number",
84
- "minimum": 0
85
- },
86
- "completion_tokens": {
87
- "type": "number",
88
- "minimum": 0
89
- },
90
- "by_agent": {
91
- "type": "array",
92
- "description": "Token usage breakdown by agent.",
93
- "items": {
94
- "type": "object",
95
- "additionalProperties": false,
96
- "properties": {
97
- "agent_id": {
98
- "type": "string"
99
- },
100
- "role": {
101
- "type": "string"
102
- },
103
- "tokens": {
104
- "type": "number",
105
- "minimum": 0
106
- }
107
- },
108
- "required": [
109
- "agent_id",
110
- "tokens"
111
- ]
112
- }
113
- }
114
- }
115
- },
116
- "execution_time_ms": {
117
- "type": "number",
118
- "description": "Execution time in milliseconds.",
119
- "minimum": 0
120
- },
121
- "impact_score": {
122
- "type": "number",
123
- "description": "Impact score (0.0-1.0).",
124
- "minimum": 0,
125
- "maximum": 1
126
- },
127
- "user_feedback": {
128
- "type": "object",
129
- "description": "Human feedback on the action/result.",
130
- "additionalProperties": false,
131
- "properties": {
132
- "decision": {
133
- "type": "string",
134
- "enum": [
135
- "approve",
136
- "reject",
137
- "override",
138
- "unknown"
139
- ]
140
- },
141
- "comment": {
142
- "type": "string"
143
- },
144
- "rating": {
145
- "type": "number",
146
- "minimum": 0,
147
- "maximum": 5
148
- }
149
- }
150
- },
151
- "governance_decisions": {
152
- "type": "array",
153
- "description": "Governance rules evaluated during execution.",
154
- "items": {
155
- "type": "object",
156
- "additionalProperties": true
157
- }
158
- },
159
- "timestamps": {
160
- "type": "object",
161
- "description": "Execution timeline.",
162
- "additionalProperties": false,
163
- "properties": {
164
- "started_at": {
165
- "type": "string",
166
- "format": "date-time"
167
- },
168
- "completed_at": {
169
- "type": "string",
170
- "format": "date-time"
171
- }
172
- },
173
- "required": [
174
- "started_at"
175
- ]
176
- },
177
- "metadata": {
178
- "type": "object",
179
- "description": "Additional metadata (extensibility point).",
180
- "additionalProperties": true
181
- },
182
- "vendor_extensions": {
183
- "type": "object",
184
- "description": "Optional vendor-specific extensions. Structure is implementation-defined and MUST NOT conflict with core protocol fields.",
185
- "additionalProperties": true
186
- }
187
- },
188
- "required": [
189
- "sample_id",
190
- "project_id",
191
- "success_flag",
192
- "timestamps"
193
- ]
194
- }
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://schemas.mplp.dev/v1.0/common/learning-sample.schema.json",
5
+ "title": "MPLP Learning Sample – Schema v2.0",
6
+ "description": "Structured learning sample for MPLP v1.0 runtimes.",
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "properties": {
10
+ "sample_id": {
11
+ "$ref": "identifiers.schema.json",
12
+ "description": "Unique identifier for this learning sample."
13
+ },
14
+ "project_id": {
15
+ "type": "string",
16
+ "description": "Project identifier this sample belongs to."
17
+ },
18
+ "intent_before": {
19
+ "type": "object",
20
+ "description": "Structured representation of the original intent (can reference Context/Plan).",
21
+ "additionalProperties": true
22
+ },
23
+ "plan": {
24
+ "type": "object",
25
+ "description": "Structured representation of the plan used (can reference Plan module).",
26
+ "additionalProperties": true
27
+ },
28
+ "delta_intents": {
29
+ "type": "array",
30
+ "description": "Array of delta intents proposed/applied.",
31
+ "items": {
32
+ "type": "object",
33
+ "additionalProperties": true
34
+ }
35
+ },
36
+ "graph_before": {
37
+ "type": "object",
38
+ "description": "Optional snapshot or summary of the knowledge graph before the change.",
39
+ "additionalProperties": true
40
+ },
41
+ "graph_after": {
42
+ "type": "object",
43
+ "description": "Optional snapshot or summary of the knowledge graph after the change.",
44
+ "additionalProperties": true
45
+ },
46
+ "pipeline_path": {
47
+ "type": "array",
48
+ "description": "Sequence of pipeline stages traversed.",
49
+ "items": {
50
+ "type": "string"
51
+ }
52
+ },
53
+ "success_flag": {
54
+ "type": "boolean",
55
+ "description": "Whether the action/intent succeeded."
56
+ },
57
+ "error_info": {
58
+ "type": "object",
59
+ "description": "Error details if action failed.",
60
+ "additionalProperties": false,
61
+ "properties": {
62
+ "error_code": {
63
+ "type": "string"
64
+ },
65
+ "error_message": {
66
+ "type": "string"
67
+ },
68
+ "stack_trace": {
69
+ "type": "string"
70
+ }
71
+ }
72
+ },
73
+ "token_usage": {
74
+ "type": "object",
75
+ "description": "LLM token consumption metrics.",
76
+ "additionalProperties": false,
77
+ "properties": {
78
+ "total_tokens": {
79
+ "type": "number",
80
+ "minimum": 0
81
+ },
82
+ "prompt_tokens": {
83
+ "type": "number",
84
+ "minimum": 0
85
+ },
86
+ "completion_tokens": {
87
+ "type": "number",
88
+ "minimum": 0
89
+ },
90
+ "by_agent": {
91
+ "type": "array",
92
+ "description": "Token usage breakdown by agent.",
93
+ "items": {
94
+ "type": "object",
95
+ "additionalProperties": false,
96
+ "properties": {
97
+ "agent_id": {
98
+ "type": "string"
99
+ },
100
+ "role": {
101
+ "type": "string"
102
+ },
103
+ "tokens": {
104
+ "type": "number",
105
+ "minimum": 0
106
+ }
107
+ },
108
+ "required": [
109
+ "agent_id",
110
+ "tokens"
111
+ ]
112
+ }
113
+ }
114
+ }
115
+ },
116
+ "execution_time_ms": {
117
+ "type": "number",
118
+ "description": "Execution time in milliseconds.",
119
+ "minimum": 0
120
+ },
121
+ "impact_score": {
122
+ "type": "number",
123
+ "description": "Impact score (0.0-1.0).",
124
+ "minimum": 0,
125
+ "maximum": 1
126
+ },
127
+ "user_feedback": {
128
+ "type": "object",
129
+ "description": "Human feedback on the action/result.",
130
+ "additionalProperties": false,
131
+ "properties": {
132
+ "decision": {
133
+ "type": "string",
134
+ "enum": [
135
+ "approve",
136
+ "reject",
137
+ "override",
138
+ "unknown"
139
+ ]
140
+ },
141
+ "comment": {
142
+ "type": "string"
143
+ },
144
+ "rating": {
145
+ "type": "number",
146
+ "minimum": 0,
147
+ "maximum": 5
148
+ }
149
+ }
150
+ },
151
+ "governance_decisions": {
152
+ "type": "array",
153
+ "description": "Governance rules evaluated during execution.",
154
+ "items": {
155
+ "type": "object",
156
+ "additionalProperties": true
157
+ }
158
+ },
159
+ "timestamps": {
160
+ "type": "object",
161
+ "description": "Execution timeline.",
162
+ "additionalProperties": false,
163
+ "properties": {
164
+ "started_at": {
165
+ "type": "string",
166
+ "format": "date-time"
167
+ },
168
+ "completed_at": {
169
+ "type": "string",
170
+ "format": "date-time"
171
+ }
172
+ },
173
+ "required": [
174
+ "started_at"
175
+ ]
176
+ },
177
+ "metadata": {
178
+ "type": "object",
179
+ "description": "Additional metadata (extensibility point).",
180
+ "additionalProperties": true
181
+ },
182
+ "vendor_extensions": {
183
+ "type": "object",
184
+ "description": "Optional vendor-specific extensions. Structure is implementation-defined and MUST NOT conflict with core protocol fields.",
185
+ "additionalProperties": true
186
+ }
187
+ },
188
+ "required": [
189
+ "sample_id",
190
+ "project_id",
191
+ "success_flag",
192
+ "timestamps"
193
+ ]
194
+ }
@@ -1,113 +1,113 @@
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
- "$id": "https://schemas.mplp.dev/v1.0/common/metadata.schema.json",
4
- "$schema": "http://json-schema.org/draft-07/schema#",
5
- "title": "MPLP Metadata",
6
- "description": "Common metadata structure for all MPLP objects. Provides version control, creation info, tags, and cross-cutting concern declarations. All top-level objects in L2/L3/L4 should include the meta field.",
7
- "type": "object",
8
- "properties": {
9
- "protocol_version": {
10
- "type": "string",
11
- "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
12
- "description": "MPLP protocol version, using Semantic Versioning.",
13
- "examples": [
14
- "1.0.0",
15
- "1.1.0"
16
- ]
17
- },
18
- "schema_version": {
19
- "type": "string",
20
- "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
21
- "description": "Schema version used by the current object, using Semantic Versioning.",
22
- "examples": [
23
- "2.0.0",
24
- "2.1.0"
25
- ]
26
- },
27
- "created_at": {
28
- "type": "string",
29
- "format": "date-time",
30
- "description": "Object creation time (ISO 8601 format).",
31
- "examples": [
32
- "2025-01-28T15:30:00.000Z"
33
- ]
34
- },
35
- "created_by": {
36
- "type": "string",
37
- "description": "Creator identifier (User ID / Agent Name / System ID).",
38
- "examples": [
39
- "user-123",
40
- "agent-planner",
41
- "system"
42
- ]
43
- },
44
- "updated_at": {
45
- "type": "string",
46
- "format": "date-time",
47
- "description": "Object last update time (ISO 8601 format).",
48
- "examples": [
49
- "2025-01-28T16:45:00.000Z"
50
- ]
51
- },
52
- "updated_by": {
53
- "type": "string",
54
- "description": "Last updater identifier.",
55
- "examples": [
56
- "user-456",
57
- "agent-executor"
58
- ]
59
- },
60
- "tags": {
61
- "type": "array",
62
- "items": {
63
- "type": "string"
64
- },
65
- "description": "Set of tags for indexing/search. Supports custom classification and retrieval.",
66
- "uniqueItems": true,
67
- "examples": [
68
- [
69
- "production",
70
- "high-priority"
71
- ],
72
- [
73
- "development",
74
- "experimental"
75
- ]
76
- ]
77
- },
78
- "cross_cutting": {
79
- "type": "array",
80
- "description": "Declares cross-cutting concerns enabled for the current object (one of the 9 concerns in Governance Plane).",
81
- "items": {
82
- "type": "string",
83
- "enum": [
84
- "coordination",
85
- "error-handling",
86
- "event-bus",
87
- "orchestration",
88
- "performance",
89
- "protocol-version",
90
- "security",
91
- "state-sync",
92
- "transaction"
93
- ]
94
- },
95
- "uniqueItems": true,
96
- "examples": [
97
- [
98
- "security",
99
- "transaction"
100
- ],
101
- [
102
- "performance",
103
- "event-bus"
104
- ]
105
- ]
106
- }
107
- },
108
- "required": [
109
- "protocol_version",
110
- "schema_version"
111
- ],
112
- "additionalProperties": false
113
- }
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
+ "$id": "https://schemas.mplp.dev/v1.0/common/metadata.schema.json",
4
+ "$schema": "http://json-schema.org/draft-07/schema#",
5
+ "title": "MPLP Metadata",
6
+ "description": "Common metadata structure for all MPLP objects. Provides version control, creation info, tags, and cross-cutting concern declarations. All top-level objects in L2/L3/L4 should include the meta field.",
7
+ "type": "object",
8
+ "properties": {
9
+ "protocol_version": {
10
+ "type": "string",
11
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
12
+ "description": "MPLP protocol version, using Semantic Versioning.",
13
+ "examples": [
14
+ "1.0.0",
15
+ "1.1.0"
16
+ ]
17
+ },
18
+ "schema_version": {
19
+ "type": "string",
20
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
21
+ "description": "Schema version used by the current object, using Semantic Versioning.",
22
+ "examples": [
23
+ "2.0.0",
24
+ "2.1.0"
25
+ ]
26
+ },
27
+ "created_at": {
28
+ "type": "string",
29
+ "format": "date-time",
30
+ "description": "Object creation time (ISO 8601 format).",
31
+ "examples": [
32
+ "2025-01-28T15:30:00.000Z"
33
+ ]
34
+ },
35
+ "created_by": {
36
+ "type": "string",
37
+ "description": "Creator identifier (User ID / Agent Name / System ID).",
38
+ "examples": [
39
+ "user-123",
40
+ "agent-planner",
41
+ "system"
42
+ ]
43
+ },
44
+ "updated_at": {
45
+ "type": "string",
46
+ "format": "date-time",
47
+ "description": "Object last update time (ISO 8601 format).",
48
+ "examples": [
49
+ "2025-01-28T16:45:00.000Z"
50
+ ]
51
+ },
52
+ "updated_by": {
53
+ "type": "string",
54
+ "description": "Last updater identifier.",
55
+ "examples": [
56
+ "user-456",
57
+ "agent-executor"
58
+ ]
59
+ },
60
+ "tags": {
61
+ "type": "array",
62
+ "items": {
63
+ "type": "string"
64
+ },
65
+ "description": "Set of tags for indexing/search. Supports custom classification and retrieval.",
66
+ "uniqueItems": true,
67
+ "examples": [
68
+ [
69
+ "production",
70
+ "high-priority"
71
+ ],
72
+ [
73
+ "development",
74
+ "experimental"
75
+ ]
76
+ ]
77
+ },
78
+ "cross_cutting": {
79
+ "type": "array",
80
+ "description": "Declares cross-cutting concerns enabled for the current object (one of the 9 concerns in Governance Plane).",
81
+ "items": {
82
+ "type": "string",
83
+ "enum": [
84
+ "coordination",
85
+ "error-handling",
86
+ "event-bus",
87
+ "orchestration",
88
+ "performance",
89
+ "protocol-version",
90
+ "security",
91
+ "state-sync",
92
+ "transaction"
93
+ ]
94
+ },
95
+ "uniqueItems": true,
96
+ "examples": [
97
+ [
98
+ "security",
99
+ "transaction"
100
+ ],
101
+ [
102
+ "performance",
103
+ "event-bus"
104
+ ]
105
+ ]
106
+ }
107
+ },
108
+ "required": [
109
+ "protocol_version",
110
+ "schema_version"
111
+ ],
112
+ "additionalProperties": false
113
+ }