@mhome/messaging-protocol 0.14.0

package/fixtures/setup-start.response.json

@@ -0,0 +1,12 @@
+{
+  "target": "/messaging/setup/start",
+  "direction": "response",
+  "body": {
+    "setup": {
+      "setupId": "setup-1",
+      "status": "action_required",
+      "expiresAtMs": 1893456000000,
+      "providerData": { "pairingCode": "ABCD" }
+    }
+  }
+}

package/fixtures/setup-status.request.json

@@ -0,0 +1,5 @@
+{
+  "target": "/messaging/setup/status",
+  "direction": "request",
+  "body": { "provider": "telegram", "placement": "local", "setupId": "setup-1" }
+}

package/fixtures/setup-status.response.json

@@ -0,0 +1,14 @@
+{
+  "target": "/messaging/setup/status",
+  "direction": "response",
+  "body": {
+    "setup": {
+      "setupId": "setup-1",
+      "status": "complete",
+      "providerData": {},
+      "accountId": "official-bot",
+      "routeId": "route-1",
+      "message": "Connected"
+    }
+  }
+}

package/fixtures/shared-account-grant-create.request.json

@@ -0,0 +1,5 @@
+{
+  "target": "/messaging/shared-account-grant/create",
+  "direction": "request",
+  "body": { "provider": "telegram", "placement": "local", "accountId": "123456" }
+}

package/fixtures/shared-account-grant-create.response.json

@@ -0,0 +1,5 @@
+{
+  "target": "/messaging/shared-account-grant/create",
+  "direction": "response",
+  "body": { "success": true }
+}

package/fixtures/shared-account-grant-delete.request.json

@@ -0,0 +1,5 @@
+{
+  "target": "/messaging/shared-account-grant/delete",
+  "direction": "request",
+  "body": { "provider": "telegram", "placement": "local", "accountId": "123456" }
+}

package/fixtures/shared-account-grant-delete.response.json

@@ -0,0 +1,5 @@
+{
+  "target": "/messaging/shared-account-grant/delete",
+  "direction": "response",
+  "body": { "success": true }
+}

package/fixtures/shared-account-grant-list.request.json

@@ -0,0 +1,5 @@
+{
+  "target": "/messaging/shared-account-grant/list",
+  "direction": "request",
+  "body": { "provider": "telegram", "placement": "local", "accountId": "123456" }
+}

package/fixtures/shared-account-grant-list.response.json

@@ -0,0 +1,9 @@
+{
+  "target": "/messaging/shared-account-grant/list",
+  "direction": "response",
+  "body": {
+    "grants": [
+      { "provider": "telegram", "placement": "local", "accountId": "123456", "tenantId": "tenant-1", "scopeId": "scope-1", "grantedByUserId": "user-1", "createdAtMs": 1787961600000, "updatedAtMs": 1787961600000 }
+    ]
+  }
+}

package/fixtures/surface-bind-code-create.request.json

@@ -0,0 +1 @@
+{"target":"/messaging/surface/bind-code/create","direction":"request","body":{"provider":"feishu","placement":"local","surfaceId":"cs1:mg:feishu:Y2xpX2E:Y2hhdF9h","scopeId":"scope_a"}}

package/fixtures/surface-bind-code-create.response.json

@@ -0,0 +1 @@
+{"target":"/messaging/surface/bind-code/create","direction":"response","body":{"challenge":{"code":"M7K9Q2","command":"/bind M7K9Q2","expiresAtMs":1720000300000}}}

package/fixtures/surface-dismiss.request.json

@@ -0,0 +1 @@
+{"target":"/messaging/surface/dismiss","direction":"request","body":{"provider":"feishu","placement":"local","surfaceId":"cs1:mg:feishu:Y2xpX2E:Y2hhdF9h"}}

package/fixtures/surface-dismiss.response.json

@@ -0,0 +1 @@
+{"target":"/messaging/surface/dismiss","direction":"response","body":{"success":true}}

package/fixtures/surface-list.request.json

@@ -0,0 +1 @@
+{"target":"/messaging/surface/list","direction":"request","body":{"provider":"feishu","placement":"local","state":"pending"}}

package/fixtures/surface-list.response.json

@@ -0,0 +1 @@
+{"target":"/messaging/surface/list","direction":"response","body":{"surfaces":[{"provider":"feishu","placement":"local","accountId":"cli_a","surfaceId":"cs1:mg:feishu:Y2xpX2E:Y2hhdF9h","displayName":"Project room","state":"pending","firstSeenAtMs":1720000000000,"lastSeenAtMs":1720000001000}]}}

package/manifest/targets.v1.json

