@ours.network/cowork 0.3.1 → 0.3.2

package/README.md

@@ -7,7 +7,9 @@ ours-cowork web
 ours-cowork docs
 ```
 
-`ours-cowork web` starts the daemon if it is absent, waits for the console, and opens `http://127.0.0.1:3052/`. Create a room first, then add each invitation requirement from its Invite panel. The Communication view contains the human-readable room chat; operational records remain in Events and the complete ordered stream remains in Archive.
+`ours-cowork web` starts the daemon if it is absent, waits for the console, and opens `http://127.0.0.1:3052/`. Create a room with a friendly display name first, then add each invitation requirement from its Invite panel. Names are trimmed, normalized to Unicode NFC, and may contain 1–64 Unicode characters excluding control and format characters. Duplicate names are allowed. The Communication view contains the human-readable room chat; operational records remain in Events and the complete ordered stream remains in Archive.
+
+The friendly `room_name` is presentation metadata. The opaque `room_id` remains the stable key for routing, URLs, storage, and identity correlation, and the underlying technical room identity is never renamed. Rooms created before friendly names existed migrate deterministically to `Room <first 8 room_id characters>`.
 
 The localhost HTTP console has no authentication. Keep it bound to `127.0.0.1`; do not proxy, forward, or expose the port to other hosts. Room state is refreshed by periodic polling, not pushed to the browser.
 

package/dist/cli.js

@@ -4280,6 +4280,7 @@ var MAX_MANAGEMENT_RESPONSE_BYTES = MAX_HISTORY_PAGE_BYTES + 1024 * 1024;
 var MAX_FILE_NAME_BYTES = 255;
 var MAX_MIME_BYTES = 255;
 var MAX_ROLE_BYTES = 256;
+var MAX_ROOM_NAME_CHARACTERS = 64;
 function utf8Bounded(label, maximumBytes) {
   return external_exports.string().refine((value) => Buffer.byteLength(value, "utf8") >= 1, `${label} must be at least 1 UTF-8 byte`).refine(
     (value) => Buffer.byteLength(value, "utf8") <= maximumBytes,
@@ -4311,6 +4312,21 @@ function isStrictRfc3339(value) {
   return day >= 1 && day <= days[month - 1];
 }
 var Rfc3339Schema = external_exports.string().refine(isStrictRfc3339, "must be a valid RFC3339 timestamp");
+function normalizeRoomName(value) {
+  return value.trim().normalize("NFC");
+}
+var RoomNameSchema = external_exports.string().refine(
+  (value) => !/[\p{Cc}\p{Cf}]/u.test(value),
+  "room name must not contain Unicode control or format characters"
+).transform(normalizeRoomName).superRefine((value, context) => {
+  const length = Array.from(value).length;
+  if (length < 1 || length > MAX_ROOM_NAME_CHARACTERS) {
+    context.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: `room name must contain 1-${MAX_ROOM_NAME_CHARACTERS} Unicode characters after normalization`
+    });
+  }
+});
 var RoleSchema = utf8Bounded("role", MAX_ROLE_BYTES);
 var MissionTextSchema = utf8Bounded("mission text", MAX_TEXT_BYTES);
 var MessageTextSchema = utf8Bounded("message text", MAX_TEXT_BYTES);
@@ -4520,8 +4536,9 @@ var RoomV1Schema = external_exports.object({
   mission: MissionV1Schema,
   seats: external_exports.array(SeatV1Schema)
 }).strict().superRefine(refineRoomLineage);
