@things-factory/ai-assistant 10.1.47 → 10.1.50

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

@@ -0,0 +1,36 @@
+export declare const CHAT_ATTACHMENT_REF = "chat-session";
+export interface StoredChatAttachment {
+    id: string;
+    name: string;
+    mimetype: string;
+    size: number;
+}
+export declare function describeAttachment(row: any): StoredChatAttachment;
+/** Stores uploaded files under the conversation. The caller has passed the write gate and the mode's policy. */
+export declare function saveChatAttachments(sessionId: string, files: any[], context: any): Promise<StoredChatAttachment[]>;
+/** One file of the conversation - `undefined` when it is not this conversation's. */
+export declare function findChatAttachment(domainId: string, sessionId: string, attachmentId: string): Promise<any | undefined>;
+/**
+ * What the model gets for a file: an image as bytes, a text file as its text (cut at TEXT_CHARS_FOR_MODEL,
+ * and the cut is said), anything else as a line that names it.
+ */
+export declare function attachmentForModel(row: any): Promise<{
+    type: 'image';
+    data: Buffer;
+    mediaType: string;
+    name: string;
+} | {
+    type: 'text';
+    text: string;
+    name: string;
+    truncated: boolean;
+}>;
+/** Removes these files from storage and their rows. */
+export declare function removeAttachmentRows(ids: string[]): Promise<void>;
+/** Removes a conversation's files from storage and their rows - the purge's part (§9-5). */
+export declare function removeSessionFiles(session: {
+    id?: string;
+    domain?: {
+        id?: string;
+    };
+}): Promise<void>;

package/dist-server/service/chat-session/session-attachments.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHAT_ATTACHMENT_REF = void 0;
+exports.describeAttachment = describeAttachment;
+exports.saveChatAttachments = saveChatAttachments;
+exports.findChatAttachment = findChatAttachment;
+exports.attachmentForModel = attachmentForModel;
+exports.removeAttachmentRows = removeAttachmentRows;
+exports.removeSessionFiles = removeSessionFiles;
+/*
+ * A conversation's files - stored in attachment-base, opened only through the conversation.
+ *
+ * Files are kept with `refType: 'chat-session'`, `refBy: <session id>` (design/ai/shared-dock.md §9-2).
+ * They are never handed out through attachment-base's own route: that route is public and unauthenticated
+ * (routes.ts, "TODO make this secure"), so a private conversation's file would leave the conversation.
+ * Every read here passes the conversation's gate first (§9-3); this module only does the storage part.
+ */
+const attachment_base_1 = require("@things-factory/attachment-base");
+const shell_1 = require("@things-factory/shell");
+const attachment_policy_js_1 = require("./attachment-policy.js");
+exports.CHAT_ATTACHMENT_REF = 'chat-session';
+function describeAttachment(row) {
+    return { id: row.id, name: row.name, mimetype: row.mimetype, size: Number(row.size) || 0 };
+}
+/** Stores uploaded files under the conversation. The caller has passed the write gate and the mode's policy. */
+async function saveChatAttachments(sessionId, files, context) {
+    const saved = [];
+    for (const file of files) {
+        const row = await (0, attachment_base_1.createAttachment)(null, { attachment: { file, category: 'chat', refType: exports.CHAT_ATTACHMENT_REF, refBy: sessionId } }, context);
+        saved.push(describeAttachment(row));
+    }
+    return saved;
+}
+/** One file of the conversation - `undefined` when it is not this conversation's. */
+async function findChatAttachment(domainId, sessionId, attachmentId) {
+    return ((await (0, shell_1.getRepository)(attachment_base_1.Attachment).findOne({
+        where: { id: attachmentId, domain: { id: domainId }, refType: exports.CHAT_ATTACHMENT_REF, refBy: sessionId }
+    })) ?? undefined);
+}
+/**
+ * What the model gets for a file: an image as bytes, a text file as its text (cut at TEXT_CHARS_FOR_MODEL,
+ * and the cut is said), anything else as a line that names it.
+ */
+async function attachmentForModel(row) {
+    const kind = (0, attachment_policy_js_1.attachmentKindOf)({ type: row.mimetype, name: row.name });
+    if (kind === 'image') {
+        const data = await attachment_base_1.STORAGE.readFile(row.path);
+        return { type: 'image', data: Buffer.isBuffer(data) ? data : Buffer.from(data), mediaType: row.mimetype, name: row.name };
+    }
+    const content = String(await attachment_base_1.STORAGE.readFile(row.path, 'utf8'));
+    const truncated = content.length > attachment_policy_js_1.TEXT_CHARS_FOR_MODEL;
+    return { type: 'text', text: truncated ? content.slice(0, attachment_policy_js_1.TEXT_CHARS_FOR_MODEL) : content, name: row.name, truncated };
+}
+/** Removes these files from storage and their rows. */
+async function removeAttachmentRows(ids) {
+    if (!ids.length)
+        return;
+    const rows = await (0, shell_1.getRepository)(attachment_base_1.Attachment).find({ where: ids.map(id => ({ id, refType: exports.CHAT_ATTACHMENT_REF })) });
+    for (const row of rows) {
+        try {
+            await attachment_base_1.STORAGE.deleteFile(row.path);
+        }
+        catch {
+            /* already gone from storage */
+        }
+    }
+    if (rows.length)
+        await (0, shell_1.getRepository)(attachment_base_1.Attachment).delete(rows.map(row => row.id));
+}
+/** Removes a conversation's files from storage and their rows - the purge's part (§9-5). */
+async function removeSessionFiles(session) {
+    const rows = await (0, shell_1.getRepository)(attachment_base_1.Attachment).find({ where: { refType: exports.CHAT_ATTACHMENT_REF, refBy: session.id } });
+    for (const row of rows) {
+        try {
+            await attachment_base_1.STORAGE.deleteFile(row.path);
+        }
+        catch {
+            /* A file already gone from storage must not keep its row alive. */
+        }
+    }
+    if (rows.length)
+        await (0, shell_1.getRepository)(attachment_base_1.Attachment).delete(rows.map(row => row.id));
+}
+//# sourceMappingURL=session-attachments.js.map

