@mhome/artifact-protocol 1.2.0 → 1.3.0

package/README.md

@@ -15,3 +15,5 @@ cloud object store or an authenticated local streaming endpoint.
 
 TTL, storage placement, filesystem paths, signed URLs, and cloud object keys are
 runtime concerns and are deliberately not encoded into an artifact reference.
+
+Capability media values (`Image`, `Audio`) use `MediaReference`: exactly `{ "uri": "meow-artifact://v1/..." }`. The reference has no URL, inline bytes, MIME or creation timestamp fields. Parse and check kind and tenant/scope at capability boundaries; do not implicitly import media. Upload bytes with `PutArtifactRequest` or explicitly download finite HTTP(S) content with `ImportArtifactRequest` via `/app/artifact/put` and `/app/artifact/import`. Storage metadata and upload transports retain their MIME and byte fields. Resolve to temporary delivery URLs only at consumers. Conversation media sources retain their existing tagged artifact protocol. Video storage remains unsupported by the runtimes.

package/manifest/artifact.v1.json

@@ -1,8 +1,13 @@
 {
   "manifest": "mhome.artifact.v1",
-  "contractVersion": "1.2.0",
+  "contractVersion": "1.3.0",
   "uriPrefix": "meow-artifact://v1/",
-  "kinds": ["image", "audio", "video", "file"],
+  "kinds": [
+    "image",
+    "audio",
+    "video",
+    "file"
+  ],
   "resolve": {
     "target": "/artifact/resolve",
     "schema": "schema/artifact-resolve.v1.schema.json",
@@ -17,5 +22,13 @@
     "target": "/artifact/upload/prepare",
     "schema": "schema/artifact-upload.v1.schema.json",
     "schemaVersion": 1
+  },
+  "mediaReference": {
+    "schema": "schema/media-reference.v1.schema.json",
+    "schemaVersion": 1
+  },
+  "import": {
+    "schema": "schema/artifact-import.v1.schema.json",
+    "schemaVersion": 1
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/artifact-protocol",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Build-time protocol artifacts for mhome.artifact",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,11 +1,13 @@
 {
   "protocol": "mhome.artifact",
-  "contractVersion": "1.2.0",
+  "contractVersion": "1.3.0",
   "manifest": "manifest/artifact.v1.json",
   "schemas": {
     "artifactMetadata": "schema/artifact-metadata.v1.schema.json",
     "artifactResolve": "schema/artifact-resolve.v1.schema.json",
     "artifactPut": "schema/artifact-put.v1.schema.json",
+    "artifactImport": "schema/artifact-import.v1.schema.json",
+    "mediaReference": "schema/media-reference.v1.schema.json",
     "artifactUpload": "schema/artifact-upload.v1.schema.json"
   },
   "fixtures": {

package/schema/artifact-import.v1.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mhome.ai/schema/artifact-import.v1.schema.json",
+  "title": "MeowLink artifact import request",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind",
+    "sourceUrl"
+  ],
+  "properties": {
+    "kind": {
+      "enum": [
+        "IMAGE",
+        "AUDIO",
+        "FILE"
+      ]
+    },
+    "sourceUrl": {
+      "type": "string",
+      "pattern": "^https?://",
+      "minLength": 8
+    },
+    "mimeType": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 255
+    }
+  }
+}

package/schema/media-reference.v1.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mhome.ai/schema/media-reference.v1.schema.json",
+  "title": "MeowLink media reference",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "uri"
+  ],
+  "properties": {
+    "uri": {
+      "type": "string",
+      "pattern": "^meow-artifact://v1/",
+      "maxLength": 2048
+    }
+  }
+}