-var RoomSchema = external_exports.object({
+var CurrentRoomSchema = external_exports.object({
   ...RoomCommonShape,
+  room_name: RoomNameSchema,
   version: external_exports.literal(2),
   mission: MissionSchema,
   role_briefings: external_exports.record(RoleSchema, RoleBriefingSchema),
@@ -4601,13 +4618,24 @@ var RoomSchema = external_exports.object({
     }
   }
 });
+function defaultRoomName(roomId) {
+  return `Room ${LowerCrockfordUlidSchema.parse(roomId).slice(0, 8)}`;
+}
+var RoomSchema = external_exports.preprocess((value) => {
+  if (typeof value !== "object" || value === null || Object.hasOwn(value, "room_name")) return value;
+  const roomId = value.room_id;
+  if (typeof roomId !== "string" || !LowerCrockfordUlidSchema.safeParse(roomId).success) return value;
+  return { ...value, room_name: defaultRoomName(roomId) };
+}, CurrentRoomSchema);
 var CreateRoomInputSchema = external_exports.object({
+  name: RoomNameSchema.optional(),
   goal: MissionTextSchema,
   briefing: MissionTextSchema,
   anonymous: external_exports.boolean().optional(),
   quiet_membership: external_exports.boolean().optional()
 }).strict();
 var UpdateRoomInputSchema = external_exports.object({
+  name: RoomNameSchema.optional(),
   goal: MissionTextSchema.optional(),
   briefing: MissionTextSchema.optional(),
   status: NonEmptyStringSchema.optional(),
@@ -4935,8 +4963,8 @@ Usage:
   ours-cowork [--json] docs [topic]
 
 Room commands:
-  create --goal <text> --briefing <text> [--anonymous] [--quiet-membership]
-  settings <room-id> [--goal <text>] [--briefing <text>] [--status <text>] [--quiet-membership true|false]
+  create [--name <display-name>] --goal <text> --briefing <text> [--anonymous] [--quiet-membership]
+  settings <room-id> [--name <display-name>] [--goal <text>] [--briefing <text>] [--status <text>] [--quiet-membership true|false]
   role-briefing <room-id> --role <label> (--text <text> | --delete)
   invite <room-id> [--role <label>] [--mode one_time|public] [--min-accepts <n>]
   revoke <room-id> <invite-id>
@@ -5025,9 +5053,10 @@ function roomRequest(command, args) {
   if (!command) usageError("room requires a command");
   switch (command) {
     case "create": {
-      const parsed = parseOptions(args, ["--goal", "--briefing"], ["--anonymous", "--quiet-membership"]);
+      const parsed = parseOptions(args, ["--name", "--goal", "--briefing"], ["--anonymous", "--quiet-membership"]);
       exactPositionals(parsed, 0, "room create");
       return { method: "room.create", params: {
+        ...parsed.values["--name"] === void 0 ? {} : { name: parsed.values["--name"] },
         goal: requiredFlag(parsed, "--goal", "room create"),
         briefing: requiredFlag(parsed, "--briefing", "room create"),
         ...parsed.booleans.has("--anonymous") ? { anonymous: true } : {},
@@ -5035,10 +5064,10 @@ function roomRequest(command, args) {
       } };
     }
     case "settings": {
-      const parsed = parseOptions(args, ["--goal", "--briefing", "--status", "--quiet-membership"]);
+      const parsed = parseOptions(args, ["--name", "--goal", "--briefing", "--status", "--quiet-membership"]);
       const [roomId] = exactPositionals(parsed, 1, "room settings");
       const params = { room_id: roomId };
-      for (const [flag, key] of [["--goal", "goal"], ["--briefing", "briefing"], ["--status", "status"]]) {
+      for (const [flag, key] of [["--name", "name"], ["--goal", "goal"], ["--briefing", "briefing"], ["--status", "status"]]) {
         if (parsed.values[flag] !== void 0) params[key] = parsed.values[flag];
       }
       const quiet = parsed.values["--quiet-membership"];

package/dist/daemon.js

@@ -4793,6 +4793,9 @@ function isStrictRfc3339(value) {
   const days = [31, leapYear ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
   return day >= 1 && day <= days[month - 1];
 }
+function normalizeRoomName(value) {
+  return value.trim().normalize("NFC");
+}
 function refineRoomLineage(room, context) {
   const pendingIdentityName = `cowork-room-${room.room_id}`;
   const exactPacketPending = room.state === "provisioning" && room.status === "packet_pending" && room.identity_name === pendingIdentityName && room.invites.length === 0 && room.seats.length === 0 && room.activated_at === void 0 && room.closed_at === void 0;
@@ -4842,6 +4845,9 @@ function refineRoomLineage(room, context) {
     }
   }
 }
+function defaultRoomName(roomId) {
+  return `Room ${LowerCrockfordUlidSchema.parse(roomId).slice(0, 8)}`;
+}
 function migrateRoomV1(room, mintParticipantId) {
   return RoomSchema.parse({
     ...room,
@@ -4918,7 +4924,7 @@ function refineMessageCategory(message, context) {
     }
   }
 }
-var MAX_TEXT_BYTES, MAX_FILE_BYTES, MAX_HISTORY_PAGE_BYTES, MAX_MANAGEMENT_RESPONSE_BYTES, MAX_FILE_NAME_BYTES, MAX_MIME_BYTES, MAX_ROLE_BYTES, NonEmptyStringSchema, PositiveSafeIntegerSchema, LowerCrockfordUlidSchema, Rfc3339Schema, RoleSchema, MissionTextSchema, MessageTextSchema, FileNameSchema, FileMimeSchema, RoomStateSchema, SeatStateSchema, InviteModeSchema, DEFAULT_ROLE, InviteStateSchema, RelayStatusSchema, SeatV1Schema, SeatSchema, RoomInviteSchema, MissionV1Schema, MissionSchema, RoleBriefingSchema, RoomCommonShape, RoomV1Schema, RoomSchema, CreateRoomInputSchema, UpdateRoomInputSchema, RoleBriefingSetInputSchema, RoleBriefingDeleteInputSchema, PostMessageInputSchema, AuthorSnapshotSchema, RecordCommonShape, AppendCommonShape, MembershipNoticeSchema, AuthorAliasSchema, MessageShape, RelayIntentShape, RelayResultStatusSchema, RelayResultShape, FileShape, MembershipIntentShape, MembershipResultShape, CloseNoticeIntentShape, CloseNoticeResultShape, MessageRecordSchema, FileRecordSchema, RelayIntentRecordSchema, RelayResultRecordSchema, MembershipIntentRecordSchema, MembershipResultRecordSchema, CloseNoticeIntentRecordSchema, CloseNoticeResultRecordSchema, RawCommunicationRecordSchema, CommunicationRecordSchema, AppendRecordSchema;
+var MAX_TEXT_BYTES, MAX_FILE_BYTES, MAX_HISTORY_PAGE_BYTES, MAX_MANAGEMENT_RESPONSE_BYTES, MAX_FILE_NAME_BYTES, MAX_MIME_BYTES, MAX_ROLE_BYTES, MAX_ROOM_NAME_CHARACTERS, NonEmptyStringSchema, PositiveSafeIntegerSchema, LowerCrockfordUlidSchema, Rfc3339Schema, RoomNameSchema, RoleSchema, MissionTextSchema, MessageTextSchema, FileNameSchema, FileMimeSchema, RoomStateSchema, SeatStateSchema, InviteModeSchema, DEFAULT_ROLE, InviteStateSchema, RelayStatusSchema, SeatV1Schema, SeatSchema, RoomInviteSchema, MissionV1Schema, MissionSchema, RoleBriefingSchema, RoomCommonShape, RoomV1Schema, CurrentRoomSchema, RoomSchema, CreateRoomInputSchema, UpdateRoomInputSchema, RoleBriefingSetInputSchema, RoleBriefingDeleteInputSchema, PostMessageInputSchema, AuthorSnapshotSchema, RecordCommonShape, AppendCommonShape, MembershipNoticeSchema, AuthorAliasSchema, MessageShape, RelayIntentShape, RelayResultStatusSchema, RelayResultShape, FileShape, MembershipIntentShape, MembershipResultShape, CloseNoticeIntentShape, CloseNoticeResultShape, MessageRecordSchema, FileRecordSchema, RelayIntentRecordSchema, RelayResultRecordSchema, MembershipIntentRecordSchema, MembershipResultRecordSchema, CloseNoticeIntentRecordSchema, CloseNoticeResultRecordSchema, RawCommunicationRecordSchema, CommunicationRecordSchema, AppendRecordSchema;
 var init_contracts = __esm({
   "src/contracts.ts"() {
     "use strict";
@@ -4930,6 +4936,7 @@ var init_contracts = __esm({
     MAX_FILE_NAME_BYTES = 255;
     MAX_MIME_BYTES = 255;
     MAX_ROLE_BYTES = 256;
+    MAX_ROOM_NAME_CHARACTERS = 64;
     NonEmptyStringSchema = external_exports.string().min(1);
     PositiveSafeIntegerSchema = external_exports.number().int().positive().safe();
     LowerCrockfordUlidSchema = external_exports.string().regex(
@@ -4937,6 +4944,18 @@ var init_contracts = __esm({
       "must be a 26-character lowercase Crockford ULID"
     );
     Rfc3339Schema = external_exports.string().refine(isStrictRfc3339, "must be a valid RFC3339 timestamp");
+    RoomNameSchema = external_exports.string().refine(
+      (value) => !/[\p{Cc}\p{Cf}]/u.test(value),
+      "room name must not contain Unicode control or format characters"
+    ).transform(normalizeRoomName).superRefine((value, context) => {
+      const length = Array.from(value).length;
+      if (length < 1 || length > MAX_ROOM_NAME_CHARACTERS) {
+        context.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          message: `room name must contain 1-${MAX_ROOM_NAME_CHARACTERS} Unicode characters after normalization`
+        });
+      }
+    });
     RoleSchema = utf8Bounded("role", MAX_ROLE_BYTES);
     MissionTextSchema = utf8Bounded("mission text", MAX_TEXT_BYTES);
     MessageTextSchema = utf8Bounded("message text", MAX_TEXT_BYTES);
@@ -5098,8 +5117,9 @@ var init_contracts = __esm({
       mission: MissionV1Schema,
       seats: external_exports.array(SeatV1Schema)
     }).strict().superRefine(refineRoomLineage);
-    RoomSchema = external_exports.object({
+    CurrentRoomSchema = external_exports.object({
       ...RoomCommonShape,
+      room_name: RoomNameSchema,
       version: external_exports.literal(2),
       mission: MissionSchema,
       role_briefings: external_exports.record(RoleSchema, RoleBriefingSchema),
@@ -5179,13 +5199,21 @@ var init_contracts = __esm({
         }
       }
     });
+    RoomSchema = external_exports.preprocess((value) => {
+      if (typeof value !== "object" || value === null || Object.hasOwn(value, "room_name")) return value;
+      const roomId = value.room_id;
+      if (typeof roomId !== "string" || !LowerCrockfordUlidSchema.safeParse(roomId).success) return value;
+      return { ...value, room_name: defaultRoomName(roomId) };
+    }, CurrentRoomSchema);
     CreateRoomInputSchema = external_exports.object({
+      name: RoomNameSchema.optional(),
       goal: MissionTextSchema,
       briefing: MissionTextSchema,
       anonymous: external_exports.boolean().optional(),
       quiet_membership: external_exports.boolean().optional()
     }).strict();
     UpdateRoomInputSchema = external_exports.object({
+      name: RoomNameSchema.optional(),
       goal: MissionTextSchema.optional(),
       briefing: MissionTextSchema.optional(),
       status: NonEmptyStringSchema.optional(),
@@ -6707,6 +6735,7 @@ var init_service = __esm({
           const provisional = RoomSchema.parse({
             version: 2,
             room_id: roomId,
+            room_name: settings.name ?? defaultRoomName(roomId),
             identity_name: identityName,
             // PacketRegistry needs the durable room directory to exist first. A
             // valid, explicitly provisional value lets startup resume this exact
@@ -6818,6 +6847,7 @@ var init_service = __esm({
           };
           const next = await this.store.save(RoomSchema.parse({
             ...room,
+            room_name: settings.name ?? room.room_name,
             mission,
             ...settings.quiet_membership === void 0 ? {} : { quiet_membership: settings.quiet_membership },
             ...settings.status === void 0 ? {} : { status: settings.status }
@@ -7987,12 +8017,18 @@ var init_storage = __esm({
           throw this.wrap(`malformed metadata for room "${roomId}"`, error);
         }
         const room = this.isVersion1(decoded) ? this.migrateUnlocked(roomId, decoded, bytes) : RoomSchema.parse(decoded);
+        if (!this.isVersion1(decoded) && this.persistedRoomName(decoded) !== room.room_name) {
+          this.atomicMetadataWrite(this.metadataPath(roomId), room);
+        }
         if (room.room_id !== roomId) throw new CoworkStorageError(`metadata room_id does not match room "${roomId}"`);
         return room;
       }
       isVersion1(decoded) {
         return typeof decoded === "object" && decoded !== null && decoded.version === 1;
       }
+      persistedRoomName(decoded) {
+        return typeof decoded === "object" && decoded !== null ? decoded.room_name : void 0;
+      }
       /**
        * Lazy additive v1 → v2 migration (spec §7): preserve the exact pre-migration
        * bytes once as room.json.v1.bak, then atomically persist the v2 metadata.
@@ -8501,6 +8537,7 @@ function createServiceRoutes(service) {
     "room.settings": { auth: true, run: (params) => {
       const { room_id, ...input } = external_exports.object({
         room_id: external_exports.string(),
+        name: external_exports.unknown().optional(),
         goal: external_exports.unknown().optional(),
         briefing: external_exports.unknown().optional(),
         status: external_exports.unknown().optional(),