@opensoha/contracts 0.1.4

package/agent/agent-provider-definition.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent-provider-definition.schema.json",
+  "title": "Agent Provider Definition",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "kind", "providerVersion", "adapterProtocol", "runtime", "capabilities"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-provider-definition/v1" },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9._-]{1,127}$" },
+    "kind": { "type": "string", "minLength": 1, "maxLength": 64 },
+    "displayName": { "type": "string", "maxLength": 160 },
+    "pluginId": { "type": "string", "maxLength": 128 },
+    "pluginVersion": { "type": "string", "maxLength": 64 },
+    "providerVersion": { "type": "string", "minLength": 1, "maxLength": 64 },
+    "adapterProtocol": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": { "enum": ["cli", "container", "remote"] },
+        "command": { "type": "string", "maxLength": 1024 },
+        "args": { "type": "array", "maxItems": 64, "items": { "type": "string", "maxLength": 2048 } },
+        "promptArg": { "type": "string", "maxLength": 128 },
+        "skillArg": { "type": "string", "maxLength": 128 },
+        "providerSkillArg": { "type": "string", "maxLength": 128 },
+        "image": { "type": "string", "maxLength": 1024 },
+        "endpoint": { "type": "string", "format": "uri", "maxLength": 2048 },
+        "healthPath": { "type": "string", "maxLength": 512 }
+      },
+      "allOf": [
+        { "if": { "properties": { "kind": { "const": "cli" } } }, "then": { "required": ["command"] } },
+        { "if": { "properties": { "kind": { "const": "container" } } }, "then": { "required": ["image"] } },
+        { "if": { "properties": { "kind": { "const": "remote" } } }, "then": { "required": ["endpoint"] } }
+      ]
+    },
+    "capabilities": { "type": "array", "minItems": 1, "maxItems": 128, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+    "requiredGatewayCapabilities": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+    "requiredScopes": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+    "secretRefs": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "type": "string", "pattern": "^secret:[^\\s]{1,240}$" } },
+    "draining": { "type": "boolean", "default": false }
+  }
+}

package/agent/agent-provider-registry.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent-provider-registry.schema.json",
+  "title": "Agent Provider Registry Snapshot",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "revision", "digest", "issuedAt", "providers"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-provider-registry/v1" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "issuedAt": { "type": "string", "format": "date-time" },
+    "providers": { "type": "array", "maxItems": 256, "items": { "$ref": "agent-provider-definition.schema.json" } },
+    "fleetTarget": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "environments": { "type": "array", "maxItems": 32, "items": { "type": "string", "maxLength": 64 } },
+        "platforms": { "type": "array", "maxItems": 16, "items": { "type": "string", "maxLength": 32 } },
+        "architectures": { "type": "array", "maxItems": 16, "items": { "type": "string", "maxLength": 32 } },
+        "labels": { "type": "object", "maxProperties": 32, "additionalProperties": { "type": "string", "maxLength": 128 } }
+      }
+    }
+  }
+}

package/agent/agent-provider-runtime-event.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent-provider-runtime-event.schema.json",
+  "title": "Agent Provider Runtime Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "eventType", "runnerId", "revision", "observedAt"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-provider-runtime-event/v1" },
+    "eventType": { "enum": ["registry_ack", "registry_nack", "provider_health", "provider_draining"] },
+    "runnerId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "revision": { "type": "integer", "minimum": 1 },
+    "activeRevision": { "type": "integer", "minimum": 0 },
+    "providerId": { "type": "string", "maxLength": 128 },
+    "providerVersion": { "type": "string", "maxLength": 64 },
+    "health": { "enum": ["healthy", "degraded", "unhealthy"] },
+    "draining": { "type": "boolean" },
+    "activeRuns": { "type": "integer", "minimum": 0 },
+    "reason": { "type": "string", "maxLength": 2048 },
+    "observedAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [
+    { "if": { "properties": { "eventType": { "enum": ["registry_ack", "registry_nack"] } } }, "then": { "required": ["activeRevision"] } },
+    { "if": { "properties": { "eventType": { "enum": ["provider_health", "provider_draining"] } } }, "then": { "required": ["providerId", "providerVersion", "health", "draining", "activeRuns"] } }
+  ]
+}