package/dist-server/service/chat-session/session-attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-attachments.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-attachments.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * A conversation's files - stored in attachment-base, opened only through the conversation.\n *\n * Files are kept with `refType: 'chat-session'`, `refBy: <session id>` (design/ai/shared-dock.md §9-2).\n * They are never handed out through attachment-base's own route: that route is public and unauthenticated\n * (routes.ts, \"TODO make this secure\"), so a private conversation's file would leave the conversation.\n * Every read here passes the conversation's gate first (§9-3); this module only does the storage part.\n */\nimport { Attachment, STORAGE, createAttachment } from '@things-factory/attachment-base'\nimport { getRepository } from '@things-factory/shell'\n\nimport { attachmentKindOf, TEXT_CHARS_FOR_MODEL } from './attachment-policy.js'\n\nexport const CHAT_ATTACHMENT_REF = 'chat-session'\n\nexport interface StoredChatAttachment {\n  id: string\n  name: string\n  mimetype: string\n  size: number\n}\n\nexport function describeAttachment(row: any): StoredChatAttachment {\n  return { id: row.id, name: row.name, mimetype: row.mimetype, size: Number(row.size) || 0 }\n}\n\n/** Stores uploaded files under the conversation. The caller has passed the write gate and the mode's policy. */\nexport async function saveChatAttachments(sessionId: string, files: any[], context: any): Promise<StoredChatAttachment[]> {\n  const saved: StoredChatAttachment[] = []\n  for (const file of files) {\n    const row = await createAttachment(null, { attachment: { file, category: 'chat', refType: CHAT_ATTACHMENT_REF, refBy: sessionId } }, context)\n    saved.push(describeAttachment(row))\n  }\n  return saved\n}\n\n/** One file of the conversation - `undefined` when it is not this conversation's. */\nexport async function findChatAttachment(domainId: string, sessionId: string, attachmentId: string): Promise<any | undefined> {\n  return (\n    (await getRepository(Attachment).findOne({\n      where: { id: attachmentId, domain: { id: domainId }, refType: CHAT_ATTACHMENT_REF, refBy: sessionId } as any\n    })) ?? undefined\n  )\n}\n\n/**\n * What the model gets for a file: an image as bytes, a text file as its text (cut at TEXT_CHARS_FOR_MODEL,\n * and the cut is said), anything else as a line that names it.\n */\nexport async function attachmentForModel(row: any): Promise<\n  | { type: 'image'; data: Buffer; mediaType: string; name: string }\n  | { type: 'text'; text: string; name: string; truncated: boolean }\n> {\n  const kind = attachmentKindOf({ type: row.mimetype, name: row.name })\n  if (kind === 'image') {\n    const data = await STORAGE.readFile(row.path)\n    return { type: 'image', data: Buffer.isBuffer(data) ? data : Buffer.from(data), mediaType: row.mimetype, name: row.name }\n  }\n  const content = String(await STORAGE.readFile(row.path, 'utf8'))\n  const truncated = content.length > TEXT_CHARS_FOR_MODEL\n  return { type: 'text', text: truncated ? content.slice(0, TEXT_CHARS_FOR_MODEL) : content, name: row.name, truncated }\n}\n\n/** Removes these files from storage and their rows. */\nexport async function removeAttachmentRows(ids: string[]): Promise<void> {\n  if (!ids.length) return\n  const rows = await getRepository(Attachment).find({ where: ids.map(id => ({ id, refType: CHAT_ATTACHMENT_REF })) as any })\n  for (const row of rows) {\n    try {\n      await STORAGE.deleteFile((row as any).path)\n    } catch {\n      /* already gone from storage */\n    }\n  }\n  if (rows.length) await getRepository(Attachment).delete(rows.map(row => (row as any).id))\n}\n\n/** Removes a conversation's files from storage and their rows - the purge's part (§9-5). */\nexport async function removeSessionFiles(session: { id?: string; domain?: { id?: string } }): Promise<void> {\n  const rows = await getRepository(Attachment).find({ where: { refType: CHAT_ATTACHMENT_REF, refBy: session.id } as any })\n  for (const row of rows) {\n    try {\n      await STORAGE.deleteFile((row as any).path)\n    } catch {\n      /* A file already gone from storage must not keep its row alive. */\n    }\n  }\n  if (rows.length) await getRepository(Attachment).delete(rows.map(row => (row as any).id))\n}\n"]}

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

