@mplp/sdk-ts 1.0.5 → 1.0.7

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@mplp/sdk-ts",
-  "version": "1.0.5",
-  "description": "TypeScript SDK and reference runtime for the MPLP Protocol v1.0.0 (Multi-Agent Lifecycle Protocol).",
+  "version": "1.0.7",
+  "description": "Public TypeScript SDK facade for MPLP Protocol v1.0.0; ships builders, runtime client helpers, schema mirrors, and Kernel Duty exports.",
   "license": "Apache-2.0",
-  "author": "Coregentis AI",
+  "author": "Bangshi Beijing Network Technology Limited Company",
   "repository": {
     "type": "git",
     "url": "https://github.com/Coregentis/MPLP-Protocol.git"
@@ -11,14 +11,15 @@
   "bugs": {
     "url": "https://github.com/Coregentis/MPLP-Protocol/issues"
   },
-  "homepage": "https://mplp.io",
+  "homepage": "https://www.mplp.io",
   "keywords": [
     "mplp",
     "multi-agent",
     "protocol",
     "ai agents",
     "lifecycle",
-    "runtime",
+    "sdk",
+    "facade",
     "typescript",
     "agent-os",
     "agent-os-protocol"
@@ -36,13 +37,22 @@
     "protocolVersion": "1.0.0",
     "frozen": true,
     "governance": "MPGC",
-    "layer": "Tools"
+    "layer": "Facade",
+    "packageClass": "PUBLIC",
+    "publishSurface": true,
+    "publishScope": "public-npm",
+    "sourcePackagePath": "packages/sources/sdk-ts",
+    "kernelDutyBaselineCarried": true
   },
   "scripts": {
     "build": "tsc",
-    "test": "vitest run"
+    "test": "echo 'No tests yet'"
   },
   "dependencies": {
+    "@mplp/core": "^1.0.6",
+    "@mplp/coordination": "^1.0.6",
+    "@mplp/runtime-minimal": "^1.0.5",
+    "@mplp/schema": "^1.0.6",
     "ajv": "^8.12.0",
     "ajv-formats": "^2.1.1",
     "chalk": "^4.1.2",
@@ -59,10 +69,16 @@
   },
   "exports": {
     ".": {
+      "require": "./dist/index.js",
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./kernel-duties": {
+      "require": "./dist/kernel-duties.js",
+      "import": "./dist/kernel-duties.js",
+      "types": "./dist/kernel-duties.d.ts"
     }
   },
   "sideEffects": false,
-  "copyright": "© 2025 邦士（北京）网络科技有限公司"
-}
+  "copyright": "© 2026 Bangshi Beijing Network Technology Limited Company"
+}

package/schemas/common/common-types.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$id": "https://schemas.mplp.dev/v1.0/common/common-types.schema.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "MPLP Common Types",

package/schemas/common/events.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$id": "https://schemas.mplp.dev/v1.0/common/events.schema.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "MPLP Base Event",

package/schemas/common/identifiers.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$id": "https://schemas.mplp.dev/v1.0/common/identifiers.schema.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "MPLP Identifier",

package/schemas/common/learning-sample.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://schemas.mplp.dev/v1.0/common/learning-sample.schema.json",
   "title": "MPLP Learning Sample – Schema v2.0",

package/schemas/common/metadata.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$id": "https://schemas.mplp.dev/v1.0/common/metadata.schema.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "MPLP Metadata",
@@ -77,16 +77,18 @@
     },
     "cross_cutting": {
       "type": "array",
-      "description": "Declares cross-cutting concerns enabled for the current object (one of the 9 concerns in Governance Plane).",
+      "description": "Declares cross-cutting concerns enabled for the current object (one of the 11 concerns in Governance Plane).",
       "items": {
         "type": "string",
         "enum": [
           "coordination",
           "error-handling",
           "event-bus",
+          "learning-feedback",
+          "observability",
           "orchestration",
           "performance",
-          "protocol-version",
+          "protocol-versioning",
           "security",
           "state-sync",
           "transaction"
@@ -116,4 +118,4 @@
     "freezeDate": "2025-12-03",
     "governance": "MPGC"
   }
-}
+}

