{
  "$defs": {
    "AccessPolicy": {
      "description": "Access control policy for a MARS entry.\n\nWhen `public` is `true` the entry is discoverable by any resolver. When\n`false`, only DIDs listed in `allowed_dids` (or those presenting a required\nattestation type) may resolve it.",
      "properties": {
        "allowedDids": {
          "description": "Explicit DID allow-list (relevant when `public` is `false`).",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "public": {
          "default": true,
          "description": "Whether the entry is publicly discoverable.",
          "type": "boolean"
        },
        "requiredAttestationTypes": {
          "description": "Attestation type URIs that grant access (relevant when `public` is\n`false`).",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "AnchorState": {
      "description": "Registry-managed lifecycle of an anchor intent or entry projection.",
      "oneOf": [
        {
          "const": "unanchored",
          "description": "No anchor has been requested for the current entry snapshot.",
          "type": "string"
        },
        {
          "const": "pending",
          "description": "Durable work exists and is ready for a worker.",
          "type": "string"
        },
        {
          "const": "submitted",
          "description": "A provider accepted the submission but has not confirmed it.",
          "type": "string"
        },
        {
          "const": "confirmed",
          "description": "The provider reported final confirmation.",
          "type": "string"
        },
        {
          "const": "failed",
          "description": "The latest attempt failed and is eligible for a bounded retry.",
          "type": "string"
        },
        {
          "const": "abandoned",
          "description": "Retry policy or an administrator ended processing permanently.",
          "type": "string"
        }
      ]
    },
    "BondAmount": {
      "description": "Exact, non-negative decimal amount used by every bond money field.\n\nThe wire form is always a JSON string in canonical plain-decimal notation.\nValues are constrained to PostgreSQL `NUMERIC(38,18)`: at most 20 integer\ndigits and 18 fractional digits, with no sign or exponent. This keeps\nsignature bytes, threshold checks, and database values identical.",
      "pattern": "^(0|[1-9][0-9]{0,19})(\\.[0-9]{1,18})?$",
      "type": "string"
    },
    "BondReference": {
      "description": "A reference to a bond stored in a MARS entry.\nPer MARS Specification Section 7.2.",
      "properties": {
        "amount": {
          "$ref": "#/$defs/BondAmount",
          "description": "Amount staked in MINTS."
        },
        "bondId": {
          "description": "Unique bond identifier.",
          "type": "string"
        },
        "currency": {
          "description": "Currency — always \"MINTS\".",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/BondStatus",
          "description": "Current bond status."
        }
      },
      "required": [
        "bondId",
        "amount",
        "currency",
        "status"
      ],
      "type": "object"
    },
    "BondStatus": {
      "description": "Status of a publisher bond.\nPer MARS Specification Appendix A (bondReference schema).",
      "oneOf": [
        {
          "const": "active",
          "description": "Bond is active and fully collateralized.",
          "type": "string"
        },
        {
          "const": "partially_slashed",
          "description": "Bond has been partially slashed but still covers minimum.",
          "type": "string"
        },
        {
          "const": "fully_slashed",
          "description": "Bond has been fully slashed — entry should be revoked.",
          "type": "string"
        },
        {
          "const": "released",
          "description": "Bond has been released back to the publisher.",
          "type": "string"
        }
      ]
    },
    "EntrySignature": {
      "description": "Cryptographic signature over a MARS entry's canonical content.\n\nThe signature uses `MARS-PUBLISHER-SIGNING-V1`: JCS (RFC 8785) over\npublisher-authored fields after removing only `signature`, `sequence`,\n`updatedAt`, `lifecycleStatus`, `verifiableAttestations`, `shardAssignment`,\n`anchorProjection`, `anchorState`, `anchorTxHash`, `anchorBlockHeight`, and\n`anchorProof`.",
      "properties": {
        "algorithm": {
          "description": "Signature algorithm. Always \"Ed25519\".",
          "pattern": "^Ed25519$",
          "type": "string"
        },
        "created": {
          "description": "ISO 8601 timestamp of when the signature was created.",
          "type": [
            "string",
            "null"
          ]
        },
        "keyId": {
          "description": "DID URL of the signing key (e.g. `\"did:oas:l1fe:ao:org#key-1\"`).",
          "pattern": "^did:oas:.+#.+$",
          "type": "string"
        },
        "value": {
          "description": "Strict URL-safe, unpadded base64url signature bytes.\n\nStandard-base64 characters (`+`, `/`) and `=` padding are rejected.",
          "type": "string"
        }
      },
      "required": [
        "algorithm",
        "keyId",
        "value"
      ],
      "type": "object"
    },
    "EntryType": {
      "description": "The 10 OAS-aligned entry types plus 4 MAP plugin types (14 total).\n\nEach variant maps to an [`oas_did::EntityKind`] value via the\n[`oas_kind`](Self::oas_kind) method.\n\n# Serialization\n\nVariants serialize to their PascalCase name (e.g. `\"AgentDefinition\"`).",
      "oneOf": [
        {
          "const": "AgentDefinition",
          "description": "A registered autonomous agent.",
          "type": "string"
        },
        {
          "const": "ToolDefinition",
          "description": "A tool that agents can invoke.",
          "type": "string"
        },
        {
          "const": "SkillDefinition",
          "description": "A composable skill unit.",
          "type": "string"
        },
        {
          "const": "WorkflowDefinition",
          "description": "A multi-step workflow definition.",
          "type": "string"
        },
        {
          "const": "ModelDefinition",
          "description": "A machine learning model with provenance.",
          "type": "string"
        },
        {
          "const": "DatasetDefinition",
          "description": "A dataset with verified lineage.",
          "type": "string"
        },
        {
          "const": "ServiceDefinition",
          "description": "An infrastructure or API service.",
          "type": "string"
        },
        {
          "const": "OrganizationDefinition",
          "description": "An autonomous organization record.",
          "type": "string"
        },
        {
          "const": "HumanRootRecord",
          "description": "A single verified human root (HMR).",
          "type": "string"
        },
        {
          "const": "MultiHumanRootRecord",
          "description": "A threshold-group multi-human root (MHR).",
          "type": "string"
        },
        {
          "const": "MapPlugin",
          "description": "A MAP plugin definition + metadata.",
          "type": "string"
        },
        {
          "const": "MapPluginRelease",
          "description": "A specific version binary + config for a MAP plugin.",
          "type": "string"
        },
        {
          "const": "MapIntegrationSchema",
          "description": "A reusable integration type definition for MAP plugins.",
          "type": "string"
        },
        {
          "const": "MapPluginCollection",
          "description": "A curated bundle of MAP plugins.",
          "type": "string"
        }
      ]
    },
    "LifecycleStatus": {
      "description": "The lifecycle status of a MARS registry entry.",
      "oneOf": [
        {
          "const": "draft",
          "description": "Entry submitted but not yet bonded/anchored.",
          "type": "string"
        },
        {
          "const": "active",
          "description": "Entry bonded, anchored, and serving.",
          "type": "string"
        },
        {
          "const": "deprecated",
          "description": "Superseded by newer version; still resolvable.",
          "type": "string"
        },
        {
          "const": "archived",
          "description": "No longer actively served; preserved for history.",
          "type": "string"
        },
        {
          "const": "revoked",
          "description": "Permanently deactivated; irreversible.",
          "type": "string"
        },
        {
          "const": "experimental",
          "description": "Published for testing; lower bond requirements.",
          "type": "string"
        }
      ]
    },
    "LineageReference": {
      "description": "A reference to the human lineage chain of a MARS entry's publisher.\n\nEvery non-root entry traces back to a human root DID through a chain of\ndelegations.",
      "properties": {
        "generation": {
          "description": "The generation distance from the root (0 = direct child).",
          "format": "uint32",
          "minimum": 0,
          "type": "integer"
        },
        "humanRootDid": {
          "description": "The DID of the originating human root.",
          "pattern": "^did:oas:",
          "type": "string"
        },
        "lineageChain": {
          "description": "Ordered chain of DIDs from root to publisher.",
          "items": {
            "pattern": "^did:oas:",
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "humanRootDid",
        "generation"
      ],
      "type": "object"
    },
    "Relationship": {
      "description": "A typed directional relationship between two MARS entries.",
      "properties": {
        "label": {
          "description": "Optional human-readable label for the relationship.",
          "type": [
            "string",
            "null"
          ]
        },
        "relationshipType": {
          "$ref": "#/$defs/RelationshipType",
          "description": "The kind of relationship."
        },
        "targetDid": {
          "description": "The DID of the target entry.",
          "type": "string"
        }
      },
      "required": [
        "relationshipType",
        "targetDid"
      ],
      "type": "object"
    },
    "RelationshipType": {
      "description": "Supported relationship types between MARS entries.",
      "oneOf": [
        {
          "const": "dependsOn",
          "description": "The source entry depends on the target entry.",
          "type": "string"
        },
        {
          "const": "composes",
          "description": "The source entry composes (includes) the target entry.",
          "type": "string"
        },
        {
          "const": "extends",
          "description": "The source entry extends the target entry.",
          "type": "string"
        },
        {
          "const": "replaces",
          "description": "The source entry replaces the target entry.",
          "type": "string"
        },
        {
          "const": "instanceOf",
          "description": "The source entry is an instance of the target entry.",
          "type": "string"
        },
        {
          "const": "publishedBy",
          "description": "The source entry is published by the target organization/human.",
          "type": "string"
        },
        {
          "const": "relatedTo",
          "description": "The source entry is related to the target entry (generic).",
          "type": "string"
        }
      ]
    },
    "SemVer": {
      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
      "type": "string"
    },
    "SemanticAnnotation": {
      "description": "RDF-style semantic annotation attached to a MARS entry.\n\nAnnotations express facts about an entry in predicate-object form. At least\none of `object_literal` or `object_uri` must be provided; supplying both is\nvalid and indicates the literal is a label/display form of the referenced\nresource.\n\n# Serialization\n\nAll fields use camelCase when serialized to JSON.\n\n# Examples\n\n```\nuse mars_protocol::types::SemanticAnnotation;\n\nlet ann = SemanticAnnotation {\n    predicate_uri: \"https://schema.org/author\".into(),\n    object_literal: Some(\"Ada Lovelace\".into()),\n    object_uri: Some(\"did:oas:hmr:abc123\".into()),\n};\nassert!(ann.validate().is_ok());\n```",
      "properties": {
        "objectLiteral": {
          "description": "A literal value for the object (plain text, number-as-string, etc.).",
          "type": [
            "string",
            "null"
          ]
        },
        "objectUri": {
          "description": "A URI reference for the object (another DID, schema URL, etc.).",
          "type": [
            "string",
            "null"
          ]
        },
        "predicateUri": {
          "description": "The predicate URI identifying the relationship (e.g. `https://schema.org/author`).",
          "type": "string"
        }
      },
      "required": [
        "predicateUri"
      ],
      "type": "object"
    },
    "ServiceEndpoint": {
      "description": "A service endpoint declared in a MARS entry.\n\nPer the MARS/OpenAgent Endpoint Contract (v1.0.0), each endpoint declares\na transport type, a URL, and a selection priority. Day-one only `https`\nendpoints are consumed; `weave` and `wss` endpoints are stored for\nforward compatibility.\n\n# Forward Compatibility\n\nClients MUST ignore endpoint types they do not support. The `properties`\nfield provides a transport-specific extension point so future metadata\ndoes not require schema-level changes.\n\n# Serialization\n\nAll fields use camelCase. `properties` is omitted when empty/None.\n\n# Examples\n\n```\nuse mars_protocol::types::ServiceEndpoint;\n\nlet ep = ServiceEndpoint {\n    id: \"primary-https\".into(),\n    endpoint_type: \"https\".into(),\n    url: \"https://api.example.com\".into(),\n    priority: 0,\n    properties: None,\n};\nassert!(ep.validate().is_ok());\n```",
      "properties": {
        "id": {
          "description": "Unique identifier within a DID's endpoint set.",
          "type": "string"
        },
        "priority": {
          "description": "Selection priority. 0 = highest. Lower values preferred.",
          "format": "uint32",
          "minimum": 0,
          "type": "integer"
        },
        "properties": {
          "additionalProperties": true,
          "description": "Transport-specific metadata (extensible, optional).",
          "type": [
            "object",
            "null"
          ]
        },
        "type": {
          "description": "Transport type: `\"https\"` (day-one), `\"weave\"`, `\"wss\"` (phase-2).",
          "type": "string"
        },
        "url": {
          "description": "Transport-specific address (URL, peer ID, etc.).",
          "type": "string"
        }
      },
      "required": [
        "id",
        "type",
        "url",
        "priority"
      ],
      "type": "object"
    }
  },
  "$id": "urn:mars:schema:v1:mars-entry",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "A complete MARS registry entry (MARS Specification Section 5).\n\nThis is the canonical on-wire and at-rest representation of every artifact\nregistered in the MARS ecosystem. Required fields are always present;\noptional fields are omitted from JSON when `None` or empty.\n\n# Validation\n\nCall [`validate`](Self::validate) to check structural invariants before\nsigning or persisting.\n\n# Examples\n\n```no_run\nuse mars_protocol::entry::{MarsEntry, EntryType};\n\nlet entry: MarsEntry = serde_json::from_str(r#\"{ ... }\"#)?;\nentry.validate()?;\n# Ok::<(), Box<dyn std::error::Error>>(())\n```",
  "properties": {
    "accessPolicy": {
      "anyOf": [
        {
          "$ref": "#/$defs/AccessPolicy"
        },
        {
          "type": "null"
        }
      ],
      "description": "Access control policy."
    },
    "anchorState": {
      "$ref": "#/$defs/AnchorState",
      "default": "unanchored",
      "description": "Registry-managed anchor projection for the current immutable snapshot.\n\nThis field is excluded from the publisher signing payload and can only\nbe advanced by the registry's durable anchor outbox."
    },
    "bondReference": {
      "anyOf": [
        {
          "$ref": "#/$defs/BondReference"
        },
        {
          "type": "null"
        }
      ],
      "description": "Associated economic bond."
    },
    "customMetadata": {
      "additionalProperties": true,
      "description": "Arbitrary extension metadata.",
      "type": [
        "object",
        "null"
      ]
    },
    "description": {
      "description": "Human-readable description (max 4096 characters).",
      "maxLength": 4096,
      "type": [
        "string",
        "null"
      ]
    },
    "entryDid": {
      "description": "The OAS DID uniquely identifying this entry.",
      "pattern": "^did:oas:",
      "type": "string"
    },
    "entryType": {
      "$ref": "#/$defs/EntryType",
      "description": "The primary entry type (one of 10 OAS kinds)."
    },
    "itemData": {
      "description": "The entry payload conforming to `item_schema_uri`."
    },
    "itemDataHash": {
      "description": "Content hash of `item_data` in `sha256:<hex>` format.",
      "pattern": "^sha256:[a-f0-9]{64}$",
      "type": "string"
    },
    "itemSchemaUri": {
      "description": "URI of the JSON Schema that `item_data` conforms to.",
      "type": "string"
    },
    "lifecycleStatus": {
      "$ref": "#/$defs/LifecycleStatus",
      "default": "active",
      "description": "Current lifecycle status (defaults to `Active`)."
    },
    "lineageReference": {
      "anyOf": [
        {
          "$ref": "#/$defs/LineageReference"
        },
        {
          "type": "null"
        }
      ],
      "description": "Lineage chain to the originating human root."
    },
    "marsVersion": {
      "description": "MARS protocol version. Must be `\"1.0.0\"`.",
      "pattern": "^1\\.0\\.0$",
      "type": "string"
    },
    "name": {
      "description": "Human-readable name (max 256 characters).",
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "publishedAt": {
      "description": "Timestamp of initial publication.",
      "format": "date-time",
      "type": "string"
    },
    "publisherDid": {
      "description": "DID of the publishing entity.",
      "pattern": "^did:oas:",
      "type": "string"
    },
    "relationships": {
      "description": "Typed relationships to other entries.",
      "items": {
        "$ref": "#/$defs/Relationship"
      },
      "type": "array"
    },
    "semanticAnnotations": {
      "description": "RDF-style semantic annotations.",
      "items": {
        "$ref": "#/$defs/SemanticAnnotation"
      },
      "type": "array"
    },
    "sequence": {
      "default": 0,
      "description": "Monotonically increasing counter for replay protection.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "serviceEndpoints": {
      "description": "Service endpoints for OpenAgent resolution.\n\nPer the MARS/OpenAgent Endpoint Contract (v1.0.0), entries MAY declare\ntransport endpoints. Day-one clients consume only `https` endpoints;\n`weave` and `wss` entries are stored for forward compatibility.",
      "items": {
        "$ref": "#/$defs/ServiceEndpoint"
      },
      "type": "array"
    },
    "shardAssignment": {
      "description": "MARS shard assignment (from gal topology map).",
      "type": [
        "string",
        "null"
      ]
    },
    "signature": {
      "$ref": "#/$defs/EntrySignature",
      "description": "Cryptographic signature over the canonical entry content."
    },
    "tags": {
      "description": "Discovery tags.",
      "items": {
        "maxLength": 64,
        "type": "string"
      },
      "maxItems": 50,
      "type": "array"
    },
    "updatedAt": {
      "description": "Timestamp of the most recent update.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "verifiableAttestations": {
      "description": "Verifiable attestations (opaque JSON; validated at a higher layer).",
      "items": true,
      "type": "array"
    },
    "version": {
      "$ref": "#/$defs/SemVer",
      "description": "Semantic version of this entry."
    }
  },
  "required": [
    "marsVersion",
    "entryDid",
    "entryType",
    "name",
    "version",
    "publisherDid",
    "publishedAt",
    "itemSchemaUri",
    "itemData",
    "itemDataHash",
    "signature"
  ],
  "title": "MarsEntry",
  "type": "object"
}