@things-factory/ai-assistant 10.1.213 → 10.1.215

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

@@ -20,6 +20,7 @@ exports.INBOX_SCAN_CAP = void 0;
 exports.buildInbox = buildInbox;
 exports.applyHidden = applyHidden;
 exports.filterInbox = filterInbox;
+exports.listedEntries = listedEntries;
 exports.searchInbox = searchInbox;
 exports.searchReadableMessages = searchReadableMessages;
 exports.countUnreadSessions = countUnreadSessions;
@@ -117,6 +118,16 @@ function filterInbox(entries, filter = {}) {
         return true;
     });
 }
+/**
+ * Which entries the list stands on before its filters (shared-dock.md §2-7): the suggestions to clear are every
+ * candidate, hidden or archived; otherwise a hidden one waits for its filter, and an archived one for its filter or a
+ * search - finding an old conversation by a word is how it is mostly looked for.
+ */
+function listedEntries(entries, opts = {}) {
+    if (opts.cleanupOnly)
+        return entries.filter(entry => entry.cleanupReason);
+    return entries.filter(entry => (opts.showHidden || !entry.hidden) && (opts.includeArchived || !!opts.search?.trim() || !entry.archived));
+}
 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\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/** Only readable user/assistant prose participates; never match a redaction notice or execution log. */\nexport function searchReadableMessages(rows: readonly { sessionId?: string; content?: string; role?: string; redacted?: boolean }[], search: string): Set<string> {\n  const q = search.trim().toLowerCase()\n  return new Set(rows.filter(row => q && !row.redacted && (row.role === 'user' || row.role === 'assistant') && row.content?.toLowerCase().includes(q))\n    .map(row => row.sessionId).filter((id): id is string => !!id))\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":";AAAA;;;;;;;;;;;;;;;GAeG;;;AA8DH,gCAkCC;AAWD,kCAUC;AA8BD,kCASC;AAOD,sCAMC;AAED,kCAMC;AAGD,wDAIC;AAMD,kDAEC;AAMD,sCAQC;AAWD,0CAOC;AA9ND,mEAAwD;AA2CxD,SAAS,IAAI,CAAC,CAAmC;IAC/C,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAA;IAChB,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACzD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,UAAU,CAAC,QAA2B,EAAE,IAAuB;IAC7E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAA;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,CAAC,SAAS;YAAE,SAAQ;QAC1B,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;QAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ;QACtB;;;WAGG;SACF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,IAAA,sCAAc,EAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;SAC1F,GAAG,CAAC,OAAO,CAAC,EAAE;QACb,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,CAAA;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QAC5C,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO;YACL,GAAG,OAAO;YACV,WAAW;YACX,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;YACxC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,EAAE,WAAW,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,IAAI;SACvD,CAAA;IACH,CAAC,CAAC,CAAA;IAEJ,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACtG,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,OAAqB,EAAE,QAAuD,EAAE,UAAU,GAAG,KAAK;IAC5H,MAAM,GAAG,GAAiB,EAAE,CAAA;IAC5B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;QACvC,2CAA2C;QAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5D,IAAI,MAAM,IAAI,CAAC,UAAU;YAAE,SAAQ;QACnC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAyBD;;;;GAIG;AACH,SAAgB,WAAW,CAA4C,OAAY,EAAE,SAAsB,EAAE;IAC3G,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC5B,IAAI,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QACzE,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QAChD,IAAI,MAAM,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,WAAW;YAAE,OAAO,KAAK,CAAA;QAC9D,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,MAAM,CAAC,UAAU;YAAE,OAAO,KAAK,CAAA;QACzF,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QACpD,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAC3B,OAAY,EACZ,OAAgI,EAAE;IAElI,IAAI,IAAI,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IACzE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC1I,CAAC;AAED,SAAgB,WAAW,CAAC,OAAqB,EAAE,MAAe;IAChE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7C,IAAI,CAAC,CAAC;QAAE,OAAO,OAAO,CAAA;IACtB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxB,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC3E,CAAA;AACH,CAAC;AAED,wGAAwG;AACxG,SAAgB,sBAAsB,CAAC,IAA4F,EAAE,MAAc;IACjJ,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACrC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SACjJ,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAClE,CAAC;AAED,4CAA4C;AAC/B,QAAA,cAAc,GAAG,GAAG,CAAA;AAEjC,8CAA8C;AAC9C,SAAgB,mBAAmB,CAAC,OAAqB;IACvD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAA;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAC3B,OAAe,EACf,KAAW,IAAI,IAAI,EAAE,EACrB,QAAkB,EAAE;IAEpB,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACxD,iEAAiE;IACjE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAA;AAC/F,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,OAAe,EAAE,GAAG,GAAG,EAAE;IACvD,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;IACvE,OAAO,IAAI,CAAA;AACb,CAAC","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\n/**\n * Which entries the list stands on before its filters (shared-dock.md §2-7): the suggestions to clear are every\n * candidate, hidden or archived; otherwise a hidden one waits for its filter, and an archived one for its filter or a\n * search - finding an old conversation by a word is how it is mostly looked for.\n */\nexport function listedEntries<T extends { hidden?: boolean; archived?: boolean; cleanupReason?: string | null }>(\n  entries: T[],\n  opts: { showHidden?: boolean | null; includeArchived?: boolean | null; cleanupOnly?: boolean | null; search?: string | null } = {}\n): T[] {\n  if (opts.cleanupOnly) return entries.filter(entry => entry.cleanupReason)\n  return entries.filter(entry => (opts.showHidden || !entry.hidden) && (opts.includeArchived || !!opts.search?.trim() || !entry.archived))\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/** Only readable user/assistant prose participates; never match a redaction notice or execution log. */\nexport function searchReadableMessages(rows: readonly { sessionId?: string; content?: string; role?: string; redacted?: boolean }[], search: string): Set<string> {\n  const q = search.trim().toLowerCase()\n  return new Set(rows.filter(row => q && !row.redacted && (row.role === 'user' || row.role === 'assistant') && row.content?.toLowerCase().includes(q))\n    .map(row => row.sessionId).filter((id): id is string => !!id))\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

@@ -3,11 +3,15 @@ export { DEFAULT_RETENTION_DAYS, purgeCutoff, retentionDaysOf } from './session-
 export declare const PURGE_BATCH = 100;
 export interface PurgeResult {
     purged: number;
+    /** Empty conversations removed - never asked anything, and nobody opened them for a day. */
+    emptied: number;
     failed: {
         sessionId: string;
         message: string;
     }[];
 }
+/** Removes the empty conversations nobody opened for EMPTY_DAYS. Each is checked against its messages and seats, not the denormalized activity alone. */
+export declare function removeEmptySessions(now?: Date, result?: PurgeResult): Promise<PurgeResult>;
 /** 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. */

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PURGE_BATCH = exports.retentionDaysOf = exports.purgeCutoff = exports.DEFAULT_RETENTION_DAYS = void 0;
+exports.removeEmptySessions = removeEmptySessions;
 exports.purgeDeletedSessions = purgeDeletedSessions;
 exports.schedulePurge = schedulePurge;
 /*
@@ -13,6 +14,9 @@ exports.schedulePurge = schedulePurge;
  * files together once the retention period has passed.
  *
  * Retention: config `ai-assistant.sessionRetentionDays`, default 30. `0` or `false` turns the job off.
+ *
+ * The same run removes empty conversations nobody opened for a day (`session-cleanup.ts`, shared-dock.md §2-7) -
+ * 「새 대화」 starts a row before its first question, and one never asked stays in the list otherwise.
  */
 const env_1 = require("@things-factory/env");
 const shell_1 = require("@things-factory/shell");
@@ -22,15 +26,50 @@ const chat_session_participant_js_1 = require("../chat-session-participant/chat-
 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");
+const session_cleanup_js_1 = require("./session-cleanup.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;
+/** A conversation, its messages, its participants and its files, gone together. */
+async function removeConversation(session) {
+    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]) });
+}
+/** Removes the empty conversations nobody opened for EMPTY_DAYS. Each is checked against its messages and seats, not the denormalized activity alone. */
+async function removeEmptySessions(now = new Date(), result = { purged: 0, emptied: 0, failed: [] }) {
+    const sessions = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession).find({
+        where: { lastMessageAt: (0, typeorm_1.IsNull)(), createdAt: (0, typeorm_1.LessThan)(new Date(now.getTime() - session_cleanup_js_1.EMPTY_DAYS * session_retention_js_1.DAY_MS)) },
+        relations: ['domain'],
+        take: exports.PURGE_BATCH
+    });
+    for (const session of sessions) {
+        try {
+            const messages = await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage).count({ where: { session: { id: session.id } } });
+            const seats = await (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant).find({ where: { session: { id: session.id } }, withDeleted: true });
+            const touched = seats.flatMap(seat => [seat.updatedAt, seat.lastReadAt]).filter(Boolean);
+            const lastTouchedAt = touched.length ? new Date(Math.max(...touched.map(at => new Date(at).getTime()))) : null;
+            if (!(0, session_cleanup_js_1.emptyAndAbandoned)({ ...session, messages, lastTouchedAt }, now))
+                continue;
+            await removeConversation(session);
+            result.emptied++;
+        }
+        catch (error) {
+            result.failed.push({ sessionId: session.id, message: error.message });
+        }
+    }
+    return result;
+}
 /** 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: [] };
+    const result = { purged: 0, emptied: 0, failed: [] };
     if (retentionDays === null)
         return result;
     const sessions = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession).find({
@@ -41,13 +80,7 @@ async function purgeDeletedSessions(now = new Date(), retentionDays = (0, sessio
     });
     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]) });
+            await removeConversation(session);
             result.purged++;
         }
         catch (error) {
@@ -63,9 +96,10 @@ 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 } : '');
+        .then(result => removeEmptySessions(new Date(), result))
+        .then(({ purged, emptied, failed }) => {
+        if (purged || emptied || failed.length)
+            console.info(`[ai-assistant] purged ${purged} deleted and ${emptied} empty conversation(s)`, failed.length ? { failed } : '');
     })
         .catch(error => console.warn('[ai-assistant] purging deleted conversations failed:', error.message));
     const first = setTimeout(run, 60 * 1000);

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

@@ -1 +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"]}
+{"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 *\n * The same run removes empty conversations nobody opened for a day (`session-cleanup.ts`, shared-dock.md §2-7) -\n * 「새 대화」 starts a row before its first question, and one never asked stays in the list otherwise.\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'\nimport { EMPTY_DAYS, emptyAndAbandoned } from './session-cleanup.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  /** Empty conversations removed - never asked anything, and nobody opened them for a day. */\n  emptied: number\n  failed: { sessionId: string; message: string }[]\n}\n\n/** A conversation, its messages, its participants and its files, gone together. */\nasync function removeConversation(session: ChatSession): Promise<void> {\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}\n\n/** Removes the empty conversations nobody opened for EMPTY_DAYS. Each is checked against its messages and seats, not the denormalized activity alone. */\nexport async function removeEmptySessions(now = new Date(), result: PurgeResult = { purged: 0, emptied: 0, failed: [] }): Promise<PurgeResult> {\n  const sessions = await getRepository(ChatSession).find({\n    where: { lastMessageAt: IsNull(), createdAt: LessThan(new Date(now.getTime() - EMPTY_DAYS * DAY_MS)) } as any,\n    relations: ['domain'],\n    take: PURGE_BATCH\n  })\n  for (const session of sessions) {\n    try {\n      const messages = await getRepository(ChatMessage).count({ where: { session: { id: session.id } } as any })\n      const seats = await getRepository(ChatSessionParticipant).find({ where: { session: { id: session.id } } as any, withDeleted: true })\n      const touched = seats.flatMap(seat => [seat.updatedAt, seat.lastReadAt]).filter(Boolean) as Date[]\n      const lastTouchedAt = touched.length ? new Date(Math.max(...touched.map(at => new Date(at).getTime()))) : null\n      if (!emptyAndAbandoned({ ...(session as any), messages, lastTouchedAt }, now)) continue\n      await removeConversation(session)\n      result.emptied++\n    } catch (error) {\n      result.failed.push({ sessionId: session.id!, message: (error as Error).message })\n    }\n  }\n  return result\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, emptied: 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 removeConversation(session)\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(result => removeEmptySessions(new Date(), result))\n      .then(({ purged, emptied, failed }) => {\n        if (purged || emptied || failed.length)\n          console.info(`[ai-assistant] purged ${purged} deleted and ${emptied} empty 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-resolver.d.ts

@@ -23,6 +23,20 @@ declare class ChatSessionInboxEntry {
     hidden?: boolean;
     visibility: string;
     owner: boolean;
+    archived?: boolean;
+    cleanupReason?: string;
+    idleDays?: number;
+}
+declare class DeletedSessionEntry {
+    id: string;
+    name?: string;
+    kind?: string;
+    deletedAt: Date;
+    purgesAt?: Date;
+}
+declare class SessionKeeping {
+    deletedDays?: number;
+    archiveDays?: number;
 }
 export declare class ChatAttachmentInfo {
     id: string;
@@ -38,14 +52,14 @@ export declare class ChatSessionResolver {
      * 집계 쿼리를 쓰지 않는다: 세션의 비정규화된 lastMessageAt 과 내 참여자 lastReadAt 을 **값 비교**한다
      * (5개 DB 드라이버 지원 때문에 group by/MAX 를 목록 경로에 두지 않는다).
      */
-    chatSessionInbox(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean, limit?: number, offset?: number, kind?: string, participantOnly?: boolean, visibility?: string, unreadOnly?: boolean): Promise<ChatSessionInboxEntry[]>;
+    chatSessionInbox(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean, limit?: number, offset?: number, kind?: string, participantOnly?: boolean, visibility?: string, unreadOnly?: boolean, includeArchived?: boolean, cleanupOnly?: boolean): Promise<ChatSessionInboxEntry[]>;
     /**
      * 필터를 통과한 **전체 개수** — "더 보기" 가 남았는지, 검색 결과가 몇 건인지.
      *
      * 목록과 같은 요청에 담아 가져가므로 왕복은 늘지 않는다. 개수를 모르면 사용자는 목록의 끝이
      * 페이지의 끝인지 자료의 끝인지 구별할 수 없다.
      */
-    chatSessionInboxTotal(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean, kind?: string, participantOnly?: boolean, visibility?: string, unreadOnly?: boolean): Promise<number>;
+    chatSessionInboxTotal(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean, kind?: string, participantOnly?: boolean, visibility?: string, unreadOnly?: boolean, includeArchived?: boolean, cleanupOnly?: boolean): Promise<number>;
     /** 필터 적용(페이지 전) — 목록·개수가 **같은 규칙**을 쓰도록 한 곳에 둔다(어긋나면 "더 보기" 가 거짓말이 된다). */
     private _inboxFiltered;
     /**
@@ -55,8 +69,16 @@ export declare class ChatSessionResolver {
      * 목록 조회와 **같은 요청**에 담아 가져갈 수 있으므로 왕복은 늘지 않는다.
      */
     hiddenSessionCount(anchorType: string, anchorId: string, context: ResolverContext): Promise<number>;
+    archivedSessionCount(anchorType: string, anchorId: string, context: ResolverContext): Promise<number>;
+    cleanupSessionCount(anchorType: string, anchorId: string, context: ResolverContext): Promise<number>;
+    aiSessionKeeping(): SessionKeeping;
+    /** What I deleted here and can still bring back - newest first. Only the creator deletes, so only the creator sees them. */
+    deletedAISessions(anchorType: string, anchorId: string, context: ResolverContext): Promise<DeletedSessionEntry[]>;
+    /** Bringing a deleted conversation back - its creator, while it is kept. Its messages and seats were never touched. */
+    restoreAISession(sessionId: string, context: ResolverContext): Promise<boolean>;
     /** 목록 조립 — 숨김 표시까지 붙인 **전체**. 목록·개수 두 진입점이 같은 규칙을 쓰도록 한 곳에 둔다. */
     private _inboxEntries;
+    private _readInbox;
     /**
      * 세션 삭제 — **만든 사람만.**
      *

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

@@ -13,6 +13,7 @@ const graphql_scalars_1 = require("graphql-scalars");
 const auth_base_1 = require("@things-factory/auth-base");
 const get_domain_users_js_1 = require("@things-factory/auth-base/dist-server/utils/get-domain-users.js");
 const shell_1 = require("@things-factory/shell");
+const env_1 = require("@things-factory/env");
 const typeorm_1 = require("typeorm");
 const chat_session_js_1 = require("./chat-session/chat-session.js");
 const session_anchor_js_1 = require("./chat-session/session-anchor.js");
@@ -28,6 +29,15 @@ const invite_notification_js_1 = require("./chat-session-participant/invite-noti
 const read_roster_js_1 = require("./chat-session-participant/read-roster.js");
 const participant_lookup_js_1 = require("./chat-session-participant/participant-lookup.js");
 const session_write_gate_js_1 = require("./chat-session/session-write-gate.js");
+const session_cleanup_js_1 = require("./chat-session/session-cleanup.js");
+const session_retention_js_1 = require("./chat-session/session-retention.js");
+/** The keeping periods the config asks for (shared-dock.md §9-5, §2-7). */
+function keeping() {
+    const options = env_1.config.get('ai-assistant', {}) ?? {};
+    return { deletedDays: (0, session_retention_js_1.retentionDaysOf)(options.sessionRetentionDays), archiveDays: (0, session_cleanup_js_1.archiveDaysOf)(options.sessionArchiveDays) };
+}
+/** One request reads the list once - the list, its total and its counts ask together and share it. */
+const inboxReads = new WeakMap();
 /** 초대 알림 — 발송은 호스트의 기전을 그대로 쓴다(`sendInviteNotification`, 문 셋이 같은 한 곳). */
 async function notifyInvited(context, invited, inviter, sessionName) {
     await (0, invite_notification_js_1.sendInviteNotification)(context.state?.notify, invited, inviter, sessionName, undefined, (0, request_translator_js_1.requestTranslator)(context));
@@ -128,11 +138,61 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)({ description: 'Whether this viewer is the owner of the session - only the owner may change its visibility.' }),
     tslib_1.__metadata("design:type", Boolean)
 ], ChatSessionInboxEntry.prototype, "owner", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Whether the session has had no activity for the archive period (config sessionArchiveDays, default 60) - left out of the list unless includeArchived or a search asks for it.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ChatSessionInboxEntry.prototype, "archived", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: "Why the list suggests clearing this session: 'empty' (never asked anything) or 'inactive' (no activity for 30 days). Only on sessions this viewer created." }),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionInboxEntry.prototype, "cleanupReason", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Whole days since the last activity, or since the start when there is none.' }),
+    tslib_1.__metadata("design:type", Number)
+], ChatSessionInboxEntry.prototype, "idleDays", void 0);
 ChatSessionInboxEntry = tslib_1.__decorate([
     (0, type_graphql_1.ObjectType)({
         description: 'Session list entry for the inbox — a session plus this viewer\'s unread state. Ordered by recent activity so a user can find where to go back to.'
     })
 ], ChatSessionInboxEntry);
+let DeletedSessionEntry = class DeletedSessionEntry {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Session id.' }),
+    tslib_1.__metadata("design:type", String)
+], DeletedSessionEntry.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Session name.' }),
+    tslib_1.__metadata("design:type", String)
+], DeletedSessionEntry.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Which conversation this session is - the registered mode kind.' }),
+    tslib_1.__metadata("design:type", String)
+], DeletedSessionEntry.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'When it was deleted.' }),
+    tslib_1.__metadata("design:type", Date)
+], DeletedSessionEntry.prototype, "deletedAt", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When the daily job empties it for good; none when emptying is turned off.' }),
+    tslib_1.__metadata("design:type", Date)
+], DeletedSessionEntry.prototype, "purgesAt", void 0);
+DeletedSessionEntry = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A session the caller deleted that is still kept - it can be brought back until it is emptied.' })
+], DeletedSessionEntry);
+let SessionKeeping = class SessionKeeping {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Days a deleted session can still be brought back; none when deleted sessions are never emptied.' }),
+    tslib_1.__metadata("design:type", Number)
+], SessionKeeping.prototype, "deletedDays", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Days without activity after which a session is archived; none when archiving is off.' }),
+    tslib_1.__metadata("design:type", Number)
+], SessionKeeping.prototype, "archiveDays", void 0);
+SessionKeeping = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'How long conversations are kept - what the list says when it deletes or archives.' })
+], SessionKeeping);
 let ChatAttachmentInfo = class ChatAttachmentInfo {
 };
 exports.ChatAttachmentInfo = ChatAttachmentInfo;
@@ -203,9 +263,9 @@ let ChatSessionResolver = class ChatSessionResolver {
      * 집계 쿼리를 쓰지 않는다: 세션의 비정규화된 lastMessageAt 과 내 참여자 lastReadAt 을 **값 비교**한다
      * (5개 DB 드라이버 지원 때문에 group by/MAX 를 목록 경로에 두지 않는다).
      */
-    async chatSessionInbox(anchorType, anchorId, context, showHidden, search, mineOnly, limit, offset, kind, participantOnly, visibility, unreadOnly) {
+    async chatSessionInbox(anchorType, anchorId, context, showHidden, search, mineOnly, limit, offset, kind, participantOnly, visibility, unreadOnly, includeArchived, cleanupOnly) {
         const filtered = await this._inboxFiltered(anchorType, anchorId, context, {
-            showHidden, search, mineOnly, kind, participantOnly, visibility, unreadOnly
+            showHidden, search, mineOnly, kind, participantOnly, visibility, unreadOnly, includeArchived, cleanupOnly
         });
         const from = Math.max(0, offset ?? 0);
         const size = Math.min(Math.max(1, limit ?? 50), 200);
@@ -217,13 +277,15 @@ let ChatSessionResolver = class ChatSessionResolver {
      * 목록과 같은 요청에 담아 가져가므로 왕복은 늘지 않는다. 개수를 모르면 사용자는 목록의 끝이
      * 페이지의 끝인지 자료의 끝인지 구별할 수 없다.
      */
-    async chatSessionInboxTotal(anchorType, anchorId, context, showHidden, search, mineOnly, kind, participantOnly, visibility, unreadOnly) {
-        return (await this._inboxFiltered(anchorType, anchorId, context, { showHidden, search, mineOnly, kind, participantOnly, visibility, unreadOnly })).length;
+    async chatSessionInboxTotal(anchorType, anchorId, context, showHidden, search, mineOnly, kind, participantOnly, visibility, unreadOnly, includeArchived, cleanupOnly) {
+        return (await this._inboxFiltered(anchorType, anchorId, context, {
+            showHidden, search, mineOnly, kind, participantOnly, visibility, unreadOnly, includeArchived, cleanupOnly
+        })).length;
     }
     /** 필터 적용(페이지 전) — 목록·개수가 **같은 규칙**을 쓰도록 한 곳에 둔다(어긋나면 "더 보기" 가 거짓말이 된다). */
     async _inboxFiltered(anchorType, anchorId, context, opts) {
         const all = await this._inboxEntries(anchorType, anchorId, context);
-        let entries = opts.showHidden ? all : all.filter(e => !e.hidden);
+        let entries = (0, session_inbox_js_1.listedEntries)(all, opts);
         entries = (0, session_inbox_js_1.filterInbox)(entries, opts);
         if (!opts.search?.trim() || !entries.length)
             return entries;
@@ -252,8 +314,68 @@ let ChatSessionResolver = class ChatSessionResolver {
         const all = await this._inboxEntries(anchorType, anchorId, context);
         return all.filter(e => e.hidden).length;
     }
+    /* Like the hidden count: an archived conversation must not be forgotten, so the list says how many wait there. */
+    async archivedSessionCount(anchorType, anchorId, context) {
+        return (await this._inboxEntries(anchorType, anchorId, context)).filter(e => e.archived && !e.hidden).length;
+    }
+    async cleanupSessionCount(anchorType, anchorId, context) {
+        return (await this._inboxEntries(anchorType, anchorId, context)).filter(e => e.cleanupReason).length;
+    }
+    aiSessionKeeping() {
+        const { deletedDays, archiveDays } = keeping();
+        return { deletedDays: deletedDays ?? undefined, archiveDays: archiveDays ?? undefined };
+    }
+    /** What I deleted here and can still bring back - newest first. Only the creator deletes, so only the creator sees them. */
+    async deletedAISessions(anchorType, anchorId, context) {
+        const { domain, user } = context.state;
+        if (!user?.id)
+            return [];
+        const { deletedDays } = keeping();
+        const rows = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession).find({
+            where: { ...(0, session_anchor_js_1.anchorWhere)(domain.id, anchorType, anchorId), creator: { id: user.id }, deletedAt: (0, typeorm_1.Not)((0, typeorm_1.IsNull)()) },
+            withDeleted: true,
+            order: { deletedAt: 'DESC' },
+            take: session_inbox_js_1.INBOX_SCAN_CAP
+        });
+        return rows.map(row => ({
+            id: row.id,
+            name: row.name ?? undefined,
+            kind: row.kind ?? undefined,
+            deletedAt: row.deletedAt,
+            purgesAt: deletedDays === null ? undefined : new Date(new Date(row.deletedAt).getTime() + deletedDays * session_retention_js_1.DAY_MS)
+        }));
+    }
+    /** Bringing a deleted conversation back - its creator, while it is kept. Its messages and seats were never touched. */
+    async restoreAISession(sessionId, context) {
+        const { domain, user } = context.state;
+        const repo = (0, shell_1.getRepository)(chat_session_js_1.ChatSession);
+        const session = await repo.findOne({ where: { id: sessionId, domain: { id: domain.id } }, withDeleted: true });
+        if (!session || !session.deletedAt)
+            return false;
+        if (!user?.id || session.creatorId !== user.id) {
+            throw new Error('Only the user who created this session may bring it back.');
+        }
+        await repo.restore(sessionId);
+        (0, session_activity_publish_js_1.publishSessionActivity)({
+            domainId: domain.id,
+            sessionId,
+            kind: 'meta',
+            anchorType: session.anchorType,
+            anchorId: session.anchorId,
+            actorId: user.id
+        });
+        return true;
+    }
     /** 목록 조립 — 숨김 표시까지 붙인 **전체**. 목록·개수 두 진입점이 같은 규칙을 쓰도록 한 곳에 둔다. */
-    async _inboxEntries(anchorType, anchorId, context) {
+    _inboxEntries(anchorType, anchorId, context) {
+        const reads = inboxReads.get(context) ?? new Map();
+        inboxReads.set(context, reads);
+        const key = `${anchorType}\u0000${anchorId}`;
+        if (!reads.has(key))
+            reads.set(key, this._readInbox(anchorType, anchorId, context));
+        return reads.get(key);
+    }
+    async _readInbox(anchorType, anchorId, context) {
         const { domain, user } = context.state;
         /* 조회 상한 — 한 앵커의 대화가 아무리 늘어도 한 번에 이만큼만 훑는다. 최근 활동순으로 자른다
          * (오래된 대화가 잘리는 것이 최근 대화가 잘리는 것보다 낫다). 정렬·검색·페이지는 순수 로직이 한다. */
@@ -273,10 +395,18 @@ let ChatSessionResolver = class ChatSessionResolver {
         const hiddenAt = new Map(rows.map(r => [r.sessionId, r.hiddenAt]));
         /* 내가 만든 대화인지 표시 — 삭제 버튼을 보일지 결정하는 UI 힌트(권한은 서버가 다시 판정한다). */
         const createdByMe = new Set(sessions.filter(s => s.creatorId === user?.id).map(s => s.id));
-        const entries = (0, session_inbox_js_1.buildInbox)(sessions, participations).map(entry => ({
-            ...entry,
-            mine: createdByMe.has(entry.id)
-        }));
+        const now = new Date();
+        const { archiveDays } = keeping();
+        const entries = (0, session_inbox_js_1.buildInbox)(sessions, participations).map(entry => {
+            const mine = createdByMe.has(entry.id);
+            return {
+                ...entry,
+                mine,
+                idleDays: (0, session_cleanup_js_1.idleDays)(entry, now),
+                archived: (0, session_cleanup_js_1.isArchived)(entry, now, archiveDays),
+                cleanupReason: (0, session_cleanup_js_1.cleanupReason)({ ...entry, mine }, now) ?? undefined
+            };
+        });
         /* showHidden=true 로 불러 **전체**를 얻는다 — 숨김 여부 판정을 두 곳에 복제하지 않기 위함. */
         const shown = (0, session_inbox_js_1.applyHidden)(entries, hiddenAt, true);
         /*
@@ -1018,8 +1148,10 @@ tslib_1.__decorate([
     tslib_1.__param(9, (0, type_graphql_1.Arg)('participantOnly', { nullable: true, description: 'Only conversations the caller is in.' })),
     tslib_1.__param(10, (0, type_graphql_1.Arg)('visibility', { nullable: true, description: "Only 'open' or only 'private'." })),
     tslib_1.__param(11, (0, type_graphql_1.Arg)('unreadOnly', { nullable: true, description: 'Only conversations with unread activity.' })),
+    tslib_1.__param(12, (0, type_graphql_1.Arg)('includeArchived', { nullable: true, description: 'Also the archived ones - no activity for the archive period.' })),
+    tslib_1.__param(13, (0, type_graphql_1.Arg)('cleanupOnly', { nullable: true, description: "Only the caller's own the list suggests clearing (empty, or inactive for 30 days), hidden and archived ones included." })),
     tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, String, Object, Boolean, String, Boolean, Number, Number, String, Boolean, String, Boolean]),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object, Boolean, String, Boolean, Number, Number, String, Boolean, String, Boolean, Boolean, Boolean]),
     tslib_1.__metadata("design:returntype", Promise)
 ], ChatSessionResolver.prototype, "chatSessionInbox", null);
 tslib_1.__decorate([
@@ -1037,8 +1169,10 @@ tslib_1.__decorate([
     tslib_1.__param(7, (0, type_graphql_1.Arg)('participantOnly', { nullable: true, description: 'Only conversations the caller is in.' })),
     tslib_1.__param(8, (0, type_graphql_1.Arg)('visibility', { nullable: true, description: "Only 'open' or only 'private'." })),
     tslib_1.__param(9, (0, type_graphql_1.Arg)('unreadOnly', { nullable: true, description: 'Only conversations with unread activity.' })),
+    tslib_1.__param(10, (0, type_graphql_1.Arg)('includeArchived', { nullable: true, description: 'Also the archived ones - no activity for the archive period.' })),
+    tslib_1.__param(11, (0, type_graphql_1.Arg)('cleanupOnly', { nullable: true, description: "Only the caller's own the list suggests clearing." })),
     tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, String, Object, Boolean, String, Boolean, String, Boolean, String, Boolean]),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object, Boolean, String, Boolean, String, Boolean, String, Boolean, Boolean, Boolean]),
     tslib_1.__metadata("design:returntype", Promise)
 ], ChatSessionResolver.prototype, "chatSessionInboxTotal", null);
 tslib_1.__decorate([
@@ -1053,9 +1187,55 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [String, String, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], ChatSessionResolver.prototype, "hiddenSessionCount", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => type_graphql_1.Int, { description: 'Number of sessions on this anchor that are archived (no activity for the archive period) and not hidden by the caller.' }),
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "query", domainOwnerGranted: true)'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('anchorType')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('anchorId')),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ChatSessionResolver.prototype, "archivedSessionCount", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => type_graphql_1.Int, { description: "Number of the caller's own sessions on this anchor the list suggests clearing - empty, or inactive for 30 days." }),
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "query", domainOwnerGranted: true)'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('anchorType')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('anchorId')),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ChatSessionResolver.prototype, "cleanupSessionCount", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => SessionKeeping, { description: 'How long deleted sessions can be brought back and after how long an idle one is archived.' }),
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "query", domainOwnerGranted: true)'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", SessionKeeping)
+], ChatSessionResolver.prototype, "aiSessionKeeping", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => [DeletedSessionEntry], { description: 'Sessions on this anchor that the caller deleted and that are still kept, newest deletion first. They can be brought back with restoreAISession until they are emptied.' }),
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "query", domainOwnerGranted: true)'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('anchorType')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('anchorId')),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ChatSessionResolver.prototype, "deletedAISessions", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Mutation)(() => Boolean, { description: 'Bring back a session the caller deleted, while it is still kept (before the daily job empties it). Creator only, like deleting.' }),
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "mutation", domainOwnerGranted: true)'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('sessionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ChatSessionResolver.prototype, "restoreAISession", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Mutation)(() => Boolean, {
-        description: 'Delete a chat session — creator only, since a shared deliberation cannot be un-deleted from the UI. Participants who are not the creator can hide it from their own list instead (hideAISession). Soft delete; broadcast as meta activity so every list drops it.'
+        description: 'Delete a chat session — creator only, since it disappears for every participant. Participants who are not the creator can hide it from their own list instead (hideAISession). Soft delete: the creator can bring it back with restoreAISession until the daily job empties it (sessionRetentionDays). Broadcast as meta activity so every list drops it.'
     }),
     (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "mutation", domainOwnerGranted: true)'),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('sessionId')),