@colibri-social/lexicons 2.28.0 → 2.30.0

package/lexicons/com/atproto/space/getSpaceCredential.json

@@ -4,18 +4,26 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Exchange a delegation token for a space credential. Called on the space authority, with the delegation token as the request's authorization token and an HTTP message signature over Authorization made by the key to bind the credential to. The resulting space credential reads repos across the space. Requires a delegation token and HTTP message signature, plus a client attestation when the space gates on app identity.",
+      "description": "Request a space credential. Called on the space authority. A delegation token is required when the space gates on the user. A client attestation is required when the space gates on app identity. A space that requires neither offers public access. The resulting space credential reads repos across the space.",
       "input": {
         "encoding": "application/json",
         "schema": {
           "type": "object",
-          "required": ["space"],
+          "required": ["space", "credentialKid"],
           "properties": {
             "space": {
               "type": "string",
               "format": "space-ref",
               "description": "Reference to the space."
             },
+            "credentialKid": {
+              "type": "string",
+              "description": "P-256 did:key to bind the credential to. Each request using the credential is signed by this key."
+            },
+            "delegationToken": {
+              "type": "string",
+              "description": "Optional delegation token establishing the user being acted for. Required only when the space gates on the user."
+            },
             "clientAttestation": {
               "type": "string",
               "description": "Optional client attestation JWT establishing the app's identity. Required only when the space gates on app identity."

package/lexicons/com/atproto/space/listRepoOps.json

@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "List the operation log for an account's permissioned repo within a space, returning operations after a given revision. Primary incremental sync mechanism. By default each created or updated operation inlines the record's current value; set excludeValues for metadata-only entries. Note the oplog is a transport optimization with no history guarantee: a host may compact it or drop it, and it does not survive account migration, so omitting `since` returns the retained window rather than the repo's full history. Use getRepo for an initial sync or when a `since` revision is no longer available. Callable with either OAuth (for the authenticated user's own data) or a space credential (for syncing services).",
+      "description": "List the operation log for an account's permissioned repo within a space, returning operations after a given revision. Primary incremental sync mechanism. By default each created or updated operation inlines the record's current value; set excludeValues for metadata-only entries. Note the oplog is a transport optimization with no history guarantee: a host may compact it or drop it, and it does not survive account migration, so omitting `since` returns the retained window rather than the repo's full history. Use getRepo for an initial sync or when a `since` revision is no longer available. Callable with either OAuth (for the authenticated user's own data) or a space credential (for syncing services). When called with a space credential, the caller must send an Atproto-Space-Want-Mac header, and a response that includes the commit carries its MAC in the Atproto-Space-Mac response header.",
       "parameters": {
         "type": "params",
         "required": ["space", "repo"],
@@ -57,8 +57,8 @@
             },
             "commit": {
               "type": "ref",
-              "ref": "com.atproto.space.defs#signedCommit",
-              "description": "The account's current signed commit. Included when the response reaches the head of the oplog; omitted on backfill responses."
+              "ref": "com.atproto.space.defs#commit",
+              "description": "The account's current commit. Included when the response reaches the head of the oplog; omitted on backfill responses."
             },
             "cursor": {
               "type": "string",
@@ -68,6 +68,10 @@
         }
       },
       "errors": [
+        {
+          "name": "BadSpaceMac",
+          "description": "The Atproto-Space-Want-Mac header is missing or malformed, names an unsupported type or version, or carries an invalid key share."
+        },
         { "name": "SpaceNotFound" },
         { "name": "RepoNotFound" },
         { "name": "RepoTakendown" },

package/lexicons/com/atproto/space/listRepos.json

@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "List the known repos that hold data in a space (the writer set), with each repo's current repoRev and commit hash. Served by the space host. This is the sync boundary, not an access-control list: it enumerates only writers, never readers. The set is what the authority claims from write notifications and is not itself authoritative; a repo's host is the source of truth.",
+      "description": "List the known repos that hold data in a space (the writer set), with each repo's current repoRev and commit data. Served by the space host. This is the sync boundary, not an access-control list: it enumerates only writers, never readers. The set is what the authority claims from write notifications and is not itself authoritative; a repo's host is the source of truth.",
       "parameters": {
         "type": "params",
         "required": ["space"],
@@ -56,7 +56,7 @@
     },
     "repo": {
       "type": "object",
-      "required": ["did", "repoRev", "hash", "spaceRev"],
+      "required": ["did", "repoRev", "data", "spaceRev"],
       "properties": {
         "did": {
           "type": "string",
@@ -68,9 +68,9 @@
           "description": "The repo's current revision (TID), as last reported to the authority. May lag the repo host, which is the source of truth.",
           "format": "tid"
         },
-        "hash": {
+        "data": {
           "type": "bytes",
-          "description": "The repo's current commit hash (sha256 of the LtHash state), as last reported to the authority."
+          "description": "The repo's current commit data (sha256 of the LtHash state), as last reported to the authority."
         },
         "spaceRev": {
           "type": "string",

package/lexicons/com/atproto/space/notifySpaceDeleted.json

@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Notify a syncing service that a space has been deleted, and that it should drop every copy of the space's data it holds. Sent by the space authority to the services registered for the space, best-effort. Authenticated with service auth addressed to the receiving service.",
+      "description": "Notify a syncing service that a space was deleted and its copy should be dropped. Sent by the space authority to registered services, retried until delivered or the registration expires. Requires service auth.",
       "input": {
         "encoding": "application/json",
         "schema": {

package/lexicons/com/atproto/space/notifyWrite.json

@@ -9,7 +9,7 @@
         "encoding": "application/json",
         "schema": {
           "type": "object",
-          "required": ["space", "repo", "repoRev", "hash"],
+          "required": ["space", "repo", "repoRev", "data"],
           "properties": {
             "space": {
               "type": "string",
@@ -26,9 +26,9 @@
               "description": "The repo revision after the write.",
               "format": "tid"
             },
-            "hash": {
+            "data": {
               "type": "bytes",
-              "description": "The repo's current commit hash (sha256 of the LtHash state) after the write. Lets the space host maintain each repo's hash for listRepos."
+              "description": "The repo's current commit data (sha256 of the LtHash state) after the write. Lets the space host maintain each repo's commit data for listRepos."
             },
             "spaceRev": {
               "type": "string",

package/lexicons/social/colibri/beta/actor/clientPreferences.json

@@ -86,6 +86,16 @@
 							"description": "An experiment id."
 						},
 						"description": "The experiments the user turned on."
+					},
+					"dismissedLegacyCommunities": {
+						"type": "array",
+						"maxLength": 256,
+						"items": {
+							"type": "string",
+							"format": "did",
+							"description": "A legacy community DID."
+						},
+						"description": "Legacy communities that cannot move onto spaces and that the user removed from their sidebar."
 					}
 				}
 			}

package/lexicons/social/colibri/beta/actor/defs.json

@@ -450,6 +450,16 @@
 						"description": "An experiment id."
 					},
 					"description": "The experiments the user turned on."
+				},
+				"dismissedLegacyCommunities": {
+					"type": "array",
+					"maxLength": 256,
+					"items": {
+						"type": "string",
+						"format": "did",
+						"description": "A legacy community DID."
+					},
+					"description": "Legacy communities that cannot move onto spaces and that the user removed from their sidebar."
 				}
 			}
 		},

package/lexicons/social/colibri/beta/blob/get.json

@@ -27,7 +27,7 @@
 					"variant": {
 						"type": "string",
 						"description": "A rendition of a resizable image.",
-						"knownValues": ["thumbnail", "avatar", "banner", "full"]
+						"knownValues": ["thumbnail", "avatar", "banner", "spaceBanner", "full"]
 					},
 					"filename": {
 						"type": "string",

package/lexicons/social/colibri/beta/community/defs.json

@@ -79,6 +79,11 @@
 					"format": "at-uri",
 					"description": "The repo-backed community this one replaces, if any."
 				},
+				"migration": {
+					"type": "ref",
+					"ref": "#migrationInfo",
+					"description": "When and by whom this community moved from its repo-backed predecessor. Set on migrated communities."
+				},
 				"memberCount": {
 					"type": "integer",
 					"description": "Number of admitted members."
@@ -656,6 +661,88 @@
 				"viewerIsAdmin": {
 					"type": "boolean",
 					"description": "Whether the requesting user may migrate this community. Only an administrator of the legacy community can."
+				},
+				"picture": {
+					"type": "string",
+					"format": "uri",
+					"description": "URL of the legacy community's icon, served by this AppView's blob proxy."
+				},
+				"owner": {
+					"type": "ref",
+					"ref": "#legacyOwner",
+					"description": "The member who owns the legacy community, for members to ask about the move."
+				},
+				"state": {
+					"type": "string",
+					"knownValues": ["migratable", "migrating", "blocked"],
+					"description": "Where the community stands. migratable waits for an administrator, migrating is moving now, blocked cannot move. Absent means migratable."
+				},
+				"blockedReason": {
+					"type": "string",
+					"knownValues": ["ownerRepo", "unreadable", "noAdmin"],
+					"description": "Why a blocked community cannot move. ownerRepo lives inside its owner's repo, unreadable has a repo that did not respond, noAdmin has nobody left who may migrate it."
+				},
+				"progress": {
+					"type": "ref",
+					"ref": "#migrationProgress",
+					"description": "How far a running migration has come. Set while state is migrating."
+				}
+			}
+		},
+		"legacyOwner": {
+			"type": "object",
+			"description": "The owner of a legacy community.",
+			"required": ["did"],
+			"properties": {
+				"did": {
+					"type": "string",
+					"format": "did",
+					"description": "The owner's DID."
+				},
+				"handle": {
+					"type": "string",
+					"format": "handle",
+					"description": "The owner's handle, when it resolves."
+				}
+			}
+		},
+		"migrationProgress": {
+			"type": "object",
+			"description": "How far a migration has come.",
+			"required": ["step", "completed", "total"],
+			"properties": {
+				"step": {
+					"type": "string",
+					"description": "The step running now. Same values as social.colibri.beta.sync.defs#communityProgressEvent."
+				},
+				"completed": {
+					"type": "integer",
+					"description": "Steps finished."
+				},
+				"total": {
+					"type": "integer",
+					"description": "Steps in total."
+				},
+				"failed": {
+					"type": "boolean",
+					"description": "Whether the last attempt failed. Starting the migration again resumes it from the last finished step."
+				}
+			}
+		},
+		"migrationInfo": {
+			"type": "object",
+			"description": "When and by whom a community moved onto spaces.",
+			"required": ["at", "by"],
+			"properties": {
+				"at": {
+					"type": "string",
+					"format": "datetime",
+					"description": "When the migration finished."
+				},
+				"by": {
+					"type": "string",
+					"format": "did",
+					"description": "The administrator who started it."
 				}
 			}
 		}

package/lexicons/social/colibri/beta/community/listMigratable.json

@@ -4,7 +4,7 @@
 	"defs": {
 		"main": {
 			"type": "query",
-			"description": "Lists the repo-backed communities the requesting user belongs to that have not been migrated onto spaces yet, so a client can offer them as a choice rather than asking for a handle. The AppView reads this live from the user's own public repo and each candidate's public repo, because nothing about an unmigrated community is indexed. Only a community that holds its own DID is listed: an older community that lived in its owner's repo cannot be migrated.",
+			"description": "Lists the repo-backed communities the requesting user belongs to that have not finished moving onto spaces. The AppView reads this live from the user's own public repo and each candidate's public repo. A community that cannot move, such as one inside its owner's repo or one whose repo did not respond, is listed in state blocked with a reason.",
 			"parameters": {
 				"type": "params",
 				"required": [],
@@ -12,7 +12,7 @@
 					"includeUnadministered": {
 						"type": "boolean",
 						"default": false,
-						"description": "Whether to include communities the user belongs to but cannot migrate. They come back with viewerIsAdmin false."
+						"description": "Whether to include communities the user belongs to but does not administer. They come back with viewerIsAdmin false."
 					}
 				}
 			},
@@ -30,15 +30,6 @@
 								"description": "An unmigrated legacy community."
 							},
 							"description": "Unmigrated legacy communities, in the user's preferred sidebar order where the legacy repo recorded one. This is not paginated: a user's community list is small and every entry costs a live read."
-						},
-						"unreadable": {
-							"type": "array",
-							"items": {
-								"type": "string",
-								"format": "did",
-								"description": "A community DID whose repo could not be read."
-							},
-							"description": "Communities named by the user's repo whose own repo could not be read, so the client can say so instead of silently dropping them."
 						}
 					}
 				}

package/lexicons/social/colibri/beta/community/migrate.json

@@ -4,7 +4,7 @@
 	"defs": {
 		"main": {
 			"type": "procedure",
-			"description": "Migrates a repo-backed community onto spaces. Structure is recreated in new spaces and stamped with migratedFrom. Message history stays in the legacy public repos and is served alongside, because messages live in their authors' repos and only their authors can move them.",
+			"description": "Starts moving a repo-backed community onto spaces and returns once the move is queued. Structure, roles, members and bans are recreated in spaces stamped with migratedFrom. Message history of current members is copied from their public repos and served alongside as read-only legacy messages. The move runs in the background and reports progress through social.colibri.beta.sync.defs#communityProgressEvent. Calling it again while it runs returns the current state, and calling it after a failed attempt resumes from the last finished step.",
 			"input": {
 				"encoding": "application/json",
 				"schema": {
@@ -27,8 +27,8 @@
 					"properties": {
 						"community": {
 							"type": "ref",
-							"ref": "social.colibri.beta.community.defs#communityView",
-							"description": "The newly created, space-backed community."
+							"ref": "social.colibri.beta.community.defs#legacyCommunityView",
+							"description": "The legacy community, in state migrating with its progress."
 						}
 					}
 				}
@@ -50,6 +50,10 @@
 					"name": "AlreadyExists",
 					"description": "This legacy community has already been migrated."
 				},
+				{
+					"name": "NotMigratable",
+					"description": "The community cannot move onto spaces, for example because it lives inside its owner's repo."
+				},
 				{
 					"name": "CredentialsUnavailable",
 					"description": "The AppView's stored credentials for this community are missing or unusable."

package/lexicons/social/colibri/beta/sync/defs.json

@@ -689,7 +689,7 @@
 		},
 		"communityProgressEvent": {
 			"type": "object",
-			"description": "Progress while a community is being created, which takes several PDS round-trips.",
+			"description": "Progress while a community is being created or migrated, which takes several PDS round-trips.",
 			"required": ["step", "completed", "total"],
 			"properties": {
 				"step": {
@@ -701,6 +701,15 @@
 						"writingProfile",
 						"creatingOwnerRole",
 						"creatingStarterChannels",
+						"readingLegacyRepo",
+						"writingSettings",
+						"migratingRoles",
+						"migratingMembers",
+						"migratingBans",
+						"migratingChannels",
+						"migratingCategories",
+						"mirroringMessages",
+						"retiringLegacyCommunity",
 						"done",
 						"failed"
 					]

package/lexicons/social/colibri/beta/thread/defs.json

@@ -73,6 +73,11 @@
 					"type": "integer",
 					"description": "How many of those messages were moved in from somewhere else."
 				},
+				"lastMessage": {
+					"type": "ref",
+					"ref": "social.colibri.beta.channel.defs#channelSummary",
+					"description": "The latest message in the thread the requesting user may see, reduced to what a thread list preview shows. Its channel is the thread's space. Absent when the thread holds no message the user may see."
+				},
 				"participants": {
 					"type": "array",
 					"items": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colibri-social/lexicons",
-  "version": "2.28.0",
+  "version": "2.30.0",
   "description": "Colibri lexicon schemas and the types generated from them",
   "type": "module",
   "exports": {
@@ -27,8 +27,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@atproto/lex": "0.0.0-spaces-alpha-20261001173819",
-    "@atproto/lex-data": "0.0.0-spaces-alpha-20261001173819"
+    "@atproto/lex": "0.0.0-spaces-alpha-20261022141228",
+    "@atproto/lex-data": "0.0.0-spaces-alpha-20261022141228"
   },
   "scripts": {
     "build": "tsc --build",