@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
@@ -1,147 +1,147 @@
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-map-event.schema.json",
5
- "title": "MPLP MAP Event v1.0",
6
- "description": "Events emitted by Multi-Agent Profile (MAP) collaboration sessions 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
- "MAPSessionStarted",
18
- "MAPRolesAssigned",
19
- "MAPTurnDispatched",
20
- "MAPTurnCompleted",
21
- "MAPBroadcastSent",
22
- "MAPBroadcastReceived",
23
- "MAPConflictDetected",
24
- "MAPConflictResolved",
25
- "MAPSessionCompleted"
26
- ],
27
- "description": "Type of MAP session lifecycle event"
28
- },
29
- "timestamp": {
30
- "type": "string",
31
- "format": "date-time",
32
- "description": "ISO 8601 timestamp when event occurred"
33
- },
34
- "session_id": {
35
- "type": "string",
36
- "format": "uuid",
37
- "description": "Collaboration session ID (corresponds to Collab.collab_id)"
38
- },
39
- "initiator_role": {
40
- "type": "string",
41
- "description": "Role ID of the initiating agent (optional, depends on event type)"
42
- },
43
- "target_roles": {
44
- "type": "array",
45
- "items": {
46
- "type": "string"
47
- },
48
- "description": "Array of target role IDs for this event (e.g., broadcast targets)"
49
- },
50
- "payload": {
51
- "type": "object",
52
- "description": "Event-specific data payload",
53
- "additionalProperties": true
54
- }
55
- },
56
- "required": [
57
- "event_id",
58
- "event_type",
59
- "timestamp",
60
- "session_id"
61
- ],
62
- "additionalProperties": false,
63
- "$defs": {
64
- "turn_dispatched_payload": {
65
- "type": "object",
66
- "properties": {
67
- "role_id": {
68
- "type": "string",
69
- "format": "uuid",
70
- "description": "Role receiving execution token"
71
- },
72
- "turn_number": {
73
- "type": "integer",
74
- "description": "Sequential turn number"
75
- },
76
- "token_id": {
77
- "type": "string",
78
- "format": "uuid",
79
- "description": "Execution token identifier"
80
- }
81
- },
82
- "required": [
83
- "role_id",
84
- "turn_number"
85
- ]
86
- },
87
- "turn_completed_payload": {
88
- "type": "object",
89
- "properties": {
90
- "role_id": {
91
- "type": "string",
92
- "format": "uuid",
93
- "description": "Role that completed the turn"
94
- },
95
- "turn_number": {
96
- "type": "integer",
97
- "description": "Sequential turn number"
98
- },
99
- "result": {
100
- "type": "object",
101
- "description": "Turn execution result"
102
- }
103
- },
104
- "required": [
105
- "role_id",
106
- "turn_number"
107
- ]
108
- },
109
- "broadcast_sent_payload": {
110
- "type": "object",
111
- "properties": {
112
- "broadcaster_role_id": {
113
- "type": "string",
114
- "description": "Role sending broadcast"
115
- },
116
- "target_count": {
117
- "type": "integer",
118
- "description": "Number of target agents"
119
- },
120
- "message": {
121
- "type": "object",
122
- "description": "Broadcast message content"
123
- }
124
- },
125
- "required": [
126
- "broadcaster_role_id",
127
- "target_count"
128
- ]
129
- },
130
- "broadcast_received_payload": {
131
- "type": "object",
132
- "properties": {
133
- "receiver_role_id": {
134
- "type": "string",
135
- "description": "Role that received broadcast"
136
- },
137
- "response": {
138
- "type": "object",
139
- "description": "Agent response to broadcast"
140
- }
141
- },
142
- "required": [
143
- "receiver_role_id"
144
- ]
145
- }
146
- }
147
- }
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://mplp.dev/schemas/v1.0/events/mplp-map-event.schema.json",
5
+ "title": "MPLP MAP Event v1.0",
6
+ "description": "Events emitted by Multi-Agent Profile (MAP) collaboration sessions 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
+ "MAPSessionStarted",
18
+ "MAPRolesAssigned",
19
+ "MAPTurnDispatched",
20
+ "MAPTurnCompleted",
21
+ "MAPBroadcastSent",
22
+ "MAPBroadcastReceived",
23
+ "MAPConflictDetected",
24
+ "MAPConflictResolved",
25
+ "MAPSessionCompleted"
26
+ ],
27
+ "description": "Type of MAP session lifecycle event"
28
+ },
29
+ "timestamp": {
30
+ "type": "string",
31
+ "format": "date-time",
32
+ "description": "ISO 8601 timestamp when event occurred"
33
+ },
34
+ "session_id": {
35
+ "type": "string",
36
+ "format": "uuid",
37
+ "description": "Collaboration session ID (corresponds to Collab.collab_id)"
38
+ },
39
+ "initiator_role": {
40
+ "type": "string",
41
+ "description": "Role ID of the initiating agent (optional, depends on event type)"
42
+ },
43
+ "target_roles": {
44
+ "type": "array",
45
+ "items": {
46
+ "type": "string"
47
+ },
48
+ "description": "Array of target role IDs for this event (e.g., broadcast targets)"
49
+ },
50
+ "payload": {
51
+ "type": "object",
52
+ "description": "Event-specific data payload",
53
+ "additionalProperties": true
54
+ }
55
+ },
56
+ "required": [
57
+ "event_id",
58
+ "event_type",
59
+ "timestamp",
60
+ "session_id"
61
+ ],
62
+ "additionalProperties": false,
63
+ "$defs": {
64
+ "turn_dispatched_payload": {
65
+ "type": "object",
66
+ "properties": {
67
+ "role_id": {
68
+ "type": "string",
69
+ "format": "uuid",
70
+ "description": "Role receiving execution token"
71
+ },
72
+ "turn_number": {
73
+ "type": "integer",
74
+ "description": "Sequential turn number"
75
+ },
76
+ "token_id": {
77
+ "type": "string",
78
+ "format": "uuid",
79
+ "description": "Execution token identifier"
80
+ }
81
+ },
82
+ "required": [
83
+ "role_id",
84
+ "turn_number"
85
+ ]
86
+ },
87
+ "turn_completed_payload": {
88
+ "type": "object",
89
+ "properties": {
90
+ "role_id": {
91
+ "type": "string",
92
+ "format": "uuid",
93
+ "description": "Role that completed the turn"
94
+ },
95
+ "turn_number": {
96
+ "type": "integer",
97
+ "description": "Sequential turn number"
98
+ },
99
+ "result": {
100
+ "type": "object",
101
+ "description": "Turn execution result"
102
+ }
103
+ },
104
+ "required": [
105
+ "role_id",
106
+ "turn_number"
107
+ ]
108
+ },
109
+ "broadcast_sent_payload": {
110
+ "type": "object",
111
+ "properties": {
112
+ "broadcaster_role_id": {
113
+ "type": "string",
114
+ "description": "Role sending broadcast"
115
+ },
116
+ "target_count": {
117
+ "type": "integer",
118
+ "description": "Number of target agents"
119
+ },
120
+ "message": {
121
+ "type": "object",
122
+ "description": "Broadcast message content"
123
+ }
124
+ },
125
+ "required": [
126
+ "broadcaster_role_id",
127
+ "target_count"
128
+ ]
129
+ },
130
+ "broadcast_received_payload": {
131
+ "type": "object",
132
+ "properties": {
133
+ "receiver_role_id": {
134
+ "type": "string",
135
+ "description": "Role that received broadcast"
136
+ },
137
+ "response": {
138
+ "type": "object",
139
+ "description": "Agent response to broadcast"
140
+ }
141
+ },
142
+ "required": [
143
+ "receiver_role_id"
144
+ ]
145
+ }
146
+ }
147
+ }
@@ -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: © 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://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: © 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://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
+ }