@adea-ai/plugins 1.0.0

package/schemas/catalog.v1.schema.json

@@ -0,0 +1,407 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hq.example/schemas/catalog.v1.schema.json",
+  "title": "Agent HQ Plugin Catalog v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "catalogId", "generatedAt", "sources", "plugins"],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "catalogId": {
+      "type": "string",
+      "pattern": "^catalog:[a-f0-9]{64}$"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/source"
+      }
+    },
+    "plugins": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/plugin"
+      }
+    }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "sha": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{40}$"
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sourceId",
+        "displayName",
+        "repositoryUrl",
+        "marketplaceDialect",
+        "manifestPath",
+        "defaultBranch",
+        "resolvedCommitSha",
+        "retrievalTimestamp",
+        "trustClassification",
+        "sourceManifestDigest",
+        "synchronizationStatus"
+      ],
+      "properties": {
+        "sourceId": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "repositoryUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "marketplaceDialect": {
+          "enum": ["openai", "cursor", "claude"]
+        },
+        "manifestPath": {
+          "type": "string"
+        },
+        "defaultBranch": {
+          "type": "string"
+        },
+        "resolvedCommitSha": {
+          "$ref": "#/$defs/sha"
+        },
+        "retrievalTimestamp": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "trustClassification": {
+          "const": "official"
+        },
+        "sourceManifestDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "synchronizationStatus": {
+          "enum": ["synchronized", "unchanged", "failed"]
+        }
+      }
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "name", "paths", "metadata", "securityImpact"],
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "paths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "metadata": {
+          "type": "object"
+        },
+        "securityImpact": {
+          "enum": ["none", "review", "sensitive"]
+        }
+      }
+    },
+    "compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "reasons", "responsibleCapabilities"],
+      "properties": {
+        "status": {
+          "type": "string"
+        },
+        "reasons": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "responsibleCapabilities": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "release": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "releaseId",
+        "resolvedRepositoryUrl",
+        "resolvedCommitSha",
+        "pluginSubdirectory",
+        "canonicalContentDigest",
+        "manifestDigest",
+        "contentResolution",
+        "releaseMetadata",
+        "capabilities",
+        "requiredConnectors",
+        "requiredCredentials",
+        "permissionSensitiveChanges",
+        "fileIndex",
+        "publicationTimestamp"
+      ],
+      "properties": {
+        "canonicalContentDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/capability"
+          }
+        },
+        "contentResolution": {
+          "enum": ["complete", "metadata-only"]
+        },
+        "fileIndex": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "icon": {
+          "description": "Brand mark resolved at compile time: a file from the release content, or the product site's icon.",
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind", "path", "contentType", "digest", "bytes"],
+              "properties": {
+                "kind": {
+                  "const": "content"
+                },
+                "path": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 512
+                },
+                "contentType": {
+                  "enum": [
+                    "image/png",
+                    "image/jpeg",
+                    "image/gif",
+                    "image/webp",
+                    "image/svg+xml",
+                    "image/x-icon"
+                  ]
+                },
+                "digest": {
+                  "$ref": "#/$defs/digest"
+                },
+                "bytes": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 1048576
+                }
+              }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind", "url", "homepage", "contentType", "digest", "bytes"],
+              "properties": {
+                "kind": {
+                  "const": "favicon"
+                },
+                "url": {
+                  "type": "string",
+                  "format": "uri",
+                  "maxLength": 1024
+                },
+                "homepage": {
+                  "type": "string",
+                  "format": "uri",
+                  "maxLength": 1024
+                },
+                "contentType": {
+                  "enum": [
+                    "image/png",
+                    "image/jpeg",
+                    "image/gif",
+                    "image/webp",
+                    "image/svg+xml",
+                    "image/x-icon"
+                  ]
+                },
+                "digest": {
+                  "$ref": "#/$defs/digest"
+                },
+                "bytes": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 1048576
+                }
+              }
+            }
+          ]
+        },
+        "manifestDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "permissionSensitiveChanges": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "pluginSubdirectory": {
+          "type": "string"
+        },
+        "publicationTimestamp": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "releaseId": {
+          "type": "string",
+          "pattern": "^release:[a-f0-9]{64}$"
+        },
+        "releaseMetadata": {
+          "type": "object"
+        },
+        "requiredConnectors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "requiredCredentials": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "resolvedCommitSha": {
+          "$ref": "#/$defs/sha"
+        },
+        "resolvedRepositoryUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "upstreamVersion": {
+          "type": "string"
+        }
+      }
+    },
+    "plugin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "pluginId",
+        "displayName",
+        "description",
+        "productGroupingKey",
+        "categories",
+        "keywords",
+        "authors",
+        "icons",
+        "sourceId",
+        "upstreamPluginName",
+        "currentReleaseId",
+        "availableReleases",
+        "capabilitySummary",
+        "harnessCompatibility",
+        "license",
+        "provenance",
+        "securityClassification"
+      ],
+      "properties": {
+        "pluginId": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "productGroupingKey": {
+          "type": "string"
+        },
+        "categories": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "keywords": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "authors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "homepage": {
+          "type": "string",
+          "format": "uri"
+        },
+        "icons": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "sourceId": {
+          "type": "string"
+        },
+        "upstreamPluginName": {
+          "type": "string"
+        },
+        "currentReleaseId": {
+          "type": "string"
+        },
+        "availableReleases": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/release"
+          }
+        },
+        "capabilitySummary": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "harnessCompatibility": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/compatibility"
+          }
+        },
+        "license": {
+          "type": "object"
+        },
+        "provenance": {
+          "type": "object"
+        },
+        "securityClassification": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}

package/schemas/compatibility.v1.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hq.example/schemas/compatibility.v1.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "catalogId", "plugins"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "catalogId": { "type": "string", "pattern": "^catalog:[a-f0-9]{64}$" },
+    "plugins": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["pluginId", "harnessCompatibility"],
+        "properties": {
+          "pluginId": { "type": "string" },
+          "harnessCompatibility": { "type": "object" }
+        }
+      }
+    }
+  }
+}

package/schemas/harness-profile.v1.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "profileVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "harness": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "runtimeVersion": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "adapterVersion": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "agentPlugins": {
+      "type": "object",
+      "properties": {
+        "versions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "skills": {
+          "type": "boolean"
+        },
+        "mcpTransports": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["stdio", "streamable-http", "sse"]
+          }
+        }
+      },
+      "required": ["versions", "skills", "mcpTransports"],
+      "additionalProperties": false
+    },
+    "components": {
+      "type": "object",
+      "properties": {
+        "skillDirectories": {
+          "type": "boolean"
+        },
+        "mcpTransports": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["stdio", "streamable-http", "sse"]
+          }
+        }
+      },
+      "required": ["skillDirectories", "mcpTransports"],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "profileVersion",
+    "harness",
+    "runtimeVersion",
+    "adapterVersion",
+    "agentPlugins",
+    "components"
+  ],
+  "additionalProperties": false,
+  "$id": "https://adea.dev/schemas/plugins/harness-profile.v1.json"
+}