@things-factory/ai-assistant 10.1.207 → 10.1.210

package/dist-server/service/chat-session-participant/invite-notification.d.ts

@@ -20,8 +20,23 @@ export interface Inviter {
     name?: string | null;
     email?: string | null;
 }
+/** The request's translator - `requestTranslator(context)`. Absent: the English words. */
+export type InviteTranslate = (key: string, options: Record<string, unknown>) => string;
 /**
  * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.
  * 받는 사람이 없으면 null (= 보낼 것 없음).
+ *
+ * The words are the inviting request's language (`t`). The people of one domain read one language; a receiver's
+ * own locale is not asked here (2026-10-24: the English words stood on a Korean screen).
+ */
+export declare function buildInviteNotification(userIds: string[], boardId: string | undefined, inviter: Inviter | undefined | null, sessionName?: string | null, t?: InviteTranslate): InviteNotification | null;
+/**
+ * Tell the people just seated - in the app's notification list while they are in it (`foreground`, published to
+ * them live) and by web push when they are not (`background`). The notifier takes one way per call, so it is
+ * called once for each; the list was the one place an invite never reached (2026-10-24: only push was sent).
+ *
+ * A letter that does not arrive does not undo the seat - the roster is the record, the notice only tells of it.
  */
-export declare function buildInviteNotification(userIds: string[], boardId: string | undefined, inviter: Inviter | undefined | null, sessionName?: string | null): InviteNotification | null;
+export declare function sendInviteNotification(notify: ((payload: InviteNotification) => Promise<unknown> | unknown) | undefined, userIds: string[], inviter: Inviter | undefined | null, sessionName?: string | null, 
+/** A board conversation keeps its board wording and the link to the modeller. */
+boardId?: string, t?: InviteTranslate): Promise<void>;

package/dist-server/service/chat-session-participant/invite-notification.js

@@ -8,22 +8,27 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildInviteNotification = buildInviteNotification;
+exports.sendInviteNotification = sendInviteNotification;
 /**
  * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.
  * 받는 사람이 없으면 null (= 보낼 것 없음).
+ *
+ * The words are the inviting request's language (`t`). The people of one domain read one language; a receiver's
+ * own locale is not asked here (2026-10-24: the English words stood on a Korean screen).
  */
