@mplp/sdk-ts 1.0.5 → 1.0.7

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 (44) hide show
  1. package/CHANGELOG.md +1 -5
  2. package/LICENSE +17 -0
  3. package/LICENSE.txt +201 -201
  4. package/README.md +61 -20
  5. package/dist/index.d.ts +1 -0
  6. package/dist/index.js +1 -0
  7. package/dist/kernel-duties.d.ts +1 -0
  8. package/dist/kernel-duties.js +7 -0
  9. package/package.json +25 -9
  10. package/schemas/common/common-types.schema.json +1 -1
  11. package/schemas/common/events.schema.json +1 -1
  12. package/schemas/common/identifiers.schema.json +1 -1
  13. package/schemas/common/learning-sample.schema.json +1 -1
  14. package/schemas/common/metadata.schema.json +6 -4
  15. package/schemas/common/trace-base.schema.json +1 -1
  16. package/schemas/events/mplp-event-core.schema.json +1 -1
  17. package/schemas/events/mplp-graph-update-event.schema.json +1 -1
  18. package/schemas/events/mplp-map-event.schema.json +1 -1
  19. package/schemas/events/mplp-pipeline-stage-event.schema.json +1 -1
  20. package/schemas/events/mplp-runtime-execution-event.schema.json +1 -1
  21. package/schemas/events/mplp-sa-event.schema.json +1 -1
  22. package/schemas/integration/mplp-ci-event.schema.json +1 -1
  23. package/schemas/integration/mplp-file-update-event.schema.json +1 -1
  24. package/schemas/integration/mplp-git-event.schema.json +1 -1
  25. package/schemas/integration/mplp-tool-event.schema.json +1 -1
  26. package/schemas/invariants/integration-invariants.yaml +136 -144
  27. package/schemas/invariants/learning-invariants.yaml +95 -103
  28. package/schemas/invariants/map-invariants.yaml +62 -70
  29. package/schemas/invariants/observability-invariants.yaml +95 -103
  30. package/schemas/invariants/sa-invariants.yaml +61 -69
  31. package/schemas/kernel-duties.json +18 -0
  32. package/schemas/learning/mplp-learning-sample-core.schema.json +1 -1
  33. package/schemas/learning/mplp-learning-sample-delta.schema.json +1 -1
  34. package/schemas/learning/mplp-learning-sample-intent.schema.json +1 -1
  35. package/schemas/mplp-collab.schema.json +1 -1
  36. package/schemas/mplp-confirm.schema.json +1 -1
  37. package/schemas/mplp-context.schema.json +1 -1
  38. package/schemas/mplp-core.schema.json +1 -1
  39. package/schemas/mplp-dialog.schema.json +1 -1
  40. package/schemas/mplp-extension.schema.json +1 -1
  41. package/schemas/mplp-network.schema.json +1 -1
  42. package/schemas/mplp-plan.schema.json +1 -1
  43. package/schemas/mplp-role.schema.json +1 -1
  44. package/schemas/mplp-trace.schema.json +1 -1
@@ -1,72 +1,64 @@
1
1
  # MPLP v1.0.0 FROZEN – Invariant Set
2
- # © 2025 邦士(北京)网络科技有限公司 – Apache-2.0
2
+ # © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0
3
3
  # Governance: MPLP Protocol Governance Committee (MPGC)
4
4
 