package/schemas/common/trace-base.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$id": "https://schemas.mplp.dev/v1.0/common/trace-base.schema.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "MPLP Trace Base",

package/schemas/events/mplp-event-core.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/events/mplp-event-core.schema.json",
   "title": "MPLP Core Event v1.0",

package/schemas/events/mplp-graph-update-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/events/mplp-graph-update-event.schema.json",
   "title": "MPLP GraphUpdateEvent v1.0",

package/schemas/events/mplp-map-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/events/mplp-map-event.schema.json",
   "title": "MPLP MAP Event v1.0",

package/schemas/events/mplp-pipeline-stage-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/events/mplp-pipeline-stage-event.schema.json",
   "title": "MPLP PipelineStageEvent v1.0",

package/schemas/events/mplp-runtime-execution-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/events/mplp-runtime-execution-event.schema.json",
   "title": "MPLP RuntimeExecutionEvent v1.0",

package/schemas/events/mplp-sa-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/events/mplp-sa-event.schema.json",
   "title": "MPLP SA Event v1.0",

package/schemas/integration/mplp-ci-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/integration/mplp-ci-event.json",
   "title": "MPLP CI Event v1.0",

package/schemas/integration/mplp-file-update-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/integration/mplp-file-update-event.json",
   "title": "MPLP File Update Event v1.0",

package/schemas/integration/mplp-git-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/integration/mplp-git-event.json",
   "title": "MPLP Git Event v1.0",

package/schemas/integration/mplp-tool-event.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "MPLP v1.0.0 FROZEN – © 2025 邦士（北京）网络科技有限公司 – Apache-2.0 – Governance: MPGC",
+  "$comment": "MPLP v1.0.0 FROZEN – © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0 – Governance: MPGC",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://mplp.dev/schemas/v1.0/integration/mplp-tool-event.json",
   "title": "MPLP Tool Event v1.0",

package/schemas/invariants/integration-invariants.yaml

@@ -1,147 +1,139 @@
 # MPLP v1.0.0 FROZEN – Invariant Set
-# © 2025 邦士（北京）网络科技有限公司 – Apache-2.0
+# © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0
 # Governance: MPLP Protocol Governance Committee (MPGC)
 
