@bsb/registry 1.0.1

package/lib/schemas/service-bsb-registry.json

@@ -0,0 +1,1883 @@
+{
+  "pluginName": "BSB Registry Core",
+  "version": "1.0.0",
+  "events": {
+    "registry.plugin.publish": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Publish a new plugin or version",
+      "inputSchema": {
+        "description": "Request body for publishing a plugin",
+        "type": "object",
+        "properties": {
+          "org": {
+            "description": "Organization name",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "name": {
+            "description": "Plugin name",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "version": {
+            "description": "Semantic version",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 50
+          },
+          "language": {
+            "description": "Programming language",
+            "type": "string",
+            "enum": [
+              "nodejs",
+              "csharp",
+              "go",
+              "java",
+              "python"
+            ]
+          },
+          "metadata": {
+            "description": "Plugin metadata",
+            "type": "object",
+            "properties": {
+              "displayName": {
+                "description": "Human-readable name",
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              },
+              "description": {
+                "description": "Short description",
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 1000
+              },
+              "category": {
+                "description": "Plugin category",
+                "type": "string",
+                "enum": [
+                  "service",
+                  "observable",
+                  "events",
+                  "config"
+                ]
+              },
+              "tags": {
+                "description": "Searchable keywords",
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "maxLength": 50
+                }
+              },
+              "author": {
+                "description": "Author - either a string or { name, email?, url? }",
+                "oneOf": [
+                  {
+                    "description": "Author name as a string",
+                    "type": "string",
+                    "maxLength": 200
+                  },
+                  {
+                    "description": "Author as an object (npm-style)",
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "description": "Author name",
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "email": {
+                        "description": "Author email",
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "url": {
+                        "description": "Author homepage",
+                        "type": "string",
+                        "format": "uri"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ]
+                  }
+                ]
+              },
+              "license": {
+                "type": "string",
+                "maxLength": 50
+              },
+              "homepage": {
+                "type": "string",
+                "format": "uri"
+              },
+              "repository": {
+                "type": "string",
+                "format": "uri"
+              }
+            },
+            "required": [
+              "displayName",
+              "description",
+              "category",
+              "tags"
+            ]
+          },
+          "eventSchema": {
+            "description": "EventSchemaExport object (parsed at HTTP boundary, transported as object)",
+            "oneOf": []
+          },
+          "capabilities": {
+            "description": "Plugin capabilities object (parsed at HTTP boundary, optional top-level override)",
+            "oneOf": []
+          },
+          "configSchema": {
+            "description": "Configuration JSON Schema object (parsed at HTTP boundary)",
+            "oneOf": []
+          },
+          "typeDefinitions": {
+            "description": "Language-specific type definitions",
+            "type": "object",
+            "properties": {
+              "nodejs": {
+                "description": "TypeScript .d.ts definitions",
+                "type": "string"
+              },
+              "csharp": {
+                "description": "C# interface definitions",
+                "type": "string"
+              },
+              "go": {
+                "description": "Go type definitions",
+                "type": "string"
+              },
+              "java": {
+                "description": "Java interface definitions",
+                "type": "string"
+              }
+            },
+            "required": []
+          },
+          "documentation": {
+            "description": "Array of markdown documentation files (at least 1 required)",
+            "type": "array",
+            "items": {
+              "description": "Markdown file content (title extracted from first # heading)",
+              "type": "string"
+            },
+            "minItems": 1
+          },
+          "dependencies": {
+            "description": "Plugin dependencies",
+            "type": "array",
+            "items": {
+              "description": "Plugin dependency declaration",
+              "type": "object",
+              "properties": {
+                "id": {
+                  "description": "Plugin ID (org/name or just name for _ org)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "version": {
+                  "description": "Semver range constraint (e.g. ^1.0.0, ~2.1, >=3.0.0)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 50
+                }
+              },
+              "required": [
+                "id",
+                "version"
+              ]
+            }
+          },
+          "package": {
+            "description": "Language-specific package information",
+            "type": "object",
+            "properties": {
+              "nodejs": {
+                "description": "NPM package name",
+                "type": "string"
+              },
+              "csharp": {
+                "description": "NuGet package name",
+                "type": "string"
+              },
+              "go": {
+                "description": "Go module path",
+                "type": "string"
+              },
+              "java": {
+                "description": "Maven coordinates",
+                "type": "string"
+              },
+              "python": {
+                "description": "PyPI package name",
+                "type": "string"
+              }
+            },
+            "required": []
+          },
+          "runtime": {
+            "description": "Runtime version requirements",
+            "type": "object",
+            "properties": {
+              "nodejs": {
+                "description": "Node.js version requirement",
+                "type": "string"
+              },
+              "dotnet": {
+                "description": ".NET version requirement",
+                "type": "string"
+              },
+              "go": {
+                "description": "Go version requirement",
+                "type": "string"
+              },
+              "java": {
+                "description": "Java version requirement",
+                "type": "string"
+              },
+              "python": {
+                "description": "Python version requirement",
+                "type": "string"
+              }
+            },
+            "required": []
+          },
+          "visibility": {
+            "description": "Visibility level (default: public)",
+            "type": "string",
+            "enum": [
+              "public",
+              "private"
+            ]
+          },
+          "publishedBy": {
+            "description": "User ID of the publisher (set by HTTP layer)",
+            "type": "string",
+            "maxLength": 200
+          }
+        },
+        "required": [
+          "org",
+          "name",
+          "version",
+          "language",
+          "metadata",
+          "eventSchema",
+          "documentation"
+        ]
+      },
+      "outputSchema": {
+        "description": "Response for publish operation",
+        "type": "object",
+        "properties": {
+          "success": {
+            "description": "Operation success status",
+            "type": "boolean"
+          },
+          "pluginId": {
+            "description": "Full plugin ID (org/name)",
+            "type": "string"
+          },
+          "version": {
+            "description": "Published version",
+            "type": "string"
+          },
+          "message": {
+            "description": "Success or error message",
+            "type": "string"
+          }
+        },
+        "required": [
+          "success",
+          "pluginId",
+          "version"
+        ]
+      }
+    },
+    "registry.plugin.get": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Get plugin details by org/name",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "org": {
+            "description": "Organization name",
+            "type": "string"
+          },
+          "name": {
+            "description": "Plugin name",
+            "type": "string"
+          },
+          "version": {
+            "description": "Version (defaults to latest)",
+            "type": "string"
+          }
+        },
+        "required": [
+          "org",
+          "name"
+        ]
+      },
+      "outputSchema": {
+        "description": "Registry entry for a plugin",
+        "type": "object",
+        "properties": {
+          "id": {
+            "description": "Full ID: org/plugin-name",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "org": {
+            "description": "Organization or user name",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "name": {
+            "description": "Plugin name",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "displayName": {
+            "description": "Human-readable name",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "description": {
+            "description": "Short description",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1000
+          },
+          "version": {
+            "description": "Semantic version (1.0.0)",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 50
+          },
+          "majorMinor": {
+            "description": "Major.minor only (1.0)",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 20
+          },
+          "language": {
+            "description": "Programming language",
+            "type": "string",
+            "enum": [
+              "nodejs",
+              "csharp",
+              "go",
+              "java",
+              "python"
+            ]
+          },
+          "package": {
+            "description": "Language-specific package information",
+            "type": "object",
+            "properties": {
+              "nodejs": {
+                "description": "NPM package name",
+                "type": "string"
+              },
+              "csharp": {
+                "description": "NuGet package name",
+                "type": "string"
+              },
+              "go": {
+                "description": "Go module path",
+                "type": "string"
+              },
+              "java": {
+                "description": "Maven coordinates",
+                "type": "string"
+              },
+              "python": {
+                "description": "PyPI package name",
+                "type": "string"
+              }
+            },
+            "required": []
+          },
+          "category": {
+            "description": "Plugin category",
+            "type": "string",
+            "enum": [
+              "service",
+              "observable",
+              "events",
+              "config"
+            ]
+          },
+          "tags": {
+            "description": "Searchable keywords",
+            "type": "array",
+            "items": {
+              "type": "string",
+              "maxLength": 50
+            }
+          },
+          "author": {
+            "description": "Author - either a string or { name, email?, url? }",
+            "oneOf": [
+              {
+                "description": "Author name as a string",
+                "type": "string",
+                "maxLength": 200
+              },
+              {
+                "description": "Author as an object (npm-style)",
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "description": "Author name",
+                    "type": "string",
+                    "maxLength": 200
+                  },
+                  "email": {
+                    "description": "Author email",
+                    "type": "string",
+                    "maxLength": 200
+                  },
+                  "url": {
+                    "description": "Author homepage",
+                    "type": "string",
+                    "format": "uri"
+                  }
+                },
+                "required": [
+                  "name"
+                ]
+              }
+            ]
+          },
+          "license": {
+            "description": "License identifier",
+            "type": "string",
+            "maxLength": 50
+          },
+          "homepage": {
+            "description": "Documentation URL",
+            "type": "string",
+            "format": "uri"
+          },
+          "repository": {
+            "description": "Source repository URL",
+            "type": "string",
+            "format": "uri"
+          },
+          "visibility": {
+            "description": "Visibility level",
+            "type": "string",
+            "enum": [
+              "public",
+              "private"
+            ]
+          },
+          "eventSchema": {
+            "description": "Events map (Record<eventName, EventExportEntry>)",
+            "oneOf": []
+          },
+          "capabilities": {
+            "description": "Plugin capabilities object",
+            "oneOf": []
+          },
+          "configSchema": {
+            "description": "Configuration JSON Schema object",
+            "oneOf": []
+          },
+          "typeDefinitions": {
+            "description": "Language-specific type definitions",
+            "type": "object",
+            "properties": {
+              "nodejs": {
+                "description": "TypeScript .d.ts definitions",
+                "type": "string"
+              },
+              "csharp": {
+                "description": "C# interface definitions",
+                "type": "string"
+              },
+              "go": {
+                "description": "Go type definitions",
+                "type": "string"
+              },
+              "java": {
+                "description": "Java interface definitions",
+                "type": "string"
+              }
+            },
+            "required": []
+          },
+          "documentation": {
+            "description": "Array of markdown documentation files (at least 1 required)",
+            "type": "array",
+            "items": {
+              "description": "Markdown file content (title extracted from first # heading)",
+              "type": "string"
+            },
+            "minItems": 1
+          },
+          "dependencies": {
+            "description": "Plugins this plugin depends on",
+            "type": "array",
+            "items": {
+              "description": "Plugin dependency declaration",
+              "type": "object",
+              "properties": {
+                "id": {
+                  "description": "Plugin ID (org/name or just name for _ org)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "version": {
+                  "description": "Semver range constraint (e.g. ^1.0.0, ~2.1, >=3.0.0)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 50
+                }
+              },
+              "required": [
+                "id",
+                "version"
+              ]
+            }
+          },
+          "permissions": {
+            "description": "Per-package user permissions",
+            "type": "array",
+            "items": {
+              "description": "Per-package permission entry (overrides org-level)",
+              "type": "object",
+              "properties": {
+                "userId": {
+                  "description": "User ID",
+                  "type": "string",
+                  "format": "uuid"
+                },
+                "permission": {
+                  "description": "Resource-level permission",
+                  "type": "string",
+                  "enum": [
+                    "read",
+                    "write"
+                  ]
+                }
+              },
+              "required": [
+                "userId",
+                "permission"
+              ]
+            }
+          },
+          "eventCount": {
+            "description": "Total event count",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "emitEventCount": {
+            "description": "Fire-and-forget emit events",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "onEventCount": {
+            "description": "Fire-and-forget on events",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "returnableEventCount": {
+            "description": "Returnable events",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "broadcastEventCount": {
+            "description": "Broadcast events",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "publishedBy": {
+            "description": "User ID who published",
+            "type": "string",
+            "maxLength": 200
+          },
+          "publishedAt": {
+            "description": "First publish timestamp",
+            "type": "string",
+            "format": "datetime"
+          },
+          "updatedAt": {
+            "description": "Last update timestamp",
+            "type": "string",
+            "format": "datetime"
+          },
+          "downloads": {
+            "description": "Download count",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "runtime": {
+            "description": "Runtime version requirements",
+            "type": "object",
+            "properties": {
+              "nodejs": {
+                "description": "Node.js version requirement",
+                "type": "string"
+              },
+              "dotnet": {
+                "description": ".NET version requirement",
+                "type": "string"
+              },
+              "go": {
+                "description": "Go version requirement",
+                "type": "string"
+              },
+              "java": {
+                "description": "Java version requirement",
+                "type": "string"
+              },
+              "python": {
+                "description": "Python version requirement",
+                "type": "string"
+              }
+            },
+            "required": []
+          }
+        },
+        "required": [
+          "id",
+          "org",
+          "name",
+          "displayName",
+          "description",
+          "version",
+          "majorMinor",
+          "language",
+          "category",
+          "tags",
+          "visibility",
+          "eventSchema",
+          "eventCount",
+          "emitEventCount",
+          "onEventCount",
+          "returnableEventCount",
+          "broadcastEventCount",
+          "publishedBy",
+          "publishedAt",
+          "updatedAt"
+        ]
+      }
+    },
+    "registry.plugin.list": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "List plugins with filtering",
+      "inputSchema": {
+        "description": "Query parameters for listing plugins",
+        "type": "object",
+        "properties": {
+          "org": {
+            "description": "Filter by organization",
+            "type": "string",
+            "maxLength": 100
+          },
+          "language": {
+            "description": "Filter by language",
+            "type": "string",
+            "enum": [
+              "nodejs",
+              "csharp",
+              "go",
+              "java",
+              "python"
+            ]
+          },
+          "category": {
+            "description": "Filter by category",
+            "type": "string",
+            "enum": [
+              "service",
+              "observable",
+              "events",
+              "config"
+            ]
+          },
+          "limit": {
+            "description": "Results per page (default: 50)",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 1,
+            "maximum": 100
+          },
+          "offset": {
+            "description": "Pagination offset (default: 0)",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          }
+        },
+        "required": []
+      },
+      "outputSchema": {
+        "description": "List results response",
+        "type": "object",
+        "properties": {
+          "results": {
+            "description": "Plugin list",
+            "type": "array",
+            "items": {
+              "description": "Registry entry for a plugin",
+              "type": "object",
+              "properties": {
+                "id": {
+                  "description": "Full ID: org/plugin-name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "org": {
+                  "description": "Organization or user name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 100
+                },
+                "name": {
+                  "description": "Plugin name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 100
+                },
+                "displayName": {
+                  "description": "Human-readable name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "description": {
+                  "description": "Short description",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1000
+                },
+                "version": {
+                  "description": "Semantic version (1.0.0)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 50
+                },
+                "majorMinor": {
+                  "description": "Major.minor only (1.0)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 20
+                },
+                "language": {
+                  "description": "Programming language",
+                  "type": "string",
+                  "enum": [
+                    "nodejs",
+                    "csharp",
+                    "go",
+                    "java",
+                    "python"
+                  ]
+                },
+                "package": {
+                  "description": "Language-specific package information",
+                  "type": "object",
+                  "properties": {
+                    "nodejs": {
+                      "description": "NPM package name",
+                      "type": "string"
+                    },
+                    "csharp": {
+                      "description": "NuGet package name",
+                      "type": "string"
+                    },
+                    "go": {
+                      "description": "Go module path",
+                      "type": "string"
+                    },
+                    "java": {
+                      "description": "Maven coordinates",
+                      "type": "string"
+                    },
+                    "python": {
+                      "description": "PyPI package name",
+                      "type": "string"
+                    }
+                  },
+                  "required": []
+                },
+                "category": {
+                  "description": "Plugin category",
+                  "type": "string",
+                  "enum": [
+                    "service",
+                    "observable",
+                    "events",
+                    "config"
+                  ]
+                },
+                "tags": {
+                  "description": "Searchable keywords",
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "maxLength": 50
+                  }
+                },
+                "author": {
+                  "description": "Author - either a string or { name, email?, url? }",
+                  "oneOf": [
+                    {
+                      "description": "Author name as a string",
+                      "type": "string",
+                      "maxLength": 200
+                    },
+                    {
+                      "description": "Author as an object (npm-style)",
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "description": "Author name",
+                          "type": "string",
+                          "maxLength": 200
+                        },
+                        "email": {
+                          "description": "Author email",
+                          "type": "string",
+                          "maxLength": 200
+                        },
+                        "url": {
+                          "description": "Author homepage",
+                          "type": "string",
+                          "format": "uri"
+                        }
+                      },
+                      "required": [
+                        "name"
+                      ]
+                    }
+                  ]
+                },
+                "license": {
+                  "description": "License identifier",
+                  "type": "string",
+                  "maxLength": 50
+                },
+                "homepage": {
+                  "description": "Documentation URL",
+                  "type": "string",
+                  "format": "uri"
+                },
+                "repository": {
+                  "description": "Source repository URL",
+                  "type": "string",
+                  "format": "uri"
+                },
+                "visibility": {
+                  "description": "Visibility level",
+                  "type": "string",
+                  "enum": [
+                    "public",
+                    "private"
+                  ]
+                },
+                "eventSchema": {
+                  "description": "Events map (Record<eventName, EventExportEntry>)",
+                  "oneOf": []
+                },
+                "capabilities": {
+                  "description": "Plugin capabilities object",
+                  "oneOf": []
+                },
+                "configSchema": {
+                  "description": "Configuration JSON Schema object",
+                  "oneOf": []
+                },
+                "typeDefinitions": {
+                  "description": "Language-specific type definitions",
+                  "type": "object",
+                  "properties": {
+                    "nodejs": {
+                      "description": "TypeScript .d.ts definitions",
+                      "type": "string"
+                    },
+                    "csharp": {
+                      "description": "C# interface definitions",
+                      "type": "string"
+                    },
+                    "go": {
+                      "description": "Go type definitions",
+                      "type": "string"
+                    },
+                    "java": {
+                      "description": "Java interface definitions",
+                      "type": "string"
+                    }
+                  },
+                  "required": []
+                },
+                "documentation": {
+                  "description": "Array of markdown documentation files (at least 1 required)",
+                  "type": "array",
+                  "items": {
+                    "description": "Markdown file content (title extracted from first # heading)",
+                    "type": "string"
+                  },
+                  "minItems": 1
+                },
+                "dependencies": {
+                  "description": "Plugins this plugin depends on",
+                  "type": "array",
+                  "items": {
+                    "description": "Plugin dependency declaration",
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "description": "Plugin ID (org/name or just name for _ org)",
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 200
+                      },
+                      "version": {
+                        "description": "Semver range constraint (e.g. ^1.0.0, ~2.1, >=3.0.0)",
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 50
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "version"
+                    ]
+                  }
+                },
+                "permissions": {
+                  "description": "Per-package user permissions",
+                  "type": "array",
+                  "items": {
+                    "description": "Per-package permission entry (overrides org-level)",
+                    "type": "object",
+                    "properties": {
+                      "userId": {
+                        "description": "User ID",
+                        "type": "string",
+                        "format": "uuid"
+                      },
+                      "permission": {
+                        "description": "Resource-level permission",
+                        "type": "string",
+                        "enum": [
+                          "read",
+                          "write"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "userId",
+                      "permission"
+                    ]
+                  }
+                },
+                "eventCount": {
+                  "description": "Total event count",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "emitEventCount": {
+                  "description": "Fire-and-forget emit events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "onEventCount": {
+                  "description": "Fire-and-forget on events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "returnableEventCount": {
+                  "description": "Returnable events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "broadcastEventCount": {
+                  "description": "Broadcast events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "publishedBy": {
+                  "description": "User ID who published",
+                  "type": "string",
+                  "maxLength": 200
+                },
+                "publishedAt": {
+                  "description": "First publish timestamp",
+                  "type": "string",
+                  "format": "datetime"
+                },
+                "updatedAt": {
+                  "description": "Last update timestamp",
+                  "type": "string",
+                  "format": "datetime"
+                },
+                "downloads": {
+                  "description": "Download count",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "runtime": {
+                  "description": "Runtime version requirements",
+                  "type": "object",
+                  "properties": {
+                    "nodejs": {
+                      "description": "Node.js version requirement",
+                      "type": "string"
+                    },
+                    "dotnet": {
+                      "description": ".NET version requirement",
+                      "type": "string"
+                    },
+                    "go": {
+                      "description": "Go version requirement",
+                      "type": "string"
+                    },
+                    "java": {
+                      "description": "Java version requirement",
+                      "type": "string"
+                    },
+                    "python": {
+                      "description": "Python version requirement",
+                      "type": "string"
+                    }
+                  },
+                  "required": []
+                }
+              },
+              "required": [
+                "id",
+                "org",
+                "name",
+                "displayName",
+                "description",
+                "version",
+                "majorMinor",
+                "language",
+                "category",
+                "tags",
+                "visibility",
+                "eventSchema",
+                "eventCount",
+                "emitEventCount",
+                "onEventCount",
+                "returnableEventCount",
+                "broadcastEventCount",
+                "publishedBy",
+                "publishedAt",
+                "updatedAt"
+              ]
+            }
+          },
+          "total": {
+            "description": "Total count",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "page": {
+            "description": "Current page number",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 1,
+            "maximum": 2147483647
+          }
+        },
+        "required": [
+          "results",
+          "total",
+          "page"
+        ]
+      }
+    },
+    "registry.plugin.search": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Search plugins by query",
+      "inputSchema": {
+        "description": "Query parameters for searching plugins",
+        "type": "object",
+        "properties": {
+          "query": {
+            "description": "Search query string",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "language": {
+            "description": "Filter by language",
+            "type": "string",
+            "enum": [
+              "nodejs",
+              "csharp",
+              "go",
+              "java",
+              "python"
+            ]
+          },
+          "category": {
+            "description": "Filter by category",
+            "type": "string",
+            "enum": [
+              "service",
+              "observable",
+              "events",
+              "config"
+            ]
+          },
+          "limit": {
+            "description": "Results per page (default: 20)",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 1,
+            "maximum": 100
+          },
+          "offset": {
+            "description": "Pagination offset (default: 0)",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          }
+        },
+        "required": [
+          "query"
+        ]
+      },
+      "outputSchema": {
+        "description": "Search results response",
+        "type": "object",
+        "properties": {
+          "results": {
+            "description": "Matching plugins",
+            "type": "array",
+            "items": {
+              "description": "Registry entry for a plugin",
+              "type": "object",
+              "properties": {
+                "id": {
+                  "description": "Full ID: org/plugin-name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "org": {
+                  "description": "Organization or user name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 100
+                },
+                "name": {
+                  "description": "Plugin name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 100
+                },
+                "displayName": {
+                  "description": "Human-readable name",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "description": {
+                  "description": "Short description",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1000
+                },
+                "version": {
+                  "description": "Semantic version (1.0.0)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 50
+                },
+                "majorMinor": {
+                  "description": "Major.minor only (1.0)",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 20
+                },
+                "language": {
+                  "description": "Programming language",
+                  "type": "string",
+                  "enum": [
+                    "nodejs",
+                    "csharp",
+                    "go",
+                    "java",
+                    "python"
+                  ]
+                },
+                "package": {
+                  "description": "Language-specific package information",
+                  "type": "object",
+                  "properties": {
+                    "nodejs": {
+                      "description": "NPM package name",
+                      "type": "string"
+                    },
+                    "csharp": {
+                      "description": "NuGet package name",
+                      "type": "string"
+                    },
+                    "go": {
+                      "description": "Go module path",
+                      "type": "string"
+                    },
+                    "java": {
+                      "description": "Maven coordinates",
+                      "type": "string"
+                    },
+                    "python": {
+                      "description": "PyPI package name",
+                      "type": "string"
+                    }
+                  },
+                  "required": []
+                },
+                "category": {
+                  "description": "Plugin category",
+                  "type": "string",
+                  "enum": [
+                    "service",
+                    "observable",
+                    "events",
+                    "config"
+                  ]
+                },
+                "tags": {
+                  "description": "Searchable keywords",
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "maxLength": 50
+                  }
+                },
+                "author": {
+                  "description": "Author - either a string or { name, email?, url? }",
+                  "oneOf": [
+                    {
+                      "description": "Author name as a string",
+                      "type": "string",
+                      "maxLength": 200
+                    },
+                    {
+                      "description": "Author as an object (npm-style)",
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "description": "Author name",
+                          "type": "string",
+                          "maxLength": 200
+                        },
+                        "email": {
+                          "description": "Author email",
+                          "type": "string",
+                          "maxLength": 200
+                        },
+                        "url": {
+                          "description": "Author homepage",
+                          "type": "string",
+                          "format": "uri"
+                        }
+                      },
+                      "required": [
+                        "name"
+                      ]
+                    }
+                  ]
+                },
+                "license": {
+                  "description": "License identifier",
+                  "type": "string",
+                  "maxLength": 50
+                },
+                "homepage": {
+                  "description": "Documentation URL",
+                  "type": "string",
+                  "format": "uri"
+                },
+                "repository": {
+                  "description": "Source repository URL",
+                  "type": "string",
+                  "format": "uri"
+                },
+                "visibility": {
+                  "description": "Visibility level",
+                  "type": "string",
+                  "enum": [
+                    "public",
+                    "private"
+                  ]
+                },
+                "eventSchema": {
+                  "description": "Events map (Record<eventName, EventExportEntry>)",
+                  "oneOf": []
+                },
+                "capabilities": {
+                  "description": "Plugin capabilities object",
+                  "oneOf": []
+                },
+                "configSchema": {
+                  "description": "Configuration JSON Schema object",
+                  "oneOf": []
+                },
+                "typeDefinitions": {
+                  "description": "Language-specific type definitions",
+                  "type": "object",
+                  "properties": {
+                    "nodejs": {
+                      "description": "TypeScript .d.ts definitions",
+                      "type": "string"
+                    },
+                    "csharp": {
+                      "description": "C# interface definitions",
+                      "type": "string"
+                    },
+                    "go": {
+                      "description": "Go type definitions",
+                      "type": "string"
+                    },
+                    "java": {
+                      "description": "Java interface definitions",
+                      "type": "string"
+                    }
+                  },
+                  "required": []
+                },
+                "documentation": {
+                  "description": "Array of markdown documentation files (at least 1 required)",
+                  "type": "array",
+                  "items": {
+                    "description": "Markdown file content (title extracted from first # heading)",
+                    "type": "string"
+                  },
+                  "minItems": 1
+                },
+                "dependencies": {
+                  "description": "Plugins this plugin depends on",
+                  "type": "array",
+                  "items": {
+                    "description": "Plugin dependency declaration",
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "description": "Plugin ID (org/name or just name for _ org)",
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 200
+                      },
+                      "version": {
+                        "description": "Semver range constraint (e.g. ^1.0.0, ~2.1, >=3.0.0)",
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 50
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "version"
+                    ]
+                  }
+                },
+                "permissions": {
+                  "description": "Per-package user permissions",
+                  "type": "array",
+                  "items": {
+                    "description": "Per-package permission entry (overrides org-level)",
+                    "type": "object",
+                    "properties": {
+                      "userId": {
+                        "description": "User ID",
+                        "type": "string",
+                        "format": "uuid"
+                      },
+                      "permission": {
+                        "description": "Resource-level permission",
+                        "type": "string",
+                        "enum": [
+                          "read",
+                          "write"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "userId",
+                      "permission"
+                    ]
+                  }
+                },
+                "eventCount": {
+                  "description": "Total event count",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "emitEventCount": {
+                  "description": "Fire-and-forget emit events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "onEventCount": {
+                  "description": "Fire-and-forget on events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "returnableEventCount": {
+                  "description": "Returnable events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "broadcastEventCount": {
+                  "description": "Broadcast events",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "publishedBy": {
+                  "description": "User ID who published",
+                  "type": "string",
+                  "maxLength": 200
+                },
+                "publishedAt": {
+                  "description": "First publish timestamp",
+                  "type": "string",
+                  "format": "datetime"
+                },
+                "updatedAt": {
+                  "description": "Last update timestamp",
+                  "type": "string",
+                  "format": "datetime"
+                },
+                "downloads": {
+                  "description": "Download count",
+                  "type": "integer",
+                  "format": "int32",
+                  "minimum": 0,
+                  "maximum": 2147483647
+                },
+                "runtime": {
+                  "description": "Runtime version requirements",
+                  "type": "object",
+                  "properties": {
+                    "nodejs": {
+                      "description": "Node.js version requirement",
+                      "type": "string"
+                    },
+                    "dotnet": {
+                      "description": ".NET version requirement",
+                      "type": "string"
+                    },
+                    "go": {
+                      "description": "Go version requirement",
+                      "type": "string"
+                    },
+                    "java": {
+                      "description": "Java version requirement",
+                      "type": "string"
+                    },
+                    "python": {
+                      "description": "Python version requirement",
+                      "type": "string"
+                    }
+                  },
+                  "required": []
+                }
+              },
+              "required": [
+                "id",
+                "org",
+                "name",
+                "displayName",
+                "description",
+                "version",
+                "majorMinor",
+                "language",
+                "category",
+                "tags",
+                "visibility",
+                "eventSchema",
+                "eventCount",
+                "emitEventCount",
+                "onEventCount",
+                "returnableEventCount",
+                "broadcastEventCount",
+                "publishedBy",
+                "publishedAt",
+                "updatedAt"
+              ]
+            }
+          },
+          "total": {
+            "description": "Total result count",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "query": {
+            "description": "Search query used",
+            "type": "string"
+          }
+        },
+        "required": [
+          "results",
+          "total",
+          "query"
+        ]
+      }
+    },
+    "registry.plugin.delete": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Delete a plugin or specific version",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "org": {
+            "description": "Organization name",
+            "type": "string"
+          },
+          "name": {
+            "description": "Plugin name",
+            "type": "string"
+          },
+          "version": {
+            "description": "Version (or all if not provided)",
+            "type": "string"
+          }
+        },
+        "required": [
+          "org",
+          "name"
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "description": "Success status",
+            "type": "boolean"
+          },
+          "deleted": {
+            "description": "Number of versions deleted",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          }
+        },
+        "required": [
+          "success",
+          "deleted"
+        ]
+      }
+    },
+    "registry.plugin.versions": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Get all versions of a plugin",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "org": {
+            "description": "Organization name",
+            "type": "string"
+          },
+          "name": {
+            "description": "Plugin name",
+            "type": "string"
+          },
+          "majorMinor": {
+            "description": "Filter by major.minor",
+            "type": "string"
+          }
+        },
+        "required": [
+          "org",
+          "name"
+        ]
+      },
+      "outputSchema": {
+        "description": "Version list response",
+        "type": "object",
+        "properties": {
+          "versions": {
+            "description": "All available versions",
+            "type": "array",
+            "items": {
+              "description": "Version information",
+              "type": "object",
+              "properties": {
+                "version": {
+                  "description": "Full semantic version",
+                  "type": "string"
+                },
+                "majorMinor": {
+                  "description": "Major.minor version",
+                  "type": "string"
+                },
+                "publishedAt": {
+                  "description": "Publication timestamp",
+                  "type": "string",
+                  "format": "datetime"
+                }
+              },
+              "required": [
+                "version",
+                "majorMinor",
+                "publishedAt"
+              ]
+            }
+          },
+          "latest": {
+            "description": "Latest version",
+            "type": "string"
+          },
+          "latestForMajorMinor": {
+            "description": "JSON map of major.minor to latest patch",
+            "type": "string"
+          }
+        },
+        "required": [
+          "versions",
+          "latest",
+          "latestForMajorMinor"
+        ]
+      }
+    },
+    "registry.stats.get": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Get registry statistics",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "required": []
+      },
+      "outputSchema": {
+        "description": "Registry statistics",
+        "type": "object",
+        "properties": {
+          "totalPlugins": {
+            "description": "Total plugin count",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          },
+          "byLanguage": {
+            "description": "JSON map of language to count",
+            "type": "string"
+          },
+          "byCategory": {
+            "description": "JSON map of category to count",
+            "type": "string"
+          },
+          "totalDownloads": {
+            "description": "Total downloads across all plugins",
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "maximum": 2147483647
+          }
+        },
+        "required": [
+          "totalPlugins",
+          "byLanguage",
+          "byCategory",
+          "totalDownloads"
+        ]
+      }
+    },
+    "registry.auth.login": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Authenticate user and get token",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "username": {
+            "description": "Username",
+            "type": "string"
+          },
+          "password": {
+            "description": "Encrypted password",
+            "type": "string"
+          }
+        },
+        "required": [
+          "username",
+          "password"
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "description": "Login success",
+            "type": "boolean"
+          },
+          "token": {
+            "description": "Auth token",
+            "type": "string"
+          },
+          "expiresAt": {
+            "description": "Expiration",
+            "type": "string",
+            "format": "datetime"
+          },
+          "message": {
+            "description": "Error message",
+            "type": "string"
+          }
+        },
+        "required": [
+          "success"
+        ]
+      }
+    },
+    "registry.auth.verify": {
+      "type": "returnable",
+      "category": "onReturnableEvents",
+      "description": "Verify authentication token",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "description": "Token to verify",
+            "type": "string"
+          }
+        },
+        "required": [
+          "token"
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "valid": {
+            "description": "Token validity",
+            "type": "boolean"
+          },
+          "userId": {
+            "description": "User ID",
+            "type": "string"
+          },
+          "permissions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "valid"
+        ]
+      }
+    }
+  },
+  "configSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "database": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "default": "file",
+            "type": "string",
+            "enum": [
+              "file",
+              "postgres"
+            ]
+          },
+          "path": {
+            "default": "./.temp/data",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "path"
+        ],
+        "additionalProperties": false
+      },
+      "auth": {
+        "type": "object",
+        "properties": {
+          "requireAuth": {
+            "default": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "requireAuth"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "required": [
+      "database",
+      "auth"
+    ],
+    "additionalProperties": false
+  },
+  "pluginType": "service"
+}