@clowder-ai/plugin-contract 0.1.0-beta.8 → 0.2.0

package/src/schemas/plugin-metadata.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://clowder-ai.dev/schemas/plugin-metadata/v1",
+  "title": "Clowder AI Plugin Product Metadata (v1)",
+  "description": "Manifest-owned static product metadata projected into the repository catalog for Agent, Console, and Marketplace discovery.",
+  "$defs": {
+    "LocalizedDescriptionObject": {
+      "type": "object",
+      "properties": {
+        "default": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "translations": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$"
+          },
+          "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 4096 },
+          "minProperties": 1,
+          "maxProperties": 32
+        }
+      },
+      "required": ["default", "translations"],
+      "additionalProperties": false
+    },
+    "LocalizedDescription": {
+      "oneOf": [
+        { "type": "string", "minLength": 1, "maxLength": 4096 },
+        { "$ref": "#/$defs/LocalizedDescriptionObject" }
+      ]
+    },
+    "PackageAssetPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*(/[A-Za-z0-9][A-Za-z0-9._-]*)*$"
+    },
+    "PackageIcon": {
+      "type": "object",
+      "properties": {
+        "type": { "type": "string", "enum": ["svg", "png"] },
+        "src": { "$ref": "#/$defs/PackageAssetPath" }
+      },
+      "required": ["type", "src"],
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "svg" } }, "required": ["type"] },
+          "then": { "properties": { "src": { "pattern": "\\.svg$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "png" } }, "required": ["type"] },
+          "then": { "properties": { "src": { "pattern": "\\.png$" } } }
+        }
+      ]
+    },
+    "PluginIcon": {
+      "oneOf": [
+        { "const": "github" },
+        { "$ref": "#/$defs/PackageIcon" }
+      ]
+    }
+  }
+}

package/src/schemas/signal.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://clowder-ai.dev/schemas/signals/v0.2",
+  "title": "Clowder AI Signal Declarations",
+  "description": "Manifest-only signal declarations and contribution metadata. Runtime publication is not part of this schema.",
+  "x-clowder-forbidden-privacy-classes": [
+    "av-raw",
+    "input-raw"
+  ],
+  "x-clowder-forbidden-source-classes": [
+    "av-capture",
+    "input-hardware"
+  ],
+  "$defs": {
+    "SignalType": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_-]*)+$"
+    },
+    "SignalSchemaRef": {
+      "type": "string",
+      "description": "Package-local content schema reference declared in manifest metadata.",
+      "minLength": 21,
+      "maxLength": 256,
+      "pattern": "^schemas/([A-Za-z0-9][A-Za-z0-9._-]*/)*[A-Za-z0-9][A-Za-z0-9._-]*\\.schema\\.json$"
+    },
+    "SignalEpistemicStatus": {
+      "type": "string",
+      "enum": [
+        "observation",
+        "inference"
+      ]
+    },
+    "SignalPrivacyClass": {
+      "type": "string",
+      "enum": [
+        "behavioral",
+        "content-adjacent",
+        "content",
+        "av-raw",
+        "input-raw"
+      ]
+    },
+    "AdmissibleSignalPrivacyClass": {
+      "type": "string",
+      "enum": [
+        "behavioral",
+        "content-adjacent",
+        "content"
+      ]
+    },
+    "SignalSourceClass": {
+      "type": "string",
+      "enum": [
+        "os-metadata",
+        "accessibility-api",
+        "remote-service",
+        "av-capture",
+        "input-hardware"
+      ]
+    },
+    "AdmissibleSignalSourceClass": {
+      "type": "string",
+      "enum": [
+        "os-metadata",
+        "accessibility-api",
+        "remote-service"
+      ]
+    },
+    "SignalDeclaration": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "$ref": "#/$defs/SignalType"
+        },
+        "schemaRef": {
+          "$ref": "#/$defs/SignalSchemaRef"
+        },
+        "epistemicStatus": {
+          "$ref": "#/$defs/SignalEpistemicStatus"
+        },
+        "privacyClass": {
+          "$ref": "#/$defs/AdmissibleSignalPrivacyClass"
+        },
+        "sourceClass": {
+          "$ref": "#/$defs/AdmissibleSignalSourceClass"
+        }
+      },
+      "required": [
+        "type",
+        "schemaRef",
+        "epistemicStatus",
+        "privacyClass",
+        "sourceClass"
+      ],
+      "additionalProperties": false
+    },
+    "SignalContribution": {
+      "type": "object",
+      "properties": {
+        "provides": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/SignalDeclaration"
+          },
+          "minItems": 1,
+          "maxItems": 64,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "provides"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$ref": "#/$defs/SignalContribution"
+}