@@ -12,10 +12,14 @@ export interface InboxSessionRow {
     /** 그 미리보기가 지나온 문 — 목록도 같은 관문을 지난다. */
     lastMessageDoors?: string[] | null;
     createdAt?: Date | string | null;
+    /** 도메인 안 누구나 읽나(`open`) · 참여자만(`private`) — ADR-0073 판정 2. 값이 없으면 open(옛 행). */
+    visibility?: string | null;
 }
 /** 내 참여 기록(읽은 지점). */
 export interface MyParticipation {
     sessionId?: string;
+    /** 이 대화에서 나의 자리 — `owner` 만 공개 범위를 바꾼다. */
+    role?: string | null;
     lastReadAt?: Date | string | null;
     /** 내 목록에서 숨긴 시각 — 이후 새 활동이 생기면 다시 보인다. */
     hiddenAt?: Date | string | null;
@@ -27,6 +31,10 @@ export interface InboxEntry extends InboxSessionRow {
     participant: boolean;
     /** 내가 숨긴 대화인가 — 목록에서 빠지지만 필터로 볼 수 있다(되돌리기 가능). */
     hidden?: boolean;
+    /** `open` · `private` — 목록이 자물쇠를 그리는 근거. */
+    visibility: string;
+    /** 내가 이 대화의 owner 인가 — 공개 범위를 바꿀 수 있는 사람. UI 힌트이고 판정은 문이 다시 한다. */
+    owner: boolean;
 }
 /**
  * 세션 + 내 참여 기록 → 목록 항목. **최근 활동순**(활동 없으면 생성순) 내림차순.
@@ -59,6 +67,27 @@ export declare function applyHidden(entries: InboxEntry[], hiddenAt: Map<string,
  * **상한을 두고** 가져오고(아래 INBOX_SCAN_CAP) 걸러내기·정렬·페이지는 여기서 한다.
  * 상한을 넘으면 잘렸다는 사실을 그대로 알린다(조용히 일부만 보여주지 않는다).
  */
+/** What the conversation list is narrowed by - the manager's filters (design/ai/shared-dock.md §2-6). */
+export interface InboxFilter {
+    /** Only this conversation kind (mode). Absent: every kind on the anchor. */
+    kind?: string | null;
+    /** Only the ones I started. */
+    mineOnly?: boolean | null;
+    /** Only the ones I am in (owner or member). */
+    participantOnly?: boolean | null;
+    /** Only 'open' or only 'private'. */
+    visibility?: string | null;
+    /** Only the ones with activity I have not read. */
+    unreadOnly?: boolean | null;
+}
+/**
+ * Narrow the list. Pure - the resolver builds the entries (with the reader's gate already applied) and
+ * this decides only what the person asked to see. A session from before the kind column has no kind:
+ * it is shown under every kind, so it is never lost from the list it was started in.
+ */
+export declare function filterInbox<T extends InboxEntry & {
+    mine?: boolean;
+}>(entries: T[], filter?: InboxFilter): T[];
 export declare function searchInbox(entries: InboxEntry[], search?: string): InboxEntry[];
 /** 한 번에 훑는 세션 상한 — 이보다 많으면 잘렸다고 알린다(정직). */
 export declare const INBOX_SCAN_CAP = 500;

package/dist-server/service/chat-session/session-inbox.js

@@ -19,10 +19,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.INBOX_SCAN_CAP = void 0;
 exports.buildInbox = buildInbox;
 exports.applyHidden = applyHidden;
+exports.filterInbox = filterInbox;
 exports.searchInbox = searchInbox;
 exports.countUnreadSessions = countUnreadSessions;
 exports.activityPatch = activityPatch;
 exports.autoSessionName = autoSessionName;
+const session_visibility_js_1 = require("./session-visibility.js");
 function time(v) {
     if (!v)
         return 0;
@@ -43,13 +45,22 @@ function time(v) {
 function buildInbox(sessions, mine) {
     const readBy = new Map();
     const isParticipant = new Set();
+    const owns = new Set();
     for (const p of mine) {
         if (!p.sessionId)
             continue;
         isParticipant.add(p.sessionId);
         readBy.set(p.sessionId, time(p.lastReadAt));
+        if (p.role === 'owner')
+            owns.add(p.sessionId);
     }
-    const entries = sessions.map(session => {
+    const entries = sessions
+        /*
+         * 남의 비공개 대화는 목록에도 서지 않는다 — ADR-0073 판정 1 의 「읽는 길은 같은 관문을 지난다」.
+         * 메시지 문(`chatMessages`)만 막고 목록이 이름을 내보내면, 대화의 주제가 다른 길로 새어 나간다.
+         */
+        .filter(session => (0, session_visibility_js_1.mayReadSession)(session.visibility, isParticipant.has(session.id ?? '')))
+        .map(session => {
         const id = session.id ?? '';
         const activity = time(session.lastMessageAt);
         const participant = isParticipant.has(id);
@@ -57,6 +68,8 @@ function buildInbox(sessions, mine) {
         return {
             ...session,
             participant,
+            visibility: session.visibility ?? 'open',
+            owner: owns.has(id),
             unread: participant && activity > 0 && activity > read
         };
     });
@@ -84,14 +97,25 @@ function applyHidden(entries, hiddenAt, showHidden = false) {
     return out;
 }
 /**
- * 검색 — 이름과 마지막 미리보기에 대한 대소문자 무시 부분일치.
- *
- * **왜 메모리에서 하는가**: 이 프레임워크는 5개 DB 드라이버를 지원한다. 대소문자 무시 검색은
- * 드라이버마다 표기가 갈리고(ILIKE=pg 전용, LOWER()+LIKE 는 되지만 정렬·NULL 취급이 또 갈린다),
- * 목록 경로에 드라이버별 SQL 을 두는 것은 이 프로젝트의 규율에 반한다. 그래서 조회는 앵커로
- * **상한을 두고** 가져오고(아래 INBOX_SCAN_CAP) 걸러내기·정렬·페이지는 여기서 한다.
- * 상한을 넘으면 잘렸다는 사실을 그대로 알린다(조용히 일부만 보여주지 않는다).
+ * Narrow the list. Pure - the resolver builds the entries (with the reader's gate already applied) and
+ * this decides only what the person asked to see. A session from before the kind column has no kind:
+ * it is shown under every kind, so it is never lost from the list it was started in.
  */
+function filterInbox(entries, filter = {}) {
+    return entries.filter(entry => {
+        if (filter.kind && entry.kind && entry.kind !== filter.kind)
+            return false;
+        if (filter.mineOnly && !entry.mine)
+            return false;
+        if (filter.participantOnly && !entry.participant)
+            return false;
+        if (filter.visibility && (entry.visibility ?? 'open') !== filter.visibility)
+            return false;
+        if (filter.unreadOnly && !entry.unread)
+            return false;
+        return true;
+    });
+}
 function searchInbox(entries, search) {
     const q = (search ?? '').trim().toLowerCase();
     if (!q)

package/dist-server/service/chat-session/session-inbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-inbox.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-inbox.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 세션 목록(받은편지함) 순수 로직 — 리졸버와 분리해 단위 테스트 가능.\n *\n * ── 왜 필요한가 ─────────────────────────────────────────────────────────────\n * 대화가 늘면(가벼운 질문을 승격할 때마다 새 세션) \"어디로 갈지\"를 목록에서 골라야 하고, 다른 참여자가\n * 남긴 새 메시지를 알아야 한다. 세션 목록은 **최근 활동순**이어야 하고 **안 읽음**이 보여야 한다.\n *\n * ── 집계 쿼리를 쓰지 않는다 ─────────────────────────────────────────────────\n * 세션마다 메시지를 집계하면(MAX/COUNT + group by) 목록 한 번에 집계가 붙고, 이 프레임워크는 5개 DB\n * 드라이버를 지원해야 한다. 대신 `ChatSession.lastMessageAt` 을 비정규화해 두고(메시지 저장 시 갱신),\n * 참여자의 `lastReadAt` 과 **값 비교**로 안 읽음을 판정한다 — 조회 두 번(세션·내 참여자)으로 끝난다.\n *\n * ── v1 은 개수가 아니라 \"안 읽음 여부\" ──────────────────────────────────────\n * 정확한 미읽음 **개수**는 세션별 count 가 필요하다(목록 N개면 N번). 목록에서는 점 하나로 충분하고,\n * 숫자가 필요해지면 화면에 보이는 세션에 한해 따로 세면 된다. 처음부터 N번 세지 않는다.\n */\n\n/** 목록에 필요한 세션 필드(엔티티·typeorm 비의존). */\nexport interface InboxSessionRow {\n  id?: string\n  name?: string\n  /** 어느 대화인가 — 목록이 대화를 가리지 않으므로, 고른 뒤 화면이 따라갈 수 있게 함께 낸다. */\n  kind?: string\n  anchorType?: string\n  anchorId?: string\n  boardId?: string\n  lastMessageAt?: Date | string | null\n  lastMessagePreview?: string | null\n  /** 그 미리보기가 지나온 문 — 목록도 같은 관문을 지난다. */\n  lastMessageDoors?: string[] | null\n  createdAt?: Date | string | null\n}\n\n/** 내 참여 기록(읽은 지점). */\nexport interface MyParticipation {\n  sessionId?: string\n  lastReadAt?: Date | string | null\n  /** 내 목록에서 숨긴 시각 — 이후 새 활동이 생기면 다시 보인다. */\n  hiddenAt?: Date | string | null\n}\n\nexport interface InboxEntry extends InboxSessionRow {\n  /** 안 읽은 활동이 있는가 — 목록의 점 표시. */\n  unread: boolean\n  /** 내가 참여자인가 — 아니면 열어볼 수는 있어도 읽음 상태를 갖지 않는다. */\n  participant: boolean\n  /** 내가 숨긴 대화인가 — 목록에서 빠지지만 필터로 볼 수 있다(되돌리기 가능). */\n  hidden?: boolean\n}\n\nfunction time(v: Date | string | null | undefined): number {\n  if (!v) return 0\n  const t = v instanceof Date ? v.getTime() : Date.parse(v)\n  return Number.isFinite(t) ? t : 0\n}\n\n/**\n * 세션 + 내 참여 기록 → 목록 항목. **최근 활동순**(활동 없으면 생성순) 내림차순.\n *\n * 안 읽음 판정: 세션의 마지막 활동이 내가 읽은 지점보다 **뒤**면 안 읽음.\n *   · 참여자가 아니면 안 읽음으로 표시하지 않는다(내 것이 아닌 대화에 배지를 띄우지 않는다).\n *   · 참여자인데 한 번도 읽지 않았고(lastReadAt 없음) 활동이 있으면 안 읽음이다.\n *   · 활동이 없는 세션(빈 대화)은 안 읽음이 아니다.\n *\n * 같은 시각 비교는 **엄격 초과**만 안 읽음으로 본다 — 읽은 직후 같은 밀리초에 저장된 활동을 안 읽음으로\n * 잡으면 방금 읽은 화면에 배지가 남는다.\n */\nexport function buildInbox(sessions: InboxSessionRow[], mine: MyParticipation[]): InboxEntry[] {\n  const readBy = new Map<string, number>()\n  const isParticipant = new Set<string>()\n  for (const p of mine) {\n    if (!p.sessionId) continue\n    isParticipant.add(p.sessionId)\n    readBy.set(p.sessionId, time(p.lastReadAt))\n  }\n\n  const entries = sessions.map(session => {\n    const id = session.id ?? ''\n    const activity = time(session.lastMessageAt)\n    const participant = isParticipant.has(id)\n    const read = readBy.get(id) ?? 0\n    return {\n      ...session,\n      participant,\n      unread: participant && activity > 0 && activity > read\n    }\n  })\n\n  return entries.sort(\n    (a, b) => (time(b.lastMessageAt) || time(b.createdAt)) - (time(a.lastMessageAt) || time(a.createdAt))\n  )\n}\n\n/**\n * 숨김 표시·필터.\n *\n * 숨김은 **나에게만** 적용되고 되돌릴 수 있다. 숨긴 **뒤에 새 활동이 생기면 다시 보인다** —\n * 아직 참여 중인 대화에서 조용히 잘려 나가는 것이 목록 한 줄보다 나쁘다.\n *\n * `showHidden` 이면 숨긴 것도 함께 돌려주되 표시(hidden)를 남긴다 — 필터를 켠 사용자가 무엇이\n * 숨겨진 것인지 알아야 되돌릴 수 있다.\n */\nexport function applyHidden(entries: InboxEntry[], hiddenAt: Map<string, Date | string | null | undefined>, showHidden = false): InboxEntry[] {\n  const out: InboxEntry[] = []\n  for (const entry of entries) {\n    const at = hiddenAt.get(entry.id ?? '')\n    /* 숨긴 시각보다 **뒤에** 활동이 있으면 숨김은 풀린 것으로 본다. */\n    const hidden = !!at && time(entry.lastMessageAt) <= time(at)\n    if (hidden && !showHidden) continue\n    out.push(hidden ? { ...entry, hidden: true } : entry)\n  }\n  return out\n}\n\n/**\n * 검색 — 이름과 마지막 미리보기에 대한 대소문자 무시 부분일치.\n *\n * **왜 메모리에서 하는가**: 이 프레임워크는 5개 DB 드라이버를 지원한다. 대소문자 무시 검색은\n * 드라이버마다 표기가 갈리고(ILIKE=pg 전용, LOWER()+LIKE 는 되지만 정렬·NULL 취급이 또 갈린다),\n * 목록 경로에 드라이버별 SQL 을 두는 것은 이 프로젝트의 규율에 반한다. 그래서 조회는 앵커로\n * **상한을 두고** 가져오고(아래 INBOX_SCAN_CAP) 걸러내기·정렬·페이지는 여기서 한다.\n * 상한을 넘으면 잘렸다는 사실을 그대로 알린다(조용히 일부만 보여주지 않는다).\n */\nexport function searchInbox(entries: InboxEntry[], search?: string): InboxEntry[] {\n  const q = (search ?? '').trim().toLowerCase()\n  if (!q) return entries\n  return entries.filter(e =>\n    `${e.name ?? ''}\\n${e.lastMessagePreview ?? ''}`.toLowerCase().includes(q)\n  )\n}\n\n/** 한 번에 훑는 세션 상한 — 이보다 많으면 잘렸다고 알린다(정직). */\nexport const INBOX_SCAN_CAP = 500\n\n/** 안 읽은 세션 수 — 도크 버튼 배지(개수가 아니라 **세션 수**). */\nexport function countUnreadSessions(entries: InboxEntry[]): number {\n  return entries.filter(e => e.unread).length\n}\n\n/**\n * 메시지 저장 시 세션에 반영할 활동 값. 미리보기는 짧게 자르고 개행을 없앤다\n * (목록 한 줄에 들어가야 하고, 컬럼 길이 제한이 있다).\n */\nexport function activityPatch(\n  content: string,\n  at: Date = new Date(),\n  doors: string[] = []\n): { lastMessageAt: Date; lastMessagePreview: string; lastMessageDoors: string[] } {\n  const flat = (content ?? '').replace(/\\s+/g, ' ').trim()\n  /* 미리보기가 어느 문을 지나온 값인지 함께 적는다 — 목록도 같은 관문을 지난다(ADR-0073 판정 1). */\n  return { lastMessageAt: at, lastMessagePreview: flat.slice(0, 200), lastMessageDoors: doors }\n}\n\n/**\n * 첫 발화로 세션 이름을 만든다.\n *\n * `세션 2` 같은 순번은 목록에서 아무것도 알려주지 않는다 — \"A-DC 포화 원인\" 이어야 돌아갈 대화를 찾는다.\n * 사용자가 직접 지은 이름은 이 함수로 덮지 않는다(호출부가 이름 없을 때만 부른다).\n *\n * 규칙: 한 줄로 눌러 첫 문장 경계(., ?, !, 개행)까지, 최대 40자. 문장 부호로 끝나면 떼어 낸다\n * (목록 제목에 물음표가 붙으면 길이만 먹는다).\n */\nexport function autoSessionName(content: string, max = 40): string {\n  const flat = (content ?? '').replace(/\\s+/g, ' ').trim()\n  if (!flat) return ''\n  const cut = flat.search(/[.?!\\n]/)\n  const head = (cut > 0 ? flat.slice(0, cut) : flat).trim()\n  const name = head.length > max ? head.slice(0, max).trim() + '…' : head\n  return name\n}\n"]}
+{"version":3,"file":"session-inbox.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-inbox.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 세션 목록(받은편지함) 순수 로직 — 리졸버와 분리해 단위 테스트 가능.\n *\n * ── 왜 필요한가 ─────────────────────────────────────────────────────────────\n * 대화가 늘면(가벼운 질문을 승격할 때마다 새 세션) \"어디로 갈지\"를 목록에서 골라야 하고, 다른 참여자가\n * 남긴 새 메시지를 알아야 한다. 세션 목록은 **최근 활동순**이어야 하고 **안 읽음**이 보여야 한다.\n *\n * ── 집계 쿼리를 쓰지 않는다 ─────────────────────────────────────────────────\n * 세션마다 메시지를 집계하면(MAX/COUNT + group by) 목록 한 번에 집계가 붙고, 이 프레임워크는 5개 DB\n * 드라이버를 지원해야 한다. 대신 `ChatSession.lastMessageAt` 을 비정규화해 두고(메시지 저장 시 갱신),\n * 참여자의 `lastReadAt` 과 **값 비교**로 안 읽음을 판정한다 — 조회 두 번(세션·내 참여자)으로 끝난다.\n *\n * ── v1 은 개수가 아니라 \"안 읽음 여부\" ──────────────────────────────────────\n * 정확한 미읽음 **개수**는 세션별 count 가 필요하다(목록 N개면 N번). 목록에서는 점 하나로 충분하고,\n * 숫자가 필요해지면 화면에 보이는 세션에 한해 따로 세면 된다. 처음부터 N번 세지 않는다.\n */\n\nimport { mayReadSession } from './session-visibility.js'\n\n/** 목록에 필요한 세션 필드(엔티티·typeorm 비의존). */\nexport interface InboxSessionRow {\n  id?: string\n  name?: string\n  /** 어느 대화인가 — 목록이 대화를 가리지 않으므로, 고른 뒤 화면이 따라갈 수 있게 함께 낸다. */\n  kind?: string\n  anchorType?: string\n  anchorId?: string\n  boardId?: string\n  lastMessageAt?: Date | string | null\n  lastMessagePreview?: string | null\n  /** 그 미리보기가 지나온 문 — 목록도 같은 관문을 지난다. */\n  lastMessageDoors?: string[] | null\n  createdAt?: Date | string | null\n  /** 도메인 안 누구나 읽나(`open`) · 참여자만(`private`) — ADR-0073 판정 2. 값이 없으면 open(옛 행). */\n  visibility?: string | null\n}\n\n/** 내 참여 기록(읽은 지점). */\nexport interface MyParticipation {\n  sessionId?: string\n  /** 이 대화에서 나의 자리 — `owner` 만 공개 범위를 바꾼다. */\n  role?: string | null\n  lastReadAt?: Date | string | null\n  /** 내 목록에서 숨긴 시각 — 이후 새 활동이 생기면 다시 보인다. */\n  hiddenAt?: Date | string | null\n}\n\nexport interface InboxEntry extends InboxSessionRow {\n  /** 안 읽은 활동이 있는가 — 목록의 점 표시. */\n  unread: boolean\n  /** 내가 참여자인가 — 아니면 열어볼 수는 있어도 읽음 상태를 갖지 않는다. */\n  participant: boolean\n  /** 내가 숨긴 대화인가 — 목록에서 빠지지만 필터로 볼 수 있다(되돌리기 가능). */\n  hidden?: boolean\n  /** `open` · `private` — 목록이 자물쇠를 그리는 근거. */\n  visibility: string\n  /** 내가 이 대화의 owner 인가 — 공개 범위를 바꿀 수 있는 사람. UI 힌트이고 판정은 문이 다시 한다. */\n  owner: boolean\n}\n\nfunction time(v: Date | string | null | undefined): number {\n  if (!v) return 0\n  const t = v instanceof Date ? v.getTime() : Date.parse(v)\n  return Number.isFinite(t) ? t : 0\n}\n\n/**\n * 세션 + 내 참여 기록 → 목록 항목. **최근 활동순**(활동 없으면 생성순) 내림차순.\n *\n * 안 읽음 판정: 세션의 마지막 활동이 내가 읽은 지점보다 **뒤**면 안 읽음.\n *   · 참여자가 아니면 안 읽음으로 표시하지 않는다(내 것이 아닌 대화에 배지를 띄우지 않는다).\n *   · 참여자인데 한 번도 읽지 않았고(lastReadAt 없음) 활동이 있으면 안 읽음이다.\n *   · 활동이 없는 세션(빈 대화)은 안 읽음이 아니다.\n *\n * 같은 시각 비교는 **엄격 초과**만 안 읽음으로 본다 — 읽은 직후 같은 밀리초에 저장된 활동을 안 읽음으로\n * 잡으면 방금 읽은 화면에 배지가 남는다.\n */\nexport function buildInbox(sessions: InboxSessionRow[], mine: MyParticipation[]): InboxEntry[] {\n  const readBy = new Map<string, number>()\n  const isParticipant = new Set<string>()\n  const owns = new Set<string>()\n  for (const p of mine) {\n    if (!p.sessionId) continue\n    isParticipant.add(p.sessionId)\n    readBy.set(p.sessionId, time(p.lastReadAt))\n    if (p.role === 'owner') owns.add(p.sessionId)\n  }\n\n  const entries = sessions\n    /*\n     * 남의 비공개 대화는 목록에도 서지 않는다 — ADR-0073 판정 1 의 「읽는 길은 같은 관문을 지난다」.\n     * 메시지 문(`chatMessages`)만 막고 목록이 이름을 내보내면, 대화의 주제가 다른 길로 새어 나간다.\n     */\n    .filter(session => mayReadSession(session.visibility, isParticipant.has(session.id ?? '')))\n    .map(session => {\n      const id = session.id ?? ''\n      const activity = time(session.lastMessageAt)\n      const participant = isParticipant.has(id)\n      const read = readBy.get(id) ?? 0\n      return {\n        ...session,\n        participant,\n        visibility: session.visibility ?? 'open',\n        owner: owns.has(id),\n        unread: participant && activity > 0 && activity > read\n      }\n    })\n\n  return entries.sort(\n    (a, b) => (time(b.lastMessageAt) || time(b.createdAt)) - (time(a.lastMessageAt) || time(a.createdAt))\n  )\n}\n\n/**\n * 숨김 표시·필터.\n *\n * 숨김은 **나에게만** 적용되고 되돌릴 수 있다. 숨긴 **뒤에 새 활동이 생기면 다시 보인다** —\n * 아직 참여 중인 대화에서 조용히 잘려 나가는 것이 목록 한 줄보다 나쁘다.\n *\n * `showHidden` 이면 숨긴 것도 함께 돌려주되 표시(hidden)를 남긴다 — 필터를 켠 사용자가 무엇이\n * 숨겨진 것인지 알아야 되돌릴 수 있다.\n */\nexport function applyHidden(entries: InboxEntry[], hiddenAt: Map<string, Date | string | null | undefined>, showHidden = false): InboxEntry[] {\n  const out: InboxEntry[] = []\n  for (const entry of entries) {\n    const at = hiddenAt.get(entry.id ?? '')\n    /* 숨긴 시각보다 **뒤에** 활동이 있으면 숨김은 풀린 것으로 본다. */\n    const hidden = !!at && time(entry.lastMessageAt) <= time(at)\n    if (hidden && !showHidden) continue\n    out.push(hidden ? { ...entry, hidden: true } : entry)\n  }\n  return out\n}\n\n/**\n * 검색 — 이름과 마지막 미리보기에 대한 대소문자 무시 부분일치.\n *\n * **왜 메모리에서 하는가**: 이 프레임워크는 5개 DB 드라이버를 지원한다. 대소문자 무시 검색은\n * 드라이버마다 표기가 갈리고(ILIKE=pg 전용, LOWER()+LIKE 는 되지만 정렬·NULL 취급이 또 갈린다),\n * 목록 경로에 드라이버별 SQL 을 두는 것은 이 프로젝트의 규율에 반한다. 그래서 조회는 앵커로\n * **상한을 두고** 가져오고(아래 INBOX_SCAN_CAP) 걸러내기·정렬·페이지는 여기서 한다.\n * 상한을 넘으면 잘렸다는 사실을 그대로 알린다(조용히 일부만 보여주지 않는다).\n */\n/** What the conversation list is narrowed by - the manager's filters (design/ai/shared-dock.md §2-6). */\nexport interface InboxFilter {\n  /** Only this conversation kind (mode). Absent: every kind on the anchor. */\n  kind?: string | null\n  /** Only the ones I started. */\n  mineOnly?: boolean | null\n  /** Only the ones I am in (owner or member). */\n  participantOnly?: boolean | null\n  /** Only 'open' or only 'private'. */\n  visibility?: string | null\n  /** Only the ones with activity I have not read. */\n  unreadOnly?: boolean | null\n}\n\n/**\n * Narrow the list. Pure - the resolver builds the entries (with the reader's gate already applied) and\n * this decides only what the person asked to see. A session from before the kind column has no kind:\n * it is shown under every kind, so it is never lost from the list it was started in.\n */\nexport function filterInbox<T extends InboxEntry & { mine?: boolean }>(entries: T[], filter: InboxFilter = {}): T[] {\n  return entries.filter(entry => {\n    if (filter.kind && entry.kind && entry.kind !== filter.kind) return false\n    if (filter.mineOnly && !entry.mine) return false\n    if (filter.participantOnly && !entry.participant) return false\n    if (filter.visibility && (entry.visibility ?? 'open') !== filter.visibility) return false\n    if (filter.unreadOnly && !entry.unread) return false\n    return true\n  })\n}\n\nexport function searchInbox(entries: InboxEntry[], search?: string): InboxEntry[] {\n  const q = (search ?? '').trim().toLowerCase()\n  if (!q) return entries\n  return entries.filter(e =>\n    `${e.name ?? ''}\\n${e.lastMessagePreview ?? ''}`.toLowerCase().includes(q)\n  )\n}\n\n/** 한 번에 훑는 세션 상한 — 이보다 많으면 잘렸다고 알린다(정직). */\nexport const INBOX_SCAN_CAP = 500\n\n/** 안 읽은 세션 수 — 도크 버튼 배지(개수가 아니라 **세션 수**). */\nexport function countUnreadSessions(entries: InboxEntry[]): number {\n  return entries.filter(e => e.unread).length\n}\n\n/**\n * 메시지 저장 시 세션에 반영할 활동 값. 미리보기는 짧게 자르고 개행을 없앤다\n * (목록 한 줄에 들어가야 하고, 컬럼 길이 제한이 있다).\n */\nexport function activityPatch(\n  content: string,\n  at: Date = new Date(),\n  doors: string[] = []\n): { lastMessageAt: Date; lastMessagePreview: string; lastMessageDoors: string[] } {\n  const flat = (content ?? '').replace(/\\s+/g, ' ').trim()\n  /* 미리보기가 어느 문을 지나온 값인지 함께 적는다 — 목록도 같은 관문을 지난다(ADR-0073 판정 1). */\n  return { lastMessageAt: at, lastMessagePreview: flat.slice(0, 200), lastMessageDoors: doors }\n}\n\n/**\n * 첫 발화로 세션 이름을 만든다.\n *\n * `세션 2` 같은 순번은 목록에서 아무것도 알려주지 않는다 — \"A-DC 포화 원인\" 이어야 돌아갈 대화를 찾는다.\n * 사용자가 직접 지은 이름은 이 함수로 덮지 않는다(호출부가 이름 없을 때만 부른다).\n *\n * 규칙: 한 줄로 눌러 첫 문장 경계(., ?, !, 개행)까지, 최대 40자. 문장 부호로 끝나면 떼어 낸다\n * (목록 제목에 물음표가 붙으면 길이만 먹는다).\n */\nexport function autoSessionName(content: string, max = 40): string {\n  const flat = (content ?? '').replace(/\\s+/g, ' ').trim()\n  if (!flat) return ''\n  const cut = flat.search(/[.?!\\n]/)\n  const head = (cut > 0 ? flat.slice(0, cut) : flat).trim()\n  const name = head.length > max ? head.slice(0, max).trim() + '…' : head\n  return name\n}\n"]}

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

@@ -0,0 +1,14 @@
+export { DEFAULT_RETENTION_DAYS, purgeCutoff, retentionDaysOf } from './session-retention.js';
+/** How many conversations one run empties - a large backlog is worked off over several runs. */
+export declare const PURGE_BATCH = 100;
+export interface PurgeResult {
+    purged: number;
+    failed: {
+        sessionId: string;
+        message: string;
+    }[];
+}
+/** Empties the conversations whose deletion is older than the retention period. */
+export declare function purgeDeletedSessions(now?: Date, retentionDays?: number): Promise<PurgeResult>;
+/** Runs the job once a little after boot, then daily. The timer never keeps the process alive. */
+export declare function schedulePurge(): void;

package/dist-server/service/chat-session/session-purge.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PURGE_BATCH = exports.retentionDaysOf = exports.purgeCutoff = exports.DEFAULT_RETENTION_DAYS = void 0;
+exports.purgeDeletedSessions = purgeDeletedSessions;
+exports.schedulePurge = schedulePurge;
+/*
+ * Emptying deleted conversations after they have been kept long enough - design/ai/shared-dock.md §9-5.
+ *
+ * `deleteAISession` is a soft delete: from that moment nobody can open the conversation or its files
+ * (every door checks the session), and within the retention period it can still be brought back whole.
+ * Nothing ever emptied them afterwards, so a deleted conversation's messages - and now its files - stayed
+ * forever (2026-09-25). This job removes a conversation, its messages, its participants and its attached
+ * files together once the retention period has passed.
+ *
+ * Retention: config `ai-assistant.sessionRetentionDays`, default 30. `0` or `false` turns the job off.
+ */
+const env_1 = require("@things-factory/env");
+const shell_1 = require("@things-factory/shell");
+const typeorm_1 = require("typeorm");
+const chat_message_js_1 = require("../chat-message/chat-message.js");
+const chat_session_participant_js_1 = require("../chat-session-participant/chat-session-participant.js");
+const chat_session_js_1 = require("./chat-session.js");
+const session_attachments_js_1 = require("./session-attachments.js");
+const session_retention_js_1 = require("./session-retention.js");
+var session_retention_js_2 = require("./session-retention.js");
+Object.defineProperty(exports, "DEFAULT_RETENTION_DAYS", { enumerable: true, get: function () { return session_retention_js_2.DEFAULT_RETENTION_DAYS; } });
+Object.defineProperty(exports, "purgeCutoff", { enumerable: true, get: function () { return session_retention_js_2.purgeCutoff; } });
+Object.defineProperty(exports, "retentionDaysOf", { enumerable: true, get: function () { return session_retention_js_2.retentionDaysOf; } });
+/** How many conversations one run empties - a large backlog is worked off over several runs. */
+exports.PURGE_BATCH = 100;
+/** Empties the conversations whose deletion is older than the retention period. */
+async function purgeDeletedSessions(now = new Date(), retentionDays = (0, session_retention_js_1.retentionDaysOf)(env_1.config.get('ai-assistant', {})?.sessionRetentionDays)) {
+    const result = { purged: 0, failed: [] };
+    if (retentionDays === null)
+        return result;
+    const sessions = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession).find({
+        where: { deletedAt: (0, typeorm_1.LessThan)((0, session_retention_js_1.purgeCutoff)(now, retentionDays)) },
+        withDeleted: true,
+        relations: ['domain'],
+        take: exports.PURGE_BATCH
+    });
+    for (const session of sessions) {
+        try {
+            await (0, session_attachments_js_1.removeSessionFiles)(session);
+            /* Messages point at each other (parentMessage) - drop the links before the rows. */
+            await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage).update({ session: { id: session.id }, parentMessage: (0, typeorm_1.Not)((0, typeorm_1.IsNull)()) }, { parentMessage: null });
+            await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage).delete({ session: { id: session.id } });
+            await (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant).delete({ session: { id: session.id } });
+            /* Board patches and anything else hanging on the session go with it (ON DELETE CASCADE). */
+            await (0, shell_1.getRepository)(chat_session_js_1.ChatSession).delete({ id: (0, typeorm_1.In)([session.id]) });
+            result.purged++;
+        }
+        catch (error) {
+            /* One conversation that cannot be emptied must not stop the rest; it is tried again next run. */
+            result.failed.push({ sessionId: session.id, message: error.message });
+        }
+    }
+    return result;
+}
+let timer;
+/** Runs the job once a little after boot, then daily. The timer never keeps the process alive. */
+function schedulePurge() {
+    if (timer)
+        return;
+    const run = () => purgeDeletedSessions()
+        .then(({ purged, failed }) => {
+        if (purged || failed.length)
+            console.info(`[ai-assistant] purged ${purged} deleted conversation(s)`, failed.length ? { failed } : '');
+    })
+        .catch(error => console.warn('[ai-assistant] purging deleted conversations failed:', error.message));
+    const first = setTimeout(run, 60 * 1000);
+    first.unref?.();
+    timer = setInterval(run, session_retention_js_1.DAY_MS);
+    timer.unref?.();
+}
+process.on('bootstrap-module-start', () => schedulePurge());
+//# sourceMappingURL=session-purge.js.map

package/dist-server/service/chat-session/session-purge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-purge.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-purge.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Emptying deleted conversations after they have been kept long enough - design/ai/shared-dock.md §9-5.\n *\n * `deleteAISession` is a soft delete: from that moment nobody can open the conversation or its files\n * (every door checks the session), and within the retention period it can still be brought back whole.\n * Nothing ever emptied them afterwards, so a deleted conversation's messages - and now its files - stayed\n * forever (2026-09-25). This job removes a conversation, its messages, its participants and its attached\n * files together once the retention period has passed.\n *\n * Retention: config `ai-assistant.sessionRetentionDays`, default 30. `0` or `false` turns the job off.\n */\nimport { config } from '@things-factory/env'\nimport { getRepository } from '@things-factory/shell'\nimport { In, IsNull, LessThan, Not } from 'typeorm'\n\nimport { ChatMessage } from '../chat-message/chat-message.js'\nimport { ChatSessionParticipant } from '../chat-session-participant/chat-session-participant.js'\nimport { ChatSession } from './chat-session.js'\nimport { removeSessionFiles } from './session-attachments.js'\n\nimport { DAY_MS, purgeCutoff, retentionDaysOf } from './session-retention.js'\n\nexport { DEFAULT_RETENTION_DAYS, purgeCutoff, retentionDaysOf } from './session-retention.js'\n/** How many conversations one run empties - a large backlog is worked off over several runs. */\nexport const PURGE_BATCH = 100\n\nexport interface PurgeResult {\n  purged: number\n  failed: { sessionId: string; message: string }[]\n}\n\n/** Empties the conversations whose deletion is older than the retention period. */\nexport async function purgeDeletedSessions(now = new Date(), retentionDays = retentionDaysOf(config.get('ai-assistant', {})?.sessionRetentionDays)): Promise<PurgeResult> {\n  const result: PurgeResult = { purged: 0, failed: [] }\n  if (retentionDays === null) return result\n\n  const sessions = await getRepository(ChatSession).find({\n    where: { deletedAt: LessThan(purgeCutoff(now, retentionDays)) } as any,\n    withDeleted: true,\n    relations: ['domain'],\n    take: PURGE_BATCH\n  })\n\n  for (const session of sessions) {\n    try {\n      await removeSessionFiles(session as any)\n      /* Messages point at each other (parentMessage) - drop the links before the rows. */\n      await getRepository(ChatMessage).update({ session: { id: session.id }, parentMessage: Not(IsNull()) } as any, { parentMessage: null } as any)\n      await getRepository(ChatMessage).delete({ session: { id: session.id } } as any)\n      await getRepository(ChatSessionParticipant).delete({ session: { id: session.id } } as any)\n      /* Board patches and anything else hanging on the session go with it (ON DELETE CASCADE). */\n      await getRepository(ChatSession).delete({ id: In([session.id]) } as any)\n      result.purged++\n    } catch (error) {\n      /* One conversation that cannot be emptied must not stop the rest; it is tried again next run. */\n      result.failed.push({ sessionId: session.id!, message: (error as Error).message })\n    }\n  }\n\n  return result\n}\n\nlet timer: ReturnType<typeof setInterval> | undefined\n\n/** Runs the job once a little after boot, then daily. The timer never keeps the process alive. */\nexport function schedulePurge(): void {\n  if (timer) return\n  const run = () =>\n    purgeDeletedSessions()\n      .then(({ purged, failed }) => {\n        if (purged || failed.length) console.info(`[ai-assistant] purged ${purged} deleted conversation(s)`, failed.length ? { failed } : '')\n      })\n      .catch(error => console.warn('[ai-assistant] purging deleted conversations failed:', (error as Error).message))\n\n  const first = setTimeout(run, 60 * 1000)\n  first.unref?.()\n  timer = setInterval(run, DAY_MS)\n  timer.unref?.()\n}\n\nprocess.on('bootstrap-module-start' as any, () => schedulePurge())\n"]}

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

@@ -0,0 +1,6 @@
+export declare const DAY_MS: number;
+export declare const DEFAULT_RETENTION_DAYS = 30;
+/** The retention the config asks for: a positive number of days, `null` when the job is off, the default when unreadable. */
+export declare function retentionDaysOf(value: unknown): number | null;
+/** Conversations deleted before this moment are due. */
+export declare function purgeCutoff(now: Date, retentionDays: number): Date;

package/dist-server/service/chat-session/session-retention.js

@@ -0,0 +1,20 @@
+"use strict";
+/* How long a deleted conversation is kept before it is emptied - pure, tested alone (shared-dock.md §9-5). */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETENTION_DAYS = exports.DAY_MS = void 0;
+exports.retentionDaysOf = retentionDaysOf;
+exports.purgeCutoff = purgeCutoff;
+exports.DAY_MS = 24 * 60 * 60 * 1000;
+exports.DEFAULT_RETENTION_DAYS = 30;
+/** The retention the config asks for: a positive number of days, `null` when the job is off, the default when unreadable. */
+function retentionDaysOf(value) {
+    if (value === false || value === 0 || value === '0')
+        return null;
+    const days = Number(value);
+    return Number.isFinite(days) && days > 0 ? days : exports.DEFAULT_RETENTION_DAYS;
+}
+/** Conversations deleted before this moment are due. */
+function purgeCutoff(now, retentionDays) {
+    return new Date(now.getTime() - retentionDays * exports.DAY_MS);
+}
+//# sourceMappingURL=session-retention.js.map

package/dist-server/service/chat-session/session-retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-retention.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-retention.ts"],"names":[],"mappings":";AAAA,8GAA8G;;;AAM9G,0CAIC;AAGD,kCAEC;AAbY,QAAA,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAC5B,QAAA,sBAAsB,GAAG,EAAE,CAAA;AAExC,6HAA6H;AAC7H,SAAgB,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,8BAAsB,CAAA;AAC1E,CAAC;AAED,wDAAwD;AACxD,SAAgB,WAAW,CAAC,GAAS,EAAE,aAAqB;IAC1D,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,aAAa,GAAG,cAAM,CAAC,CAAA;AACzD,CAAC","sourcesContent":["/* How long a deleted conversation is kept before it is emptied - pure, tested alone (shared-dock.md §9-5). */\n\nexport const DAY_MS = 24 * 60 * 60 * 1000\nexport const DEFAULT_RETENTION_DAYS = 30\n\n/** The retention the config asks for: a positive number of days, `null` when the job is off, the default when unreadable. */\nexport function retentionDaysOf(value: unknown): number | null {\n  if (value === false || value === 0 || value === '0') return null\n  const days = Number(value)\n  return Number.isFinite(days) && days > 0 ? days : DEFAULT_RETENTION_DAYS\n}\n\n/** Conversations deleted before this moment are due. */\nexport function purgeCutoff(now: Date, retentionDays: number): Date {\n  return new Date(now.getTime() - retentionDays * DAY_MS)\n}\n\n"]}

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

@@ -13,3 +13,11 @@ export declare function initialVisibility(session: {
 }): SessionVisibility;
 /** 이 사람이 이 대화를 읽을 수 있나. open 이면 도메인 안 누구나, private 이면 참여자만. */
 export declare function mayReadSession(visibility: string | null | undefined, isParticipant: boolean): boolean;
+/**
+ * 이 사람이 이 대화에 **쓸** 수 있나 — 읽을 수 있는 사람만 쓴다.
+ *
+ * 읽는 문(`chatMessages`)과 목록만 막고 쓰는 문을 열어 두면, 비공개 대화의 id 를 가진 사람이 그 안에 말을
+ * 넣을 수 있었다. `assistantChat` 에서는 더 나쁘다 — 답이 그 대화의 이력 위에서 만들어지므로, 읽을 수 없는
+ * 내용이 답으로 새어 나간다(2026-09-24, operato-ecs 두 사람 시험 7번). 쓰는 문도 같은 관문을 지난다.
+ */
+export declare function mayWriteSession(visibility: string | null | undefined, isParticipant: boolean): boolean;

package/dist-server/service/chat-session/session-visibility.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SESSION_VISIBILITIES = void 0;
 exports.initialVisibility = initialVisibility;
 exports.mayReadSession = mayReadSession;
+exports.mayWriteSession = mayWriteSession;
 exports.SESSION_VISIBILITIES = ['open', 'private'];
 /**
  * 이렇게 만들어진 세션은 무엇으로 시작하나.
@@ -32,4 +33,14 @@ function initialVisibility(session) {
 function mayReadSession(visibility, isParticipant) {
     return (visibility ?? 'open') === 'open' || isParticipant;
 }
+/**
+ * 이 사람이 이 대화에 **쓸** 수 있나 — 읽을 수 있는 사람만 쓴다.
+ *
+ * 읽는 문(`chatMessages`)과 목록만 막고 쓰는 문을 열어 두면, 비공개 대화의 id 를 가진 사람이 그 안에 말을
+ * 넣을 수 있었다. `assistantChat` 에서는 더 나쁘다 — 답이 그 대화의 이력 위에서 만들어지므로, 읽을 수 없는
+ * 내용이 답으로 새어 나간다(2026-09-24, operato-ecs 두 사람 시험 7번). 쓰는 문도 같은 관문을 지난다.
+ */
+function mayWriteSession(visibility, isParticipant) {
+    return mayReadSession(visibility, isParticipant);
+}
 //# sourceMappingURL=session-visibility.js.map

package/dist-server/service/chat-session/session-visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-visibility.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-visibility.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAaH,8CAWC;AAGD,wCAEC;AAzBY,QAAA,oBAAoB,GAAiC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAErF;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,OAA+D;IAC/F,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAEpC;;;;;OAKG;IACH,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,MAAM,CAAA;IACtE,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACtC,CAAC;AAED,+DAA+D;AAC/D,SAAgB,cAAc,CAAC,UAAqC,EAAE,aAAsB;IAC1F,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,MAAM,IAAI,aAAa,CAAA;AAC3D,CAAC","sourcesContent":["/*\n * 새 대화가 공개로 태어나는가 — ADR-0073 판정 2.\n *\n * 판정을 세션을 만드는 자리마다 적으면 한 곳이 빠진 날 그 세션만 다른 규칙으로 산다. 한 줄로 모은다.\n */\n\nexport type SessionVisibility = 'open' | 'private'\n\nexport const SESSION_VISIBILITIES: readonly SessionVisibility[] = ['open', 'private']\n\n/**\n * 이렇게 만들어진 세션은 무엇으로 시작하나.\n *\n * 앵커가 있으면 공유된 대상을 놓고 하는 이야기다 — 공개. 앵커가 없거나 앞선 대화를 옮겨 적어 만든\n * 것이면 비공개. `copyOf` 가 있다는 것은 다른 대화의 원문이 이 안에 들어왔다는 뜻이고, 그 원문은\n * 자기가 있던 자리의 규칙으로 쓰였다.\n */\nexport function initialVisibility(session: { anchorType?: string | null; copyOf?: string | null }): SessionVisibility {\n  if (session.copyOf) return 'private'\n\n  /*\n   * `'none'` 은 **앵커가 아니다.** 저장되는 앵커 종류 목록에 그 글자가 들어 있어서(`session-anchor.ts`\n   * — 대상이 없다는 것도 행에 적어야 하므로), 「값이 있으면 앵커가 있다」로 읽으면 대상 없는 개인 질문이\n   * 공개 방으로 태어난다. ADR-0073 결정 2 가 그것을 `private` 로 못박았다 — 「앵커 없는 세션(`twin.none`\n   * 같은 개인 질문)」.\n   */\n  const anchored = !!session.anchorType && session.anchorType !== 'none'\n  return anchored ? 'open' : 'private'\n}\n\n/** 이 사람이 이 대화를 읽을 수 있나. open 이면 도메인 안 누구나, private 이면 참여자만. */\nexport function mayReadSession(visibility: string | null | undefined, isParticipant: boolean): boolean {\n  return (visibility ?? 'open') === 'open' || isParticipant\n}\n"]}
+{"version":3,"file":"session-visibility.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-visibility.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAaH,8CAWC;AAGD,wCAEC;AASD,0CAEC;AApCY,QAAA,oBAAoB,GAAiC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAErF;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,OAA+D;IAC/F,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAEpC;;;;;OAKG;IACH,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,MAAM,CAAA;IACtE,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACtC,CAAC;AAED,+DAA+D;AAC/D,SAAgB,cAAc,CAAC,UAAqC,EAAE,aAAsB;IAC1F,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,MAAM,IAAI,aAAa,CAAA;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,UAAqC,EAAE,aAAsB;IAC3F,OAAO,cAAc,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;AAClD,CAAC","sourcesContent":["/*\n * 새 대화가 공개로 태어나는가 — ADR-0073 판정 2.\n *\n * 판정을 세션을 만드는 자리마다 적으면 한 곳이 빠진 날 그 세션만 다른 규칙으로 산다. 한 줄로 모은다.\n */\n\nexport type SessionVisibility = 'open' | 'private'\n\nexport const SESSION_VISIBILITIES: readonly SessionVisibility[] = ['open', 'private']\n\n/**\n * 이렇게 만들어진 세션은 무엇으로 시작하나.\n *\n * 앵커가 있으면 공유된 대상을 놓고 하는 이야기다 — 공개. 앵커가 없거나 앞선 대화를 옮겨 적어 만든\n * 것이면 비공개. `copyOf` 가 있다는 것은 다른 대화의 원문이 이 안에 들어왔다는 뜻이고, 그 원문은\n * 자기가 있던 자리의 규칙으로 쓰였다.\n */\nexport function initialVisibility(session: { anchorType?: string | null; copyOf?: string | null }): SessionVisibility {\n  if (session.copyOf) return 'private'\n\n  /*\n   * `'none'` 은 **앵커가 아니다.** 저장되는 앵커 종류 목록에 그 글자가 들어 있어서(`session-anchor.ts`\n   * — 대상이 없다는 것도 행에 적어야 하므로), 「값이 있으면 앵커가 있다」로 읽으면 대상 없는 개인 질문이\n   * 공개 방으로 태어난다. ADR-0073 결정 2 가 그것을 `private` 로 못박았다 — 「앵커 없는 세션(`twin.none`\n   * 같은 개인 질문)」.\n   */\n  const anchored = !!session.anchorType && session.anchorType !== 'none'\n  return anchored ? 'open' : 'private'\n}\n\n/** 이 사람이 이 대화를 읽을 수 있나. open 이면 도메인 안 누구나, private 이면 참여자만. */\nexport function mayReadSession(visibility: string | null | undefined, isParticipant: boolean): boolean {\n  return (visibility ?? 'open') === 'open' || isParticipant\n}\n\n/**\n * 이 사람이 이 대화에 **쓸** 수 있나 — 읽을 수 있는 사람만 쓴다.\n *\n * 읽는 문(`chatMessages`)과 목록만 막고 쓰는 문을 열어 두면, 비공개 대화의 id 를 가진 사람이 그 안에 말을\n * 넣을 수 있었다. `assistantChat` 에서는 더 나쁘다 — 답이 그 대화의 이력 위에서 만들어지므로, 읽을 수 없는\n * 내용이 답으로 새어 나간다(2026-09-24, operato-ecs 두 사람 시험 7번). 쓰는 문도 같은 관문을 지난다.\n */\nexport function mayWriteSession(visibility: string | null | undefined, isParticipant: boolean): boolean {\n  return mayReadSession(visibility, isParticipant)\n}\n"]}

package/dist-server/service/chat-session/session-write-gate.d.ts

@@ -0,0 +1,11 @@
+export interface WriteGateInput {
+    session: {
+        id?: string;
+        visibility?: string | null;
+    };
+    userId?: string;
+    /** Is this user a participant of the session (owner or member)? Asked only for a private one. */
+    isParticipant: () => Promise<boolean>;
+    t: (key: string, options?: Record<string, unknown>) => string;
+}
+export declare function assertMayWriteSession({ session, userId, isParticipant, t }: WriteGateInput): Promise<void>;

package/dist-server/service/chat-session/session-write-gate.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertMayWriteSession = assertMayWriteSession;
+/*
+ * The gate every door that writes into a conversation passes - ADR-0073 decision 1, applied to writing.
+ *
+ * `mayWriteSession` is the rule; this looks up only what the rule needs (whether the writer is in the
+ * room, and only for a private conversation) and refuses by a named message. Kept apart from the resolvers
+ * so the five write doors call one line and cannot drift.
+ */
+const session_visibility_js_1 = require("./session-visibility.js");
+async function assertMayWriteSession({ session, userId, isParticipant, t }) {
+    const visibility = session.visibility ?? 'open';
+    /* A public conversation is open to everyone in the domain - no lookup. */
+    if (visibility === 'open')
+        return;
+    const participant = !!userId && (await isParticipant());
+    if (!(0, session_visibility_js_1.mayWriteSession)(visibility, participant)) {
+        throw new Error(t('ai-assistant.text.private-session-refused', {
+            defaultValue: 'this conversation is private - only the people in it can write here. ask one of them to bring you in.'
+        }));
+    }
+}
+//# sourceMappingURL=session-write-gate.js.map

package/dist-server/service/chat-session/session-write-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-write-gate.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-write-gate.ts"],"names":[],"mappings":";;AAiBA,sDAaC;AA9BD;;;;;;GAMG;AACH,mEAAyD;AAUlD,KAAK,UAAU,qBAAqB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,EAAkB;IAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAA;IAC/C,0EAA0E;IAC1E,IAAI,UAAU,KAAK,MAAM;QAAE,OAAM;IAEjC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,aAAa,EAAE,CAAC,CAAA;IACvD,IAAI,CAAC,IAAA,uCAAe,EAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,CAAC,CAAC,2CAA2C,EAAE;YAC7C,YAAY,EAAE,uGAAuG;SACtH,CAAC,CACH,CAAA;IACH,CAAC;AACH,CAAC","sourcesContent":["/*\n * The gate every door that writes into a conversation passes - ADR-0073 decision 1, applied to writing.\n *\n * `mayWriteSession` is the rule; this looks up only what the rule needs (whether the writer is in the\n * room, and only for a private conversation) and refuses by a named message. Kept apart from the resolvers\n * so the five write doors call one line and cannot drift.\n */\nimport { mayWriteSession } from './session-visibility.js'\n\nexport interface WriteGateInput {\n  session: { id?: string; visibility?: string | null }\n  userId?: string\n  /** Is this user a participant of the session (owner or member)? Asked only for a private one. */\n  isParticipant: () => Promise<boolean>\n  t: (key: string, options?: Record<string, unknown>) => string\n}\n\nexport async function assertMayWriteSession({ session, userId, isParticipant, t }: WriteGateInput): Promise<void> {\n  const visibility = session.visibility ?? 'open'\n  /* A public conversation is open to everyone in the domain - no lookup. */\n  if (visibility === 'open') return\n\n  const participant = !!userId && (await isParticipant())\n  if (!mayWriteSession(visibility, participant)) {\n    throw new Error(\n      t('ai-assistant.text.private-session-refused', {\n        defaultValue: 'this conversation is private - only the people in it can write here. ask one of them to bring you in.'\n      })\n    )\n  }\n}\n"]}

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

@@ -24,4 +24,4 @@ export interface Inviter {
  * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.
  * 받는 사람이 없으면 null (= 보낼 것 없음).
  */
-export declare function buildInviteNotification(userIds: string[], boardId: string | undefined, inviter: Inviter | undefined | null): InviteNotification | null;
+export declare function buildInviteNotification(userIds: string[], boardId: string | undefined, inviter: Inviter | undefined | null, sessionName?: string | null): InviteNotification | null;