@joe-broadhead/opencode-messaging 0.4.0 → 0.5.0

package/dist/messaging.js

@@ -5746,7 +5746,8 @@ looseObject({
 	jti: string$1().regex(/^[\x21-\x7e]{1,128}$/, "printable jti"),
 	iss: string$1().max(2048).optional(),
 	dev: string$1().max(200).optional(),
-	cls: string$1().max(32).optional()
+	cls: string$1().max(32).optional(),
+	mbr: string$1().max(200).optional()
 });
 looseObject({
 	aud: string$1().min(1).max(2048),
@@ -6312,7 +6313,8 @@ object({
 	label: MachineLabel,
 	sessions: array(SessionInfo).max(LIMITS.presenceSessions),
 	features: array(string$1().max(64)).max(32).optional(),
-	direct: array(DirectEndpoint).min(1).max(4).optional()
+	direct: array(DirectEndpoint).min(1).max(4).optional(),
+	away: literal(true).optional()
 });
 const Provenance = object({
 	envelopeId: Ulid,
@@ -6532,78 +6534,104 @@ const Size = number$1().int().positive();
 const Handle = string$1().regex(/^[a-z][a-z0-9-]{0,31}$/, "lowercase handle");
 const Email = string$1().max(254).regex(/^[^\s@A-Z]{1,64}@(?:[a-z0-9-]+\.)+[a-z0-9-]+$/, "lower-case email address");
 const OrgId = string$1().min(1).max(200);
-discriminatedUnion("t", [
-	object({
-		t: literal("dir.bind"),
-		req: Req,
-		entry: LogEntry
-	}),
-	object({
-		t: literal("hello"),
-		realm: RealmId,
+const DirBindFrame = object({
+	t: literal("dir.bind"),
+	req: Req,
+	entry: LogEntry
+});
+const HostedHelloFrame = object({
+	t: literal("hello"),
+	realm: RealmId,
+	person: HostedPersonId,
+	device: DeviceId,
+	ts: Millis,
+	sig: Base64Url
+});
+const DirAppendFrame = object({
+	t: literal("dir.append"),
+	req: Req,
+	entry: LogEntry
+});
+const DirKeysFrame = object({
+	t: literal("dir.keys"),
+	req: Req,
+	stmt: KeysStatement
+});
+const DirSthFrame = object({
+	t: literal("dir.sth"),
+	req: Req,
+	size: Size.optional(),
+	from: Size.optional(),
+	epoch: number$1().int().nonnegative().optional()
+});
+const DirLookupFrame = object({
+	t: literal("dir.lookup"),
+	req: Req,
+	persons: array(object({
 		person: HostedPersonId,
-		device: DeviceId,
-		ts: Millis,
-		sig: Base64Url
-	}),
-	object({
-		t: literal("dir.append"),
-		req: Req,
-		entry: LogEntry
-	}),
-	object({
-		t: literal("dir.keys"),
-		req: Req,
-		stmt: KeysStatement
-	}),
-	object({
-		t: literal("dir.sth"),
-		req: Req,
-		size: Size.optional(),
-		from: Size.optional(),
-		epoch: number$1().int().nonnegative().optional()
-	}),
-	object({
-		t: literal("dir.lookup"),
-		req: Req,
-		persons: array(object({
-			person: HostedPersonId,
-			knownSeq: number$1().int().nonnegative().optional()
-		})).min(1).max(LIMITS.dirLookupPersons),
-		size: Size.optional()
-	}),
-	object({
-		t: literal("dir.device"),
-		req: Req,
-		device: DeviceId
-	}),
-	object({
-		t: literal("dir.resolve"),
-		req: Req,
-		handle: Handle.optional(),
-		email: Email.optional()
-	}).refine((frame) => frame.handle === void 0 !== (frame.email === void 0), { message: "exactly one of handle and email" }),
-	object({
-		t: literal("dir.search"),
-		req: Req,
-		query: string$1().min(1).max(64),
-		limit: number$1().int().min(1).max(LIMITS.dirSearchResults)
-	}),
-	object({
-		t: literal("dir.watch"),
-		req: Req,
-		persons: array(HostedPersonId).max(LIMITS.watchPersons)
-	}),
+		knownSeq: number$1().int().nonnegative().optional()
+	})).min(1).max(LIMITS.dirLookupPersons),
+	size: Size.optional()
+});
+const DirDeviceFrame = object({
+	t: literal("dir.device"),
+	req: Req,
+	device: DeviceId
+});
+const DirResolveFrame = object({
+	t: literal("dir.resolve"),
+	req: Req,
+	handle: Handle.optional(),
+	email: Email.optional()
+}).refine((frame) => frame.handle === void 0 !== (frame.email === void 0), { message: "exactly one of handle and email" });
+const DirSearchFrame = object({
+	t: literal("dir.search"),
+	req: Req,
+	query: string$1().min(1).max(64),
+	limit: number$1().int().min(1).max(LIMITS.dirSearchResults)
+});
+const DirWatchFrame = object({
+	t: literal("dir.watch"),
+	req: Req,
+	persons: array(HostedPersonId).max(LIMITS.watchPersons)
+});
+const PresenceWatchFrame = object({
+	t: literal("presence.watch"),
+	req: Req,
+	persons: array(HostedPersonId).max(LIMITS.watchPersons)
+});
+const DirEraseFrame = object({
+	t: literal("dir.erase"),
+	req: Req,
+	entries: array(LogEntry).min(1).max(LIMITS.devicesPerPerson),
+	token: Jws
+});
+const WAKE_TICKET_BYTES = 4096;
+const WakeUrl = string$1().max(2048).regex(/^https?:\/\/[^/?#@\s]+\/hosts\/hst_[A-Za-z0-9._:-]{1,123}\/wake$/, "a Jelly ID wake URL");
+discriminatedUnion("t", [
+	DirBindFrame,
+	HostedHelloFrame,
+	DirAppendFrame,
+	DirKeysFrame,
+	DirSthFrame,
+	DirLookupFrame,
+	DirDeviceFrame,
+	DirResolveFrame,
+	DirSearchFrame,
+	DirWatchFrame,
+	PresenceWatchFrame,
+	DirEraseFrame,
 	object({
-		t: literal("presence.watch"),
+		t: literal("wake.arm"),
 		req: Req,
-		persons: array(HostedPersonId).max(LIMITS.watchPersons)
+		url: WakeUrl,
+		ticket: Jws.refine((ticket) => ticket.length <= WAKE_TICKET_BYTES, { message: `at most ${WAKE_TICKET_BYTES} bytes` }),
+		agents: array(SessionName).max(64),
+		awaiting: array(Ulid).max(500)
 	}),
 	object({
-		t: literal("dir.erase"),
-		req: Req,
-		entries: array(LogEntry).min(1).max(LIMITS.devicesPerPerson),
-		token: Jws
+		t: literal("wake.disarm"),
+		req: Req
 	})
 ]);
 const HostedWelcomeFrame = object({
@@ -6800,6 +6828,19 @@ const LoginState = discriminatedUnion("state", [
 		purpose: LoginPurpose
 	})
 ]);
+const DeviceRemoveParams = strictObject({
+	device: MachineId,
+	reason: _enum([
+		"self",
+		"removed",
+		"lost"
+	]).optional(),
+	token: Jws.optional()
+});
+const DeviceApproveParams = strictObject({
+	link: LinkText,
+	sas: Sas
+});
 const DEVICE_METHODS = {
 	"device.status": {
 		params: strictObject({}),
@@ -6822,15 +6863,7 @@ const DEVICE_METHODS = {
 		result: object({ devices: array(DeviceListEntry) })
 	},
 	"device.remove": {
-		params: strictObject({
-			device: MachineId,
-			reason: _enum([
-				"self",
-				"removed",
-				"lost"
-			]).optional(),
-			token: Jws.optional()
-		}),
+		params: DeviceRemoveParams,
 		result: object({ seq: number$1().int().nonnegative() })
 	},
 	"device.link": {
@@ -6867,14 +6900,11 @@ const DEVICE_METHODS = {
 		result: object({ ok: literal(true) })
 	},
 	"device.approve.preview": {
-		params: strictObject({ link: LinkText }),
+		params: DeviceApproveParams.partial({ sas: true }),
 		result: LinkPreview
 	},
 	"device.approve": {
-		params: strictObject({
-			link: LinkText,
-			sas: Sas
-		}),
+		params: DeviceApproveParams,
 		result: object({
 			device: MachineId,
 			seq: number$1().int().nonnegative()
@@ -7099,6 +7129,16 @@ const PersonReach = object({
 	source: _enum(["card", "default"]),
 	at: Millis.optional()
 });
+const RequestAnswerParams = strictObject({
+	id: Ulid,
+	answer: RequestAnswer,
+	all: boolean().optional()
+});
+const ContactRequestParams = strictObject({
+	email: Email,
+	text: RequestText,
+	suggestion: Ulid.optional()
+});
 const CONSENT_METHODS = {
 	"grant.list": {
 		params: strictObject({ subject: GrantTarget.optional() }),
@@ -7120,19 +7160,35 @@ const CONSENT_METHODS = {
 		result: object({ requests: array(HeldRequest).max(LIMITS.heldTotal * 3) })
 	},
 	"request.answer": {
-		params: strictObject({
-			id: Ulid,
-			answer: RequestAnswer,
-			all: boolean().optional()
-		}),
+		params: RequestAnswerParams,
 		result: object({ answered: array(Ulid).max(LIMITS.heldTotal) })
 	},
+	"request.answer.preview": {
+		params: RequestAnswerParams,
+		result: object({
+			kind: _enum([
+				"message",
+				"task",
+				"contact",
+				"suggestion"
+			]),
+			from: object({
+				name: string$1().max(200),
+				email: string$1().max(320).optional(),
+				org: _enum([
+					"same",
+					"other",
+					"none"
+				])
+			}),
+			agent: SessionName.optional(),
+			to: SessionName.optional(),
+			count: number$1().int().positive(),
+			sentence: string$1().max(500)
+		})
+	},
 	"contact.request": {
-		params: strictObject({
-			email: Email,
-			text: RequestText,
-			suggestion: Ulid.optional()
-		}),
+		params: ContactRequestParams,
 		result: object({
 			id: Ulid,
 			conversation: RoomRef,
@@ -7140,7 +7196,7 @@ const CONSENT_METHODS = {
 		})
 	},
 	"contact.request.preview": {
-		params: strictObject({ email: Email }),
+		params: ContactRequestParams.partial({ text: true }),
 		result: object({ found: boolean() })
 	},
 	"card.get": {
@@ -7308,7 +7364,8 @@ const SURFACE_METHODS = {
 		result: PersonSummary.extend({ devices: array(object({
 			device: MachineId,
 			label: MachineLabel,
-			self: boolean()
+			self: boolean(),
+			away: literal(true).optional()
 		})) })
 	}
 };
@@ -7426,8 +7483,45 @@ const JELLY_METHODS = {
 		params: strictObject({ ids: array(NoticeId).min(1).max(200) }),
 		result: object({ ok: literal(true) })
 	},
+	"daemon.woke": {
+		params: strictObject({}),
+		result: object({ ok: literal(true) })
+	},
+	"person.attached": {
+		params: strictObject({ attached: boolean() }),
+		result: object({ ok: literal(true) })
+	},
+	"wake.arm": {
+		params: strictObject({
+			url: WakeUrl,
+			ticket: Jws.refine((ticket) => ticket.length <= WAKE_TICKET_BYTES, { message: `at most ${WAKE_TICKET_BYTES} bytes` }),
+			agents: array(SessionName).max(64)
+		}),
+		result: object({
+			relay: _enum(["armed", "pending"]),
+			awaiting: number$1().int().nonnegative()
+		})
+	},
+	"wake.disarm": {
+		params: strictObject({}),
+		result: object({ relay: _enum(["disarmed", "pending"]) })
+	},
+	"daemon.snapshot": {
+		params: strictObject({ done: literal(true).optional() }),
+		result: union$1([object({
+			folder: string$1().max(4096),
+			files: array(object({
+				name: string$1().max(64),
+				bytes: number$1().int().nonnegative(),
+				sha256: string$1().regex(/^[0-9a-f]{64}$/)
+			})).max(8),
+			storeSchema: number$1().int().positive(),
+			at: Millis,
+			until: Millis
+		}), object({ released: boolean() })])
+	},
 	"device.remove.preview": {
-		params: strictObject({ device: MachineId }),
+		params: DeviceRemoveParams,
 		result: object({
 			label: MachineLabel,
 			kind: DeviceKind.optional(),
@@ -7800,6 +7894,63 @@ const AGENT_METHODS = [
 	"task.update",
 	"task.cancel"
 ];
+const HUMAN_METHODS = [
+	"conv.list",
+	"conv.read",
+	"conv.markRead",
+	"conv.subscribe",
+	"person.send",
+	"people.search",
+	"people.get",
+	"grant.list",
+	"grant.set",
+	"grant.set.preview",
+	"request.list",
+	"request.answer",
+	"request.answer.preview",
+	"contact.request",
+	"contact.request.preview",
+	"card.get",
+	"agents.list",
+	"agents.read",
+	"notice.subscribe",
+	"notice.list",
+	"notice.ack",
+	"device.approve.preview",
+	"device.remove.preview",
+	"channel.create",
+	"channel.invite",
+	"channel.leave",
+	"channel.remove"
+];
+const ADMIN_METHODS = [
+	"daemon.stop",
+	"daemon.woke",
+	"person.attached",
+	"daemon.snapshot",
+	"wake.arm",
+	"wake.disarm",
+	"device.list",
+	"device.remove",
+	"device.link",
+	"device.login",
+	"device.login.status",
+	"device.login.cancel",
+	"device.approve",
+	"identity.rotateEnc",
+	"team.create",
+	"team.invite",
+	"team.join",
+	"team.members",
+	"team.remove",
+	"team.role",
+	"team.revokeInvite",
+	"team.add",
+	"team.pair",
+	"team.claim",
+	"team.pairCancel",
+	"team.prepare"
+];
 const IpcEvent = discriminatedUnion("type", [
 	object({
 		type: literal("inbox"),
@@ -7870,7 +8021,7 @@ function utf8(text) {
 	return Buffer.from(text, "utf8");
 }
 // packages/core/dist/version.js
-const VERSION = "0.4.0";
+const VERSION = "0.5.0";
 // packages/core/dist/jcs.js
 const LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/;
 function hasLoneSurrogate(text) {
@@ -8258,6 +8409,28 @@ Envelope.omit({
 	body: true,
 	sig: true
 });
+// packages/core/dist/jelly-host.js
+const CHAT_METHODS = [
+	"person.send",
+	"conv.markRead",
+	"notice.ack"
+];
+const VIEW_METHODS = [
+	"conv.list",
+	"conv.read",
+	"conv.subscribe",
+	"people.search",
+	"people.get",
+	"grant.list",
+	"request.list",
+	"agents.list",
+	"agents.read",
+	"notice.subscribe",
+	"notice.list",
+	"device.list"
+];
+const classOf = (method) => CHAT_METHODS.includes(method) ? "chat" : VIEW_METHODS.includes(method) ? "view" : "local";
+Object.freeze(Object.fromEntries([...HUMAN_METHODS, ...ADMIN_METHODS].map((method) => [method, classOf(method)])));
 object({
 	iss: string$1().min(1).max(2048),
 	sub: JellySubject
@@ -10484,7 +10657,7 @@ var MessagingClient = class MessagingClient {
 				timer = setTimeout(() => reject(new DaemonMismatchError(`the process on the Messaging daemon socket did not say which version it is within ${wait} ms: it is a messagingd from before this version, or it is stuck. ${REMEDY}`)), wait);
 			})]);
 			if (pointer !== void 0 && hello.pid !== pointer.pid) throw new MessagingError("forbidden", "the process on the Messaging daemon's pipe is not the daemon that published it");
-			const expected = options.version ?? "0.4.0";
+			const expected = options.version ?? "0.5.0";
 			if (hello.protocol !== 1 || hello.version !== expected) throw new DaemonMismatchError(`the Messaging daemon for this home is version ${shown(hello.version)} (IPC protocol ${hello.protocol}), and this client is version ${shown(expected)} (IPC protocol 1). ${REMEDY}`, hello);
 			client.daemonHello = hello;
 			return client;