com.emdashcms.experimental.labeler.defs

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "assessmentSubject": {
      "description": "An exact publisher record revision assessed for display in a plugin listing.",
      "properties": {
        "cid": {
          "description": "CID of the exact assessed record revision.",
          "format": "cid",
          "type": "string"
        },
        "kind": {
          "description": "Whether the record supplies package-profile metadata or release metadata and media.",
          "knownValues": [
            "profile",
            "release"
          ],
          "type": "string"
        },
        "uri": {
          "description": "AT URI of the assessed record.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "uri",
        "cid"
      ],
      "type": "object"
    },
    "coverage": {
      "description": "Completion state for every class of publisher-controlled content the admin may display or link.",
      "properties": {
        "links": {
          "knownValues": [
            "complete",
            "not-present",
            "unavailable"
          ],
          "type": "string"
        },
        "media": {
          "knownValues": [
            "complete",
            "not-present",
            "partial",
            "unavailable"
          ],
          "type": "string"
        },
        "text": {
          "knownValues": [
            "complete",
            "not-present",
            "unavailable"
          ],
          "type": "string"
        }
      },
      "required": [
        "text",
        "links",
        "media"
      ],
      "type": "object"
    },
    "currentAssessmentView": {
      "description": "Current assessment and effective standard signed labels for one exact record revision. activeLabels is the moderation authority for this view.",
      "properties": {
        "activeLabels": {
          "description": "Effective signed label state for this exact record revision.",
          "items": {
            "ref": "#signedLabel",
            "type": "ref"
          },
          "maxLength": 16,
          "type": "array"
        },
        "assessment": {
          "ref": "#publicAssessment",
          "type": "ref"
        },
        "src": {
          "format": "did",
          "type": "string"
        },
        "subject": {
          "ref": "#assessmentSubject",
          "type": "ref"
        }
      },
      "required": [
        "src",
        "subject",
        "assessment",
        "activeLabels"
      ],
      "type": "object"
    },
    "labelDefinition": {
      "description": "Public policy meaning for a standard ATProto label value; this is not a second label format.",
      "properties": {
        "issuanceModes": {
          "items": {
            "knownValues": [
              "automated",
              "reviewer",
              "admin"
            ],
            "type": "string"
          },
          "maxLength": 3,
          "minLength": 1,
          "type": "array"
        },
        "officialEffect": {
          "knownValues": [
            "eligible",
            "ineligible",
            "informational",
            "redact"
          ],
          "type": "string"
        },
        "subjectKinds": {
          "items": {
            "knownValues": [
              "profile",
              "release"
            ],
            "type": "string"
          },
          "maxLength": 2,
          "minLength": 1,
          "type": "array"
        },
        "value": {
          "knownValues": [
            "listing-passed",
            "listing-pending",
            "listing-review",
            "listing-error",
            "listing-blocked",
            "listing-overridden",
            "!takedown"
          ],
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "value",
        "officialEffect",
        "subjectKinds",
        "issuanceModes"
      ],
      "type": "object"
    },
    "labelerPolicy": {
      "description": "Versioned public description of this labeler's metadata-only assessment and standard-label policy.",
      "properties": {
        "assessmentSchemaVersion": {
          "minimum": 1,
          "type": "integer"
        },
        "effectiveAt": {
          "format": "datetime",
          "type": "string"
        },
        "labelerDid": {
          "format": "did",
          "type": "string"
        },
        "labels": {
          "items": {
            "ref": "#labelDefinition",
            "type": "ref"
          },
          "maxLength": 16,
          "minLength": 1,
          "type": "array"
        },
        "models": {
          "items": {
            "ref": "#modelDescriptor",
            "type": "ref"
          },
          "maxLength": 4,
          "type": "array"
        },
        "parserVersion": {
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        },
        "policyVersion": {
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        },
        "publicApi": {
          "ref": "#publicApi",
          "type": "ref"
        },
        "reasonCodes": {
          "items": {
            "ref": "#reasonCodeDefinition",
            "type": "ref"
          },
          "maxLength": 64,
          "type": "array"
        },
        "schemaVersion": {
          "maximum": 1,
          "minimum": 1,
          "type": "integer"
        },
        "supportedSubjects": {
          "items": {
            "ref": "#subjectPolicy",
            "type": "ref"
          },
          "maxLength": 2,
          "minLength": 1,
          "type": "array"
        }
      },
      "required": [
        "schemaVersion",
        "policyVersion",
        "effectiveAt",
        "labelerDid",
        "assessmentSchemaVersion",
        "parserVersion",
        "supportedSubjects",
        "reasonCodes",
        "labels",
        "models",
        "publicApi"
      ],
      "type": "object"
    },
    "manualDecision": {
      "description": "Public portion of an exact-revision operator decision.",
      "properties": {
        "decidedAt": {
          "format": "datetime",
          "type": "string"
        },
        "outcome": {
          "knownValues": [
            "approved",
            "blocked"
          ],
          "type": "string"
        },
        "reasonCode": {
          "maxLength": 64,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "outcome",
        "reasonCode",
        "decidedAt"
      ],
      "type": "object"
    },
    "modelDescriptor": {
      "description": "Versioned inference configuration used for one assessment purpose.",
      "properties": {
        "modelId": {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "modelVersion": {
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        },
        "promptHash": {
          "description": "Stable digest of the prompt and strict output contract.",
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        },
        "provider": {
          "knownValues": [
            "workers-ai"
          ],
          "maxLength": 64,
          "type": "string"
        },
        "purpose": {
          "knownValues": [
            "text",
            "image"
          ],
          "type": "string"
        }
      },
      "required": [
        "purpose",
        "provider",
        "modelId",
        "modelVersion",
        "promptHash"
      ],
      "type": "object"
    },
    "publicApi": {
      "properties": {
        "baseUrl": {
          "format": "uri",
          "maxLength": 2048,
          "type": "string"
        },
        "getAssessmentNsid": {
          "format": "nsid",
          "type": "string"
        },
        "getCurrentAssessmentNsid": {
          "format": "nsid",
          "type": "string"
        },
        "getPolicyNsid": {
          "format": "nsid",
          "type": "string"
        },
        "listAssessmentsNsid": {
          "format": "nsid",
          "type": "string"
        }
      },
      "required": [
        "baseUrl",
        "getAssessmentNsid",
        "getCurrentAssessmentNsid",
        "listAssessmentsNsid",
        "getPolicyNsid"
      ],
      "type": "object"
    },
    "publicAssessment": {
      "description": "Public-safe explanation of one immutable metadata-only assessment run. Its labels field contains signed outcome labels emitted by that run, not a second source of effective moderation state.",
      "properties": {
        "assessmentSchemaVersion": {
          "minimum": 1,
          "type": "integer"
        },
        "completedAt": {
          "format": "datetime",
          "type": "string"
        },
        "coverage": {
          "ref": "#coverage",
          "type": "ref"
        },
        "createdAt": {
          "format": "datetime",
          "type": "string"
        },
        "findings": {
          "items": {
            "ref": "#publicFinding",
            "type": "ref"
          },
          "maxLength": 32,
          "type": "array"
        },
        "id": {
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        },
        "labels": {
          "description": "Signed outcome labels emitted by this assessment run. Effective moderation state comes from com.atproto.label queries and subscriptions.",
          "items": {
            "ref": "#signedLabel",
            "type": "ref"
          },
          "maxLength": 16,
          "type": "array"
        },
        "manualDecision": {
          "ref": "#manualDecision",
          "type": "ref"
        },
        "models": {
          "items": {
            "ref": "#modelDescriptor",
            "type": "ref"
          },
          "maxLength": 4,
          "type": "array"
        },
        "parserVersion": {
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        },
        "policyVersion": {
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        },
        "reasonCodes": {
          "description": "Stable public reason codes defined by policyVersion.",
          "items": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          },
          "maxLength": 32,
          "type": "array"
        },
        "src": {
          "description": "DID that issues this assessment's signed labels.",
          "format": "did",
          "type": "string"
        },
        "state": {
          "knownValues": [
            "pending",
            "passed",
            "review",
            "blocked",
            "error",
            "superseded"
          ],
          "type": "string"
        },
        "subject": {
          "ref": "#assessmentSubject",
          "type": "ref"
        },
        "summary": {
          "description": "Optional labeler-authored public summary without raw assessed content.",
          "maxLength": 1024,
          "type": "string"
        },
        "supersededByAssessmentId": {
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "id",
        "src",
        "subject",
        "state",
        "coverage",
        "reasonCodes",
        "findings",
        "assessmentSchemaVersion",
        "policyVersion",
        "parserVersion",
        "models",
        "labels",
        "createdAt"
      ],
      "type": "object"
    },
    "publicFinding": {
      "description": "A bounded, public-safe policy finding. It contains no publisher content or private evidence.",
      "properties": {
        "category": {
          "knownValues": [
            "explicit-sexual-content",
            "hateful-or-dehumanizing-content",
            "graphic-violence",
            "phishing-or-credential-solicitation",
            "material-impersonation",
            "scam-or-spam",
            "malicious-or-deceptive-link",
            "misleading-media-or-claims",
            "moderation-manipulation"
          ],
          "type": "string"
        },
        "reasonCode": {
          "description": "Stable code defined by the assessment's policy version.",
          "maxLength": 64,
          "minLength": 1,
          "type": "string"
        },
        "summary": {
          "description": "Labeler-authored public explanation without raw assessed content.",
          "maxLength": 512,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "category",
        "reasonCode",
        "summary"
      ],
      "type": "object"
    },
    "reasonCodeDefinition": {
      "properties": {
        "code": {
          "maxLength": 64,
          "minLength": 1,
          "type": "string"
        },
        "description": {
          "maxLength": 512,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "code",
        "description"
      ],
      "type": "object"
    },
    "signedLabel": {
      "description": "A standard AT Protocol label with a required signature. Its payload and stored history are immutable; query and subscription delivery may replace sig with a signature from the current key during key rotation.",
      "properties": {
        "cid": {
          "description": "Optional CID of the exact resource revision to which the label applies.",
          "format": "cid",
          "type": "string"
        },
        "cts": {
          "description": "Time at which the label was created.",
          "format": "datetime",
          "type": "string"
        },
        "exp": {
          "description": "Optional time after which the label no longer applies.",
          "format": "datetime",
          "type": "string"
        },
        "neg": {
          "description": "Whether this event negates prior label state.",
          "type": "boolean"
        },
        "sig": {
          "description": "Signature over the canonical DAG-CBOR label payload.",
          "type": "bytes"
        },
        "src": {
          "description": "DID of the label issuer.",
          "format": "did",
          "type": "string"
        },
        "uri": {
          "description": "Resource to which the label applies.",
          "format": "uri",
          "type": "string"
        },
        "val": {
          "description": "Label value.",
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        },
        "ver": {
          "description": "AT Protocol label version.",
          "type": "integer"
        }
      },
      "required": [
        "ver",
        "src",
        "uri",
        "val",
        "cts",
        "sig"
      ],
      "type": "object"
    },
    "subjectPolicy": {
      "properties": {
        "collection": {
          "format": "nsid",
          "type": "string"
        },
        "kind": {
          "knownValues": [
            "profile",
            "release"
          ],
          "type": "string"
        }
      },
      "required": [
        "kind",
        "collection"
      ],
      "type": "object"
    }
  },
  "description": "Public assessment and policy views for the experimental EmDash plugin-listing labeler. Effective moderation decisions are standard signed labels served through com.atproto.label queries and subscriptions. EXPERIMENTAL.",
  "id": "com.emdashcms.experimental.labeler.defs",
  "lexicon": 1
}