@shadowob/shared 1.1.7 → 1.1.9

package/dist/{chunk-EXZEQO5X.js → chunk-KKRZTKE6.js}

@@ -8,24 +8,21 @@ var playTemplate = (id) => ({
   },
   materials: { cover: playCover(id) }
 });
-var communityAction = (channelName, greeting) => ({
+var communityAction = (channelName) => ({
   kind: "public_channel",
   channelName,
-  buddyTemplateSlug: channelName,
-  ...greeting ? { greeting } : {}
+  buddyTemplateSlug: channelName
 });
-var roomAction = (namePrefix, greeting) => ({
+var roomAction = (namePrefix) => ({
   kind: "private_room",
   namePrefix,
-  buddyTemplateSlug: namePrefix,
-  ...greeting ? { greeting } : {}
+  buddyTemplateSlug: namePrefix
 });
-var cloudAction = (templateSlug, resourceTier = "lightweight", defaultChannelName) => ({
+var cloudAction = (templateSlug, resourceTier = "lightweight") => ({
   kind: "cloud_deploy",
   templateSlug,
   buddyTemplateSlug: templateSlug,
-  resourceTier,
-  ...defaultChannelName ? { defaultChannelName } : {}
+  resourceTier
 });
 function getPlayBuddyUsername(templateSlug) {
   const normalized = templateSlug.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 27) || "play";
@@ -34,55 +31,15 @@ function getPlayBuddyUsername(templateSlug) {
 function getPlayBuddyEmail(templateSlug) {
   return `${getPlayBuddyUsername(templateSlug)}@shadowob.bot`;
 }
-var SHADOW_PLAY_SERVER_TEMPLATE = {
-  slug: "shadow-plays",
-  name: "Shadow Plays",
-  description: "Default public community space for launchable homepage plays.",
-  channels: [
-    {
-      name: "general",
-      topic: "General discussion for new players and Shadow community members."
-    },
-    {
-      name: "world-pulse",
-      topic: "A public room for real-time global events and daily signal."
-    },
-    {
-      name: "financial-freedom",
-      topic: "A public room for lightweight financial freedom simulations and planning prompts."
-    },
-    {
-      name: "ai-werewolf",
-      topic: "A public room for AI-hosted social deduction sessions."
-    },
-    {
-      name: "code-arena",
-      topic: "A public room for coding challenges and real-time battles."
-    },
-    {
-      name: "brain-fix",
-      topic: "A calm public room for one-minute focus resets and reflection."
-    },
-    {
-      name: "gitstory",
-      topic: "A public room for turning software history into stories and retrospectives."
-    },
-    {
-      name: "gstack",
-      topic: "A public room for founder strategy, product stress tests, and launch planning."
-    }
-  ]
-};
 function cloudPlay(id, input) {
-  const { defaultChannelName, ...content } = input;
   return {
     id,
     image: playCover(id),
     status: "gated",
-    action: cloudAction(id, "lightweight", defaultChannelName),
+    action: cloudAction(id, "lightweight"),
     gates: { auth: "required", membership: "required", profile: "optional" },
     ...playTemplate(id),
-    ...content
+    ...input
   };
 }
 var DEFAULT_HOMEPLAY_CATALOG = [
@@ -246,7 +203,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     accentColor: "#f59e0b",
     hot: true,
     status: "gated",
-    action: cloudAction("little-match-girl", "lightweight", "match-street"),
+    action: cloudAction("little-match-girl", "lightweight"),
     gates: { auth: "required", membership: "required", profile: "optional" },
     ...playTemplate("little-match-girl"),
     materials: { cover: "/home-assets/topics/night-radio.jpg" }
@@ -260,8 +217,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     categoryEn: "Buddy Teams",
     starts: "16.4k",
     accentColor: "#22d3ee",
-    hot: true,
-    defaultChannelName: "choose"
+    hot: true
   }),
   cloudPlay("bmad-method-buddy", {
     title: "BMAD \u65B9\u6CD5 Buddy",
@@ -271,8 +227,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     category: "Buddy \u56E2\u961F",
     categoryEn: "Buddy Teams",
     starts: "13.7k",
-    accentColor: "#60a5fa",
-    defaultChannelName: "delivery"
+    accentColor: "#60a5fa"
   }),
   cloudPlay("claude-ads-buddy", {
     title: "Claude Ads Buddy",
@@ -335,8 +290,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     categoryEn: "Hacker & Painter",
     starts: "15.1k",
     accentColor: "#fb923c",
-    hot: true,
-    defaultChannelName: "office-hours"
+    hot: true
   }),
   cloudPlay("marketingskills-buddy", {
     title: "\u8425\u9500\u6280\u80FD Buddy",
@@ -423,7 +377,6 @@ function getDefaultHomePlay(playId) {
 export {
   getPlayBuddyUsername,
   getPlayBuddyEmail,
-  SHADOW_PLAY_SERVER_TEMPLATE,
   DEFAULT_HOMEPLAY_CATALOG,
   getDefaultHomePlay
 };

package/dist/chunk-X6FS22AL.js

@@ -0,0 +1,175 @@
+// src/types/inbox.types.ts
+var BUDDY_INBOX_TOPIC_PREFIX = "shadow:buddy-inbox:";
+function buddyInboxTopic(agentId) {
+  return `${BUDDY_INBOX_TOPIC_PREFIX}${agentId}`;
+}
+function parseBuddyInboxAgentId(topic) {
+  if (!topic?.startsWith(BUDDY_INBOX_TOPIC_PREFIX)) return null;
+  const agentId = topic.slice(BUDDY_INBOX_TOPIC_PREFIX.length).trim();
+  return agentId || null;
+}
+function isBuddyInboxTopic(topic) {
+  return parseBuddyInboxAgentId(topic) !== null;
+}
+var TASK_MESSAGE_CARD_STATUSES = [
+  "queued",
+  "claimed",
+  "running",
+  "completed",
+  "failed",
+  "canceled",
+  "transferred"
+];
+var TERMINAL_TASK_MESSAGE_CARD_STATUSES = [
+  "completed",
+  "failed",
+  "canceled",
+  "transferred"
+];
+var TASK_MESSAGE_CARD_STATUS_TRANSITIONS = {
+  queued: ["queued", "claimed", "running", "completed", "failed", "canceled"],
+  claimed: ["claimed", "running", "completed", "failed", "canceled"],
+  running: ["running", "completed", "failed", "canceled"],
+  completed: ["completed"],
+  failed: ["failed", "transferred"],
+  canceled: ["canceled"],
+  transferred: ["transferred"]
+};
+function isTerminalTaskMessageCardStatus(status) {
+  return TERMINAL_TASK_MESSAGE_CARD_STATUSES.includes(
+    status
+  );
+}
+function canTransitionTaskMessageCardStatus(from, to) {
+  const allowed = TASK_MESSAGE_CARD_STATUS_TRANSITIONS[from];
+  return allowed.includes(to);
+}
+var DEFAULT_BUDDY_INBOX_ADMISSION_POLICY = {
+  defaultMode: "allow",
+  rules: []
+};
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function parseAdmissionMode(value, fallback) {
+  if (value === "allow" || value === "deny" || value === "first_time" || value === "every_time") {
+    return value;
+  }
+  if (value === void 0 || value === null) return fallback;
+  throw new Error("Invalid Buddy Inbox admission mode");
+}
+function parseSubjectKind(value) {
+  if (value === "user" || value === "agent" || value === "server_app" || value === "system") {
+    return value;
+  }
+  throw new Error("Invalid Buddy Inbox admission subject kind");
+}
+function parseOptionalString(value, field, maxLength) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  if (typeof value !== "string" || value.length > maxLength) {
+    throw new Error(`Invalid Buddy Inbox admission ${field}`);
+  }
+  return value;
+}
+function normalizeBuddyInboxAdmissionPolicy(value) {
+  if (value === void 0 || value === null) return { ...DEFAULT_BUDDY_INBOX_ADMISSION_POLICY };
+  if (!isRecord(value)) throw new Error("Invalid Buddy Inbox admission policy");
+  const defaultMode = parseAdmissionMode(value.defaultMode, "allow");
+  const rawRules = value.rules;
+  if (rawRules !== void 0 && !Array.isArray(rawRules)) {
+    throw new Error("Invalid Buddy Inbox admission rules");
+  }
+  const rules = (rawRules ?? []).slice(0, 100).map((entry) => {
+    if (!isRecord(entry)) throw new Error("Invalid Buddy Inbox admission rule");
+    return {
+      subjectKind: parseSubjectKind(entry.subjectKind),
+      subjectId: parseOptionalString(entry.subjectId, "subjectId", 160),
+      appKey: parseOptionalString(entry.appKey, "appKey", 120),
+      mode: parseAdmissionMode(entry.mode, defaultMode),
+      ...entry.approved === true ? { approved: true } : {},
+      note: parseOptionalString(entry.note, "note", 500),
+      createdAt: parseOptionalString(entry.createdAt, "createdAt", 64),
+      updatedAt: parseOptionalString(entry.updatedAt, "updatedAt", 64)
+    };
+  });
+  return { defaultMode, rules };
+}
+function buddyInboxAdmissionRuleKey(rule) {
+  return [rule.subjectKind, rule.subjectId ?? "", rule.appKey ?? ""].join(":");
+}
+function parsePendingTask(value) {
+  if (!isRecord(value)) throw new Error("Invalid Buddy Inbox pending task");
+  const title = parseOptionalString(value.title, "task.title", 180);
+  if (!title) throw new Error("Invalid Buddy Inbox pending task title");
+  const body = parseOptionalString(value.body, "task.body", 8e3);
+  const priority = value.priority;
+  if (priority !== void 0 && priority !== "low" && priority !== "normal" && priority !== "high" && priority !== "urgent") {
+    throw new Error("Invalid Buddy Inbox pending task priority");
+  }
+  const idempotencyKey = parseOptionalString(value.idempotencyKey, "task.idempotencyKey", 240);
+  const source = isRecord(value.source) ? value.source : void 0;
+  const data = isRecord(value.data) ? value.data : void 0;
+  return {
+    title,
+    ...body ? { body } : {},
+    ...priority ? { priority } : {},
+    ...idempotencyKey ? { idempotencyKey } : {},
+    ...source ? { source } : {},
+    ...data ? { data } : {}
+  };
+}
+function normalizeBuddyInboxAdmissionPendingDeliveries(value) {
+  if (value === void 0 || value === null) return [];
+  if (!Array.isArray(value)) throw new Error("Invalid Buddy Inbox pending deliveries");
+  return value.slice(0, 100).map((entry) => {
+    if (!isRecord(entry)) throw new Error("Invalid Buddy Inbox pending delivery");
+    const id = parseOptionalString(entry.id, "pending.id", 80);
+    const serverId = parseOptionalString(entry.serverId, "pending.serverId", 160);
+    const channelId = parseOptionalString(entry.channelId, "pending.channelId", 160);
+    const agentId = parseOptionalString(entry.agentId, "pending.agentId", 160);
+    const mode = parseAdmissionMode(entry.mode, "first_time");
+    if (mode !== "first_time" && mode !== "every_time") {
+      throw new Error("Invalid Buddy Inbox pending mode");
+    }
+    if (!isRecord(entry.subject)) throw new Error("Invalid Buddy Inbox pending subject");
+    if (!isRecord(entry.requestedBy)) throw new Error("Invalid Buddy Inbox pending requester");
+    if (!id || !serverId || !channelId || !agentId) {
+      throw new Error("Invalid Buddy Inbox pending delivery identifiers");
+    }
+    const requestedAt = parseOptionalString(entry.requestedAt, "pending.requestedAt", 64);
+    if (!requestedAt) throw new Error("Invalid Buddy Inbox pending requestedAt");
+    return {
+      id,
+      serverId,
+      channelId,
+      agentId,
+      mode,
+      subject: {
+        kind: parseSubjectKind(entry.subject.kind),
+        id: parseOptionalString(entry.subject.id, "subject.id", 160),
+        appKey: parseOptionalString(entry.subject.appKey, "subject.appKey", 120),
+        label: parseOptionalString(entry.subject.label, "subject.label", 160)
+      },
+      task: parsePendingTask(entry.task),
+      requestedBy: entry.requestedBy,
+      requestedAt,
+      updatedAt: parseOptionalString(entry.updatedAt, "pending.updatedAt", 64)
+    };
+  });
+}
+
+export {
+  BUDDY_INBOX_TOPIC_PREFIX,
+  buddyInboxTopic,
+  parseBuddyInboxAgentId,
+  isBuddyInboxTopic,
+  TASK_MESSAGE_CARD_STATUSES,
+  TERMINAL_TASK_MESSAGE_CARD_STATUSES,
+  TASK_MESSAGE_CARD_STATUS_TRANSITIONS,
+  isTerminalTaskMessageCardStatus,
+  canTransitionTaskMessageCardStatus,
+  DEFAULT_BUDDY_INBOX_ADMISSION_POLICY,
+  normalizeBuddyInboxAdmissionPolicy,
+  buddyInboxAdmissionRuleKey,
+  normalizeBuddyInboxAdmissionPendingDeliveries
+};

package/dist/index.cjs

@@ -20,14 +20,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BUDDY_INBOX_TOPIC_PREFIX: () => BUDDY_INBOX_TOPIC_PREFIX,
   CAT_AVATAR_COUNT: () => CAT_AVATAR_COUNT,
   CLIENT_EVENTS: () => CLIENT_EVENTS,
+  DEFAULT_BUDDY_INBOX_ADMISSION_POLICY: () => DEFAULT_BUDDY_INBOX_ADMISSION_POLICY,
   DEFAULT_HOMEPLAY_CATALOG: () => DEFAULT_HOMEPLAY_CATALOG,
   LIMITS: () => LIMITS,
   SERVER_EVENTS: () => SERVER_EVENTS,
-  SHADOW_PLAY_SERVER_TEMPLATE: () => SHADOW_PLAY_SERVER_TEMPLATE,
+  TASK_MESSAGE_CARD_STATUSES: () => TASK_MESSAGE_CARD_STATUSES,
+  TASK_MESSAGE_CARD_STATUS_TRANSITIONS: () => TASK_MESSAGE_CARD_STATUS_TRANSITIONS,
+  TERMINAL_TASK_MESSAGE_CARD_STATUSES: () => TERMINAL_TASK_MESSAGE_CARD_STATUSES,
   assignMentionRanges: () => assignMentionRanges,
+  buddyInboxAdmissionRuleKey: () => buddyInboxAdmissionRuleKey,
+  buddyInboxTopic: () => buddyInboxTopic,
   buildMentionMarkdownLinks: () => buildMentionMarkdownLinks,
+  canTransitionTaskMessageCardStatus: () => canTransitionTaskMessageCardStatus,
   canonicalMentionToken: () => canonicalMentionToken,
   canonicalizeMentionContent: () => canonicalizeMentionContent,
   escapeMarkdownLinkLabel: () => escapeMarkdownLinkLabel,
@@ -41,9 +48,14 @@ __export(index_exports, {
   getDefaultHomePlay: () => getDefaultHomePlay,
   getPlayBuddyEmail: () => getPlayBuddyEmail,
   getPlayBuddyUsername: () => getPlayBuddyUsername,
+  isBuddyInboxTopic: () => isBuddyInboxTopic,
   isCanonicalMentionToken: () => isCanonicalMentionToken,
+  isTerminalTaskMessageCardStatus: () => isTerminalTaskMessageCardStatus,
   isValidEmail: () => isValidEmail,
   mentionDisplayText: () => mentionDisplayText,
+  normalizeBuddyInboxAdmissionPendingDeliveries: () => normalizeBuddyInboxAdmissionPendingDeliveries,
+  normalizeBuddyInboxAdmissionPolicy: () => normalizeBuddyInboxAdmissionPolicy,
+  parseBuddyInboxAgentId: () => parseBuddyInboxAgentId,
   parseCanonicalMentionToken: () => parseCanonicalMentionToken,
   renderCatSvg: () => renderCatSvg,
   segmentTextByMentions: () => segmentTextByMentions,
@@ -124,24 +136,21 @@ var playTemplate = (id) => ({
   },
   materials: { cover: playCover(id) }
 });
-var communityAction = (channelName, greeting) => ({
+var communityAction = (channelName) => ({
   kind: "public_channel",
   channelName,
-  buddyTemplateSlug: channelName,
-  ...greeting ? { greeting } : {}
+  buddyTemplateSlug: channelName
 });
-var roomAction = (namePrefix, greeting) => ({
+var roomAction = (namePrefix) => ({
   kind: "private_room",
   namePrefix,
-  buddyTemplateSlug: namePrefix,
-  ...greeting ? { greeting } : {}
+  buddyTemplateSlug: namePrefix
 });
-var cloudAction = (templateSlug, resourceTier = "lightweight", defaultChannelName) => ({
+var cloudAction = (templateSlug, resourceTier = "lightweight") => ({
   kind: "cloud_deploy",
   templateSlug,
   buddyTemplateSlug: templateSlug,
-  resourceTier,
-  ...defaultChannelName ? { defaultChannelName } : {}
+  resourceTier
 });
 function getPlayBuddyUsername(templateSlug) {
   const normalized = templateSlug.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 27) || "play";
@@ -150,55 +159,15 @@ function getPlayBuddyUsername(templateSlug) {
 function getPlayBuddyEmail(templateSlug) {
   return `${getPlayBuddyUsername(templateSlug)}@shadowob.bot`;
 }
-var SHADOW_PLAY_SERVER_TEMPLATE = {
-  slug: "shadow-plays",
-  name: "Shadow Plays",
-  description: "Default public community space for launchable homepage plays.",
-  channels: [
-    {
-      name: "general",
-      topic: "General discussion for new players and Shadow community members."
-    },
-    {
-      name: "world-pulse",
-      topic: "A public room for real-time global events and daily signal."
-    },
-    {
-      name: "financial-freedom",
-      topic: "A public room for lightweight financial freedom simulations and planning prompts."
-    },
-    {
-      name: "ai-werewolf",
-      topic: "A public room for AI-hosted social deduction sessions."
-    },
-    {
-      name: "code-arena",
-      topic: "A public room for coding challenges and real-time battles."
-    },
-    {
-      name: "brain-fix",
-      topic: "A calm public room for one-minute focus resets and reflection."
-    },
-    {
-      name: "gitstory",
-      topic: "A public room for turning software history into stories and retrospectives."
-    },
-    {
-      name: "gstack",
-      topic: "A public room for founder strategy, product stress tests, and launch planning."
-    }
-  ]
-};
 function cloudPlay(id, input) {
-  const { defaultChannelName, ...content } = input;
   return {
     id,
     image: playCover(id),
     status: "gated",
-    action: cloudAction(id, "lightweight", defaultChannelName),
+    action: cloudAction(id, "lightweight"),
     gates: { auth: "required", membership: "required", profile: "optional" },
     ...playTemplate(id),
-    ...content
+    ...input
   };
 }
 var DEFAULT_HOMEPLAY_CATALOG = [
@@ -362,7 +331,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     accentColor: "#f59e0b",
     hot: true,
     status: "gated",
-    action: cloudAction("little-match-girl", "lightweight", "match-street"),
+    action: cloudAction("little-match-girl", "lightweight"),
     gates: { auth: "required", membership: "required", profile: "optional" },
     ...playTemplate("little-match-girl"),
     materials: { cover: "/home-assets/topics/night-radio.jpg" }
@@ -376,8 +345,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     categoryEn: "Buddy Teams",
     starts: "16.4k",
     accentColor: "#22d3ee",
-    hot: true,
-    defaultChannelName: "choose"
+    hot: true
   }),
   cloudPlay("bmad-method-buddy", {
     title: "BMAD \u65B9\u6CD5 Buddy",
@@ -387,8 +355,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     category: "Buddy \u56E2\u961F",
     categoryEn: "Buddy Teams",
     starts: "13.7k",
-    accentColor: "#60a5fa",
-    defaultChannelName: "delivery"
+    accentColor: "#60a5fa"
   }),
   cloudPlay("claude-ads-buddy", {
     title: "Claude Ads Buddy",
@@ -451,8 +418,7 @@ var DEFAULT_HOMEPLAY_CATALOG = [
     categoryEn: "Hacker & Painter",
     starts: "15.1k",
     accentColor: "#fb923c",
-    hot: true,
-    defaultChannelName: "office-hours"
+    hot: true
   }),
   cloudPlay("marketingskills-buddy", {
     title: "\u8425\u9500\u6280\u80FD Buddy",
@@ -536,6 +502,166 @@ function getDefaultHomePlay(playId) {
   return DEFAULT_HOMEPLAY_CATALOG.find((play) => play.id === playId) ?? null;
 }
 
+// src/types/inbox.types.ts
+var BUDDY_INBOX_TOPIC_PREFIX = "shadow:buddy-inbox:";
+function buddyInboxTopic(agentId) {
+  return `${BUDDY_INBOX_TOPIC_PREFIX}${agentId}`;
+}
+function parseBuddyInboxAgentId(topic) {
+  if (!topic?.startsWith(BUDDY_INBOX_TOPIC_PREFIX)) return null;
+  const agentId = topic.slice(BUDDY_INBOX_TOPIC_PREFIX.length).trim();
+  return agentId || null;
+}
+function isBuddyInboxTopic(topic) {
+  return parseBuddyInboxAgentId(topic) !== null;
+}
+var TASK_MESSAGE_CARD_STATUSES = [
+  "queued",
+  "claimed",
+  "running",
+  "completed",
+  "failed",
+  "canceled",
+  "transferred"
+];
+var TERMINAL_TASK_MESSAGE_CARD_STATUSES = [
+  "completed",
+  "failed",
+  "canceled",
+  "transferred"
+];
+var TASK_MESSAGE_CARD_STATUS_TRANSITIONS = {
+  queued: ["queued", "claimed", "running", "completed", "failed", "canceled"],
+  claimed: ["claimed", "running", "completed", "failed", "canceled"],
+  running: ["running", "completed", "failed", "canceled"],
+  completed: ["completed"],
+  failed: ["failed", "transferred"],
+  canceled: ["canceled"],
+  transferred: ["transferred"]
+};
+function isTerminalTaskMessageCardStatus(status) {
+  return TERMINAL_TASK_MESSAGE_CARD_STATUSES.includes(
+    status
+  );
+}
+function canTransitionTaskMessageCardStatus(from, to) {
+  const allowed = TASK_MESSAGE_CARD_STATUS_TRANSITIONS[from];
+  return allowed.includes(to);
+}
+var DEFAULT_BUDDY_INBOX_ADMISSION_POLICY = {
+  defaultMode: "allow",
+  rules: []
+};
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function parseAdmissionMode(value, fallback) {
+  if (value === "allow" || value === "deny" || value === "first_time" || value === "every_time") {
+    return value;
+  }
+  if (value === void 0 || value === null) return fallback;
+  throw new Error("Invalid Buddy Inbox admission mode");
+}
+function parseSubjectKind(value) {
+  if (value === "user" || value === "agent" || value === "server_app" || value === "system") {
+    return value;
+  }
+  throw new Error("Invalid Buddy Inbox admission subject kind");
+}
+function parseOptionalString(value, field, maxLength) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  if (typeof value !== "string" || value.length > maxLength) {
+    throw new Error(`Invalid Buddy Inbox admission ${field}`);
+  }
+  return value;
+}
+function normalizeBuddyInboxAdmissionPolicy(value) {
+  if (value === void 0 || value === null) return { ...DEFAULT_BUDDY_INBOX_ADMISSION_POLICY };
+  if (!isRecord(value)) throw new Error("Invalid Buddy Inbox admission policy");
+  const defaultMode = parseAdmissionMode(value.defaultMode, "allow");
+  const rawRules = value.rules;
+  if (rawRules !== void 0 && !Array.isArray(rawRules)) {
+    throw new Error("Invalid Buddy Inbox admission rules");
+  }
+  const rules = (rawRules ?? []).slice(0, 100).map((entry) => {
+    if (!isRecord(entry)) throw new Error("Invalid Buddy Inbox admission rule");
+    return {
+      subjectKind: parseSubjectKind(entry.subjectKind),
+      subjectId: parseOptionalString(entry.subjectId, "subjectId", 160),
+      appKey: parseOptionalString(entry.appKey, "appKey", 120),
+      mode: parseAdmissionMode(entry.mode, defaultMode),
+      ...entry.approved === true ? { approved: true } : {},
+      note: parseOptionalString(entry.note, "note", 500),
+      createdAt: parseOptionalString(entry.createdAt, "createdAt", 64),
+      updatedAt: parseOptionalString(entry.updatedAt, "updatedAt", 64)
+    };
+  });
+  return { defaultMode, rules };
+}
+function buddyInboxAdmissionRuleKey(rule) {
+  return [rule.subjectKind, rule.subjectId ?? "", rule.appKey ?? ""].join(":");
+}
+function parsePendingTask(value) {
+  if (!isRecord(value)) throw new Error("Invalid Buddy Inbox pending task");
+  const title = parseOptionalString(value.title, "task.title", 180);
+  if (!title) throw new Error("Invalid Buddy Inbox pending task title");
+  const body = parseOptionalString(value.body, "task.body", 8e3);
+  const priority = value.priority;
+  if (priority !== void 0 && priority !== "low" && priority !== "normal" && priority !== "high" && priority !== "urgent") {
+    throw new Error("Invalid Buddy Inbox pending task priority");
+  }
+  const idempotencyKey = parseOptionalString(value.idempotencyKey, "task.idempotencyKey", 240);
+  const source = isRecord(value.source) ? value.source : void 0;
+  const data = isRecord(value.data) ? value.data : void 0;
+  return {
+    title,
+    ...body ? { body } : {},
+    ...priority ? { priority } : {},
+    ...idempotencyKey ? { idempotencyKey } : {},
+    ...source ? { source } : {},
+    ...data ? { data } : {}
+  };
+}
+function normalizeBuddyInboxAdmissionPendingDeliveries(value) {
+  if (value === void 0 || value === null) return [];
+  if (!Array.isArray(value)) throw new Error("Invalid Buddy Inbox pending deliveries");
+  return value.slice(0, 100).map((entry) => {
+    if (!isRecord(entry)) throw new Error("Invalid Buddy Inbox pending delivery");
+    const id = parseOptionalString(entry.id, "pending.id", 80);
+    const serverId = parseOptionalString(entry.serverId, "pending.serverId", 160);
+    const channelId = parseOptionalString(entry.channelId, "pending.channelId", 160);
+    const agentId = parseOptionalString(entry.agentId, "pending.agentId", 160);
+    const mode = parseAdmissionMode(entry.mode, "first_time");
+    if (mode !== "first_time" && mode !== "every_time") {
+      throw new Error("Invalid Buddy Inbox pending mode");
+    }
+    if (!isRecord(entry.subject)) throw new Error("Invalid Buddy Inbox pending subject");
+    if (!isRecord(entry.requestedBy)) throw new Error("Invalid Buddy Inbox pending requester");
+    if (!id || !serverId || !channelId || !agentId) {
+      throw new Error("Invalid Buddy Inbox pending delivery identifiers");
+    }
+    const requestedAt = parseOptionalString(entry.requestedAt, "pending.requestedAt", 64);
+    if (!requestedAt) throw new Error("Invalid Buddy Inbox pending requestedAt");
+    return {
+      id,
+      serverId,
+      channelId,
+      agentId,
+      mode,
+      subject: {
+        kind: parseSubjectKind(entry.subject.kind),
+        id: parseOptionalString(entry.subject.id, "subject.id", 160),
+        appKey: parseOptionalString(entry.subject.appKey, "subject.appKey", 120),
+        label: parseOptionalString(entry.subject.label, "subject.label", 160)
+      },
+      task: parsePendingTask(entry.task),
+      requestedBy: entry.requestedBy,
+      requestedAt,
+      updatedAt: parseOptionalString(entry.updatedAt, "pending.updatedAt", 64)
+    };
+  });
+}
+
 // src/utils/index.ts
 var import_nanoid = require("nanoid");
 
@@ -1039,14 +1165,21 @@ function slugify(text) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BUDDY_INBOX_TOPIC_PREFIX,
   CAT_AVATAR_COUNT,
   CLIENT_EVENTS,
+  DEFAULT_BUDDY_INBOX_ADMISSION_POLICY,
   DEFAULT_HOMEPLAY_CATALOG,
   LIMITS,
   SERVER_EVENTS,
-  SHADOW_PLAY_SERVER_TEMPLATE,
+  TASK_MESSAGE_CARD_STATUSES,
+  TASK_MESSAGE_CARD_STATUS_TRANSITIONS,
+  TERMINAL_TASK_MESSAGE_CARD_STATUSES,
   assignMentionRanges,
+  buddyInboxAdmissionRuleKey,
+  buddyInboxTopic,
   buildMentionMarkdownLinks,
+  canTransitionTaskMessageCardStatus,
   canonicalMentionToken,
   canonicalizeMentionContent,
   escapeMarkdownLinkLabel,
@@ -1060,9 +1193,14 @@ function slugify(text) {
   getDefaultHomePlay,
   getPlayBuddyEmail,
   getPlayBuddyUsername,
+  isBuddyInboxTopic,
   isCanonicalMentionToken,
+  isTerminalTaskMessageCardStatus,
   isValidEmail,
   mentionDisplayText,
+  normalizeBuddyInboxAdmissionPendingDeliveries,
+  normalizeBuddyInboxAdmissionPolicy,
+  parseBuddyInboxAgentId,
   parseCanonicalMentionToken,
   renderCatSvg,
   segmentTextByMentions,