@mplp/schema 1.0.4 → 1.0.6

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 (43) hide show
  1. package/LICENSE +17 -0
  2. package/LICENSE.txt +201 -201
  3. package/README.md +25 -7
  4. package/dist/index.d.ts +1 -0
  5. package/dist/index.js +15 -0
  6. package/dist/kernel-duties.d.ts +9 -0
  7. package/dist/kernel-duties.js +19 -0
  8. package/package.json +17 -7
  9. package/schemas/common/common-types.schema.json +49 -49
  10. package/schemas/common/events.schema.json +66 -66
  11. package/schemas/common/identifiers.schema.json +13 -13
  12. package/schemas/common/learning-sample.schema.json +194 -194
  13. package/schemas/common/metadata.schema.json +115 -113
  14. package/schemas/common/trace-base.schema.json +43 -43
  15. package/schemas/events/mplp-event-core.schema.json +58 -58
  16. package/schemas/events/mplp-graph-update-event.schema.json +58 -58
  17. package/schemas/events/mplp-map-event.schema.json +147 -147
  18. package/schemas/events/mplp-pipeline-stage-event.schema.json +56 -56
  19. package/schemas/events/mplp-runtime-execution-event.schema.json +58 -58
  20. package/schemas/events/mplp-sa-event.schema.json +109 -109
  21. package/schemas/integration/mplp-ci-event.schema.json +130 -130
  22. package/schemas/integration/mplp-file-update-event.schema.json +70 -70
  23. package/schemas/integration/mplp-git-event.schema.json +98 -98
  24. package/schemas/integration/mplp-tool-event.schema.json +83 -83
  25. package/schemas/invariants/integration-invariants.yaml +139 -147
  26. package/schemas/invariants/learning-invariants.yaml +98 -106
  27. package/schemas/invariants/map-invariants.yaml +65 -73
  28. package/schemas/invariants/observability-invariants.yaml +98 -106
  29. package/schemas/invariants/sa-invariants.yaml +64 -72
  30. package/schemas/kernel-duties.json +18 -0
  31. package/schemas/learning/mplp-learning-sample-core.schema.json +94 -94
  32. package/schemas/learning/mplp-learning-sample-delta.schema.json +137 -137
  33. package/schemas/learning/mplp-learning-sample-intent.schema.json +119 -119
  34. package/schemas/mplp-collab.schema.json +243 -243
  35. package/schemas/mplp-confirm.schema.json +226 -226
  36. package/schemas/mplp-context.schema.json +246 -246
  37. package/schemas/mplp-core.schema.json +183 -183
  38. package/schemas/mplp-dialog.schema.json +198 -198
  39. package/schemas/mplp-extension.schema.json +179 -179
  40. package/schemas/mplp-network.schema.json +230 -230
  41. package/schemas/mplp-plan.schema.json +193 -193
  42. package/schemas/mplp-role.schema.json +139 -139
  43. package/schemas/mplp-trace.schema.json +216 -216
