mirror of
https://git.openapi.site/https://github.com/desirecore/registry.git
synced 2026-09-05 15:23:39 +08:00
553 lines
22 KiB
JSON
553 lines
22 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"$id": "https://github.com/desirecore/registry/schemas/registry-entry.schema.json",
|
|
"title": "DesireCore Registry Entry",
|
|
"description": "A strictly discriminated DesireCore Registry catalog entry. External integrations are discovery-only pointers and cannot carry installation or connection semantics.",
|
|
"oneOf": [
|
|
{ "$ref": "#/definitions/dockerApp" },
|
|
{ "$ref": "#/definitions/mcp" },
|
|
{ "$ref": "#/definitions/httpApi" },
|
|
{ "$ref": "#/definitions/externalIntegration" }
|
|
],
|
|
"definitions": {
|
|
"id": {
|
|
"type": "string",
|
|
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
|
|
"description": "Stable entry identifier; must equal the containing directory name."
|
|
},
|
|
"nonEmptyString": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"pattern": "^[0-9]+(?:\\.[0-9]+){1,3}(?:[-+][0-9A-Za-z.-]+)?$",
|
|
"description": "Entry or client version in dotted numeric form."
|
|
},
|
|
"httpsUrl": {
|
|
"type": "string",
|
|
"pattern": "^https://[^\\s]+$",
|
|
"description": "An HTTPS URL without embedded whitespace."
|
|
},
|
|
"platformSupport": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"uniqueItems": true,
|
|
"items": {
|
|
"type": "string",
|
|
"enum": ["macos", "windows", "linux"]
|
|
},
|
|
"description": "Desktop platforms on which the entry is relevant."
|
|
},
|
|
"tags": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"uniqueItems": true,
|
|
"items": { "$ref": "#/definitions/nonEmptyString" },
|
|
"description": "Human-readable discovery and search tags."
|
|
},
|
|
"capabilities": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"uniqueItems": true,
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^[a-z0-9]+(?:_[a-z0-9]+)*$"
|
|
}
|
|
},
|
|
"environment": {
|
|
"type": "object",
|
|
"additionalProperties": { "type": "string" }
|
|
},
|
|
"mcpInstall": {
|
|
"type": "object",
|
|
"required": ["method", "command", "args"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"method": { "$ref": "#/definitions/nonEmptyString" },
|
|
"packageName": { "$ref": "#/definitions/nonEmptyString" },
|
|
"command": { "$ref": "#/definitions/nonEmptyString" },
|
|
"args": {
|
|
"type": "array",
|
|
"items": { "type": "string" }
|
|
},
|
|
"postInstall": {
|
|
"type": "array",
|
|
"items": { "$ref": "#/definitions/nonEmptyString" }
|
|
},
|
|
"env": { "$ref": "#/definitions/environment" }
|
|
}
|
|
},
|
|
"connection": {
|
|
"type": "object",
|
|
"required": ["transport"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"transport": {
|
|
"type": "string",
|
|
"enum": ["stdio", "streamable-http", "sse"]
|
|
},
|
|
"command": { "$ref": "#/definitions/nonEmptyString" },
|
|
"args": {
|
|
"type": "array",
|
|
"items": { "type": "string" }
|
|
},
|
|
"url": { "$ref": "#/definitions/nonEmptyString" },
|
|
"env": { "$ref": "#/definitions/environment" }
|
|
}
|
|
},
|
|
"dockerApp": {
|
|
"type": "object",
|
|
"required": [
|
|
"id", "name", "type", "version", "author", "description", "tags", "icon",
|
|
"iconLetter", "platformSupport", "category", "fullDesc", "shortDesc", "install"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"id": { "$ref": "#/definitions/id" },
|
|
"name": { "$ref": "#/definitions/nonEmptyString" },
|
|
"type": { "const": "docker-app" },
|
|
"version": { "$ref": "#/definitions/version" },
|
|
"author": { "$ref": "#/definitions/nonEmptyString" },
|
|
"description": { "$ref": "#/definitions/nonEmptyString" },
|
|
"tags": { "$ref": "#/definitions/tags" },
|
|
"icon": { "$ref": "#/definitions/nonEmptyString" },
|
|
"iconLetter": { "type": "string", "minLength": 1, "maxLength": 2 },
|
|
"platformSupport": { "$ref": "#/definitions/platformSupport" },
|
|
"category": {
|
|
"type": "string",
|
|
"enum": ["ai-platform", "chat", "workflow", "rag", "tools"]
|
|
},
|
|
"fullDesc": { "$ref": "#/definitions/nonEmptyString" },
|
|
"shortDesc": { "$ref": "#/definitions/nonEmptyString" },
|
|
"stars": { "type": "integer", "minimum": 0 },
|
|
"githubUrl": { "$ref": "#/definitions/httpsUrl" },
|
|
"install": {
|
|
"type": "object",
|
|
"required": ["method", "requirements", "configNeeded"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"method": { "type": "string", "enum": ["docker", "docker-compose"] },
|
|
"requirements": {
|
|
"type": "object",
|
|
"required": ["docker", "minMemory", "minDisk", "ports"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"docker": { "const": true },
|
|
"minMemory": { "$ref": "#/definitions/nonEmptyString" },
|
|
"minDisk": { "$ref": "#/definitions/nonEmptyString" },
|
|
"ports": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"uniqueItems": true,
|
|
"items": { "type": "integer", "minimum": 1, "maximum": 65535 }
|
|
}
|
|
}
|
|
},
|
|
"configNeeded": {
|
|
"type": "array",
|
|
"items": { "$ref": "#/definitions/nonEmptyString" }
|
|
}
|
|
}
|
|
},
|
|
"exposes": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["type", "port", "path", "name"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"type": { "const": "http-api" },
|
|
"port": { "type": "integer", "minimum": 1, "maximum": 65535 },
|
|
"path": { "type": "string", "pattern": "^/" },
|
|
"name": { "$ref": "#/definitions/nonEmptyString" }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"mcp": {
|
|
"type": "object",
|
|
"required": [
|
|
"id", "name", "type", "version", "author", "description", "tags", "icon",
|
|
"platformSupport", "capabilities", "connection"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"id": { "$ref": "#/definitions/id" },
|
|
"name": { "$ref": "#/definitions/nonEmptyString" },
|
|
"type": { "const": "mcp" },
|
|
"version": { "$ref": "#/definitions/version" },
|
|
"author": { "$ref": "#/definitions/nonEmptyString" },
|
|
"description": { "$ref": "#/definitions/nonEmptyString" },
|
|
"tags": { "$ref": "#/definitions/tags" },
|
|
"icon": { "$ref": "#/definitions/nonEmptyString" },
|
|
"platformSupport": { "$ref": "#/definitions/platformSupport" },
|
|
"capabilities": { "$ref": "#/definitions/capabilities" },
|
|
"toolCount": { "type": "integer", "minimum": 0 },
|
|
"install": { "$ref": "#/definitions/mcpInstall" },
|
|
"connection": { "$ref": "#/definitions/connection" },
|
|
"sourceAppId": { "$ref": "#/definitions/id" },
|
|
"sourceAppName": { "$ref": "#/definitions/nonEmptyString" }
|
|
}
|
|
},
|
|
"httpApi": {
|
|
"type": "object",
|
|
"required": [
|
|
"id", "name", "type", "version", "author", "description", "tags", "icon",
|
|
"platformSupport", "endpoint", "capabilities"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"id": { "$ref": "#/definitions/id" },
|
|
"name": { "$ref": "#/definitions/nonEmptyString" },
|
|
"type": { "const": "http-api" },
|
|
"version": { "$ref": "#/definitions/version" },
|
|
"author": { "$ref": "#/definitions/nonEmptyString" },
|
|
"description": { "$ref": "#/definitions/nonEmptyString" },
|
|
"tags": { "$ref": "#/definitions/tags" },
|
|
"icon": { "$ref": "#/definitions/nonEmptyString" },
|
|
"platformSupport": { "$ref": "#/definitions/platformSupport" },
|
|
"endpoint": { "type": "string", "pattern": "^https?://[^\\s]+$" },
|
|
"capabilities": { "$ref": "#/definitions/capabilities" },
|
|
"sourceAppId": { "$ref": "#/definitions/id" },
|
|
"sourceAppName": { "$ref": "#/definitions/nonEmptyString" }
|
|
}
|
|
},
|
|
"maintainer": {
|
|
"type": "object",
|
|
"required": ["name", "url", "verified"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"name": {
|
|
"allOf": [{ "$ref": "#/definitions/nonEmptyString" }],
|
|
"description": "Human-readable maintainer identity."
|
|
},
|
|
"url": {
|
|
"allOf": [{ "$ref": "#/definitions/httpsUrl" }],
|
|
"description": "Public source used to verify the maintainer identity."
|
|
},
|
|
"verified": {
|
|
"const": true,
|
|
"description": "The Registry maintainer verified this identity against the public source."
|
|
}
|
|
}
|
|
},
|
|
"officialLink": {
|
|
"description": "A Kimi WebBridge upstream URL pinned by kind, hostname, path, and extension ID where applicable.",
|
|
"oneOf": [
|
|
{
|
|
"type": "object",
|
|
"required": ["kind", "label", "url"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "product" },
|
|
"label": { "$ref": "#/definitions/nonEmptyString" },
|
|
"url": { "const": "https://www.kimi.ai/products/kimi-webbridge" }
|
|
}
|
|
},
|
|
{
|
|
"type": "object",
|
|
"required": ["kind", "label", "url"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "documentation" },
|
|
"label": { "$ref": "#/definitions/nonEmptyString" },
|
|
"url": { "const": "https://www.kimi.ai/help/kimi-webbridge/kimi-webbridge-introduction" }
|
|
}
|
|
},
|
|
{
|
|
"type": "object",
|
|
"required": ["kind", "label", "extensionId", "url"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "chrome-web-store" },
|
|
"label": { "$ref": "#/definitions/nonEmptyString" },
|
|
"extensionId": {
|
|
"const": "fldmhceldgbpfpkbgopacenieobmligc",
|
|
"description": "The audited Chrome Web Store extension identifier."
|
|
},
|
|
"url": { "const": "https://chromewebstore.google.com/detail/kimi-webbridge/fldmhceldgbpfpkbgopacenieobmligc" }
|
|
}
|
|
},
|
|
{
|
|
"type": "object",
|
|
"required": ["kind", "label", "extensionId", "url"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "edge-add-ons" },
|
|
"label": { "$ref": "#/definitions/nonEmptyString" },
|
|
"extensionId": {
|
|
"const": "bnlffdbcfnanfbknnlaflhlhkocccckg",
|
|
"description": "The audited Microsoft Edge Add-ons extension identifier."
|
|
},
|
|
"url": { "const": "https://microsoftedge.microsoft.com/addons/detail/kimi-webbridge/bnlffdbcfnanfbknnlaflhlhkocccckg" }
|
|
}
|
|
},
|
|
{
|
|
"type": "object",
|
|
"required": ["kind", "label", "url"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "privacy" },
|
|
"label": { "$ref": "#/definitions/nonEmptyString" },
|
|
"url": { "const": "https://www.kimi.ai/user/agreement/userPrivacy?version=v2" }
|
|
}
|
|
},
|
|
{
|
|
"type": "object",
|
|
"required": ["kind", "label", "url"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "terms" },
|
|
"label": { "$ref": "#/definitions/nonEmptyString" },
|
|
"url": { "const": "https://www.kimi.ai/user/agreement/modelUse?version=v2" }
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"browserExtensionComponent": {
|
|
"type": "object",
|
|
"required": ["kind", "name", "description", "distribution", "browsers"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "browser-extension" },
|
|
"name": { "$ref": "#/definitions/nonEmptyString" },
|
|
"description": { "$ref": "#/definitions/nonEmptyString" },
|
|
"distribution": {
|
|
"const": "official-upstream-only",
|
|
"description": "DesireCore does not mirror or repackage this third-party component."
|
|
},
|
|
"browsers": {
|
|
"type": "array",
|
|
"minItems": 2,
|
|
"maxItems": 2,
|
|
"uniqueItems": true,
|
|
"items": { "type": "string", "enum": ["chrome", "edge"] },
|
|
"allOf": [{ "contains": { "const": "chrome" } }, { "contains": { "const": "edge" } }]
|
|
}
|
|
}
|
|
},
|
|
"localDaemonComponent": {
|
|
"type": "object",
|
|
"required": ["kind", "name", "description", "distribution", "platforms"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "local-daemon" },
|
|
"name": { "$ref": "#/definitions/nonEmptyString" },
|
|
"description": { "$ref": "#/definitions/nonEmptyString" },
|
|
"distribution": {
|
|
"const": "official-upstream-only",
|
|
"description": "DesireCore does not mirror or repackage this third-party component."
|
|
},
|
|
"platforms": {
|
|
"type": "array",
|
|
"minItems": 2,
|
|
"maxItems": 3,
|
|
"uniqueItems": true,
|
|
"items": { "type": "string", "enum": ["macos", "windows", "linux"] },
|
|
"allOf": [{ "contains": { "const": "macos" } }, { "contains": { "const": "windows" } }]
|
|
}
|
|
}
|
|
},
|
|
"externalComponent": {
|
|
"description": "One strictly discriminated Kimi WebBridge physical component.",
|
|
"oneOf": [
|
|
{ "$ref": "#/definitions/browserExtensionComponent" },
|
|
{ "$ref": "#/definitions/localDaemonComponent" }
|
|
]
|
|
},
|
|
"artifactReview": {
|
|
"type": "object",
|
|
"required": ["component", "platform", "architecture", "version", "url", "sha256", "reviewedAt", "reviewedBy"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"component": { "const": "local-daemon" },
|
|
"platform": { "type": "string", "enum": ["macos", "windows", "linux"] },
|
|
"architecture": { "type": "string", "enum": ["x64", "arm64"] },
|
|
"version": { "$ref": "#/definitions/version" },
|
|
"url": { "$ref": "#/definitions/httpsUrl" },
|
|
"sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
|
|
"reviewedAt": { "type": "string", "format": "date" },
|
|
"reviewedBy": { "$ref": "#/definitions/nonEmptyString" }
|
|
}
|
|
},
|
|
"externalIntegration": {
|
|
"type": "object",
|
|
"required": [
|
|
"id", "name", "type", "version", "author", "description", "category", "shortDesc",
|
|
"fullDesc", "tags", "icon", "platformSupport", "requiredClientVersion", "stewardship",
|
|
"availability", "redistribution", "branding", "listingMaintainer", "upstreamMaintainer",
|
|
"integration", "officialLinks", "components", "permissions", "profileRecommendation",
|
|
"dataBoundaries", "admission", "compliance"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"id": {
|
|
"const": "kimi-webbridge",
|
|
"description": "The only external-integration ID admitted by Registry Schema v4."
|
|
},
|
|
"name": { "$ref": "#/definitions/nonEmptyString" },
|
|
"type": { "const": "external-integration" },
|
|
"version": { "$ref": "#/definitions/version" },
|
|
"author": { "$ref": "#/definitions/nonEmptyString" },
|
|
"description": { "$ref": "#/definitions/nonEmptyString" },
|
|
"category": { "const": "tools" },
|
|
"shortDesc": { "$ref": "#/definitions/nonEmptyString" },
|
|
"fullDesc": { "$ref": "#/definitions/nonEmptyString" },
|
|
"tags": { "$ref": "#/definitions/tags" },
|
|
"icon": {
|
|
"type": "string",
|
|
"enum": ["monitor", "puzzle", "globe"],
|
|
"description": "A neutral DesireCore icon name; upstream logos are not permitted in this listing type."
|
|
},
|
|
"platformSupport": {
|
|
"type": "array",
|
|
"minItems": 2,
|
|
"maxItems": 2,
|
|
"uniqueItems": true,
|
|
"items": { "type": "string", "enum": ["macos", "windows"] },
|
|
"allOf": [{ "contains": { "const": "macos" } }, { "contains": { "const": "windows" } }],
|
|
"description": "The reviewed listing must support both macOS and Windows."
|
|
},
|
|
"requiredClientVersion": {
|
|
"allOf": [{ "$ref": "#/definitions/version" }],
|
|
"description": "Minimum DesireCore version that understands this strict listing-only entry."
|
|
},
|
|
"stewardship": { "const": "pointer" },
|
|
"availability": { "const": "listing-only" },
|
|
"redistribution": { "const": "source-pointer-only" },
|
|
"branding": {
|
|
"type": "object",
|
|
"required": ["relationship", "nameUsage", "logoStatus"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"relationship": { "const": "independent-listing" },
|
|
"nameUsage": { "const": "nominative" },
|
|
"logoStatus": { "const": "not-used" }
|
|
}
|
|
},
|
|
"listingMaintainer": { "$ref": "#/definitions/maintainer" },
|
|
"upstreamMaintainer": { "$ref": "#/definitions/maintainer" },
|
|
"integration": {
|
|
"type": "object",
|
|
"required": ["kind", "adapterId", "executionAvailability", "installMode"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"kind": { "const": "local-extension-bridge" },
|
|
"adapterId": { "$ref": "#/definitions/id" },
|
|
"executionAvailability": { "const": "blocked" },
|
|
"installMode": { "const": "upstream-guided" }
|
|
}
|
|
},
|
|
"officialLinks": {
|
|
"type": "array",
|
|
"minItems": 6,
|
|
"maxItems": 6,
|
|
"uniqueItems": true,
|
|
"items": { "$ref": "#/definitions/officialLink" },
|
|
"description": "One reviewed official source for each required link kind."
|
|
},
|
|
"components": {
|
|
"type": "array",
|
|
"minItems": 2,
|
|
"maxItems": 2,
|
|
"uniqueItems": true,
|
|
"items": { "$ref": "#/definitions/externalComponent" },
|
|
"description": "The upstream browser extension and local daemon, neither redistributed by DesireCore."
|
|
},
|
|
"permissions": {
|
|
"type": "object",
|
|
"required": ["browserExtension"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"browserExtension": {
|
|
"type": "object",
|
|
"required": ["apiPermissions", "hostPermissions", "riskLevel"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"apiPermissions": {
|
|
"type": "array",
|
|
"minItems": 7,
|
|
"maxItems": 7,
|
|
"uniqueItems": true,
|
|
"items": {
|
|
"type": "string",
|
|
"enum": ["tabs", "activeTab", "debugger", "storage", "alarms", "tabGroups", "windows"]
|
|
}
|
|
},
|
|
"hostPermissions": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"maxItems": 1,
|
|
"items": { "const": "<all_urls>" }
|
|
},
|
|
"riskLevel": { "const": "high" }
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"profileRecommendation": { "const": "dedicated-browser-profile" },
|
|
"dataBoundaries": {
|
|
"type": "object",
|
|
"required": ["webBridgeLocalExecution", "desireCoreModelContext", "modelProviderDisclosureRequired"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"webBridgeLocalExecution": {
|
|
"allOf": [{ "$ref": "#/definitions/nonEmptyString" }],
|
|
"description": "A scoped statement of the upstream claim about the local WebBridge execution path."
|
|
},
|
|
"desireCoreModelContext": {
|
|
"allOf": [{ "$ref": "#/definitions/nonEmptyString" }],
|
|
"description": "A separate disclosure that content entering DesireCore context may be sent to the selected model provider."
|
|
},
|
|
"modelProviderDisclosureRequired": { "const": true }
|
|
}
|
|
},
|
|
"admission": {
|
|
"type": "object",
|
|
"required": ["status", "code", "reason", "missingPrerequisites"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"status": { "const": "blocked" },
|
|
"code": { "const": "native-integration-not-admitted" },
|
|
"reason": { "$ref": "#/definitions/nonEmptyString" },
|
|
"missingPrerequisites": {
|
|
"type": "array",
|
|
"minItems": 4,
|
|
"maxItems": 4,
|
|
"uniqueItems": true,
|
|
"items": {
|
|
"type": "string",
|
|
"enum": [
|
|
"stable-auditable-protocol",
|
|
"integration-authorization",
|
|
"deterministic-command-receipts",
|
|
"user-interaction-pause-signal"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"compliance": {
|
|
"type": "object",
|
|
"required": ["reviewedAt", "reviewedBy", "upstreamEndorsed", "relationshipDisclosure", "artifactReviews"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"reviewedAt": { "type": "string", "format": "date" },
|
|
"reviewedBy": { "$ref": "#/definitions/nonEmptyString" },
|
|
"upstreamEndorsed": { "const": false },
|
|
"relationshipDisclosure": { "const": "independent-listing-not-endorsed" },
|
|
"artifactReviews": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"items": { "$ref": "#/definitions/artifactReview" },
|
|
"description": "Immutable upstream artifact audit facts; these records do not admit installation or redistribution."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|