-function buildInviteNotification(userIds, boardId, inviter, sessionName) {
+function buildInviteNotification(userIds, boardId, inviter, sessionName, t) {
     if (!Array.isArray(userIds) || userIds.length === 0)
         return null;
     const who = inviter?.name || inviter?.email || 'someone';
+    const say = (key, defaultValue, params = {}) => t ? t(`ai-assistant.text.${key}`, { ...params, defaultValue }) : defaultValue.replace(/\{(\w+)\}/g, (_, name) => params[name] ?? '');
     /* A board conversation keeps its board wording and the link to the modeller. */
     if (boardId) {
         return {
             receivers: userIds,
             type: 'board-collab-invite',
             subject: 'info',
-            title: 'Board collaboration invite',
-            body: `${who} invited you to collaborate on a board.`,
+            title: say('board-invite-title', 'Board collaboration invite'),
+            body: say('board-invite-body', '{who} invited you to collaborate on a board.', { who }),
             url: `board-modeller/${boardId}`,
             mode: 'background'
         };
@@ -37,9 +42,33 @@ function buildInviteNotification(userIds, boardId, inviter, sessionName) {
         receivers: userIds,
         type: 'chat-invite',
         subject: 'info',
-        title: 'Conversation invite',
-        body: name ? `${who} brought you into the conversation "${name}".` : `${who} brought you into a conversation.`,
+        title: say('invite-title', 'Conversation invite'),
+        body: name
+            ? say('invite-body-named', '{who} brought you into the conversation "{name}".', { who, name })
+            : say('invite-body', '{who} brought you into a conversation.', { who }),
         mode: 'background'
     };
 }
+/**
+ * Tell the people just seated - in the app's notification list while they are in it (`foreground`, published to
+ * them live) and by web push when they are not (`background`). The notifier takes one way per call, so it is
+ * called once for each; the list was the one place an invite never reached (2026-10-24: only push was sent).
+ *
+ * A letter that does not arrive does not undo the seat - the roster is the record, the notice only tells of it.
+ */
+async function sendInviteNotification(notify, userIds, inviter, sessionName, 
+/** A board conversation keeps its board wording and the link to the modeller. */
+boardId, t) {
+    const payload = buildInviteNotification(userIds, boardId, inviter, sessionName, t);
+    if (!payload || !notify)
+        return;
+    for (const mode of ['foreground', 'background']) {
+        try {
+            await notify({ ...payload, mode });
+        }
+        catch {
+            /* the other way may still reach them */
+        }
+    }
+}
 //# sourceMappingURL=invite-notification.js.map

package/dist-server/service/chat-session-participant/invite-notification.js.map

@@ -1 +1 @@
-{"version":3,"file":"invite-notification.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/invite-notification.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAuBH,0DAoCC;AAxCD;;;GAGG;AACH,SAAgB,uBAAuB,CACrC,OAAiB,EACjB,OAA2B,EAC3B,OAAmC,EACnC,WAA2B;IAE3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEhE,MAAM,GAAG,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,KAAK,IAAI,SAAS,CAAA;IAExD,gFAAgF;IAChF,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO;YACL,SAAS,EAAE,OAAO;YAClB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,4BAA4B;YACnC,IAAI,EAAE,GAAG,GAAG,yCAAyC;YACrD,GAAG,EAAE,kBAAkB,OAAO,EAAE;YAChC,IAAI,EAAE,YAAY;SACnB,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,IAAI,GAAG,WAAW,EAAE,IAAI,EAAE,CAAA;IAChC,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,uCAAuC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,mCAAmC;QAC9G,IAAI,EAAE,YAAY;KACnB,CAAA;AACH,CAAC","sourcesContent":["/**\n * 협업 초대 알림 — 순수 payload 빌더.\n *\n * 부수효과(실제 발송)는 resolver 의 thin caller 가 `context.state.notify` 로 수행.\n * 여기엔 \"무엇을 보낼지\"(payload) 결정 로직만 둔다 — DB·pubsub·notify 의존 없이 테스트 가능.\n * (patch spine 의 board-patch-broadcast.ts 와 동일한 순수/부수효과 분리 컨벤션.)\n */\n\n/** notification-middleware 의 notifier 가 받는 인자 형태 (필요한 키만). */\nexport interface InviteNotification {\n  receivers: string[]\n  type: string\n  subject: string\n  title: string\n  body: string\n  url?: string\n  mode: 'background' | 'foreground'\n}\n\n/** 초대자 식별용 — User 엔티티에서 쓰는 필드만 (duck-typed). */\nexport interface Inviter {\n  name?: string | null\n  email?: string | null\n}\n\n/**\n * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.\n * 받는 사람이 없으면 null (= 보낼 것 없음).\n */\nexport function buildInviteNotification(\n  userIds: string[],\n  boardId: string | undefined,\n  inviter: Inviter | undefined | null,\n  sessionName?: string | null\n): InviteNotification | null {\n  if (!Array.isArray(userIds) || userIds.length === 0) return null\n\n  const who = inviter?.name || inviter?.email || 'someone'\n\n  /* A board conversation keeps its board wording and the link to the modeller. */\n  if (boardId) {\n    return {\n      receivers: userIds,\n      type: 'board-collab-invite',\n      subject: 'info',\n      title: 'Board collaboration invite',\n      body: `${who} invited you to collaborate on a board.`,\n      url: `board-modeller/${boardId}`,\n      mode: 'background'\n    }\n  }\n\n  /*\n   * Every other conversation is not about a board. Both chat doors called this without one and every\n   * invite read \"Board collaboration invite\" - in operato-ecs, in plant, anywhere (2026-09-24).\n   */\n  const name = sessionName?.trim()\n  return {\n    receivers: userIds,\n    type: 'chat-invite',\n    subject: 'info',\n    title: 'Conversation invite',\n    body: name ? `${who} brought you into the conversation \"${name}\".` : `${who} brought you into a conversation.`,\n    mode: 'background'\n  }\n}\n"]}
+{"version":3,"file":"invite-notification.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/invite-notification.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA6BH,0DAyCC;AASD,wDAkBC;AA3ED;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACrC,OAAiB,EACjB,OAA2B,EAC3B,OAAmC,EACnC,WAA2B,EAC3B,CAAmB;IAEnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEhE,MAAM,GAAG,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,KAAK,IAAI,SAAS,CAAA;IACxD,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,YAAoB,EAAE,SAAiC,EAAE,EAAE,EAAE,CACrF,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAEtI,gFAAgF;IAChF,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO;YACL,SAAS,EAAE,OAAO;YAClB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,GAAG,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;YAC9D,IAAI,EAAE,GAAG,CAAC,mBAAmB,EAAE,8CAA8C,EAAE,EAAE,GAAG,EAAE,CAAC;YACvF,GAAG,EAAE,kBAAkB,OAAO,EAAE;YAChC,IAAI,EAAE,YAAY;SACnB,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,IAAI,GAAG,WAAW,EAAE,IAAI,EAAE,CAAA;IAChC,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,qBAAqB,CAAC;QACjD,IAAI,EAAE,IAAI;YACR,CAAC,CAAC,GAAG,CAAC,mBAAmB,EAAE,mDAAmD,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YAC9F,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,wCAAwC,EAAE,EAAE,GAAG,EAAE,CAAC;QACzE,IAAI,EAAE,YAAY;KACnB,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,sBAAsB,CAC1C,MAAiF,EACjF,OAAiB,EACjB,OAAmC,EACnC,WAA2B;AAC3B,iFAAiF;AACjF,OAAgB,EAChB,CAAmB;IAEnB,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;IAClF,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAM;IAC/B,KAAK,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,YAAY,CAAU,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["/**\n * 협업 초대 알림 — 순수 payload 빌더.\n *\n * 부수효과(실제 발송)는 resolver 의 thin caller 가 `context.state.notify` 로 수행.\n * 여기엔 \"무엇을 보낼지\"(payload) 결정 로직만 둔다 — DB·pubsub·notify 의존 없이 테스트 가능.\n * (patch spine 의 board-patch-broadcast.ts 와 동일한 순수/부수효과 분리 컨벤션.)\n */\n\n/** notification-middleware 의 notifier 가 받는 인자 형태 (필요한 키만). */\nexport interface InviteNotification {\n  receivers: string[]\n  type: string\n  subject: string\n  title: string\n  body: string\n  url?: string\n  mode: 'background' | 'foreground'\n}\n\n/** 초대자 식별용 — User 엔티티에서 쓰는 필드만 (duck-typed). */\nexport interface Inviter {\n  name?: string | null\n  email?: string | null\n}\n\n/** The request's translator - `requestTranslator(context)`. Absent: the English words. */\nexport type InviteTranslate = (key: string, options: Record<string, unknown>) => string\n\n/**\n * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.\n * 받는 사람이 없으면 null (= 보낼 것 없음).\n *\n * The words are the inviting request's language (`t`). The people of one domain read one language; a receiver's\n * own locale is not asked here (2026-10-24: the English words stood on a Korean screen).\n */\nexport function buildInviteNotification(\n  userIds: string[],\n  boardId: string | undefined,\n  inviter: Inviter | undefined | null,\n  sessionName?: string | null,\n  t?: InviteTranslate\n): InviteNotification | null {\n  if (!Array.isArray(userIds) || userIds.length === 0) return null\n\n  const who = inviter?.name || inviter?.email || 'someone'\n  const say = (key: string, defaultValue: string, params: Record<string, string> = {}) =>\n    t ? t(`ai-assistant.text.${key}`, { ...params, defaultValue }) : defaultValue.replace(/\\{(\\w+)\\}/g, (_, name) => params[name] ?? '')\n\n  /* A board conversation keeps its board wording and the link to the modeller. */\n  if (boardId) {\n    return {\n      receivers: userIds,\n      type: 'board-collab-invite',\n      subject: 'info',\n      title: say('board-invite-title', 'Board collaboration invite'),\n      body: say('board-invite-body', '{who} invited you to collaborate on a board.', { who }),\n      url: `board-modeller/${boardId}`,\n      mode: 'background'\n    }\n  }\n\n  /*\n   * Every other conversation is not about a board. Both chat doors called this without one and every\n   * invite read \"Board collaboration invite\" - in operato-ecs, in plant, anywhere (2026-09-24).\n   */\n  const name = sessionName?.trim()\n  return {\n    receivers: userIds,\n    type: 'chat-invite',\n    subject: 'info',\n    title: say('invite-title', 'Conversation invite'),\n    body: name\n      ? say('invite-body-named', '{who} brought you into the conversation \"{name}\".', { who, name })\n      : say('invite-body', '{who} brought you into a conversation.', { who }),\n    mode: 'background'\n  }\n}\n\n/**\n * Tell the people just seated - in the app's notification list while they are in it (`foreground`, published to\n * them live) and by web push when they are not (`background`). The notifier takes one way per call, so it is\n * called once for each; the list was the one place an invite never reached (2026-10-24: only push was sent).\n *\n * A letter that does not arrive does not undo the seat - the roster is the record, the notice only tells of it.\n */\nexport async function sendInviteNotification(\n  notify: ((payload: InviteNotification) => Promise<unknown> | unknown) | undefined,\n  userIds: string[],\n  inviter: Inviter | undefined | null,\n  sessionName?: string | null,\n  /** A board conversation keeps its board wording and the link to the modeller. */\n  boardId?: string,\n  t?: InviteTranslate\n): Promise<void> {\n  const payload = buildInviteNotification(userIds, boardId, inviter, sessionName, t)\n  if (!payload || !notify) return\n  for (const mode of ['foreground', 'background'] as const) {\n    try {\n      await notify({ ...payload, mode })\n    } catch {\n      /* the other way may still reach them */\n    }\n  }\n}\n"]}

package/dist-server/service/chat-session-participant/mention-invite.d.ts

@@ -5,7 +5,7 @@ export declare function newParticipantUserIds(mentioned: ReadonlyArray<string>,
 export interface MentionInviteResult {
     /** 이번에 새로 앉은 사람들. 알림은 이들에게 간다. */
     invited: string[];
-    /** 비공개 대화라 앉히지 못한 사람들 — 이름은 불렸고 방에는 못 들어온다. 화면이 그대로 말한다. */
+    /** 앉힐 수 없는 방이거나 부른 사람에게 그 자리가 없어 앉히지 못한 사람들 — 이름은 불렸고 방에는 못 들어온다. */
     notSeated?: string[];
 }
 export interface MentionInviteInput {
@@ -18,12 +18,38 @@ export interface MentionInviteInput {
     } | undefined | null;
     /** 참여자 저장소 — 시험이 가짜를 넣는다. */
     participants: any;
-    /** 이 대화가 공개인가(ADR-0073 판정 2). 비공개면 이름만 알리고 앉히지 않는다. */
+    /** 이 대화의 공개 범위(ADR-0073). 그룹은 owner 의 멘션만, 비공개는 아무의 멘션도 앉히지 않는다. */
+    visibility?: string | null;
+}
+/** 멘션된 사람을 참여자로 앉힌다 — 앉힐 수 있는 방이고 부른 사람에게 그 자리가 있을 때만(`maySeat`). */
+export declare function inviteMentionedUsers(input: MentionInviteInput): Promise<MentionInviteResult>;
+export interface SeatInput {
+    sessionId: string;
+    domainId: string;
+    inviter: {
+        id?: string;
+    } | undefined | null;
+    /** 앉힐 사람들. 이미 앉은 사람과 부른 사람 자신은 빠진다. */
+    userIds: ReadonlyArray<string>;
+    participants: any;
     visibility?: string | null;
 }
 /**
- * 멘션된 사람을 참여자로 앉힌다.
+ * 사람을 앉힌다 — 멘션과 초대 단추가 함께 쓰는 한 곳.
  *
+ * 규칙은 `maySeat` 한 줄이다: 공개 방은 누구나, 그룹은 owner 만, 비공개는 아무도. 앉히지 못하면
+ * 아무것도 쓰지 않고 그 사람들을 `notSeated` 로 돌려준다 — 화면이 그대로 말한다.
  * 나갔던 사람(soft delete)은 되살린다 — 다시 부른 것이지 새 사람이 아니다.
  */
-export declare function inviteMentionedUsers(input: MentionInviteInput): Promise<MentionInviteResult>;
+export declare function seatParticipants(input: SeatInput): Promise<MentionInviteResult>;
+/**
+ * The seats a person's turn gives - what every door that stores a person's words calls.
+ *
+ * The writer first: in an open room anyone may walk in and speak, and until 2026-10-24 speaking seated nobody. A
+ * conversation four people wrote in showed two in its roster - the one who started it and the one who was
+ * mentioned - and the other two had no presence, no unread badge and no activity notice. In a group or private
+ * room the writer is seated already (the write gate let them in by their seat). Then the people mentioned.
+ */
+export declare function seatTurn(input: MentionInviteInput): Promise<MentionInviteResult>;
+/** Seat the person who spoke, in an open room only - there the seat grants nothing, it records who took part. */
+export declare function seatWriter(input: Omit<SeatInput, 'userIds'>): Promise<boolean>;

package/dist-server/service/chat-session-participant/mention-invite.js

@@ -1,4 +1,11 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMentionUserIds = extractMentionUserIds;
+exports.newParticipantUserIds = newParticipantUserIds;
+exports.inviteMentionedUsers = inviteMentionedUsers;
+exports.seatParticipants = seatParticipants;
+exports.seatTurn = seatTurn;
+exports.seatWriter = seatWriter;
 /*
  * Mentioning someone tells them (ADR-0071 decision 1, as amended by ADR-0073).
  *
@@ -20,11 +27,13 @@
  * What went: the inviter's own role (there is nothing to hand out), the refusal verdicts, and the
  * notice shown before sending. A private conversation is the one place a mention cannot seat
  * someone — there the named person is told and stays outside until an owner opens it.
+ *
+ * ── A group (2026-10-24, ADR-0073 decision 3) ──────────────────────────────────
+ * In a group the seat is the key, so who seats is asked again: the owner's mention seats, a member's
+ * tells (`maySeat`). The invite door (`inviteToAISession`) seats through the same `seatParticipants`
+ * under the same rule - two ways in, one seat.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractMentionUserIds = extractMentionUserIds;
-exports.newParticipantUserIds = newParticipantUserIds;
-exports.inviteMentionedUsers = inviteMentionedUsers;
+const session_visibility_js_1 = require("../chat-session/session-visibility.js");
 /** 본문에서 `@user{userId:UUID}` 마커의 userId 를 뽑는다 — 첫 등장 순, 중복 제거. */
 function extractMentionUserIds(text) {
     if (!text)
@@ -57,47 +66,85 @@ function newParticipantUserIds(mentioned, existing, selfUserId) {
     }
     return out;
 }
-/**
- * 멘션된 사람을 참여자로 앉힌다.
- *
- * 나갔던 사람(soft delete)은 되살린다 — 다시 부른 것이지 새 사람이 아니다.
- */
+/** 멘션된 사람을 참여자로 앉힌다 — 앉힐 수 있는 방이고 부른 사람에게 그 자리가 있을 때만(`maySeat`). */
 async function inviteMentionedUsers(input) {
     const mentioned = extractMentionUserIds(input.content);
     if (mentioned.length === 0)
         return { invited: [] };
+    return seatParticipants({ ...input, userIds: mentioned });
+}
+/**
+ * 사람을 앉힌다 — 멘션과 초대 단추가 함께 쓰는 한 곳.
+ *
+ * 규칙은 `maySeat` 한 줄이다: 공개 방은 누구나, 그룹은 owner 만, 비공개는 아무도. 앉히지 못하면
+ * 아무것도 쓰지 않고 그 사람들을 `notSeated` 로 돌려준다 — 화면이 그대로 말한다.
+ * 나갔던 사람(soft delete)은 되살린다 — 다시 부른 것이지 새 사람이 아니다.
+ */
+async function seatParticipants(input) {
     const repo = input.participants;
     const existing = await repo.find({
         where: { session: { id: input.sessionId }, domain: { id: input.domainId } },
         withDeleted: true
     });
-    const activeIds = existing.filter((row) => !row.deletedAt).map((row) => row.userId).filter(Boolean);
-    const fresh = newParticipantUserIds(mentioned, activeIds, input.inviter?.id);
+    /* A hide-only `viewer` row is not a seat - the person is brought in over it, as a member. */
+    const seated = existing.filter((row) => !row.deletedAt && row.role !== 'viewer');
+    const activeIds = seated.map((row) => row.userId).filter(Boolean);
+    const fresh = newParticipantUserIds(input.userIds, activeIds, input.inviter?.id);
     if (fresh.length === 0)
         return { invited: [] };
     /*
-     * 비공개 대화에서는 이름을 불러도 앉히지 않는다. 공개 대화에서는 앉히는 일이 아무것도 주지 않지만
-     * (누구나 들어온다), 비공개에서는 그것이 곧 접근을 주는 일이다. 부르는 사람이 아니라 owner 가 열
-     * 일이다 — 이름이 불렸다는 것만 알린다.
+     * 공개 방에서 앉히는 일은 아무것도 주지 않지만(누구나 들어온다), 그룹과 비공개에서는 그것이 곧 접근을
+     * 주는 일이다. 그룹에서는 owner 가 주고, 비공개에서는 아무도 주지 않는다 — 이름이 불렸다는 것만 남는다.
      */
-    if ((input.visibility ?? 'open') !== 'open')
+    const inviterRole = seated.find((row) => row.userId === input.inviter?.id)?.role;
+    if (!(0, session_visibility_js_1.maySeat)(input.visibility, inviterRole))
         return { invited: [], notSeated: fresh };
-    for (const userId of fresh) {
-        const prior = existing.find((row) => row.userId === userId && row.deletedAt);
-        if (prior) {
-            await repo.update(prior.id, { deletedAt: null, role: 'member', updater: input.inviter });
-        }
-        else {
-            await repo.save({
-                domain: { id: input.domainId },
-                session: { id: input.sessionId },
-                user: { id: userId },
-                role: 'member',
-                creator: input.inviter,
-                updater: input.inviter
-            });
-        }
-    }
+    for (const userId of fresh)
+        await writeMemberSeat(repo, existing, input, userId);
     return { invited: fresh };
 }
+/**
+ * The seats a person's turn gives - what every door that stores a person's words calls.
+ *
+ * The writer first: in an open room anyone may walk in and speak, and until 2026-10-24 speaking seated nobody. A
+ * conversation four people wrote in showed two in its roster - the one who started it and the one who was
+ * mentioned - and the other two had no presence, no unread badge and no activity notice. In a group or private
+ * room the writer is seated already (the write gate let them in by their seat). Then the people mentioned.
+ */
+async function seatTurn(input) {
+    await seatWriter(input);
+    return inviteMentionedUsers(input);
+}
+/** Seat the person who spoke, in an open room only - there the seat grants nothing, it records who took part. */
+async function seatWriter(input) {
+    const writerId = input.inviter?.id;
+    if (!writerId || !(0, session_visibility_js_1.isOpenRoom)(input.visibility))
+        return false;
+    const repo = input.participants;
+    const existing = await repo.find({
+        where: { session: { id: input.sessionId }, domain: { id: input.domainId } },
+        withDeleted: true
+    });
+    if (existing.some((row) => row.userId === writerId && !row.deletedAt && row.role !== 'viewer'))
+        return false;
+    await writeMemberSeat(repo, existing, input, writerId);
+    return true;
+}
+/** One member seat: someone who left (soft delete) or only hid it (`viewer`) is brought back on that row, never a second one. */
+async function writeMemberSeat(repo, existing, input, userId) {
+    const prior = existing.find((row) => row.userId === userId && (row.deletedAt || row.role === 'viewer'));
+    if (prior) {
+        await repo.update(prior.id, { deletedAt: null, role: 'member', updater: input.inviter });
+    }
+    else {
+        await repo.save({
+            domain: { id: input.domainId },
+            session: { id: input.sessionId },
+            user: { id: userId },
+            role: 'member',
+            creator: input.inviter,
+            updater: input.inviter
+        });
+    }
+}
 //# sourceMappingURL=mention-invite.js.map

package/dist-server/service/chat-session-participant/mention-invite.js.map

@@ -1 +1 @@
-{"version":3,"file":"mention-invite.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/mention-invite.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Mentioning someone tells them (ADR-0071 decision 1, as amended by ADR-0073).\n *\n * The machinery existed in the board product only: `@name` in a board chat added a participant and\n * sent them an invite, and the same `@name` in a twin deliberation added nobody. The person typing\n * it had every reason to believe they had called a colleague in.\n *\n * ── What a mention is now ─────────────────────────────────────────────────────\n * A conversation in the domain is open: anyone may walk in, with nothing to approve and nobody to\n * ask (ADR-0073 decision 2). So a mention grants nothing — it points. It seats the named person so\n * the conversation reaches their list, and it tells them their name came up. Somebody who was never\n * mentioned can read the same room by opening it.\n *\n * Two rules survive the amendment:\n *   ① only a door that stores **a person's turn** mentions — never the model, a tool, or the\n *      assistant's own answer. What the assistant writes must not seat people.\n *   ② whoever is named joins as a member and is told.\n *\n * What went: the inviter's own role (there is nothing to hand out), the refusal verdicts, and the\n * notice shown before sending. A private conversation is the one place a mention cannot seat\n * someone — there the named person is told and stays outside until an owner opens it.\n */\n\n/** 본문에서 `@user{userId:UUID}` 마커의 userId 를 뽑는다 — 첫 등장 순, 중복 제거. */\nexport function extractMentionUserIds(text: string | null | undefined): string[] {\n  if (!text) return []\n  const re = /\\{userId:([^}\\s]+)\\}/g\n  const seen = new Set<string>()\n  const out: string[] = []\n  let m: RegExpExecArray | null\n  while ((m = re.exec(text)) !== null) {\n    const id = m[1]\n    if (!seen.has(id)) {\n      seen.add(id)\n      out.push(id)\n    }\n  }\n  return out\n}\n\n/** 멘션된 사람 중 **아직 참여자가 아니고 자기 자신도 아닌** 새 사람만. */\nexport function newParticipantUserIds(\n  mentioned: ReadonlyArray<string>,\n  existing: ReadonlyArray<string>,\n  selfUserId?: string | null\n): string[] {\n  const have = new Set(existing)\n  if (selfUserId) have.add(selfUserId)\n  const out: string[] = []\n  const seen = new Set<string>()\n  for (const id of mentioned) {\n    if (!id || have.has(id) || seen.has(id)) continue\n    seen.add(id)\n    out.push(id)\n  }\n  return out\n}\n\nexport interface MentionInviteResult {\n  /** 이번에 새로 앉은 사람들. 알림은 이들에게 간다. */\n  invited: string[]\n  /** 비공개 대화라 앉히지 못한 사람들 — 이름은 불렸고 방에는 못 들어온다. 화면이 그대로 말한다. */\n  notSeated?: string[]\n}\n\nexport interface MentionInviteInput {\n  /** 저장된 **사람의 말**. 어시스턴트의 답이나 도구 결과를 여기에 넘기지 않는다(조건 ①). */\n  content: string\n  sessionId: string\n  domainId: string\n  inviter: { id?: string } | undefined | null\n  /** 참여자 저장소 — 시험이 가짜를 넣는다. */\n  participants: any\n  /** 이 대화가 공개인가(ADR-0073 판정 2). 비공개면 이름만 알리고 앉히지 않는다. */\n  visibility?: string | null\n}\n\n/**\n * 멘션된 사람을 참여자로 앉힌다.\n *\n * 나갔던 사람(soft delete)은 되살린다 — 다시 부른 것이지 새 사람이 아니다.\n */\nexport async function inviteMentionedUsers(input: MentionInviteInput): Promise<MentionInviteResult> {\n  const mentioned = extractMentionUserIds(input.content)\n  if (mentioned.length === 0) return { invited: [] }\n\n  const repo = input.participants\n  const existing = await repo.find({\n    where: { session: { id: input.sessionId } as any, domain: { id: input.domainId } as any },\n    withDeleted: true\n  })\n\n  const activeIds = existing.filter((row: any) => !row.deletedAt).map((row: any) => row.userId).filter(Boolean)\n  const fresh = newParticipantUserIds(mentioned, activeIds, input.inviter?.id)\n  if (fresh.length === 0) return { invited: [] }\n\n  /*\n   * 비공개 대화에서는 이름을 불러도 앉히지 않는다. 공개 대화에서는 앉히는 일이 아무것도 주지 않지만\n   * (누구나 들어온다), 비공개에서는 그것이 곧 접근을 주는 일이다. 부르는 사람이 아니라 owner 가 열\n   * 일이다 — 이름이 불렸다는 것만 알린다.\n   */\n  if ((input.visibility ?? 'open') !== 'open') return { invited: [], notSeated: fresh }\n\n  for (const userId of fresh) {\n    const prior = existing.find((row: any) => row.userId === userId && row.deletedAt)\n    if (prior) {\n      await repo.update(prior.id, { deletedAt: null, role: 'member', updater: input.inviter } as any)\n    } else {\n      await repo.save({\n        domain: { id: input.domainId } as any,\n        session: { id: input.sessionId } as any,\n        user: { id: userId } as any,\n        role: 'member',\n        creator: input.inviter,\n        updater: input.inviter\n      } as any)\n    }\n  }\n\n  return { invited: fresh }\n}\n"]}
+{"version":3,"file":"mention-invite.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/mention-invite.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Mentioning someone tells them (ADR-0071 decision 1, as amended by ADR-0073).\n *\n * The machinery existed in the board product only: `@name` in a board chat added a participant and\n * sent them an invite, and the same `@name` in a twin deliberation added nobody. The person typing\n * it had every reason to believe they had called a colleague in.\n *\n * ── What a mention is now ─────────────────────────────────────────────────────\n * A conversation in the domain is open: anyone may walk in, with nothing to approve and nobody to\n * ask (ADR-0073 decision 2). So a mention grants nothing — it points. It seats the named person so\n * the conversation reaches their list, and it tells them their name came up. Somebody who was never\n * mentioned can read the same room by opening it.\n *\n * Two rules survive the amendment:\n *   ① only a door that stores **a person's turn** mentions — never the model, a tool, or the\n *      assistant's own answer. What the assistant writes must not seat people.\n *   ② whoever is named joins as a member and is told.\n *\n * What went: the inviter's own role (there is nothing to hand out), the refusal verdicts, and the\n * notice shown before sending. A private conversation is the one place a mention cannot seat\n * someone — there the named person is told and stays outside until an owner opens it.\n *\n * ── A group (2026-10-24, ADR-0073 decision 3) ──────────────────────────────────\n * In a group the seat is the key, so who seats is asked again: the owner's mention seats, a member's\n * tells (`maySeat`). The invite door (`inviteToAISession`) seats through the same `seatParticipants`\n * under the same rule - two ways in, one seat.\n */\nimport { isOpenRoom, maySeat } from '../chat-session/session-visibility.js'\n\n/** 본문에서 `@user{userId:UUID}` 마커의 userId 를 뽑는다 — 첫 등장 순, 중복 제거. */\nexport function extractMentionUserIds(text: string | null | undefined): string[] {\n  if (!text) return []\n  const re = /\\{userId:([^}\\s]+)\\}/g\n  const seen = new Set<string>()\n  const out: string[] = []\n  let m: RegExpExecArray | null\n  while ((m = re.exec(text)) !== null) {\n    const id = m[1]\n    if (!seen.has(id)) {\n      seen.add(id)\n      out.push(id)\n    }\n  }\n  return out\n}\n\n/** 멘션된 사람 중 **아직 참여자가 아니고 자기 자신도 아닌** 새 사람만. */\nexport function newParticipantUserIds(\n  mentioned: ReadonlyArray<string>,\n  existing: ReadonlyArray<string>,\n  selfUserId?: string | null\n): string[] {\n  const have = new Set(existing)\n  if (selfUserId) have.add(selfUserId)\n  const out: string[] = []\n  const seen = new Set<string>()\n  for (const id of mentioned) {\n    if (!id || have.has(id) || seen.has(id)) continue\n    seen.add(id)\n    out.push(id)\n  }\n  return out\n}\n\nexport interface MentionInviteResult {\n  /** 이번에 새로 앉은 사람들. 알림은 이들에게 간다. */\n  invited: string[]\n  /** 앉힐 수 없는 방이거나 부른 사람에게 그 자리가 없어 앉히지 못한 사람들 — 이름은 불렸고 방에는 못 들어온다. */\n  notSeated?: string[]\n}\n\nexport interface MentionInviteInput {\n  /** 저장된 **사람의 말**. 어시스턴트의 답이나 도구 결과를 여기에 넘기지 않는다(조건 ①). */\n  content: string\n  sessionId: string\n  domainId: string\n  inviter: { id?: string } | undefined | null\n  /** 참여자 저장소 — 시험이 가짜를 넣는다. */\n  participants: any\n  /** 이 대화의 공개 범위(ADR-0073). 그룹은 owner 의 멘션만, 비공개는 아무의 멘션도 앉히지 않는다. */\n  visibility?: string | null\n}\n\n/** 멘션된 사람을 참여자로 앉힌다 — 앉힐 수 있는 방이고 부른 사람에게 그 자리가 있을 때만(`maySeat`). */\nexport async function inviteMentionedUsers(input: MentionInviteInput): Promise<MentionInviteResult> {\n  const mentioned = extractMentionUserIds(input.content)\n  if (mentioned.length === 0) return { invited: [] }\n  return seatParticipants({ ...input, userIds: mentioned })\n}\n\nexport interface SeatInput {\n  sessionId: string\n  domainId: string\n  inviter: { id?: string } | undefined | null\n  /** 앉힐 사람들. 이미 앉은 사람과 부른 사람 자신은 빠진다. */\n  userIds: ReadonlyArray<string>\n  participants: any\n  visibility?: string | null\n}\n\n/**\n * 사람을 앉힌다 — 멘션과 초대 단추가 함께 쓰는 한 곳.\n *\n * 규칙은 `maySeat` 한 줄이다: 공개 방은 누구나, 그룹은 owner 만, 비공개는 아무도. 앉히지 못하면\n * 아무것도 쓰지 않고 그 사람들을 `notSeated` 로 돌려준다 — 화면이 그대로 말한다.\n * 나갔던 사람(soft delete)은 되살린다 — 다시 부른 것이지 새 사람이 아니다.\n */\nexport async function seatParticipants(input: SeatInput): Promise<MentionInviteResult> {\n  const repo = input.participants\n  const existing = await repo.find({\n    where: { session: { id: input.sessionId } as any, domain: { id: input.domainId } as any },\n    withDeleted: true\n  })\n\n  /* A hide-only `viewer` row is not a seat - the person is brought in over it, as a member. */\n  const seated = existing.filter((row: any) => !row.deletedAt && row.role !== 'viewer')\n  const activeIds = seated.map((row: any) => row.userId).filter(Boolean)\n  const fresh = newParticipantUserIds(input.userIds, activeIds, input.inviter?.id)\n  if (fresh.length === 0) return { invited: [] }\n\n  /*\n   * 공개 방에서 앉히는 일은 아무것도 주지 않지만(누구나 들어온다), 그룹과 비공개에서는 그것이 곧 접근을\n   * 주는 일이다. 그룹에서는 owner 가 주고, 비공개에서는 아무도 주지 않는다 — 이름이 불렸다는 것만 남는다.\n   */\n  const inviterRole = seated.find((row: any) => row.userId === input.inviter?.id)?.role\n  if (!maySeat(input.visibility, inviterRole)) return { invited: [], notSeated: fresh }\n\n  for (const userId of fresh) await writeMemberSeat(repo, existing, input, userId)\n\n  return { invited: fresh }\n}\n\n/**\n * The seats a person's turn gives - what every door that stores a person's words calls.\n *\n * The writer first: in an open room anyone may walk in and speak, and until 2026-10-24 speaking seated nobody. A\n * conversation four people wrote in showed two in its roster - the one who started it and the one who was\n * mentioned - and the other two had no presence, no unread badge and no activity notice. In a group or private\n * room the writer is seated already (the write gate let them in by their seat). Then the people mentioned.\n */\nexport async function seatTurn(input: MentionInviteInput): Promise<MentionInviteResult> {\n  await seatWriter(input)\n  return inviteMentionedUsers(input)\n}\n\n/** Seat the person who spoke, in an open room only - there the seat grants nothing, it records who took part. */\nexport async function seatWriter(input: Omit<SeatInput, 'userIds'>): Promise<boolean> {\n  const writerId = input.inviter?.id\n  if (!writerId || !isOpenRoom(input.visibility)) return false\n  const repo = input.participants\n  const existing = await repo.find({\n    where: { session: { id: input.sessionId } as any, domain: { id: input.domainId } as any },\n    withDeleted: true\n  })\n  if (existing.some((row: any) => row.userId === writerId && !row.deletedAt && row.role !== 'viewer')) return false\n  await writeMemberSeat(repo, existing, input, writerId)\n  return true\n}\n\n/** One member seat: someone who left (soft delete) or only hid it (`viewer`) is brought back on that row, never a second one. */\nasync function writeMemberSeat(repo: any, existing: any[], input: { sessionId: string; domainId: string; inviter: { id?: string } | undefined | null }, userId: string) {\n  const prior = existing.find((row: any) => row.userId === userId && (row.deletedAt || row.role === 'viewer'))\n  if (prior) {\n    await repo.update(prior.id, { deletedAt: null, role: 'member', updater: input.inviter } as any)\n  } else {\n    await repo.save({\n      domain: { id: input.domainId } as any,\n      session: { id: input.sessionId } as any,\n      user: { id: userId } as any,\n      role: 'member',\n      creator: input.inviter,\n      updater: input.inviter\n    } as any)\n  }\n}\n"]}

package/dist-server/service/chat-session-participant/read-roster.js

@@ -2,14 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readRoster = readRoster;
 const session_visibility_js_1 = require("../chat-session/session-visibility.js");
+const participant_lookup_roles_js_1 = require("./participant-lookup-roles.js");
 /** Read the room roster with user identities hydrated, after applying the room's visibility gate. */
 async function readRoster(room, port) {
-    if (!(0, session_visibility_js_1.mayReadSession)(room.visibility, room.visibility === 'private' ? await port.isParticipant() : false))
+    if (!(0, session_visibility_js_1.mayReadSession)(room.visibility, (0, session_visibility_js_1.isOpenRoom)(room.visibility) ? false : await port.isParticipant()))
         return [];
-    return port.find({
+    /* A hide-only `viewer` row is not someone in the room - the roster lists the seats. */
+    const rows = await port.find({
         where: { session: { id: room.id }, domain: { id: room.domainId } },
         relations: ['user'],
         order: { createdAt: 'ASC' }
     });
+    return rows.filter((row) => (0, participant_lookup_roles_js_1.isRoomRole)(row?.role));
 }
 //# sourceMappingURL=read-roster.js.map

package/dist-server/service/chat-session-participant/read-roster.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-roster.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/read-roster.ts"],"names":[],"mappings":";;AAGA,gCAUC;AAbD,iFAAsE;AAEtE,qGAAqG;AAC9F,KAAK,UAAU,UAAU,CAC9B,IAA2D,EAC3D,IAA6E;IAE7E,IAAI,CAAC,IAAA,sCAAc,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACnH,OAAO,IAAI,CAAC,IAAI,CAAC;QACf,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE;QAClE,SAAS,EAAE,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;KAC5B,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import { mayReadSession } from '../chat-session/session-visibility.js'\n\n/** Read the room roster with user identities hydrated, after applying the room's visibility gate. */\nexport async function readRoster<T>(\n  room: { id: string; domainId: string; visibility?: string },\n  port: { isParticipant(): Promise<boolean>; find(options: any): Promise<T[]> }\n): Promise<T[]> {\n  if (!mayReadSession(room.visibility, room.visibility === 'private' ? await port.isParticipant() : false)) return []\n  return port.find({\n    where: { session: { id: room.id }, domain: { id: room.domainId } },\n    relations: ['user'],\n    order: { createdAt: 'ASC' }\n  })\n}\n"]}
+{"version":3,"file":"read-roster.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/read-roster.ts"],"names":[],"mappings":";;AAIA,gCAYC;AAhBD,iFAAkF;AAClF,+EAA0D;AAE1D,qGAAqG;AAC9F,KAAK,UAAU,UAAU,CAC9B,IAA2D,EAC3D,IAA6E;IAE7E,IAAI,CAAC,IAAA,sCAAc,EAAC,IAAI,CAAC,UAAU,EAAE,IAAA,kCAAU,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAAE,OAAO,EAAE,CAAA;IACjH,uFAAuF;IACvF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;QAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE;QAClE,SAAS,EAAE,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;KAC5B,CAAC,CAAA;IACF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,IAAA,wCAAU,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;AACzD,CAAC","sourcesContent":["import { isOpenRoom, mayReadSession } from '../chat-session/session-visibility.js'\nimport { isRoomRole } from './participant-lookup-roles.js'\n\n/** Read the room roster with user identities hydrated, after applying the room's visibility gate. */\nexport async function readRoster<T>(\n  room: { id: string; domainId: string; visibility?: string },\n  port: { isParticipant(): Promise<boolean>; find(options: any): Promise<T[]> }\n): Promise<T[]> {\n  if (!mayReadSession(room.visibility, isOpenRoom(room.visibility) ? false : await port.isParticipant())) return []\n  /* A hide-only `viewer` row is not someone in the room - the roster lists the seats. */\n  const rows = await port.find({\n    where: { session: { id: room.id }, domain: { id: room.domainId } },\n    relations: ['user'],\n    order: { createdAt: 'ASC' }\n  })\n  return rows.filter((row: any) => isRoomRole(row?.role))\n}\n"]}

package/dist-server/service/chat-session-resolver.d.ts

@@ -95,6 +95,28 @@ export declare class ChatSessionResolver {
      * 강제하지 않는다 — 문이 막을 수 있는 것은 누가 바꾸느냐까지다.
      */
     setSessionVisibility(sessionId: string, visibility: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * Bring people into this conversation - the same seat a mention gives, by the same rule (`maySeat`): anyone
+     * in an open room, the owner in a group, nobody in a private one. Each person seated is told
+     * (`notifyInvited`). People outside the domain are not seated.
+     */
+    inviteToAISession(sessionId: string, userIds: string[], context: ResolverContext): Promise<string[]>;
+    /**
+     * Send a member out - the owner only, and never the owner themself. In a group the seat was the key, so the
+     * person no longer reads or writes here (every gate asks the seat). Their list is told once and drops it.
+     */
+    removeFromAISession(sessionId: string, userId: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * Leave this conversation - a member steps out of their own seat. The owner does not leave: the room would be
+     * nobody's. They delete it, or make it private.
+     */
+    leaveAISession(sessionId: string, context: ResolverContext): Promise<boolean>;
+    private _leave;
+    /**
+     * "I am typing" - a notice to the others in the room, stored nowhere. Only a person who may write here is
+     * typing here (the write gate), and the listeners pass the room's read gate (`ChatTypingSubscription`).
+     */
+    sayTyping(sessionId: string, context: ResolverContext): Promise<boolean>;
     renameAISession(sessionId: string, name: string, context: ResolverContext): Promise<boolean>;
     /**
      * 읽은 지점 갱신 — 이 세션을 여기까지 읽었다. 멱등(여러 번 호출해도 최신 시각으로만 이동).
@@ -103,6 +125,11 @@ export declare class ChatSessionResolver {
     markSessionRead(sessionId: string, context: ResolverContext): Promise<boolean>;
     domainUsersForMention(query: string | undefined, limit: number, context: ResolverContext): Promise<User[]>;
     chatSessionParticipants(sessionId: string, context: ResolverContext): Promise<ChatSessionParticipant[]>;
+    /**
+     * May the caller seat someone here - the server's answer to the screen, so the screen keeps no copy of the
+     * rule (`maySeat`). The invite button and the line under a mention read it; the doors decide again.
+     */
+    mayInviteToAISession(sessionId: string, context: ResolverContext): Promise<boolean>;
     touchPresence(sessionId: string, context: ResolverContext): Promise<boolean>;
     chatMessages(sessionId: string, limit: number, offset: number, context: ResolverContext): Promise<ChatMessage[]>;
     startAISession(anchorType: string, anchorId: string, context: ResolverContext): Promise<ChatSession>;