package/schemas/mplp-plan.schema.json CHANGED
@@ -1,193 +1,193 @@
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/mplp-plan.schema.json",
5
- "title": "MPLP Plan Module – Core Protocol v1.0",
6
- "description": "Plan Module Core Protocol: Describes the plan objects and their lifecycle minimal required semantics (Core Profile) in multi-agent collaboration.",
7
- "type": "object",
8
- "additionalProperties": false,
9
- "properties": {
10
- "meta": {
11
- "$ref": "common/metadata.schema.json",
12
- "description": "[PROTOCOL-CORE] MPLP protocol schema metadata (version, source, cross-cutting tags, etc.)."
13
- },
14
- "plan_id": {
15
- "$ref": "common/identifiers.schema.json",
16
- "description": "[PROTOCOL-CORE] Global unique identifier for the Plan."
17
- },
18
- "context_id": {
19
- "$ref": "common/identifiers.schema.json",
20
- "description": "[PROTOCOL-CORE] Identifier of the Context this Plan belongs to."
21
- },
22
- "title": {
23
- "type": "string",
24
- "minLength": 1,
25
- "description": "[PROTOCOL-CORE] Plan title (brief description for humans and Agents)."
26
- },
27
- "objective": {
28
- "type": "string",
29
- "minLength": 1,
30
- "description": "[PROTOCOL-CORE] Description of the objective to be achieved by the Plan."
31
- },
32
- "status": {
33
- "type": "string",
34
- "description": "[PROTOCOL-CORE] Status of the Plan in its lifecycle.",
35
- "enum": [
36
- "draft",
37
- "proposed",
38
- "approved",
39
- "in_progress",
40
- "completed",
41
- "cancelled",
42
- "failed"
43
- ]
44
- },
45
- "steps": {
46
- "type": "array",
47
- "description": "[PROTOCOL-CORE] List of core steps decomposed from the Plan.",
48
- "minItems": 1,
49
- "items": {
50
- "$ref": "#/$defs/plan_step_core"
51
- }
52
- },
53
- "trace": {
54
- "$ref": "common/trace-base.schema.json",
55
- "description": "[PROTOCOL-CORE] Main execution trace reference associated with this Plan."
56
- },
57
- "events": {
58
- "type": "array",
59
- "description": "[PROTOCOL-CORE] List of key events directly associated with this Plan (changes, approvals, status transitions, etc.).",
60
- "items": {
61
- "$ref": "common/events.schema.json"
62
- }
63
- }
64
- },
65
- "required": [
66
- "meta",
67
- "plan_id",
68
- "context_id",
69
- "title",
70
- "objective",
71
- "status",
72
- "steps"
73
- ],
74
- "$defs": {
75
- "plan_core_properties": {
76
- "type": "object",
77
- "properties": {
78
- "meta": {
79
- "$ref": "common/metadata.schema.json",
80
- "description": "[PROTOCOL-CORE] MPLP protocol schema metadata (version, source, cross-cutting tags, etc.)."
81
- },
82
- "plan_id": {
83
- "$ref": "common/identifiers.schema.json",
84
- "description": "[PROTOCOL-CORE] Global unique identifier for the Plan."
85
- },
86
- "context_id": {
87
- "$ref": "common/identifiers.schema.json",
88
- "description": "[PROTOCOL-CORE] Identifier of the Context this Plan belongs to."
89
- },
90
- "title": {
91
- "type": "string",
92
- "minLength": 1,
93
- "description": "[PROTOCOL-CORE] Plan title (brief description for humans and Agents)."
94
- },
95
- "objective": {
96
- "type": "string",
97
- "minLength": 1,
98
- "description": "[PROTOCOL-CORE] Description of the objective to be achieved by the Plan."
99
- },
100
- "status": {
101
- "type": "string",
102
- "description": "[PROTOCOL-CORE] Status of the Plan in its lifecycle.",
103
- "enum": [
104
- "draft",
105
- "proposed",
106
- "approved",
107
- "in_progress",
108
- "completed",
109
- "cancelled",
110
- "failed"
111
- ]
112
- },
113
- "steps": {
114
- "type": "array",
115
- "description": "[PROTOCOL-CORE] List of core steps decomposed from the Plan.",
116
- "minItems": 1,
117
- "items": {
118
- "$ref": "#/$defs/plan_step_core"
119
- }
120
- },
121
- "trace": {
122
- "$ref": "common/trace-base.schema.json",
123
- "description": "[PROTOCOL-CORE] Main execution trace reference associated with this Plan."
124
- },
125
- "events": {
126
- "type": "array",
127
- "description": "[PROTOCOL-CORE] List of key events directly associated with this Plan (changes, approvals, status transitions, etc.).",
128
- "items": {
129
- "$ref": "common/events.schema.json"
130
- }
131
- }
132
- },
133
- "required": [
134
- "meta",
135
- "plan_id",
136
- "context_id",
137
- "title",
138
- "objective",
139
- "status",
140
- "steps"
141
- ]
142
- },
143
- "plan_step_core": {
144
- "type": "object",
145
- "description": "[PROTOCOL-CORE] Minimal required semantics for a plan step (excluding execution engine, scheduling policy implementation details).",
146
- "additionalProperties": false,
147
- "properties": {
148
- "step_id": {
149
- "$ref": "common/identifiers.schema.json",
150
- "description": "[PROTOCOL-CORE] Global unique identifier for the step."
151
- },
152
- "description": {
153
- "type": "string",
154
- "minLength": 1,
155
- "description": "[PROTOCOL-CORE] Content of the work to be completed in the step."
156
- },
157
- "status": {
158
- "type": "string",
159
- "description": "[PROTOCOL-CORE] Current status of the step.",
160
- "enum": [
161
- "pending",
162
- "in_progress",
163
- "completed",
164
- "blocked",
165
- "skipped",
166
- "failed"
167
- ]
168
- },
169
- "dependencies": {
170
- "type": "array",
171
- "description": "[PROTOCOL-CORE] List of other step IDs that this step depends on.",
172
- "items": {
173
- "$ref": "common/identifiers.schema.json"
174
- }
175
- },
176
- "agent_role": {
177
- "type": "string",
178
- "description": "[PROTOCOL-CORE] Identifier of the role responsible for this step (should correspond to role_id in Role module)."
179
- },
180
- "order_index": {
181
- "type": "integer",
182
- "minimum": 0,
183
- "description": "[PROTOCOL-CORE] Sort index in the current Plan, used for defining execution order or display order."
184
- }
185
- },
186
- "required": [
187
- "step_id",
188
- "description",
189
- "status"
190
- ]
191
- }
192
- }
193
- }
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: © 2026 Bangshi Beijing Network Technology Limited Company\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/mplp-plan.schema.json",
5
+ "title": "MPLP Plan Module – Core Protocol v1.0",
6
+ "description": "Plan Module Core Protocol: Describes the plan objects and their lifecycle minimal required semantics (Core Profile) in multi-agent collaboration.",
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "properties": {
10
+ "meta": {
11
+ "$ref": "common/metadata.schema.json",
12
+ "description": "[PROTOCOL-CORE] MPLP protocol schema metadata (version, source, cross-cutting tags, etc.)."
13
+ },
14
+ "plan_id": {
15
+ "$ref": "common/identifiers.schema.json",
16
+ "description": "[PROTOCOL-CORE] Global unique identifier for the Plan."
17
+ },
18
+ "context_id": {
19
+ "$ref": "common/identifiers.schema.json",
20
+ "description": "[PROTOCOL-CORE] Identifier of the Context this Plan belongs to."
21
+ },
22
+ "title": {
23
+ "type": "string",
24
+ "minLength": 1,
25
+ "description": "[PROTOCOL-CORE] Plan title (brief description for humans and Agents)."
26
+ },
27
+ "objective": {
28
+ "type": "string",
29
+ "minLength": 1,
30
+ "description": "[PROTOCOL-CORE] Description of the objective to be achieved by the Plan."
31
+ },
32
+ "status": {
33
+ "type": "string",
34
+ "description": "[PROTOCOL-CORE] Status of the Plan in its lifecycle.",
35
+ "enum": [
36
+ "draft",
37
+ "proposed",
38
+ "approved",
39
+ "in_progress",
40
+ "completed",
41
+ "cancelled",
42
+ "failed"
43
+ ]
44
+ },
45
+ "steps": {
46
+ "type": "array",
47
+ "description": "[PROTOCOL-CORE] List of core steps decomposed from the Plan.",
48
+ "minItems": 1,
49
+ "items": {
50
+ "$ref": "#/$defs/plan_step_core"
51
+ }
52
+ },
53
+ "trace": {
54
+ "$ref": "common/trace-base.schema.json",
55
+ "description": "[PROTOCOL-CORE] Main execution trace reference associated with this Plan."
56
+ },
57
+ "events": {
58
+ "type": "array",
59
+ "description": "[PROTOCOL-CORE] List of key events directly associated with this Plan (changes, approvals, status transitions, etc.).",
60
+ "items": {
61
+ "$ref": "common/events.schema.json"
62
+ }
63
+ }
64
+ },
65
+ "required": [
66
+ "meta",
67
+ "plan_id",
68
+ "context_id",
69
+ "title",
70
+ "objective",
71
+ "status",
72
+ "steps"
73
+ ],
74
+ "$defs": {
75
+ "plan_core_properties": {
76
+ "type": "object",
77
+ "properties": {
78
+ "meta": {
79
+ "$ref": "common/metadata.schema.json",
80
+ "description": "[PROTOCOL-CORE] MPLP protocol schema metadata (version, source, cross-cutting tags, etc.)."
81
+ },
82
+ "plan_id": {
83
+ "$ref": "common/identifiers.schema.json",
84
+ "description": "[PROTOCOL-CORE] Global unique identifier for the Plan."
85
+ },
86
+ "context_id": {
87
+ "$ref": "common/identifiers.schema.json",
88
+ "description": "[PROTOCOL-CORE] Identifier of the Context this Plan belongs to."
89
+ },
90
+ "title": {
91
+ "type": "string",
92
+ "minLength": 1,
93
+ "description": "[PROTOCOL-CORE] Plan title (brief description for humans and Agents)."
94
+ },
95
+ "objective": {
96
+ "type": "string",
97
+ "minLength": 1,
98
+ "description": "[PROTOCOL-CORE] Description of the objective to be achieved by the Plan."
99
+ },
100
+ "status": {
101
+ "type": "string",
102
+ "description": "[PROTOCOL-CORE] Status of the Plan in its lifecycle.",
103
+ "enum": [
104
+ "draft",
105
+ "proposed",
106
+ "approved",
107
+ "in_progress",
108
+ "completed",
109
+ "cancelled",
110
+ "failed"
111
+ ]
112
+ },
113
+ "steps": {
114
+ "type": "array",
115
+ "description": "[PROTOCOL-CORE] List of core steps decomposed from the Plan.",
116
+ "minItems": 1,
117
+ "items": {
118
+ "$ref": "#/$defs/plan_step_core"
119
+ }
120
+ },
121
+ "trace": {
122
+ "$ref": "common/trace-base.schema.json",
123
+ "description": "[PROTOCOL-CORE] Main execution trace reference associated with this Plan."
124
+ },
125
+ "events": {
126
+ "type": "array",
127
+ "description": "[PROTOCOL-CORE] List of key events directly associated with this Plan (changes, approvals, status transitions, etc.).",
128
+ "items": {
129
+ "$ref": "common/events.schema.json"
130
+ }
131
+ }
132
+ },
133
+ "required": [
134
+ "meta",
135
+ "plan_id",
136
+ "context_id",
137
+ "title",
138
+ "objective",
139
+ "status",
140
+ "steps"
141
+ ]
142
+ },
143
+ "plan_step_core": {
144
+ "type": "object",
145
+ "description": "[PROTOCOL-CORE] Minimal required semantics for a plan step (excluding execution engine, scheduling policy implementation details).",
146
+ "additionalProperties": false,
147
+ "properties": {
148
+ "step_id": {
149
+ "$ref": "common/identifiers.schema.json",
150
+ "description": "[PROTOCOL-CORE] Global unique identifier for the step."
151
+ },
152
+ "description": {
153
+ "type": "string",
154
+ "minLength": 1,
155
+ "description": "[PROTOCOL-CORE] Content of the work to be completed in the step."
156
+ },
157
+ "status": {
158
+ "type": "string",
159
+ "description": "[PROTOCOL-CORE] Current status of the step.",
160
+ "enum": [
161
+ "pending",
162
+ "in_progress",
163
+ "completed",
164
+ "blocked",
165
+ "skipped",
166
+ "failed"
167
+ ]
168
+ },
169
+ "dependencies": {
170
+ "type": "array",
171
+ "description": "[PROTOCOL-CORE] List of other step IDs that this step depends on.",
172
+ "items": {
173
+ "$ref": "common/identifiers.schema.json"
174
+ }
175
+ },
176
+ "agent_role": {
177
+ "type": "string",
178
+ "description": "[PROTOCOL-CORE] Identifier of the role responsible for this step (should correspond to role_id in Role module)."
179
+ },
180
+ "order_index": {
181
+ "type": "integer",
182
+ "minimum": 0,
183
+ "description": "[PROTOCOL-CORE] Sort index in the current Plan, used for defining execution order or display order."
184
+ }
185
+ },
186
+ "required": [
187
+ "step_id",
188
+ "description",
189
+ "status"
190
+ ]
191
+ }
192
+ }
193
+ }