com.emdashcms.experimental.labeler.defs

emdashcms.com

Documentation

assessmentSubject object

An exact publisher record revision assessed for display in a plugin listing.

Properties

cid string cid Required

CID of the exact assessed record revision.

kind string Required

Whether the record supplies package-profile metadata or release metadata and media.

Known values: profile, release
uri string at-uri Required

AT URI of the assessed record.

View raw schema
{
  "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 object

Completion state for every class of publisher-controlled content the admin may display or link.

Properties

media string Required

No description available.

Known values: complete, not-present, partial, unavailable
text string Required

No description available.

Known values: complete, not-present, unavailable
View raw schema
{
  "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 object

Current assessment and effective standard signed labels for one exact record revision. activeLabels is the moderation authority for this view.

Properties

activeLabels array of ref#signedLabel Required

Effective signed label state for this exact record revision.

maxLength: 16 items
src string did Required

A decentralized identifier (DID).

View raw schema
{
  "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 object

Public policy meaning for a standard ATProto label value; this is not a second label format.

Properties

issuanceModes array of string Required

No description available.

maxLength: 3 itemsminLength: 1 items
officialEffect string Required

No description available.

Known values: eligible, ineligible, informational, redact
subjectKinds array of string Required

No description available.

maxLength: 2 itemsminLength: 1 items
value string Required

No description available.

maxLength: 128 bytesminLength: 1 bytes
Known values: listing-passed, listing-pending, listing-review, listing-error, listing-blocked, listing-overridden, !takedown
View raw schema
{
  "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 object

Versioned public description of this labeler's metadata-only assessment and standard-label policy.

Properties

assessmentSchemaVersion integer Required

No description available.

minimum: 1
effectiveAt string datetime Required

An RFC 3339 formatted timestamp.

labelerDid string did Required

A decentralized identifier (DID).

labels array of ref#labelDefinition Required

No description available.

maxLength: 16 itemsminLength: 1 items
models array of ref#modelDescriptor Required

No description available.

maxLength: 4 items
parserVersion string Required

No description available.

maxLength: 128 bytesminLength: 1 bytes
policyVersion string Required

No description available.

maxLength: 128 bytesminLength: 1 bytes
publicApi ref #publicApi Required

No description available.

schemaVersion integer Required

No description available.

minimum: 1maximum: 1
supportedSubjects array of ref#subjectPolicy Required

No description available.

maxLength: 2 itemsminLength: 1 items
View raw schema
{
  "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 object

Public portion of an exact-revision operator decision.

Properties

decidedAt string datetime Required

An RFC 3339 formatted timestamp.

outcome string Required

No description available.

Known values: approved, blocked
reasonCode string Required

No description available.

maxLength: 64 bytesminLength: 1 bytes
View raw schema
{
  "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 object

Versioned inference configuration used for one assessment purpose.

Properties

modelId string Required

No description available.

maxLength: 256 bytesminLength: 1 bytes
modelVersion string Required

No description available.

maxLength: 128 bytesminLength: 1 bytes
promptHash string Required

Stable digest of the prompt and strict output contract.

maxLength: 128 bytesminLength: 1 bytes
provider string Required

No description available.

maxLength: 64 bytes
Known values: workers-ai
purpose string Required

No description available.

Known values: text, image
View raw schema
{
  "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 object

No description available.

Properties

baseUrl string uri Required

A valid URI.

maxLength: 2048 bytes
getAssessmentNsid string nsid Required

A namespaced identifier (e.g., app.bsky.feed.post).

getCurrentAssessmentNsid string nsid Required

A namespaced identifier (e.g., app.bsky.feed.post).

getPolicyNsid string nsid Required

A namespaced identifier (e.g., app.bsky.feed.post).

listAssessmentsNsid string nsid Required

A namespaced identifier (e.g., app.bsky.feed.post).

View raw schema
{
  "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 object

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 integer Required

No description available.

minimum: 1
completedAt string datetime Optional

An RFC 3339 formatted timestamp.

coverage ref #coverage Required

No description available.

createdAt string datetime Required

An RFC 3339 formatted timestamp.

findings array of ref#publicFinding Required

No description available.

maxLength: 32 items
id string Required

No description available.

maxLength: 100 bytesminLength: 1 bytes
labels array of ref#signedLabel Required

Signed outcome labels emitted by this assessment run. Effective moderation state comes from com.atproto.label queries and subscriptions.

maxLength: 16 items
models array of ref#modelDescriptor Required

No description available.

maxLength: 4 items
parserVersion string Required

No description available.

maxLength: 128 bytesminLength: 1 bytes
policyVersion string Required

No description available.

maxLength: 128 bytesminLength: 1 bytes
reasonCodes array of string Required

Stable public reason codes defined by policyVersion.

maxLength: 32 items
src string did Required

DID that issues this assessment's signed labels.

state string Required

No description available.

Known values: pending, passed, review, blocked, error, superseded
summary string Optional

Optional labeler-authored public summary without raw assessed content.

maxLength: 1024 bytes
supersededByAssessmentId string Optional

No description available.

maxLength: 100 bytesminLength: 1 bytes
View raw schema
{
  "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 object

A bounded, public-safe policy finding. It contains no publisher content or private evidence.

Properties

category string Required

No description available.

Known values: 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
reasonCode string Required

Stable code defined by the assessment's policy version.

maxLength: 64 bytesminLength: 1 bytes
summary string Required

Labeler-authored public explanation without raw assessed content.

maxLength: 512 bytesminLength: 1 bytes
View raw schema
{
  "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 object

No description available.

Properties

code string Required

No description available.

maxLength: 64 bytesminLength: 1 bytes
description string Required

No description available.

maxLength: 512 bytesminLength: 1 bytes
View raw schema
{
  "properties": {
    "code": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "maxLength": 512,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "code",
    "description"
  ],
  "type": "object"
}
signedLabel object

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 string cid Optional

Optional CID of the exact resource revision to which the label applies.

cts string datetime Required

Time at which the label was created.

exp string datetime Optional

Optional time after which the label no longer applies.

neg boolean Optional

Whether this event negates prior label state.

sig bytes Required

Signature over the canonical DAG-CBOR label payload.

src string did Required

DID of the label issuer.

uri string uri Required

Resource to which the label applies.

val string Required

Label value.

maxLength: 128 bytesminLength: 1 bytes
ver integer Required

AT Protocol label version.

View raw schema
{
  "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 object

No description available.

Properties

collection string nsid Required

A namespaced identifier (e.g., app.bsky.feed.post).

kind string Required

No description available.

Known values: profile, release
View raw schema
{
  "properties": {
    "collection": {
      "format": "nsid",
      "type": "string"
    },
    "kind": {
      "knownValues": [
        "profile",
        "release"
      ],
      "type": "string"
    }
  },
  "required": [
    "kind",
    "collection"
  ],
  "type": "object"
}

Lexicon Garden

@