package/agent/agent-run-step.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent-run-step.schema.json",
+  "title": "Agent Run Step",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "runId", "sequence", "attempt", "state", "contextRef", "startedAt"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-run-step/v1" },
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "sequence": { "type": "integer", "minimum": 1 },
+    "attempt": { "type": "integer", "minimum": 1 },
+    "state": { "enum": ["queued", "preparing", "running", "waiting_approval", "waiting_environment", "paused", "rejected", "completed", "failed", "cancelled", "budget_exceeded", "timed_out"] },
+    "contextRef": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "modelCallRef": { "type": "string", "maxLength": 512 },
+    "toolCallRefs": { "type": "array", "maxItems": 128, "items": { "type": "string", "maxLength": 512 } },
+    "observationRefs": { "type": "array", "maxItems": 256, "items": { "type": "string", "maxLength": 512 } },
+    "checkpointRef": { "type": "string", "maxLength": 512 },
+    "stopReason": { "enum": ["answer_accepted", "max_steps", "max_tokens", "max_tool_calls", "max_cost", "deadline", "no_progress", "user_cancelled", "policy_denied", "provider_stop", "environment_failure"] },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "completedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/agent/conformance-run.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent/conformance-run.schema.json",
+  "title": "Agent Provider Conformance Run",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "providerRef", "environmentRef", "suiteVersion", "status", "results", "startedAt"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-conformance-run/v1" },
+    "id": { "type": "string", "minLength": 1 },
+    "providerRef": { "type": "string", "minLength": 1 },
+    "environmentRef": { "type": "string", "minLength": 1 },
+    "suiteVersion": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["queued", "running", "passed", "failed", "cancelled"] },
+    "results": { "type": "array", "maxItems": 128, "items": { "type": "object", "required": ["name", "passed"], "properties": { "name": { "type": "string" }, "passed": { "type": "boolean" }, "evidenceRef": { "type": "string" } }, "additionalProperties": false } },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "completedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/agent/environment-lease.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/environment-lease.schema.json",
+  "title": "Agent Environment Lease",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "runId", "ownerId", "scopeHash", "mode", "quota", "issuedAt", "expiresAt"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/environment-lease/v1" },
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "ownerId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "scopeHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "mode": { "enum": ["observe-only", "restricted-write"] },
+    "workspacePath": { "type": "string", "maxLength": 2048 },
+    "quota": {
+      "type": "object", "additionalProperties": false,
+      "required": ["diskBytes", "memoryBytes", "cpuUnits", "maxProcesses", "networkEgress"],
+      "properties": {
+        "diskBytes": { "type": "integer", "minimum": 1 },
+        "memoryBytes": { "type": "integer", "minimum": 1 },
+        "cpuUnits": { "type": "integer", "minimum": 1 },
+        "maxProcesses": { "type": "integer", "minimum": 1 },
+        "networkEgress": { "type": "boolean" }
+      }
+    },
+    "issuedAt": { "type": "string", "format": "date-time" },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "releasedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/agent/environment-snapshot.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/environment-snapshot.schema.json",
+  "title": "Agent Environment Snapshot",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "leaseId", "runId", "state", "resourceUsage", "observedAt"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/environment-snapshot/v1" },
+    "leaseId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "state": { "enum": ["active", "released", "expired", "quota_exceeded"] },
+    "resourceUsage": {
+      "type": "object", "additionalProperties": false,
+      "required": ["diskBytes", "memoryBytes", "cpuTimeNanos", "processes"],
+      "properties": {
+        "diskBytes": { "type": "integer", "minimum": 0 },
+        "memoryBytes": { "type": "integer", "minimum": 0 },
+        "cpuTimeNanos": { "type": "integer", "minimum": 0 },
+        "processes": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "artifactRefs": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "type": "string", "maxLength": 512 } },
+    "observedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/agent/environment-template.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent/environment-template.schema.json",
+  "title": "Agent Environment Template",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "version", "backend", "isolationMode", "quota", "ttlSeconds", "enabled"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-environment-template/v1" },
+    "id": { "type": "string", "minLength": 1 },
+    "version": { "type": "string", "minLength": 1 },
+    "backend": { "enum": ["local-process", "container", "kubernetes"] },
+    "isolationMode": { "enum": ["observe-only", "restricted-write", "disposable-write"] },
+    "quota": { "type": "object", "required": ["cpuUnits", "memoryBytes", "diskBytes", "maxProcesses"], "properties": { "cpuUnits": { "type": "integer", "minimum": 1 }, "memoryBytes": { "type": "integer", "minimum": 1 }, "diskBytes": { "type": "integer", "minimum": 1 }, "maxProcesses": { "type": "integer", "minimum": 1 } }, "additionalProperties": false },
+    "networkEgress": { "type": "boolean" },
+    "ttlSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 },
+    "enabled": { "type": "boolean" }
+  }
+}

package/agent/fleet-target.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent/fleet-target.schema.json",
+  "title": "Agent Fleet Target",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-fleet-target/v1" },
+    "environments": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "maxLength": 64 } },
+    "platforms": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "maxLength": 32 } },
+    "architectures": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "maxLength": 32 } },
+    "labels": { "type": "object", "maxProperties": 32, "additionalProperties": { "type": "string", "maxLength": 128 } }
+  }
+}

