# tools.kryphocron.feed.postPrivate

> Private-tier post. Audience-gated via the required audienceList reference: the substrate serves it only to requesters in the audience list. Not confidential: the record can still reach sync channels such as the firehose, so the gate is access friction, not encryption. The presence of audienceList is what structurally distinguishes private from public.

- Kind: record
- Record key: tid
- Authority: feed.kryphocron.tools
- Lexicon: 1
- Published by [lexicons.kryphocron.tools](https://lexicon.garden/identity/did:plc:femlcrrqw5ja23dlsqc6qtgy), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:femlcrrqw5ja23dlsqc6qtgy/tools.kryphocron.feed.postPrivate)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:femlcrrqw5ja23dlsqc6qtgy/tools.kryphocron.feed.postPrivate/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:femlcrrqw5ja23dlsqc6qtgy/tools.kryphocron.feed.postPrivate/analytics)

## Record (`tools.kryphocron.feed.postPrivate`)

Type: record · key tid

### Properties

- `audienceList` (string · at-uri, required): Required AT-URI reference to the audience list governing visibility. Consulted at read time (not at post time); membership changes on the referenced audience apply retroactively to records carrying this reference.
- `createdAt` (string · datetime, required)
- `embed` (union)
  - One of: `tools.kryphocron.feed.postPublic#embedImage`, `tools.kryphocron.feed.postPublic#embedExternal`, `tools.kryphocron.feed.postPublic#embedRecord`, `tools.kryphocron.feed.postPublic#embedGallery`, `tools.kryphocron.feed.postPublic#embedVideo`, `tools.kryphocron.feed.postPublic#embedRecordWithMedia`
- `embedBlobs` (array): Set by the encoder when `encodedContent` carries the embed: every blob the embed references, so the host keeps them. Readers ignore it for display; the decoded embed is authoritative. Absent when the embed carries no blobs or is not encoded.
  - `items` (blob)
- `encodedContent` (bytes): Optional codec output for at-rest content transform. When present, replaces the `text` field (XOR — exactly one of the two MUST be present, substrate-enforced per validate_record). The codec output itself is opaque to the substrate; for laquna, it includes the 32-byte slug inline at the tail. For `laquna/0.2`, the decoded payload takes one of two forms. Text form: the post's text as UTF-8. Content form: the byte 0xFF, then a UTF-8 JSON object `{text, facets?, embed?}`, where `text` is a string (empty when the post has none) and `facets` and `embed` follow this record's schema, present only when the post has them; 0xFF never starts valid UTF-8, so the two forms cannot be confused. In the content form, `text`, `facets` and `embed` are absent from the stored record, and `embedBlobs`, `mentionDids`, `quote` and `mediaKinds` are derived from the decoded content. See encodedContentCodec for the codec identifier.
  - Constraints: maxLength: 1000000
- `encodedContentCodec` (string): Operator-namespaced codec identifier (e.g. 'laquna/0.2') for the codec that produced `encodedContent`. Required at application layer when `encodedContent` is present (substrate-enforced per validate_record). Matches the Rust-side CodecId(BoundedString<128>) bound.
  - Constraints: maxLength: 128
- `encodedContentGeneration` (string): Optional per-record rotation generation mark, set at encode time by the encoder: the encoding host or the member's client. Readers treat it as asserted by the encoder, not verified, and treat a mark dated in the future as due for rotation. Host rewrite-on-rotate jobs select records by `WHERE encodedContentGeneration < current_generation`. Matches the Rust-side RotationGenerationMark(BoundedString<128>) bound. Encoders MUST pick a lex-sortable encoding; laquna marks are `laquna/{unix seconds, zero-padded to 20 digits}/{64 hex}`.
  - Constraints: maxLength: 128
- `facets` (array)
  - `items` (ref)
    - Reference: `tools.kryphocron.feed.postPublic#facet`
- `labels` (union): Self-applied content labels.
  - One of: `tools.kryphocron.feed.postPublic#selfLabels`
- `langs` (array): Languages the post is written in.
  - Constraints: maxLength: 3
  - `items` (string · language)
- `mediaKinds` (array): Set by the encoder when `encodedContent` carries the embed: the kinds of media the post's own embed carries, each at most once, `image` before `video`, left in the clear so AppViews can filter an author's posts by media without decoding. Images and galleries count as `image`; a video counts as `video` whatever its presentation hint. A record-with-media embed counts its own media. Link cards (GIF links among them), plain quotes and a quoted post's own media do not count. Derived from the encoded embed; readers treat it as asserted by the encoder. Absent when the post has no media or the embed is not encoded.
  - Constraints: maxLength: 2
  - `items` (string)
    - Constraints: knownValues: image | video
- `mentionDids` (array): Set by the encoder when `encodedContent` carries the facets: the DIDs of the post's mention facets, deduplicated, in first-appearance order, left in the clear so AppViews can index mentions without decoding. Derived from the encoded facets. Absent when there are none or the facets are not encoded.
  - `items` (string · did)
- `publicCompanion` (string · at-uri): Optional AT-URI pointing at a paired public-tier record (the public side of a dual-faced post). The linkage lives only on the kryphocron-side record; the public-side record carries no kryphocron-visible markers. When absent, the post is a standalone private post with no public companion.
- `quote` (ref): Set by the encoder when `encodedContent` carries the embed: a strong ref to the quoted record of a record or record-with-media embed, left in the clear so AppViews can index quotes without decoding. Derived from the encoded embed. Absent when the post quotes nothing or the embed is not encoded.
  - Reference: `tools.kryphocron.feed.postPublic#strongRef`
- `reply` (ref)
  - Reference: `tools.kryphocron.feed.postPublic#replyRef`
- `text` (string): Post content.
  - Constraints: maxLength: 3000, maxGraphemes: 300

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "key": "tid",
      "record": {
        "properties": {
          "audienceList": {
            "description": "Required AT-URI reference to the audience list governing visibility. Consulted at read time (not at post time); membership changes on the referenced audience apply retroactively to records carrying this reference.",
            "format": "at-uri",
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "embed": {
            "refs": [
              "tools.kryphocron.feed.postPublic#embedImage",
              "tools.kryphocron.feed.postPublic#embedExternal",
              "tools.kryphocron.feed.postPublic#embedRecord",
              "tools.kryphocron.feed.postPublic#embedGallery",
              "tools.kryphocron.feed.postPublic#embedVideo",
              "tools.kryphocron.feed.postPublic#embedRecordWithMedia"
            ],
            "type": "union"
          },
          "embedBlobs": {
            "description": "Set by the encoder when `encodedContent` carries the embed: every blob the embed references, so the host keeps them. Readers ignore it for display; the decoded embed is authoritative. Absent when the embed carries no blobs or is not encoded.",
            "items": {
              "type": "blob"
            },
            "type": "array"
          },
          "encodedContent": {
            "description": "Optional codec output for at-rest content transform. When present, replaces the `text` field (XOR — exactly one of the two MUST be present, substrate-enforced per validate_record). The codec output itself is opaque to the substrate; for laquna, it includes the 32-byte slug inline at the tail. For `laquna/0.2`, the decoded payload takes one of two forms. Text form: the post's text as UTF-8. Content form: the byte 0xFF, then a UTF-8 JSON object `{text, facets?, embed?}`, where `text` is a string (empty when the post has none) and `facets` and `embed` follow this record's schema, present only when the post has them; 0xFF never starts valid UTF-8, so the two forms cannot be confused. In the content form, `text`, `facets` and `embed` are absent from the stored record, and `embedBlobs`, `mentionDids`, `quote` and `mediaKinds` are derived from the decoded content. See encodedContentCodec for the codec identifier.",
            "maxLength": 1000000,
            "type": "bytes"
          },
          "encodedContentCodec": {
            "description": "Operator-namespaced codec identifier (e.g. 'laquna/0.2') for the codec that produced `encodedContent`. Required at application layer when `encodedContent` is present (substrate-enforced per validate_record). Matches the Rust-side CodecId(BoundedString<128>) bound.",
            "maxLength": 128,
            "type": "string"
          },
          "encodedContentGeneration": {
            "description": "Optional per-record rotation generation mark, set at encode time by the encoder: the encoding host or the member's client. Readers treat it as asserted by the encoder, not verified, and treat a mark dated in the future as due for rotation. Host rewrite-on-rotate jobs select records by `WHERE encodedContentGeneration < current_generation`. Matches the Rust-side RotationGenerationMark(BoundedString<128>) bound. Encoders MUST pick a lex-sortable encoding; laquna marks are `laquna/{unix seconds, zero-padded to 20 digits}/{64 hex}`.",
            "maxLength": 128,
            "type": "string"
          },
          "facets": {
            "items": {
              "ref": "tools.kryphocron.feed.postPublic#facet",
              "type": "ref"
            },
            "type": "array"
          },
          "labels": {
            "description": "Self-applied content labels.",
            "refs": [
              "tools.kryphocron.feed.postPublic#selfLabels"
            ],
            "type": "union"
          },
          "langs": {
            "description": "Languages the post is written in.",
            "items": {
              "format": "language",
              "type": "string"
            },
            "maxLength": 3,
            "type": "array"
          },
          "mediaKinds": {
            "description": "Set by the encoder when `encodedContent` carries the embed: the kinds of media the post's own embed carries, each at most once, `image` before `video`, left in the clear so AppViews can filter an author's posts by media without decoding. Images and galleries count as `image`; a video counts as `video` whatever its presentation hint. A record-with-media embed counts its own media. Link cards (GIF links among them), plain quotes and a quoted post's own media do not count. Derived from the encoded embed; readers treat it as asserted by the encoder. Absent when the post has no media or the embed is not encoded.",
            "items": {
              "knownValues": [
                "image",
                "video"
              ],
              "type": "string"
            },
            "maxLength": 2,
            "type": "array"
          },
          "mentionDids": {
            "description": "Set by the encoder when `encodedContent` carries the facets: the DIDs of the post's mention facets, deduplicated, in first-appearance order, left in the clear so AppViews can index mentions without decoding. Derived from the encoded facets. Absent when there are none or the facets are not encoded.",
            "items": {
              "format": "did",
              "type": "string"
            },
            "type": "array"
          },
          "publicCompanion": {
            "description": "Optional AT-URI pointing at a paired public-tier record (the public side of a dual-faced post). The linkage lives only on the kryphocron-side record; the public-side record carries no kryphocron-visible markers. When absent, the post is a standalone private post with no public companion.",
            "format": "at-uri",
            "type": "string"
          },
          "quote": {
            "description": "Set by the encoder when `encodedContent` carries the embed: a strong ref to the quoted record of a record or record-with-media embed, left in the clear so AppViews can index quotes without decoding. Derived from the encoded embed. Absent when the post quotes nothing or the embed is not encoded.",
            "ref": "tools.kryphocron.feed.postPublic#strongRef",
            "type": "ref"
          },
          "reply": {
            "ref": "tools.kryphocron.feed.postPublic#replyRef",
            "type": "ref"
          },
          "text": {
            "description": "Post content.",
            "maxGraphemes": 300,
            "maxLength": 3000,
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "audienceList"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "Private-tier post. Audience-gated via the required audienceList reference: the substrate serves it only to requesters in the audience list. Not confidential: the record can still reach sync channels such as the firehose, so the gate is access friction, not encryption. The presence of audienceList is what structurally distinguishes private from public.",
  "id": "tools.kryphocron.feed.postPrivate",
  "lexicon": 1
}
```