@@ -0,0 +1,57 @@
+{
+  "manifest": "mhome.messaging.targets.v1",
+  "contractVersion": "0.14.0",
+  "requestTargets": [
+    "/messaging/provider/list",
+    "/messaging/provider-account/list",
+    "/messaging/provider-account/update",
+    "/messaging/provider-account/delete",
+    "/messaging/provider-account/test",
+    "/messaging/provider-account/status",
+    "/messaging/shared-account-grant/create",
+    "/messaging/shared-account-grant/delete",
+    "/messaging/shared-account-grant/list",
+    "/messaging/route/list",
+    "/messaging/route/update",
+    "/messaging/route/delete",
+    "/messaging/setup/options",
+    "/messaging/setup/start",
+    "/messaging/setup/status",
+    "/messaging/surface/list",
+    "/messaging/surface/dismiss",
+    "/messaging/surface/bind-code/create",
+    "/messaging/actor/link-code/create",
+    "/messaging/actor/link-claim/status",
+    "/messaging/actor/link-claim/confirm",
+    "/messaging/actor/link/list",
+    "/messaging/actor/link/delete"
+  ],
+  "responseTargets": [
+    "/messaging/provider/list",
+    "/messaging/provider-account/list",
+    "/messaging/provider-account/update",
+    "/messaging/provider-account/delete",
+    "/messaging/provider-account/test",
+    "/messaging/provider-account/status",
+    "/messaging/shared-account-grant/create",
+    "/messaging/shared-account-grant/delete",
+    "/messaging/shared-account-grant/list",
+    "/messaging/route/list",
+    "/messaging/route/update",
+    "/messaging/route/delete",
+    "/messaging/setup/options",
+    "/messaging/setup/start",
+    "/messaging/setup/status",
+    "/messaging/surface/list",
+    "/messaging/surface/dismiss",
+    "/messaging/surface/bind-code/create",
+    "/messaging/actor/link-code/create",
+    "/messaging/actor/link-claim/status",
+    "/messaging/actor/link-claim/confirm",
+    "/messaging/actor/link/list",
+    "/messaging/actor/link/delete"
+  ],
+  "eventTargets": [
+    "/messaging/actor/link-claim/event"
+  ]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@mhome/messaging-protocol",
+  "version": "0.14.0",
+  "description": "Build-time protocol artifacts for mhome.messaging",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mhome-ai/foundation.git",
+    "directory": "crates/messaging-api"
+  },
+  "homepage": "https://github.com/mhome-ai/foundation#readme",
+  "bugs": {
+    "url": "https://github.com/mhome-ai/foundation/issues"
+  },
+  "keywords": [
+    "mhome",
+    "protocol",
+    "json-schema",
+    "fixtures"
+  ],
+  "private": false,
+  "files": [
+    "protocol.json",
+    "manifest",
+    "contract",
+    "schema",
+    "fixtures",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./protocol.json": "./protocol.json",
+    "./manifest/*": "./manifest/*",
+    "./contract/*": "./contract/*",
+    "./schema/*": "./schema/*",
+    "./fixtures/*": "./fixtures/*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/protocol.json

@@ -0,0 +1,16 @@
+{
+  "protocol": "mhome.messaging",
+  "contractVersion": "0.14.0",
+  "manifest": "manifest/targets.v1.json",
+  "schemas": {
+    "frame": "schema/messaging-frame.v3.schema.json",
+    "normalizedInbound": "schema/normalized-inbound.v4.schema.json",
+    "messagingCommands": "schema/messaging-commands.v1.schema.json"
+  },
+  "fixtures": {
+    "valid": "fixtures",
+    "invalid": "fixtures/invalid",
+    "normalizedInbound": "fixtures/normalized-inbound.conformance.json",
+    "messagingCommands": "fixtures/messaging-commands.conformance.json"
+  }
+}

package/schema/messaging-commands.v1.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:mhome:messaging-api:commands:v1",
+  "title": "mHome messaging command conformance corpus v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "parseCases", "orderingCases"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "parseCases": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "input", "result"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "input": { "type": "string" },
+          "result": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["kind"],
+                "properties": { "kind": { "enum": ["not_command", "invalid_switch"] } }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["kind", "command"],
+                "properties": {
+                  "kind": { "const": "command" },
+                  "command": { "enum": ["info", "help", "rotate"] }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["kind", "command", "selection"],
+                "properties": {
+                  "kind": { "const": "command" },
+                  "command": { "const": "switch" },
+                  "selection": { "type": "integer", "minimum": 1 }
+                }
+              }
+            ]
+          }
+        }
+      }
+    },
+    "orderingCases": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "scopeIds", "expected"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "scopeIds": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+          "expected": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+        }
+      }
+    }
+  }
+}