-# MPLP Protocol v1.0.0 — Frozen Specification
-# Freeze Date: 2025-12-03
-# Status: FROZEN (no breaking changes permitted)
-# Governance: MPLP Protocol Governance Committee (MPGC)
-# © 2025 邦士（北京）网络科技有限公司
-# License: Apache-2.0
-# Any normative change requires a new protocol version.
-
-# MPLP Protocol 1.0.0 — Frozen Specification
-# Status: Frozen as of 2025-11-30
-# Copyright: © 2025 邦士（北京）网络科技有限公司
-# License: Apache-2.0 (see LICENSE at repository root)
-# Any normative change requires a new protocol version.
-
-invariants:
-  # ========================================
-  # Tool Event Invariants
-  # ========================================
-  - id: integration_tool_event_id_non_empty
-    scope: tool_event
-    path: tool_id
-    rule: non-empty-string
-    description: "Tool event must have non-empty tool_id"
-
-  - id: integration_tool_kind_valid
-    scope: tool_event
-    path: tool_kind
-    rule: enum(formatter,linter,test_runner,generator,other)
-    description: "Tool kind must be valid enum value"
-
-  - id: integration_tool_invocation_id_uuid
-    scope: tool_event
-    path: invocation_id
-    rule: uuid-v4
-    description: "Tool invocation_id must be UUID v4"
-
-  - id: integration_tool_status_valid
-    scope: tool_event
-    path: status
-    rule: enum(pending,running,succeeded,failed,cancelled)
-    description: "Tool event status must be valid enum value"
-
-  - id: integration_tool_started_at_iso
-    scope: tool_event
-    path: started_at
-    rule: iso-datetime
-    description: "If started_at present, must be ISO 8601 datetime"
-    note: "Apply only when started_at field exists"
-
-  # ========================================
-  # File Update Event Invariants
-  # ========================================
-  - id: integration_file_path_non_empty
-    scope: file_update_event
-    path: file_path
-    rule: non-empty-string
-    description: "File update event must have non-empty file_path"
-
-  - id: integration_file_change_type_valid
-    scope: file_update_event
-    path: change_type
-    rule: enum(created,modified,deleted,renamed)
-    description: "File change_type must be valid enum value"
-
-  - id: integration_file_timestamp_iso
-    scope: file_update_event
-    path: timestamp
-    rule: iso-datetime
-    description: "File update timestamp must be ISO 8601 datetime"
-
-  # ========================================
-  # Git Event Invariants
-  # ========================================
-  - id: integration_git_repo_url_non_empty
-    scope: git_event
-    path: repo_url
-    rule: non-empty-string
-    description: "Git event must have non-empty repo_url"
-
-  - id: integration_git_commit_id_non_empty
-    scope: git_event
-    path: commit_id
-    rule: non-empty-string
-    description: "Git event must have non-empty commit_id"
-
-  - id: integration_git_ref_name_non_empty
-    scope: git_event
-    path: ref_name
-    rule: non-empty-string
-    description: "Git event must have non-empty ref_name"
-
-  - id: integration_git_event_kind_valid
-    scope: git_event
-    path: event_kind
-    rule: enum(commit,push,merge,tag,branch_create,branch_delete)
-    description: "Git event_kind must be valid enum value"
-
-  - id: integration_git_timestamp_iso
-    scope: git_event
-    path: timestamp
-    rule: iso-datetime
-    description: "Git event timestamp must be ISO 8601 datetime"
-
-  # ========================================
-  # CI Event Invariants
-  # ========================================
-  - id: integration_ci_provider_non_empty
-    scope: ci_event
-    path: ci_provider
-    rule: non-empty-string
-    description: "CI event must have non-empty ci_provider"
-
-  - id: integration_ci_pipeline_id_non_empty
-    scope: ci_event
-    path: pipeline_id
-    rule: non-empty-string
-    description: "CI event must have non-empty pipeline_id"
-
-  - id: integration_ci_run_id_non_empty
-    scope: ci_event
-    path: run_id
-    rule: non-empty-string
-    description: "CI event must have non-empty run_id"
-
-  - id: integration_ci_status_valid
-    scope: ci_event
-    path: status
-    rule: enum(pending,running,succeeded,failed,cancelled)
-    description: "CI event status must be valid enum value"
-
-  - id: integration_ci_started_at_iso
-    scope: ci_event
-    path: started_at
-    rule: iso-datetime
-    description: "If started_at present, must be ISO 8601 datetime"
-    note: "Apply only when started_at field exists"
-
-  - id: integration_ci_completed_at_iso
-    scope: ci_event
-    path: completed_at
-    rule: iso-datetime
-    description: "If completed_at present, must be ISO 8601 datetime"
-    note: "Apply only when completed_at field exists"
+# MPLP Protocol 1.0.0 — Frozen Specification
+# Status: Frozen as of 2025-11-30
+# Copyright: © 2026 Bangshi Beijing Network Technology Limited Company
+# License: Apache-2.0 (see LICENSE at repository root)
+# Any normative change requires a new protocol version.
+
+invariants:
+  # ========================================
+  # Tool Event Invariants
+  # ========================================
+  - id: integration_tool_event_id_non_empty
+    scope: tool_event
+    path: tool_id
+    rule: non-empty-string
+    description: "Tool event must have non-empty tool_id"
+
+  - id: integration_tool_kind_valid
+    scope: tool_event
+    path: tool_kind
+    rule: enum(formatter,linter,test_runner,generator,other)
+    description: "Tool kind must be valid enum value"
+
+  - id: integration_tool_invocation_id_uuid
+    scope: tool_event
+    path: invocation_id
+    rule: uuid-v4
+    description: "Tool invocation_id must be UUID v4"
+
+  - id: integration_tool_status_valid
+    scope: tool_event
+    path: status
+    rule: enum(pending,running,succeeded,failed,cancelled)
+    description: "Tool event status must be valid enum value"
+
+  - id: integration_tool_started_at_iso
+    scope: tool_event
+    path: started_at
+    rule: iso-datetime
+    description: "If started_at present, must be ISO 8601 datetime"
+    note: "Apply only when started_at field exists"
+
+  # ========================================
+  # File Update Event Invariants
+  # ========================================
+  - id: integration_file_path_non_empty
+    scope: file_update_event
+    path: file_path
+    rule: non-empty-string
+    description: "File update event must have non-empty file_path"
+
+  - id: integration_file_change_type_valid
+    scope: file_update_event
+    path: change_type
+    rule: enum(created,modified,deleted,renamed)
+    description: "File change_type must be valid enum value"
+
+  - id: integration_file_timestamp_iso
+    scope: file_update_event
+    path: timestamp
+    rule: iso-datetime
+    description: "File update timestamp must be ISO 8601 datetime"
+
+  # ========================================
+  # Git Event Invariants
+  # ========================================
+  - id: integration_git_repo_url_non_empty
+    scope: git_event
+    path: repo_url
+    rule: non-empty-string
+    description: "Git event must have non-empty repo_url"
+
+  - id: integration_git_commit_id_non_empty
+    scope: git_event
+    path: commit_id
+    rule: non-empty-string
+    description: "Git event must have non-empty commit_id"
+
+  - id: integration_git_ref_name_non_empty
+    scope: git_event
+    path: ref_name
+    rule: non-empty-string
+    description: "Git event must have non-empty ref_name"
+
+  - id: integration_git_event_kind_valid
+    scope: git_event
+    path: event_kind
+    rule: enum(commit,push,merge,tag,branch_create,branch_delete)
+    description: "Git event_kind must be valid enum value"
+
+  - id: integration_git_timestamp_iso
+    scope: git_event
+    path: timestamp
+    rule: iso-datetime
+    description: "Git event timestamp must be ISO 8601 datetime"
+
+  # ========================================
+  # CI Event Invariants
+  # ========================================
+  - id: integration_ci_provider_non_empty
+    scope: ci_event
+    path: ci_provider
+    rule: non-empty-string
+    description: "CI event must have non-empty ci_provider"
+
+  - id: integration_ci_pipeline_id_non_empty
+    scope: ci_event
+    path: pipeline_id
+    rule: non-empty-string
+    description: "CI event must have non-empty pipeline_id"
+
+  - id: integration_ci_run_id_non_empty
+    scope: ci_event
+    path: run_id
+    rule: non-empty-string
+    description: "CI event must have non-empty run_id"
+
+  - id: integration_ci_status_valid
+    scope: ci_event
+    path: status
+    rule: enum(pending,running,succeeded,failed,cancelled)
+    description: "CI event status must be valid enum value"
+
+  - id: integration_ci_started_at_iso
+    scope: ci_event
+    path: started_at
+    rule: iso-datetime
+    description: "If started_at present, must be ISO 8601 datetime"
+    note: "Apply only when started_at field exists"
+
+  - id: integration_ci_completed_at_iso
+    scope: ci_event
+    path: completed_at
+    rule: iso-datetime
+    description: "If completed_at present, must be ISO 8601 datetime"
+    note: "Apply only when completed_at field exists"