5
- # MPLP Protocol v1.0.0 — Frozen Specification
6
- # Freeze Date: 2025-12-03
7
- # Status: FROZEN (no breaking changes permitted)
8
- # Governance: MPLP Protocol Governance Committee (MPGC)
9
- # © 2025 邦士(北京)网络科技有限公司
10
- # License: Apache-2.0
11
- # Any normative change requires a new protocol version.
12
-
13
- # MPLP Protocol 1.0.0 — Frozen Specification
14
- # Status: Frozen as of 2025-11-30
15
- # Copyright: © 2025 邦士(北京)网络科技有限公司
16
- # License: Apache-2.0 (see LICENSE at repository root)
17
- # Any normative change requires a new protocol version.
18
-
19
- invariants:
20
- - id: sa_requires_context
21
- scope: context
22
- path: context_id
23
- rule: uuid-v4
24
- description: "SA execution requires a valid Context with UUID v4 identifier"
25
-
26
- - id: sa_context_must_be_active
27
- scope: context
28
- path: status
29
- rule: enum(active)
30
- description: "SA can only execute when Context status is 'active'"
31
-
32
- - id: sa_plan_context_binding
33
- scope: plan
34
- path: context_id
35
- rule: eq(context.context_id)
36
- description: "Plan's context_id must match SA's loaded Context"
37
-
38
- - id: sa_plan_has_steps
39
- scope: plan
40
- path: steps
41
- rule: min-length(1)
42
- description: "Plan must contain at least one executable step"
43
-
44
- - id: sa_steps_have_valid_ids
45
- scope: plan
46
- path: steps[*].step_id
47
- rule: uuid-v4
48
- description: "All plan steps must have valid UUID v4 identifiers"
49
-
50
- - id: sa_steps_have_agent_role
51
- scope: plan
52
- path: steps[*].agent_role
53
- rule: non-empty-string
54
- description: "All steps must specify an agent_role for executor selection"
55
-
56
- - id: sa_trace_not_empty
57
- scope: trace
58
- path: events
59
- rule: min-length(1)
60
- description: "SA must emit at least one trace event before completion"
61
-
62
- - id: sa_trace_context_binding
63
- scope: trace
64
- path: context_id
65
- rule: eq(context.context_id)
66
- description: "Trace context_id must match SA's Context"
67
-
68
- - id: sa_trace_plan_binding
69
- scope: trace
70
- path: plan_id
71
- rule: eq(plan.plan_id)
72
- description: "Trace plan_id must match SA's Plan"
5
+ # MPLP Protocol 1.0.0 — Frozen Specification
6
+ # Status: Frozen as of 2025-11-30
7
+ # Copyright: © 2026 Bangshi Beijing Network Technology Limited Company
8
+ # License: Apache-2.0 (see LICENSE at repository root)
9
+ # Any normative change requires a new protocol version.
10
+
11
+ invariants:
12
+ - id: sa_requires_context
13
+ scope: context
14
+ path: context_id
15
+ rule: uuid-v4
16
+ description: "SA execution requires a valid Context with UUID v4 identifier"
17
+
18
+ - id: sa_context_must_be_active
19
+ scope: context
20
+ path: status
21
+ rule: enum(active)
22
+ description: "SA can only execute when Context status is 'active'"
23
+
24
+ - id: sa_plan_context_binding
25
+ scope: plan
26
+ path: context_id
27
+ rule: eq(context.context_id)
28
+ description: "Plan's context_id must match SA's loaded Context"
29
+
30
+ - id: sa_plan_has_steps
31
+ scope: plan
32
+ path: steps
33
+ rule: min-length(1)
34
+ description: "Plan must contain at least one executable step"
35
+
36
+ - id: sa_steps_have_valid_ids
37
+ scope: plan
38
+ path: steps[*].step_id
39
+ rule: uuid-v4
40
+ description: "All plan steps must have valid UUID v4 identifiers"
41
+
42
+ - id: sa_steps_have_agent_role
43
+ scope: plan
44
+ path: steps[*].agent_role
45
+ rule: non-empty-string
46
+ description: "All steps must specify an agent_role for executor selection"
47
+
48
+ - id: sa_trace_not_empty
49
+ scope: trace
50
+ path: events
51
+ rule: min-length(1)
52
+ description: "SA must emit at least one trace event before completion"
53
+
54
+ - id: sa_trace_context_binding
55
+ scope: trace
56
+ path: context_id
57
+ rule: eq(context.context_id)
58
+ description: "Trace context_id must match SA's Context"
59
+
60
+ - id: sa_trace_plan_binding
61
+ scope: trace
62
+ path: plan_id
63
+ rule: eq(plan.plan_id)
64
+ description: "Trace plan_id must match SA's Plan"
@@ -0,0 +1,18 @@
1
+ {
2
+ "protocol_version": "1.0.0",
3
+ "source_of_truth": "schemas/v2/taxonomy/kernel-duties.yaml",
4
+ "count": 11,
5
+ "duties": [
6
+ { "id": "KD-01", "name": "Coordination", "slug": "coordination" },
7
+ { "id": "KD-02", "name": "Error Handling", "slug": "error-handling" },
8
+ { "id": "KD-03", "name": "Event Bus", "slug": "event-bus" },
9
+ { "id": "KD-04", "name": "Learning Feedback", "slug": "learning-feedback" },
10
+ { "id": "KD-05", "name": "Observability", "slug": "observability" },
11
+ { "id": "KD-06", "name": "Orchestration", "slug": "orchestration" },
12
+ { "id": "KD-07", "name": "Performance", "slug": "performance" },
13
+ { "id": "KD-08", "name": "Protocol Versioning", "slug": "protocol-versioning" },
14
+ { "id": "KD-09", "name": "Security", "slug": "security" },
15
+ { "id": "KD-10", "name": "State Sync", "slug": "state-sync" },
16
+ { "id": "KD-11", "name": "Transaction", "slug": "transaction" }
17
+ ]
18
+ }
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-core.schema.json",
5
5
  "title": "MPLP LearningSample Core v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-delta.schema.json",
5
5
  "title": "MPLP LearningSample – Delta Impact v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-intent.schema.json",
5
5
  "title": "MPLP LearningSample – Intent Resolution v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-collab.schema.json",
5
5
  "title": "MPLP Collab Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-confirm.schema.json",
5
5
  "title": "MPLP Confirm Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-context.schema.json",
5
5
  "title": "MPLP Context Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-core.schema.json",
5
5
  "title": "MPLP Core Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-dialog.schema.json",
5
5
  "title": "MPLP Dialog Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-extension.schema.json",
5
5
  "title": "MPLP Extension Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-network.schema.json",
5
5
  "title": "MPLP Network Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-plan.schema.json",
5
5
  "title": "MPLP Plan Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-role.schema.json",
5
5
  "title": "MPLP Role Module – Core Protocol v1.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士(北京)网络科技有限公司 – Apache-2.0 – Governance: MPGC",
2
+ "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "$id": "https://schemas.mplp.dev/v1.0/mplp-trace.schema.json",
5
5
  "title": "MPLP Trace Module – Core Protocol v1.0",