package/agent/multi-agent-plan.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent/multi-agent-plan.schema.json",
+  "title": "Bounded Multi-Agent Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "coordinatorRef", "subtasks", "sharedBudget", "status", "createdAt"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/multi-agent-plan/v1" },
+    "id": { "type": "string", "minLength": 1 },
+    "coordinatorRef": { "type": "string", "minLength": 1 },
+    "subtasks": { "type": "array", "minItems": 1, "maxItems": 8, "items": { "type": "object", "required": ["id", "agentProfileRef", "input", "permissionKeys", "status"], "properties": { "id": { "type": "string" }, "agentProfileRef": { "type": "string" }, "input": { "type": "string", "maxLength": 16000 }, "permissionKeys": { "type": "array", "maxItems": 64, "items": { "type": "string" } }, "status": { "enum": ["pending", "running", "completed", "failed", "cancelled"] } }, "additionalProperties": false } },
+    "sharedBudget": { "type": "object", "required": ["maxSteps", "maxTokens", "maxCost", "deadlineSeconds"], "properties": { "maxSteps": { "type": "integer", "minimum": 1, "maximum": 100 }, "maxTokens": { "type": "integer", "minimum": 1, "maximum": 2000000 }, "maxCost": { "type": "number", "minimum": 0 }, "deadlineSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 } }, "additionalProperties": false },
+    "status": { "enum": ["running", "completed", "failed", "cancelled"] },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "completedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/agent/provider-rollout.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensoha.dev/schemas/agent/provider-rollout.schema.json",
+  "title": "Agent Provider Rollout",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "desiredRevision", "previousRevision", "target", "status", "createdAt"],
+  "properties": {
+    "schemaVersion": { "const": "opensoha.dev/agent-provider-rollout/v1" },
+    "id": { "type": "string", "minLength": 1 },
+    "desiredRevision": { "type": "integer", "minimum": 1 },
+    "previousRevision": { "type": "integer", "minimum": 0 },
+    "target": { "type": "object" },
+    "status": { "enum": ["draft", "validating", "canary", "rolling_out", "paused", "converged", "rolling_back", "rolled_back", "failed"] },
+    "batchSize": { "type": "integer", "minimum": 1, "maximum": 1000 },
+    "ackTimeoutSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 },
+    "createdAt": { "type": "string", "format": "date-time" }
+  }
+}

package/apiresponse/response.go

@@ -0,0 +1,25 @@
+package apiresponse
+
+type ErrorBody struct {
+	Code      string `json:"code"`
+	Message   string `json:"message"`
+	RequestID string `json:"request_id,omitempty"`
+}
+
+func Item(data any) map[string]any {
+	return map[string]any{"data": data}
+}
+
+func Items(items any) map[string]any {
+	return map[string]any{"items": items}
+}
+
+func Error(code, message, requestID string) map[string]any {
+	return map[string]any{
+		"error": ErrorBody{
+			Code:      code,
+			Message:   message,
+			RequestID: requestID,
+		},
+	}
+}

package/apiresponse/response_test.go

@@ -0,0 +1,27 @@
+package apiresponse
+
+import "testing"
+
+func TestItemAndItems(t *testing.T) {
+	t.Parallel()
+
+	if got := Item("value")["data"]; got != "value" {
+		t.Fatalf("Item() data = %v, want value", got)
+	}
+	if got := Items([]string{"a"})["items"]; got == nil {
+		t.Fatal("Items() items is nil")
+	}
+}
+
+func TestError(t *testing.T) {
+	t.Parallel()
+
+	payload := Error("invalid_argument", "bad input", "request-1")
+	body, ok := payload["error"].(ErrorBody)
+	if !ok {
+		t.Fatalf("Error() error body type = %T, want ErrorBody", payload["error"])
+	}
+	if body.Code != "invalid_argument" || body.Message != "bad input" || body.RequestID != "request-1" {
+		t.Fatalf("Error() body = %#v", body)
+	}
+}

