@alook/daemon 0.1.47 → 0.1.49

package/dist/cli/index.js

@@ -22143,30 +22143,288 @@ var HostCommandSchema = exports_external.discriminatedUnion("type", [
 // src/cli/proxyServerApi.ts
 import * as fs from "fs";
 import * as path from "path";
-// ../shared/src/community-attention.ts
+// ../shared/src/community-contract.ts
+var COMMUNITY_RESOURCE_CONTRACT_VERSION = 3;
+
+// ../shared/src/community-friend-approval.ts
+var profile = exports_external.strictObject({
+  id: exports_external.string(),
+  name: exports_external.string(),
+  discriminator: exports_external.string(),
+  image: exports_external.string().nullable(),
+  avatarVersion: exports_external.number().int().nonnegative()
+});
+var FriendApprovalPayloadSchema = exports_external.strictObject({
+  friendshipId: exports_external.string(),
+  status: exports_external.enum(["pending", "approved", "denied", "superseded", "cancelled"]),
+  waitingOn: exports_external.enum(["you", "other-owner", "addressee"]).nullable(),
+  otherProfile: profile,
+  botProfile: profile,
+  waitingOnProfile: profile.nullable().optional()
+});
+
+// ../shared/src/community-resources.ts
 var id = exports_external.string().min(1);
-var AttentionScopeSchema = exports_external.strictObject({
-  scopeId: id,
+var nullableId = id.nullable();
+var legacyArchivedSchema = exports_external.union([exports_external.boolean(), exports_external.literal(0), exports_external.literal(1)]).transform((value) => value === true || value === 1);
+var CommunityChannelResourceSchema = exports_external.strictObject({
+  id,
+  type: exports_external.enum(["text", "forum", "thread", "dm"]),
+  serverId: nullableId,
+  categoryId: nullableId,
+  name: exports_external.string().nullable(),
+  topic: exports_external.string(),
+  parentChannelId: nullableId,
+  parentMessageId: nullableId,
+  creatorId: nullableId,
+  position: exports_external.number(),
+  archived: exports_external.boolean(),
+  createdAt: exports_external.string(),
+  lastMessageAt: exports_external.string().nullable(),
+  messageCount: exports_external.number().int().nonnegative()
+});
+var CommunityChannelIdentitySchema = CommunityChannelResourceSchema.pick({
+  id: true,
+  type: true,
+  serverId: true,
+  name: true,
+  parentChannelId: true,
+  parentMessageId: true,
+  creatorId: true,
+  archived: true,
+  lastMessageAt: true,
+  createdAt: true
+}).partial({ createdAt: true }).strip();
+var legacyChannelIdentitySchema = CommunityChannelIdentitySchema.extend({
+  archived: legacyArchivedSchema,
+  parentChannelId: nullableId.default(null),
+  parentMessageId: nullableId.default(null),
+  creatorId: nullableId.default(null),
+  lastMessageAt: CommunityChannelResourceSchema.shape.lastMessageAt.default(null)
+});
+var CommunityAccessDecisionSchema = exports_external.strictObject({
+  channelId: id,
+  canRead: exports_external.boolean(),
+  canSend: exports_external.boolean(),
+  canCreateDiscussion: exports_external.boolean()
+});
+var CommunityLegacyMessageAttachmentSchema = exports_external.strictObject({
+  kind: exports_external.enum(["image", "file"]),
+  name: exports_external.string(),
+  url: exports_external.string(),
+  thumbnailUrl: exports_external.string().optional(),
+  contentType: exports_external.string().optional(),
+  size: exports_external.string().optional(),
+  sizeBytes: exports_external.number().nonnegative().optional(),
+  width: exports_external.number().nonnegative().optional(),
+  height: exports_external.number().nonnegative().optional()
+});
+var CommunityMessageAttachmentSchema = exports_external.strictObject({
+  id,
+  name: exports_external.string(),
+  url: exports_external.string(),
+  thumbnailUrl: exports_external.string().nullable(),
+  contentType: exports_external.string().nullable(),
+  sizeBytes: exports_external.number().int().nonnegative().nullable(),
+  width: exports_external.number().int().nonnegative().nullable(),
+  height: exports_external.number().int().nonnegative().nullable()
+});
+var CommunityMessagePreviewAttachmentSchema = CommunityMessageAttachmentSchema.partial().required({ name: true, url: true });
+var CommunityResourceProfileSchema = exports_external.strictObject({
+  id,
+  name: exports_external.string(),
+  discriminator: exports_external.string().min(1).nullable(),
+  avatar: exports_external.string().nullable(),
+  avatarVersion: exports_external.number().int().nonnegative(),
+  aboutMe: exports_external.string().optional(),
+  bannerColor: exports_external.string().nullable().optional(),
+  kind: exports_external.enum(["human", "bot"]).optional(),
+  ownerUserId: nullableId.optional(),
+  ownerHandle: exports_external.string().nullable().optional(),
+  mutualServers: exports_external.number().int().nonnegative().optional(),
+  ownedByViewer: exports_external.boolean().optional(),
+  statusEmoji: exports_external.string().nullable().optional(),
+  statusText: exports_external.string().nullable().optional()
+});
+var CommunityMessageThreadParticipantSchema = CommunityResourceProfileSchema.pick({ id: true, name: true, avatar: true, avatarVersion: true });
+var messageThreadSchema = exports_external.strictObject({
+  id,
+  name: CommunityChannelResourceSchema.shape.name,
+  messageCount: CommunityChannelResourceSchema.shape.messageCount,
+  lastReplyAt: CommunityChannelResourceSchema.shape.lastMessageAt.optional(),
+  tags: exports_external.array(exports_external.string()).optional(),
+  preview: exports_external.string().optional(),
+  participants: exports_external.array(CommunityMessageThreadParticipantSchema).optional(),
+  participantCount: exports_external.number().int().nonnegative().optional()
+});
+var legacyMessageThreadSchema = messageThreadSchema.extend({
+  name: exports_external.string(),
+  lastReplyAt: exports_external.string().optional(),
+  participants: exports_external.array(CommunityMessageThreadParticipantSchema.extend({ avatar: exports_external.string() })).optional()
+});
+var messageThreadPreviewSchema = messageThreadSchema.partial().required({ id: true }).extend({
+  participants: exports_external.array(CommunityMessageThreadParticipantSchema.partial().required({ id: true })).optional()
+});
+var CommunityMessageResourceSchema = exports_external.strictObject({
+  id,
   channelId: id,
-  serverId: id.nullable().optional(),
-  parentChannelId: id.nullable().optional(),
+  seq: exports_external.number().int().nonnegative(),
+  authorId: id,
+  createdAt: exports_external.string(),
+  type: exports_external.enum(["chat", "system"]),
+  content: exports_external.string(),
+  replyToId: nullableId,
+  clientNonce: exports_external.string().nullable(),
+  attachments: exports_external.array(CommunityMessageAttachmentSchema),
+  systemKind: exports_external.literal("thread").optional(),
+  authorName: exports_external.string().optional(),
+  authorAvatar: exports_external.string().nullable().optional(),
+  authorAvatarVersion: exports_external.number().int().nonnegative().optional(),
+  mentionType: exports_external.literal("everyone").nullable().optional(),
+  replyTo: exports_external.strictObject({
+    id,
+    authorId: id.optional(),
+    authorName: exports_external.string(),
+    text: exports_external.string(),
+    deleted: exports_external.boolean().optional()
+  }).optional(),
+  embeds: exports_external.array(exports_external.unknown()).optional(),
+  reactions: exports_external.array(exports_external.strictObject({
+    emoji: exports_external.string(),
+    count: exports_external.number().int().nonnegative(),
+    me: exports_external.boolean(),
+    userIds: exports_external.array(id)
+  })).optional(),
+  thread: messageThreadSchema.optional(),
+  approval: FriendApprovalPayloadSchema.optional()
+});
+var CommunityMessagePreviewSchema = CommunityMessageResourceSchema.partial().required({
+  id: true,
+  type: true
+}).extend({ attachments: exports_external.array(CommunityMessagePreviewAttachmentSchema).optional(), thread: messageThreadPreviewSchema.optional() });
+var CommunityReadStateResourceSchema = exports_external.strictObject({
+  channelId: id,
+  lastReadMessageId: nullableId,
+  lastReadAt: exports_external.string().nullable(),
+  lastReadSeq: exports_external.number().int().nonnegative()
+});
+var CommunityMemberRelationSchema = exports_external.strictObject({
+  channelId: id,
+  userId: id,
+  relation: exports_external.enum(["access", "notify"]),
+  source: exports_external.string(),
+  isCreator: exports_external.boolean(),
+  role: exports_external.string().nullable(),
+  memberId: nullableId
+});
+var CommunityPageSchema = exports_external.strictObject({
+  olderCursor: exports_external.string().nullable(),
+  newerCursor: exports_external.string().nullable(),
+  hasMoreOlder: exports_external.boolean(),
+  hasMoreNewer: exports_external.boolean(),
+  latestSeq: exports_external.number().int().nonnegative()
+});
+var envelope = { contractVersion: exports_external.literal(COMMUNITY_RESOURCE_CONTRACT_VERSION), channelId: id };
+var CommunityChannelReadSchema = exports_external.strictObject({ ...envelope, channel: CommunityChannelResourceSchema, access: CommunityAccessDecisionSchema });
+var CommunityMessagesReadSchema = exports_external.strictObject({
+  ...envelope,
+  messages: exports_external.array(CommunityMessageResourceSchema),
+  page: CommunityPageSchema,
+  surfaceReceipt: exports_external.strictObject({ channelId: id, surfaceKind: exports_external.enum(["channel", "forum", "thread", "dm"]) })
+});
+var CommunityMessagePostedSchema = CommunityMessagesReadSchema.pick({ contractVersion: true, channelId: true }).extend({
+  message: CommunityMessageResourceSchema,
+  deduped: exports_external.boolean(),
+  threadId: id.optional()
+});
+var CommunityMessageReadSchema = CommunityMessagePostedSchema.omit({ deduped: true, threadId: true });
+var CommunityReadStateReadSchema = exports_external.strictObject({ ...envelope, readState: CommunityReadStateResourceSchema });
+var CommunityMembersReadSchema = exports_external.strictObject({ ...envelope, relation: exports_external.enum(["access", "notify"]), members: exports_external.array(CommunityMemberRelationSchema), profiles: exports_external.array(CommunityResourceProfileSchema) });
+var CommunityThreadsReadSchema = exports_external.strictObject({
+  ...envelope,
+  channel: CommunityChannelResourceSchema,
+  threads: exports_external.array(CommunityChannelResourceSchema),
+  included: exports_external.strictObject({
+    messages: exports_external.array(CommunityMessageResourceSchema),
+    members: exports_external.array(CommunityMemberRelationSchema),
+    profiles: exports_external.array(CommunityResourceProfileSchema),
+    tags: exports_external.array(exports_external.strictObject({ messageId: id, tag: exports_external.string() })),
+    participantCounts: exports_external.array(exports_external.strictObject({ channelId: id, count: exports_external.number().int().nonnegative() }))
+  }),
+  page: exports_external.strictObject({ nextCursor: exports_external.string().nullable(), hasMore: exports_external.boolean() })
+});
+var CommunityReadAdvanceSchema = exports_external.strictObject({ ...envelope, changed: exports_external.boolean(), targetSeq: exports_external.number().int().nonnegative(), revision: exports_external.number().int().nonnegative() });
+var CommunityReadErrorSchema = exports_external.strictObject({ contractVersion: exports_external.literal(COMMUNITY_RESOURCE_CONTRACT_VERSION), error: exports_external.strictObject({
+  code: exports_external.enum(["invalid_input", "invalid_reply_target", "unauthenticated", "not_found", "not_allowed", "blocked", "idempotency_conflict", "rate_limited", "temporarily_unavailable"]),
+  message: exports_external.string(),
+  retryable: exports_external.boolean()
+}) });
+var legacyProfileSchema = CommunityResourceProfileSchema.pick({
+  id: true,
+  name: true,
+  avatar: true,
+  avatarVersion: true
+}).extend({ discriminator: exports_external.string().nullable(), statusEmoji: exports_external.string().nullable(), statusText: exports_external.string() });
+var CommunityLegacyMessageResourceSchema = CommunityMessageResourceSchema.extend({ authorAvatar: exports_external.string().optional(), attachments: exports_external.array(CommunityLegacyMessageAttachmentSchema), thread: legacyMessageThreadSchema.optional() });
+var legacyEnvelope = { contractVersion: exports_external.literal(2), channelId: id };
+var legacyReadSchemas = {
+  channel: CommunityChannelReadSchema.extend(legacyEnvelope),
+  messages: CommunityMessagesReadSchema.extend({ ...legacyEnvelope, messages: exports_external.array(CommunityLegacyMessageResourceSchema) }),
+  readState: CommunityReadStateReadSchema.extend(legacyEnvelope),
+  members: CommunityMembersReadSchema.extend({ ...legacyEnvelope, profiles: exports_external.array(legacyProfileSchema) }),
+  threads: CommunityThreadsReadSchema.extend({ ...legacyEnvelope, included: CommunityThreadsReadSchema.shape.included.extend({
+    messages: exports_external.array(CommunityLegacyMessageResourceSchema),
+    profiles: exports_external.array(legacyProfileSchema)
+  }) }),
+  readAdvance: CommunityReadAdvanceSchema.extend(legacyEnvelope),
+  error: CommunityReadErrorSchema.extend({ contractVersion: exports_external.literal(2) })
+};
+var legacyChannelResourcePreviewSchema = CommunityChannelResourceSchema.partial().strip().extend({
+  archived: legacyArchivedSchema.optional()
+});
+var legacyChannelResourceSchema = CommunityChannelResourceSchema.strip().extend({
+  topic: CommunityChannelResourceSchema.shape.topic.nullish().transform((value) => value ?? ""),
+  position: CommunityChannelResourceSchema.shape.position.nullish().transform((value) => value ?? 0),
+  messageCount: CommunityChannelResourceSchema.shape.messageCount.nullish().transform((value) => value ?? 0),
+  categoryId: nullableId.default(null),
+  parentChannelId: nullableId.default(null),
+  parentMessageId: nullableId.default(null),
+  creatorId: nullableId.default(null),
+  lastMessageAt: CommunityChannelResourceSchema.shape.lastMessageAt.default(null),
+  archived: legacyArchivedSchema
+});
+var legacyMessageResourceSchema = CommunityLegacyMessageResourceSchema.strip().extend({
+  channelId: id.optional(),
+  replyToId: nullableId.optional(),
+  clientNonce: CommunityMessageResourceSchema.shape.clientNonce.default(null),
+  attachments: CommunityLegacyMessageResourceSchema.shape.attachments.default([]),
+  embeds: CommunityMessageResourceSchema.shape.embeds.nullable().transform((value) => value ?? undefined)
+});
+
+// ../shared/src/community-attention.ts
+var id2 = exports_external.string().min(1);
+var AttentionScopeSchema = exports_external.strictObject({
+  scopeId: id2,
+  channelId: id2,
+  serverId: id2.nullable().optional(),
+  parentChannelId: id2.nullable().optional(),
   ordinaryUnread: exports_external.boolean(),
   lastUnreadSeq: exports_external.number().int().nonnegative(),
   lastAttentionSeq: exports_external.number().int().nonnegative().nullable().optional(),
   attentionCount: exports_external.number().int().nonnegative()
 });
 var AttentionItemSchema = exports_external.strictObject({
-  id,
+  id: id2,
   kind: exports_external.enum(["mention", "reply", "friend_request", "forum_post"]),
-  sourceId: id,
-  scopeId: id.nullable().optional(),
-  messageId: id.nullable().optional(),
-  actorUserId: id.nullable().optional(),
+  sourceId: id2,
+  scopeId: id2.nullable().optional(),
+  messageId: id2.nullable().optional(),
+  actorUserId: id2.nullable().optional(),
   createdAt: exports_external.string(),
-  childChannelId: id.optional(),
+  childChannelId: id2.optional(),
   openerSeq: exports_external.number().int().nonnegative().optional(),
   readTarget: exports_external.strictObject({
-    channelId: id,
+    channelId: id2,
     seq: exports_external.number().int().nonnegative()
   }).optional()
 }).superRefine((item, ctx) => {
@@ -22196,26 +22454,30 @@ var AttentionItemSchema = exports_external.strictObject({
   }
 });
 var AttentionIncludedServerSchema = exports_external.strictObject({
-  id,
+  id: id2,
   name: exports_external.string(),
   discriminator: exports_external.string()
 });
-var AttentionIncludedChannelSchema = exports_external.strictObject({
-  id,
-  serverId: id,
-  name: exports_external.string(),
-  type: exports_external.enum(["text", "forum", "thread"]),
-  parentChannelId: id.nullable(),
-  parentMessageId: id.nullable(),
-  creatorId: id.nullable(),
-  archived: exports_external.boolean(),
-  lastMessageAt: exports_external.string().nullable(),
+var AttentionIncludedChannelSchema = CommunityChannelResourceSchema.pick({
+  id: true,
+  serverId: true,
+  name: true,
+  type: true,
+  parentChannelId: true,
+  parentMessageId: true,
+  creatorId: true,
+  archived: true,
+  lastMessageAt: true
+}).extend({
+  serverId: CommunityChannelResourceSchema.shape.serverId.unwrap(),
+  name: CommunityChannelResourceSchema.shape.name.unwrap(),
+  type: CommunityChannelResourceSchema.shape.type.extract(["text", "forum", "thread"]),
   openerSeq: exports_external.number().int().nonnegative().optional(),
   openerUnread: exports_external.boolean().optional()
 });
 var AttentionIncludedDmSchema = exports_external.strictObject({
-  id,
-  userId: id,
+  id: id2,
+  userId: id2,
   name: exports_external.string(),
   discriminator: exports_external.string(),
   avatar: exports_external.string(),
@@ -22224,22 +22486,21 @@ var AttentionIncludedDmSchema = exports_external.strictObject({
   lastUnreadSeq: exports_external.number().int().nonnegative()
 });
 var AttentionIncludedProfileSchema = exports_external.strictObject({
-  userId: id,
-  name: exports_external.string(),
+  userId: CommunityResourceProfileSchema.shape.id,
+  ...CommunityResourceProfileSchema.pick({ name: true, discriminator: true, avatar: true, avatarVersion: true }).shape,
   discriminator: exports_external.string(),
-  avatar: exports_external.string(),
-  avatarVersion: exports_external.number().int().nonnegative()
-});
-var AttentionIncludedMessageSchema = exports_external.strictObject({
-  id,
-  channelId: id,
-  type: exports_external.enum(["chat", "system"]),
-  authorId: id.optional(),
-  authorName: exports_external.string().optional(),
-  seq: exports_external.number().int().nonnegative(),
-  createdAt: exports_external.string(),
-  content: exports_external.string()
+  avatar: exports_external.string()
 });
+var AttentionIncludedMessageSchema = CommunityMessagePreviewSchema.pick({
+  id: true,
+  channelId: true,
+  type: true,
+  authorId: true,
+  authorName: true,
+  seq: true,
+  createdAt: true,
+  content: true
+}).required({ channelId: true, seq: true, createdAt: true, content: true });
 var AttentionIncludedSchema = exports_external.strictObject({
   servers: exports_external.array(AttentionIncludedServerSchema),
   channels: exports_external.array(AttentionIncludedChannelSchema),
@@ -22265,7 +22526,7 @@ var AccountAttentionSnapshotSchema = exports_external.strictObject({
   const serverById = new Map(snapshot.included.servers.map((server) => [server.id, server]));
   const channelById = new Map(snapshot.included.channels.map((channel2) => [channel2.id, channel2]));
   const dmById = new Map(snapshot.included.dms.map((dm) => [dm.id, dm]));
-  const profileById = new Map(snapshot.included.profiles.map((profile) => [profile.userId, profile]));
+  const profileById = new Map(snapshot.included.profiles.map((profile2) => [profile2.userId, profile2]));
   const messageById = new Map(snapshot.included.messages.map((message2) => [message2.id, message2]));
   const rejectDuplicates = (values, kind) => {
     const seen = new Set;
@@ -22278,7 +22539,7 @@ var AccountAttentionSnapshotSchema = exports_external.strictObject({
   rejectDuplicates(snapshot.included.servers.map((server) => server.id), "server");
   rejectDuplicates(snapshot.included.channels.map((channel2) => channel2.id), "channel");
   rejectDuplicates(snapshot.included.dms.map((dm) => dm.id), "dm");
-  rejectDuplicates(snapshot.included.profiles.map((profile) => profile.userId), "profile");
+  rejectDuplicates(snapshot.included.profiles.map((profile2) => profile2.userId), "profile");
   rejectDuplicates(snapshot.included.messages.map((message2) => message2.id), "message");
   for (const scope of snapshot.scopes) {
     if (scope.serverId) {
@@ -23090,15 +23351,15 @@ var CommunityMachineRuntimeListSchema = exports_external.array(CommunityMachineR
 var CommunityRunningAgentListSchema = exports_external.array(exports_external.string()).transform((list) => {
   const seen = new Set;
   const out = [];
-  for (const id2 of list) {
-    if (seen.has(id2))
+  for (const id3 of list) {
+    if (seen.has(id3))
       continue;
-    seen.add(id2);
-    out.push(id2);
+    seen.add(id3);
+    out.push(id3);
   }
   return out;
 });
-var CommunityMachineSummarySchema = exports_external.object({
+var CommunityMachineSummarySchema = exports_external.strictObject({
   id: exports_external.string(),
   hostname: exports_external.string(),
   displayName: exports_external.string(),
@@ -23108,8 +23369,8 @@ var CommunityMachineSummarySchema = exports_external.object({
   daemonVersion: exports_external.string(),
   lastSeenAt: exports_external.string().nullable(),
   status: exports_external.enum(["online", "offline"]),
-  availableRuntimes: exports_external.array(CommunityMachineRuntimeSchema).default([]),
-  lastRuntimeError: exports_external.object({
+  availableRuntimes: exports_external.array(CommunityMachineRuntimeSchema.strict()),
+  lastRuntimeError: exports_external.strictObject({
     requested: exports_external.string(),
     available: exports_external.array(exports_external.string()),
     at: exports_external.string()
@@ -23492,6 +23753,7 @@ __export(exports_community_schema, {
   communityMessageTag: () => communityMessageTag,
   communityMessageSeq: () => communityMessageSeq,
   communityMessageMark: () => communityMessageMark,
+  communityMessageAttachment: () => communityMessageAttachment,
   communityMessage: () => communityMessage,
   communityMention: () => communityMention,
   communityFriendship: () => communityFriendship,
@@ -23667,11 +23929,7 @@ var communityReaction = sqliteTable("community_reaction", {
 ]);
 var communityAttachment = sqliteTable("community_attachment", {
   id: text("id").primaryKey().$defaultFn(() => nanoid3()),
-  messageId: text("message_id").references(() => communityMessage.id, {
-    onDelete: "cascade"
-  }),
   uploaderId: text("uploader_id").notNull(),
-  targetId: text("target_id").notNull(),
   r2Key: text("r2_key").notNull(),
   thumbnailR2Key: text("thumbnail_r2_key"),
   filename: text("filename").notNull(),
@@ -23679,10 +23937,20 @@ var communityAttachment = sqliteTable("community_attachment", {
   size: integer2("size"),
   width: integer2("width"),
   height: integer2("height"),
-  position: integer2("position"),
   createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
 }, (t) => [
-  index("idx_attachment_message").on(t.messageId, t.position)
+  index("idx_attachment_uploader").on(t.uploaderId),
+  index("idx_attachment_r2_key").on(t.r2Key),
+  index("idx_attachment_thumbnail_r2_key").on(t.thumbnailR2Key)
+]);
+var communityMessageAttachment = sqliteTable("community_message_attachment", {
+  messageId: text("message_id").notNull().references(() => communityMessage.id, { onDelete: "cascade" }),
+  attachmentId: text("attachment_id").notNull().references(() => communityAttachment.id, { onDelete: "restrict" }),
+  position: integer2("position").notNull()
+}, (t) => [
+  primaryKey({ columns: [t.messageId, t.attachmentId] }),
+  unique("uq_message_attachment_position").on(t.messageId, t.position),
+  index("idx_message_attachment_file").on(t.attachmentId, t.messageId)
 ]);
 var communityPin = sqliteTable("community_pin", {
   id: text("id").primaryKey().$defaultFn(() => nanoid3()),
@@ -23804,6 +24072,41 @@ var communityMessageTag = sqliteTable("community_message_tag", {
   index("idx_message_tag_tag").on(t.tag, t.messageId)
 ]);
 
+// ../shared/src/db/queries/_chunk.ts
+var D1_MAX_BIND_PARAMS = 100;
+function maxInParams(fixedParams) {
+  if (!Number.isInteger(fixedParams) || fixedParams < 0) {
+    throw new Error("fixed params must be a non-negative integer");
+  }
+  if (fixedParams >= D1_MAX_BIND_PARAMS) {
+    throw new Error("fixed params must leave room for at least one IN parameter");
+  }
+  return D1_MAX_BIND_PARAMS - fixedParams;
+}
+function maxRowsPerInsert(paramsPerRow) {
+  if (paramsPerRow < 1)
+    throw new Error("paramsPerRow must be >= 1");
+  return Math.floor(D1_MAX_BIND_PARAMS / paramsPerRow);
+}
+
+// ../shared/src/db/queries/community/channel.ts
+var CHANNEL_COLUMNS = {
+  id: communityChannel.id,
+  serverId: communityChannel.serverId,
+  categoryId: communityChannel.categoryId,
+  name: communityChannel.name,
+  type: communityChannel.type,
+  topic: communityChannel.topic,
+  position: communityChannel.position,
+  parentChannelId: communityChannel.parentChannelId,
+  creatorId: communityChannel.creatorId,
+  messageCount: communityChannel.messageCount,
+  archived: communityChannel.archived,
+  parentMessageId: communityChannel.parentMessageId,
+  lastMessageAt: communityChannel.lastMessageAt,
+  createdAt: communityChannel.createdAt
+};
+
 // ../shared/src/logger.ts
 var LEVELS = {
   debug: 0,
@@ -23884,23 +24187,6 @@ function createLogger(opts) {
   return new Logger(opts);
 }
 
-// ../shared/src/db/queries/_chunk.ts
-var D1_MAX_BIND_PARAMS = 100;
-function maxInParams(fixedParams) {
-  if (!Number.isInteger(fixedParams) || fixedParams < 0) {
-    throw new Error("fixed params must be a non-negative integer");
-  }
-  if (fixedParams >= D1_MAX_BIND_PARAMS) {
-    throw new Error("fixed params must leave room for at least one IN parameter");
-  }
-  return D1_MAX_BIND_PARAMS - fixedParams;
-}
-function maxRowsPerInsert(paramsPerRow) {
-  if (paramsPerRow < 1)
-    throw new Error("paramsPerRow must be >= 1");
-  return Math.floor(D1_MAX_BIND_PARAMS / paramsPerRow);
-}
-
 // ../shared/src/db/queries/community/message.ts
 var log = createLogger({ service: "community-queries" });
 var messageProjection = {
@@ -23999,24 +24285,6 @@ var userProductPlan = sqliteTable("user_product_plan", {
   updatedAt: text("updated_at").notNull().$defaultFn(() => new Date().toISOString())
 }, (t) => [index("idx_user_product_plan_plan").on(t.planId)]);
 
-// ../shared/src/db/queries/community/channel.ts
-var CHANNEL_COLUMNS = {
-  id: communityChannel.id,
-  serverId: communityChannel.serverId,
-  categoryId: communityChannel.categoryId,
-  name: communityChannel.name,
-  type: communityChannel.type,
-  topic: communityChannel.topic,
-  position: communityChannel.position,
-  parentChannelId: communityChannel.parentChannelId,
-  creatorId: communityChannel.creatorId,
-  messageCount: communityChannel.messageCount,
-  archived: communityChannel.archived,
-  parentMessageId: communityChannel.parentMessageId,
-  lastMessageAt: communityChannel.lastMessageAt,
-  createdAt: communityChannel.createdAt
-};
-
 // ../shared/src/db/queries/community/thread.ts
 var NOTIFY_CONFLICT_TARGET = [
   communityChannelMember.channelId,
@@ -24042,203 +24310,6 @@ var AGENT_UNREAD_CHANNEL_CHUNK_SIZE = maxInParams(13);
 
 // ../shared/src/db/queries/community/mention.ts
 var MENTION_INSERT_MAX_ROWS = maxRowsPerInsert(5);
-// ../shared/src/community-friend-approval.ts
-var profile = exports_external.strictObject({
-  id: exports_external.string(),
-  name: exports_external.string(),
-  discriminator: exports_external.string(),
-  image: exports_external.string().nullable(),
-  avatarVersion: exports_external.number().int().nonnegative()
-});
-var FriendApprovalPayloadSchema = exports_external.strictObject({
-  friendshipId: exports_external.string(),
-  status: exports_external.enum(["pending", "approved", "denied", "superseded", "cancelled"]),
-  waitingOn: exports_external.enum(["you", "other-owner", "addressee"]).nullable(),
-  otherProfile: profile,
-  botProfile: profile,
-  waitingOnProfile: profile.nullable().optional()
-});
-
-// ../shared/src/community-contract.ts
-var COMMUNITY_CONTRACT_VERSION = 2;
-
-// ../shared/src/community-resources.ts
-var id2 = exports_external.string().min(1);
-var nullableId = id2.nullable();
-var legacyArchivedSchema = exports_external.union([exports_external.boolean(), exports_external.literal(0), exports_external.literal(1)]).transform((value) => value === true || value === 1);
-var CommunityChannelResourceSchema = exports_external.strictObject({
-  id: id2,
-  type: exports_external.enum(["text", "forum", "thread", "dm"]),
-  serverId: nullableId,
-  categoryId: nullableId,
-  name: exports_external.string().nullable(),
-  topic: exports_external.string(),
-  parentChannelId: nullableId,
-  parentMessageId: nullableId,
-  creatorId: nullableId,
-  position: exports_external.number(),
-  archived: exports_external.boolean(),
-  createdAt: exports_external.string(),
-  lastMessageAt: exports_external.string().nullable(),
-  messageCount: exports_external.number().int().nonnegative()
-});
-var CommunityChannelIdentitySchema = CommunityChannelResourceSchema.pick({
-  id: true,
-  type: true,
-  serverId: true,
-  name: true,
-  parentChannelId: true,
-  parentMessageId: true,
-  creatorId: true,
-  archived: true,
-  lastMessageAt: true,
-  createdAt: true
-}).partial({ createdAt: true }).strip();
-var legacyChannelIdentitySchema = CommunityChannelIdentitySchema.extend({
-  archived: legacyArchivedSchema,
-  parentChannelId: nullableId.default(null),
-  parentMessageId: nullableId.default(null),
-  creatorId: nullableId.default(null),
-  lastMessageAt: CommunityChannelResourceSchema.shape.lastMessageAt.default(null)
-});
-var CommunityAccessDecisionSchema = exports_external.strictObject({
-  channelId: id2,
-  canRead: exports_external.boolean(),
-  canSend: exports_external.boolean(),
-  canCreateDiscussion: exports_external.boolean()
-});
-var CommunityMessageAttachmentSchema = exports_external.strictObject({
-  kind: exports_external.enum(["image", "file"]),
-  name: exports_external.string(),
-  url: exports_external.string(),
-  thumbnailUrl: exports_external.string().optional(),
-  contentType: exports_external.string().optional(),
-  size: exports_external.string().optional(),
-  sizeBytes: exports_external.number().nonnegative().optional(),
-  width: exports_external.number().nonnegative().optional(),
-  height: exports_external.number().nonnegative().optional()
-});
-var CommunityMessageResourceSchema = exports_external.strictObject({
-  id: id2,
-  channelId: id2,
-  seq: exports_external.number().int().nonnegative(),
-  authorId: id2,
-  createdAt: exports_external.string(),
-  type: exports_external.enum(["chat", "system"]),
-  content: exports_external.string(),
-  replyToId: nullableId,
-  clientNonce: exports_external.string().nullable(),
-  attachments: exports_external.array(CommunityMessageAttachmentSchema),
-  systemKind: exports_external.literal("thread").optional(),
-  authorName: exports_external.string().optional(),
-  authorAvatar: exports_external.string().optional(),
-  authorAvatarVersion: exports_external.number().int().nonnegative().optional(),
-  mentionType: exports_external.literal("everyone").nullable().optional(),
-  replyTo: exports_external.strictObject({
-    id: id2,
-    authorId: id2.optional(),
-    authorName: exports_external.string(),
-    text: exports_external.string(),
-    deleted: exports_external.boolean().optional()
-  }).optional(),
-  embeds: exports_external.array(exports_external.unknown()).optional(),
-  reactions: exports_external.array(exports_external.strictObject({
-    emoji: exports_external.string(),
-    count: exports_external.number().int().nonnegative(),
-    me: exports_external.boolean(),
-    userIds: exports_external.array(id2)
-  })).optional(),
-  thread: exports_external.strictObject({
-    id: id2,
-    name: exports_external.string(),
-    messageCount: exports_external.number().int().nonnegative(),
-    lastReplyAt: exports_external.string().optional(),
-    tags: exports_external.array(exports_external.string()).optional(),
-    preview: exports_external.string().optional(),
-    participants: exports_external.array(exports_external.strictObject({ id: id2, name: exports_external.string(), avatar: exports_external.string(), avatarVersion: exports_external.number().int().nonnegative() })).optional(),
-    participantCount: exports_external.number().int().nonnegative().optional()
-  }).optional(),
-  approval: FriendApprovalPayloadSchema.optional()
-});
-var CommunityReadStateResourceSchema = exports_external.strictObject({
-  channelId: id2,
-  lastReadMessageId: nullableId,
-  lastReadAt: exports_external.string().nullable(),
-  lastReadSeq: exports_external.number().int().nonnegative()
-});
-var CommunityMemberRelationSchema = exports_external.strictObject({
-  channelId: id2,
-  userId: id2,
-  relation: exports_external.enum(["access", "notify"]),
-  source: exports_external.string(),
-  isCreator: exports_external.boolean(),
-  role: exports_external.string().nullable(),
-  memberId: nullableId
-});
-var CommunityResourceProfileSchema = exports_external.strictObject({
-  id: id2,
-  name: exports_external.string(),
-  discriminator: exports_external.string().nullable(),
-  avatar: exports_external.string().nullable(),
-  avatarVersion: exports_external.number().int().nonnegative(),
-  statusEmoji: exports_external.string().nullable(),
-  statusText: exports_external.string()
-});
-var CommunityPageSchema = exports_external.strictObject({
-  olderCursor: exports_external.string().nullable(),
-  newerCursor: exports_external.string().nullable(),
-  hasMoreOlder: exports_external.boolean(),
-  hasMoreNewer: exports_external.boolean(),
-  latestSeq: exports_external.number().int().nonnegative()
-});
-var envelope = { contractVersion: exports_external.literal(COMMUNITY_CONTRACT_VERSION), channelId: id2 };
-var CommunityChannelReadSchema = exports_external.strictObject({ ...envelope, channel: CommunityChannelResourceSchema, access: CommunityAccessDecisionSchema });
-var CommunityMessagesReadSchema = exports_external.strictObject({
-  ...envelope,
-  messages: exports_external.array(CommunityMessageResourceSchema),
-  page: CommunityPageSchema,
-  surfaceReceipt: exports_external.strictObject({ channelId: id2, surfaceKind: exports_external.enum(["channel", "forum", "thread", "dm"]) })
-});
-var CommunityReadStateReadSchema = exports_external.strictObject({ ...envelope, readState: CommunityReadStateResourceSchema });
-var CommunityMembersReadSchema = exports_external.strictObject({ ...envelope, relation: exports_external.enum(["access", "notify"]), members: exports_external.array(CommunityMemberRelationSchema), profiles: exports_external.array(CommunityResourceProfileSchema) });
-var CommunityThreadsReadSchema = exports_external.strictObject({
-  ...envelope,
-  channel: CommunityChannelResourceSchema,
-  threads: exports_external.array(CommunityChannelResourceSchema),
-  included: exports_external.strictObject({
-    messages: exports_external.array(CommunityMessageResourceSchema),
-    members: exports_external.array(CommunityMemberRelationSchema),
-    profiles: exports_external.array(CommunityResourceProfileSchema),
-    tags: exports_external.array(exports_external.strictObject({ messageId: id2, tag: exports_external.string() })),
-    participantCounts: exports_external.array(exports_external.strictObject({ channelId: id2, count: exports_external.number().int().nonnegative() }))
-  }),
-  page: exports_external.strictObject({ nextCursor: exports_external.string().nullable(), hasMore: exports_external.boolean() })
-});
-var CommunityReadAdvanceSchema = exports_external.strictObject({ ...envelope, changed: exports_external.boolean(), targetSeq: exports_external.number().int().nonnegative(), revision: exports_external.number().int().nonnegative() });
-var CommunityReadErrorSchema = exports_external.strictObject({ contractVersion: exports_external.literal(COMMUNITY_CONTRACT_VERSION), error: exports_external.strictObject({
-  code: exports_external.enum(["invalid_input", "invalid_reply_target", "unauthenticated", "not_found", "not_allowed", "blocked", "idempotency_conflict", "rate_limited", "temporarily_unavailable"]),
-  message: exports_external.string(),
-  retryable: exports_external.boolean()
-}) });
-var legacyChannelResourceSchema = CommunityChannelResourceSchema.strip().extend({
-  topic: CommunityChannelResourceSchema.shape.topic.nullish().transform((value) => value ?? ""),
-  position: CommunityChannelResourceSchema.shape.position.nullish().transform((value) => value ?? 0),
-  messageCount: CommunityChannelResourceSchema.shape.messageCount.nullish().transform((value) => value ?? 0),
-  categoryId: nullableId.default(null),
-  parentChannelId: nullableId.default(null),
-  parentMessageId: nullableId.default(null),
-  creatorId: nullableId.default(null),
-  lastMessageAt: CommunityChannelResourceSchema.shape.lastMessageAt.default(null),
-  archived: legacyArchivedSchema
-});
-var legacyMessageResourceSchema = CommunityMessageResourceSchema.strip().extend({
-  channelId: id2.optional(),
-  replyToId: nullableId.optional(),
-  clientNonce: CommunityMessageResourceSchema.shape.clientNonce.default(null),
-  attachments: CommunityMessageResourceSchema.shape.attachments.default([]),
-  embeds: CommunityMessageResourceSchema.shape.embeds.nullable().transform((value) => value ?? undefined)
-});
-
 // ../shared/src/community-ws-events.ts
 var string4 = exports_external.string();
 var nullableString = string4.nullable();
@@ -24268,6 +24339,7 @@ var messageSchema = CommunityMessageResourceSchema.pick({
   seq: exports_external.number(),
   authorId: string4,
   authorName: string4,
+  authorAvatar: string4.optional(),
   authorAvatarVersion: CommunityMessageResourceSchema.shape.authorAvatarVersion.unwrap(),
   replyToId: nullableString.optional(),
   replyTo: CommunityMessageResourceSchema.shape.replyTo.unwrap().extend({
@@ -24277,7 +24349,7 @@ var messageSchema = CommunityMessageResourceSchema.pick({
   attachments: exports_external.array(messageAttachmentSchema).optional(),
   clientNonce: string4.optional()
 });
-var communityMessageCreateSchema = exports_external.strictObject({
+var CommunityLegacyMessageCreateSchema = exports_external.strictObject({
   type: exports_external.literal("community:message.create"),
   channelId: string4,
   serverId: string4.optional(),
@@ -24589,29 +24661,9 @@ var communityProfileUpdateSchema = exports_external.strictObject({
   kind: exports_external.enum(["human", "bot"]),
   ownerUserId: nullableString
 });
-var machineRuntimeSchema = CommunityMachineRuntimeSchema.strict();
-var CommunityMachineSummarySchema2 = exports_external.strictObject({
-  id: string4,
-  hostname: string4,
-  displayName: string4,
-  platform: string4,
-  arch: string4,
-  osRelease: string4,
-  daemonVersion: string4,
-  lastSeenAt: nullableString,
-  status: exports_external.enum(["online", "offline"]),
-  availableRuntimes: exports_external.array(machineRuntimeSchema),
-  lastRuntimeError: exports_external.strictObject({
-    requested: string4,
-    available: exports_external.array(string4),
-    at: string4
-  }).optional(),
-  createdAt: string4,
-  updatedAt: string4
-});
 var communityMachineCreatedSchema = exports_external.strictObject({
   type: exports_external.literal("community:machine.created"),
-  machine: CommunityMachineSummarySchema2,
+  machine: CommunityMachineSummarySchema,
   tokenId: string4
 });
 var communityMachineStatusSchema = exports_external.strictObject({
@@ -24622,7 +24674,7 @@ var communityMachineStatusSchema = exports_external.strictObject({
 });
 var communityMachineUpdatedSchema = exports_external.strictObject({
   type: exports_external.literal("community:machine.updated"),
-  machine: CommunityMachineSummarySchema2
+  machine: CommunityMachineSummarySchema
 });
 var communityMachineRemovedSchema = exports_external.strictObject({
   type: exports_external.literal("community:machine.removed"),
@@ -24638,8 +24690,7 @@ var communityBotAuditEventSchema = exports_external.strictObject({
   launchId: nullableString.optional(),
   createdAt: string4
 }).refine((event) => Object.prototype.hasOwnProperty.call(event, "payload"));
-var CommunityWsEventDiscriminatedSchema = exports_external.discriminatedUnion("type", [
-  communityMessageCreateSchema,
+var commonCommunityEventSchemas = [
   communityMessageUpdatedSchema,
   communityMessageEditedSchema,
   communityReactionAddSchema,
@@ -24648,12 +24699,8 @@ var CommunityWsEventDiscriminatedSchema = exports_external.discriminatedUnion("t
   communityPinRemoveSchema,
   communityTypingStartSchema,
   communityTypingStopSchema,
-  communityChildChannelCreateSchema,
-  communityChildChannelUpdateSchema,
   communityServerUpdateSchema,
   communityServerDeleteSchema,
-  communityChannelCreateSchema,
-  communityChannelUpdateSchema,
   communityChannelDeleteSchema,
   communityChannelReorderSchema,
   communityChannelMemberAddSchema,
@@ -24678,15 +24725,34 @@ var CommunityWsEventDiscriminatedSchema = exports_external.discriminatedUnion("t
   communityInboxChangedSchema,
   communityPresenceUpdateSchema,
   communityStatusUpdateSchema,
-  communityIdentityUpdateSchema,
-  communityProfileUpdateSchema,
   communityMachineCreatedSchema,
   communityMachineStatusSchema,
   communityMachineUpdatedSchema,
   communityMachineRemovedSchema,
   communityBotAuditEventSchema
+];
+var CommunityWsEventDiscriminatedSchema = exports_external.discriminatedUnion("type", [
+  ...commonCommunityEventSchemas,
+  CommunityLegacyMessageCreateSchema,
+  communityChildChannelCreateSchema,
+  communityChannelCreateSchema,
+  communityChildChannelUpdateSchema,
+  communityChannelUpdateSchema,
+  communityIdentityUpdateSchema,
+  communityProfileUpdateSchema
+]);
+var CommunityResourceWsEventDiscriminatedSchema = exports_external.discriminatedUnion("type", [
+  ...commonCommunityEventSchemas,
+  CommunityLegacyMessageCreateSchema.extend({ message: CommunityMessageResourceSchema.required({ authorName: true, authorAvatarVersion: true }) }).refine((event) => event.message.channelId === event.channelId),
+  communityChildChannelCreateSchema.extend({ channel: CommunityChannelResourceSchema.extend({ type: exports_external.literal("thread") }) }).refine((event) => event.channel.parentChannelId === event.parentChannelId && (event.parentMessageId === undefined || event.parentMessageId === event.channel.parentMessageId)),
+  communityChannelCreateSchema.extend({ channel: CommunityChannelResourceSchema.extend({ type: channelTypeSchema }) }).refine((event) => event.channel.serverId === event.serverId),
+  communityChildChannelUpdateSchema.extend({ changes: CommunityChannelResourceSchema.pick({ name: true, archived: true, lastMessageAt: true, messageCount: true }).partial().extend({ tags: exports_external.array(string4).nullable().optional() }) }),
+  communityChannelUpdateSchema.extend({ changes: CommunityChannelResourceSchema.pick({ name: true, topic: true, categoryId: true, type: true }).partial().extend({ type: channelTypeSchema.optional() }) }),
+  communityIdentityUpdateSchema.extend({ avatar: CommunityResourceProfileSchema.shape.avatar, avatarVersion: CommunityResourceProfileSchema.shape.avatarVersion.refine((version3) => version3 > 0) }),
+  CommunityResourceProfileSchema.pick({ name: true, discriminator: true, aboutMe: true, bannerColor: true, kind: true, ownerUserId: true }).required().extend({ type: exports_external.literal("community:profile.update"), userId: string4 })
 ]);
 var CommunityWsEventSchema = CommunityWsEventDiscriminatedSchema.transform((event) => event);
+var CommunityResourceWsEventSchema = CommunityResourceWsEventDiscriminatedSchema.transform((event) => event);
 var WS_EVENTS = {
   MESSAGE_CREATE: "community:message.create",
   MESSAGE_UPDATED: "community:message.updated",
@@ -24770,6 +24836,7 @@ var memberAddedSchema = exports_external.strictObject({
   channelId: exports_external.string().min(1)
 });
 var batchShape = exports_external.strictObject({
+  communityContract: exports_external.literal(3).optional(),
   messageId: exports_external.string().min(1),
   messageEvent: exports_external.unknown(),
   contentUserIds: targetList,
@@ -24886,8 +24953,46 @@ var communityFunnelAnalyticsEvent = sqliteTable("community_funnel_analytics_even
   index("idx_community_funnel_analytics_owner_claimed_created").on(t.ownerUserId, t.claimedAt, t.createdAt)
 ]);
 
+// ../shared/src/db/product-analytics-schema.ts
+var exports_product_analytics_schema = {};
+__export(exports_product_analytics_schema, {
+  productAnalyticsEvent: () => productAnalyticsEvent,
+  PRODUCT_ANALYTICS_EVENTS: () => PRODUCT_ANALYTICS_EVENTS
+});
+var PRODUCT_ANALYTICS_EVENTS = [
+  "landing_cta_clicked",
+  "login_page_view",
+  "sign_up",
+  "sign_in_success",
+  "sign_in_failed",
+  "onboarding_enter_clicked",
+  "onboarding_first_message",
+  "invitation_link_visit"
+];
+var productAnalyticsEvent = sqliteTable("product_analytics_event", {
+  id: text("id").primaryKey(),
+  eventName: text("event_name").notNull().$type(),
+  actorUserId: text("actor_user_id").references(() => user.id, { onDelete: "cascade" }),
+  serverId: text("server_id").references(() => communityServer.id, { onDelete: "cascade" }),
+  sourceId: text("source_id"),
+  dedupeKey: text("dedupe_key").notNull(),
+  clientId: text("client_id").notNull(),
+  sessionId: text("session_id").notNull(),
+  method: text("method"),
+  accountKind: text("account_kind").$type(),
+  ctaName: text("cta_name"),
+  failureStage: text("failure_stage").$type(),
+  createdAt: text("created_at").notNull(),
+  deliveryStatus: text("delivery_status").notNull().default("pending").$type(),
+  deliveryReason: text("delivery_reason"),
+  attemptedAt: text("attempted_at")
+}, (t) => [
+  uniqueIndex("uq_product_analytics_dedupe").on(t.dedupeKey),
+  index("idx_product_analytics_actor_server_event").on(t.actorUserId, t.serverId, t.eventName)
+]);
+
 // ../shared/src/db/index.ts
-var allSchema = { ...exports_schema, ...exports_community_schema, ...exports_community_machine_schema, ...exports_product_plan_schema, ...exports_billing_schema, ...exports_community_funnel_analytics_schema };
+var allSchema = { ...exports_schema, ...exports_community_schema, ...exports_community_machine_schema, ...exports_product_plan_schema, ...exports_billing_schema, ...exports_community_funnel_analytics_schema, ...exports_product_analytics_schema };
 // ../shared/src/community-server-rail.ts
 var MAX_SERVER_RAIL_COMMANDS = 3;
 var idSchema = exports_external.string().trim().min(1);
@@ -25170,7 +25275,8 @@ function createProxyServerApi(config2) {
       form.append("width", String(req.width));
     if (req.height !== undefined)
       form.append("height", String(req.height));
-    const url2 = `${base}/api/community/channels/${REF_PLACEHOLDER_ID}/attachments?target=${encodeURIComponent(req.target)}`;
+    const query = req.target === undefined ? "" : `?target=${encodeURIComponent(req.target)}`;
+    const url2 = `${base}/api/community/channels/${REF_PLACEHOLDER_ID}/attachments${query}`;
     const res = await fetchImpl(url2, {
       method: "POST",
       headers: { authorization: `Bearer ${config2.voucher}` },
@@ -38494,9 +38600,9 @@ function cliCommandsSection() {
     "### Messaging",
     "",
     `1. \`${CLI} inbox pull\` — fetch unread messages and advance their read waterlines.`,
-    `2. \`${CLI} message send --target <ref> --remind-after <0|Nm|Nh> --stdin\` — send to a ` + `channel, DM, or thread. ` + `The body is required through \`--stdin\` and limited to 1 KiB of UTF-8. ` + `Attach uploaded files with \`--attachment <id>\` (repeatable, order matters). ` + `\`--remind-after\` accepts \`0\`, or a whole-number duration from \`1m\` to \`24h\`.`,
-    `3. \`${CLI} message attachment upload --target <ref> --file <path>\` — upload a file; ` + `returns an id stable across pending→persisted.`,
-    `4. \`${CLI} message attachment download --id <id> [--out <path>]\` — download any ` + `attachment you can see (or your own pending uploads).`,
+    `2. \`${CLI} message send --target <ref> --remind-after <0|Nm|Nh> --stdin\` — send to a ` + `channel, DM, or thread. ` + `The body is required through \`--stdin\` and limited to 1 KiB of UTF-8. ` + `Attach files with \`--attachment <id>\` (repeatable, order matters). ` + `\`--remind-after\` accepts \`0\`, or a whole-number duration from \`1m\` to \`24h\`.`,
+    `3. \`${CLI} message attachment upload --file <path>\` — upload a local file and get a reusable attachment ID.`,
+    `4. \`${CLI} message attachment download --id <id> [--out <path>]\` — download an attachment you can read, including your own unsent uploads.`,
     `5. \`${CLI} message property set --target <full-message-ref> --json <json>\` — add a supported property value to a message.`,
     `6. \`${CLI} message property list --target <full-message-ref>\` — list the message's current properties and supported capabilities.`,
     `7. \`${CLI} message property remove --target <full-message-ref> --json <json>\` — remove a supported property value from a message.`,
@@ -38557,7 +38663,8 @@ function messagingSection() {
     "#### Sending mechanics",
     "",
     `- Send body: use \`${CLI} message send --target <ref> --remind-after T --stdin\` with the ` + "quoted-heredoc form under *Message formatting*.",
-    `- Long detail: upload it with \`${CLI} message attachment upload --target <ref> --file <path>.md\`; ` + "add the returned id as `--attachment <id>` on the short stdin send.",
+    `- Long detail: upload it with \`${CLI} message attachment upload --file <path>.md\`; ` + "add the returned id as `--attachment <id>` on the short stdin send.",
+    "- Reuse files: to forward an attachment or send the same file again, pass its existing ID with `--attachment <id>`. " + "Do not download and upload it again. Reuse works across channels, DMs, and threads while you can still read the file. " + "Upload only a new or changed file.",
     `- Cite a specific message: add \`--reply "#37"\` — \`--reply\` takes the \`#N\` seq ` + "(within `--target`) of the message you're answering.",
     "",
     "Reply where the message came from. Post results in the channel that owns the topic. " + "When uncertain, read history (below) or DM the relevant people.",
@@ -38673,7 +38780,19 @@ function utilsSection() {
     "",
     "### Join a new server",
     "",
-    `If a message contains a \`/c/invite/...\` link, just run \`${CLI} server join --invite <link>\`. ` + "The server enforces owner-only: it accepts only invites your owner created and rejects the " + "rest with a reason. Safe to attempt without reasoning about who sent it."
+    `If a message contains a \`/c/invite/...\` link, just run \`${CLI} server join --invite <link>\`. ` + "The server enforces owner-only: it accepts only invites your owner created and rejects the " + "rest with a reason. Safe to attempt without reasoning about who sent it.",
+    "",
+    "### Answer questions about Alook itself",
+    "",
+    "Alook frontend source code: https://github.com/alookai/alook/tree/main/src/web/src",
+    "",
+    "Only when a user specifically asks for Alook product guidance or clarification about " + "the product, read the relevant frontend code before answering. " + "Check the page, visible labels, and interaction handlers to verify the steps.",
+    "",
+    "Give clear UI click instructions in the user's language. Start with the page they are on. " + "Use simple positions such as top-left or left sidebar, visible icons, and button labels " + "to identify exactly where to click. Explain each click in order and what appears next. " + "Keep frontend code names and layout terms out of the user's instructions.",
+    "",
+    'Bad: "Click thisReactButton, on the same layer as serverRailContainer."',
+    "",
+    'Good: "From the channel chat page in XX server, look at the top-left corner. Click the ' + "Home button with the Alook logo. After Home opens, click My Bots near the top-left " + 'of the left sidebar."'
   ].join(`
 `);
 }
@@ -47007,8 +47126,6 @@ async function cmdAttachmentUpload(opts) {
   const agent2 = agentId(opts);
   const target2 = opts.target;
   const filePath = opts.file;
-  if (!target2)
-    throw new CliError("message attachment upload: --target <ref> is required");
   if (!filePath)
     throw new CliError("message attachment upload: --file <path> is required");
   const fs13 = await import("fs/promises");
@@ -47045,7 +47162,7 @@ async function cmdAttachmentUpload(opts) {
   }
   const result = await api2.attachmentUpload({
     agentId: agent2,
-    target: target2,
+    ...target2 !== undefined ? { target: target2 } : {},
     file: { data: new Uint8Array(bytes), filename, contentType },
     ...thumbnail ? { thumbnail } : {},
     ...width !== undefined ? { width } : {},
@@ -47329,7 +47446,7 @@ function buildProgram(stdin) {
   });
   const attachment = message2.command("attachment").description("attachment operations").exitOverride();
   attachment.configureOutput({ writeOut: () => {}, writeErr: () => {} });
-  attachment.command("upload").description("upload a local file as a pending attachment for a future send").option("--target <ref>", "destination (channel, DM, or thread ref)").option("--file <path>", "local file to upload").exitOverride().configureOutput({ writeOut: () => {}, writeErr: () => {} }).action(async function() {
+  attachment.command("upload").description("upload a local file and get its reusable attachment id").option("--target <ref>", "optional legacy target (channel, DM, or thread ref)").option("--file <path>", "local file to upload").exitOverride().configureOutput({ writeOut: () => {}, writeErr: () => {} }).action(async function() {
     const localOpts = this.opts();
     const globalOpts = program.opts();
     const result = await cmdAttachmentUpload({ ...globalOpts, ...localOpts });