package/auth/token-claims.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.opensoha.dev/auth/token-claims.schema.json",
+  "title": "Soha Token Claims",
+  "description": "JWT/access-token claims shared by Soha core, CLI, agent runtime, and future cloud edge services.",
+  "type": "object",
+  "required": ["sub", "exp", "iat", "tokenId", "tokenKind", "subjectType", "subjectId"],
+  "properties": {
+    "iss": { "type": "string" },
+    "sub": { "type": "string", "minLength": 1 },
+    "aud": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      ]
+    },
+    "exp": { "type": "integer" },
+    "nbf": { "type": "integer" },
+    "iat": { "type": "integer" },
+    "jti": { "type": "string" },
+    "tenantId": {
+      "type": "string",
+      "default": "default"
+    },
+    "workspaceId": {
+      "type": "string",
+      "default": "default"
+    },
+    "tokenId": { "type": "string", "minLength": 1 },
+    "tokenKind": {
+      "type": "string",
+      "enum": [
+        "session",
+        "personal_access_token",
+        "service_account",
+        "runtime_execution_runner",
+        "stream_ticket"
+      ]
+    },
+    "sessionId": { "type": "string" },
+    "subjectType": {
+      "type": "string",
+      "enum": ["user", "service_account", "runner", "anonymous"]
+    },
+    "subjectId": { "type": "string", "minLength": 1 },
+    "userId": { "type": "string" },
+    "userName": { "type": "string" },
+    "email": { "type": "string" },
+    "roles": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "teams": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "permissionKeys": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "scopes": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "aiClientId": { "type": "string" },
+    "skillId": { "type": "string" },
+    "path": { "type": "string" }
+  },
+  "additionalProperties": true
+}
+

package/capabilities/cluster-capability-matrix.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.opensoha.dev/capabilities/cluster-capability-matrix.schema.json",
+  "title": "OpenSoha Cluster Capability Matrix",
+  "description": "Shared capability matrix for Direct and Agent runtime support across Kubernetes, Helm, YAML, logs, exec, port-forward, and Docker capabilities.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["items"],
+  "properties": {
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "capabilitySetVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "items": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/CapabilityMatrixEntry" }
+    }
+  },
+  "$defs": {
+    "CapabilityStatus": {
+      "type": "string",
+      "enum": ["available", "partial", "unsupported"]
+    },
+    "RiskLevel": {
+      "type": "string",
+      "enum": ["read", "analyze", "mutate", "execute", "high"]
+    },
+    "ModeSupport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "allOf": [
+        {
+          "if": {
+            "required": ["status"],
+            "properties": {
+              "status": { "enum": ["partial", "unsupported"] }
+            }
+          },
+          "then": { "required": ["reason"] }
+        }
+      ],
+      "properties": {
+        "status": { "$ref": "#/$defs/CapabilityStatus" },
+        "reason": { "type": "string", "minLength": 1 },
+        "diagnostic": { "type": "string" },
+        "requiredAgentVersion": { "type": "string" },
+        "requiredScopes": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        }
+      }
+    },
+    "CapabilityMatrixEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "label", "category", "riskLevel", "requiresApproval", "direct", "agent"],
+      "properties": {
+        "key": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[a-z][a-z0-9]*(\\.[a-z][a-z0-9-]*)+$",
+          "description": "Stable capability key such as kubernetes.yaml.apply or docker.logs.stream."
+        },
+        "label": { "type": "string", "minLength": 1 },
+        "category": {
+          "type": "string",
+          "enum": ["kubernetes", "helm", "yaml", "logs", "exec", "port-forward", "docker", "runtime"]
+        },
+        "riskLevel": { "$ref": "#/$defs/RiskLevel" },
+        "requiresApproval": { "type": "boolean" },
+        "direct": { "$ref": "#/$defs/ModeSupport" },
+        "agent": { "$ref": "#/$defs/ModeSupport" },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    }
+  }
+}

package/compat/json-schema-ecosystem-0.1.0.json

@@ -0,0 +1,59 @@
+{
+  "version": "0.1.4",
+  "schemas": {
+    "plugins/plugin-manifest.schema.json": {
+      "rootRequired": ["id", "name", "publisher", "type", "version"],
+      "rootProperties": [
+        "assets",
+        "capabilities",
+        "compatibility",
+        "description",
+        "homepage",
+        "id",
+        "integrity",
+        "metadata",
+        "name",
+        "permissions",
+        "publisher",
+        "secrets",
+        "type",
+        "version"
+      ],
+      "enums": [
+        {
+          "path": "properties/type",
+          "values": [
+            "agent-profile",
+            "ai-provider-adapter",
+            "connector",
+            "gateway-policy-pack",
+            "mcp-preset",
+            "skill",
+            "skill-pack"
+          ]
+        }
+      ]
+    },
+    "skills/skill-manifest.schema.json": {
+      "rootRequired": ["category", "id", "name"],
+      "rootProperties": [
+        "capabilityRefs",
+        "category",
+        "description",
+        "id",
+        "metadata",
+        "name",
+        "permissionKeys",
+        "providerSkillRefs",
+        "requiredScopes",
+        "version"
+      ],
+      "enums": []
+    },
+    "connectors/connector-event-envelope.schema.json": {
+      "rootRequired": ["connectorId", "events"],
+      "rootProperties": ["connectorId", "events"],
+      "enums": []
+    }
+  }
+}