@things-factory/board-ai 10.0.0 → 10.0.2

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

@@ -14,6 +14,8 @@ declare class ChatSessionInboxEntry {
     createdAt?: Date;
     unread: boolean;
     participant: boolean;
+    mine: boolean;
+    hidden?: boolean;
 }
 export declare class ChatSessionResolver {
     chatSession(id: string, context: ResolverContext): Promise<ChatSession | null>;
@@ -26,7 +28,43 @@ export declare class ChatSessionResolver {
      * 집계 쿼리를 쓰지 않는다: 세션의 비정규화된 lastMessageAt 과 내 참여자 lastReadAt 을 **값 비교**한다
      * (5개 DB 드라이버 지원 때문에 group by/MAX 를 목록 경로에 두지 않는다).
      */
-    chatSessionInbox(anchorType: string, anchorId: string, context: ResolverContext): Promise<ChatSessionInboxEntry[]>;
+    chatSessionInbox(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean, limit?: number, offset?: number): Promise<ChatSessionInboxEntry[]>;
+    /**
+     * 필터를 통과한 **전체 개수** — "더 보기" 가 남았는지, 검색 결과가 몇 건인지.
+     *
+     * 목록과 같은 요청에 담아 가져가므로 왕복은 늘지 않는다. 개수를 모르면 사용자는 목록의 끝이
+     * 페이지의 끝인지 자료의 끝인지 구별할 수 없다.
+     */
+    chatSessionInboxTotal(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean): Promise<number>;
+    /** 필터 적용(페이지 전) — 목록·개수가 **같은 규칙**을 쓰도록 한 곳에 둔다(어긋나면 "더 보기" 가 거짓말이 된다). */
+    private _inboxFiltered;
+    /**
+     * 내가 숨긴 대화 수 — 필터에 "몇 개가 접혀 있는지" 를 보여주기 위한 값.
+     *
+     * 숨긴 것이 몇 개인지 모르면 필터를 눌러 볼 이유가 생기지 않는다(숨긴 사실 자체를 잊는다).
+     * 목록 조회와 **같은 요청**에 담아 가져갈 수 있으므로 왕복은 늘지 않는다.
+     */
+    hiddenSessionCount(anchorType: string, anchorId: string, context: ResolverContext): Promise<number>;
+    /** 목록 조립 — 숨김 표시까지 붙인 **전체**. 목록·개수 두 진입점이 같은 규칙을 쓰도록 한 곳에 둔다. */
+    private _inboxEntries;
+    /**
+     * 세션 삭제 — **만든 사람만.**
+     *
+     * 협의는 여럿의 기록이고 삭제는 화면에서 되돌릴 수 없다. 그래서 권한을 좁힌다(이름 변경은 되돌릴 수
+     * 있어서 누구나 할 수 있는 것과 대비). 권한이 없는 사람에게는 `hideAISession`(내 목록에서만 숨김)이
+     * 있다 — 남의 기록을 지우지 않고 자기 목록을 정리하는 길.
+     *
+     * 소프트 삭제(deletedAt)다 — 메시지·패치는 세션을 통해서만 도달하므로 함께 사라지고, 잘못 지운 경우
+     * 데이터로는 남아 있다. 다른 참여자 목록에서도 사라져야 하므로 meta 활동으로 방송한다.
+     */
+    deleteAISession(sessionId: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * 내 목록에서 숨기기·되돌리기 — **나에게만** 적용된다(대화·다른 참여자 목록은 그대로).
+     *
+     * 참여자가 아니어도 숨길 수 있어야 한다 — 목록에는 같은 공간의 남의 협의도 보이고, 그것을 정리하는
+     * 것은 남에게 아무 영향이 없다. 그 경우 'viewer' 역할로 기록만 남긴다(참여자 명부·배지에는 들지 않는다).
+     */
+    hideAISession(sessionId: string, context: ResolverContext, hidden?: boolean): Promise<boolean>;
     /**
      * 세션 이름 변경 — **참여자 누구나** 할 수 있다.
      *
@@ -53,6 +91,11 @@ export declare class ChatSessionResolver {
     startBoardAISession(boardId: string, context: ResolverContext): Promise<ChatSession>;
     createAISession(anchorType: string, anchorId: string, name: string | undefined, context: ResolverContext): Promise<ChatSession>;
     renameChatSession(sessionId: string, name: string, context: ResolverContext): Promise<boolean>;
+    appendSessionNote(sessionId: string, content: string, context: ResolverContext): Promise<boolean>;
+    appendSessionTurns(sessionId: string, turns: {
+        role?: string;
+        content?: string;
+    }[], context: ResolverContext): Promise<boolean>;
     recordDirectPatch(sessionId: string, ops: any[], summary: string | undefined, context: ResolverContext): Promise<PatchEntry>;
     revertPatch(patchId: string, context: ResolverContext): Promise<boolean>;
 }

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

@@ -65,6 +65,14 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)({ description: 'Whether this viewer is a participant of the session (non-participants get no unread state).' }),
     tslib_1.__metadata("design:type", Boolean)
 ], ChatSessionInboxEntry.prototype, "participant", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Whether this viewer created the session — only the creator may delete it.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ChatSessionInboxEntry.prototype, "mine", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Whether this viewer hid the session from their own list (only returned when showHidden is on).' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ChatSessionInboxEntry.prototype, "hidden", 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.'
@@ -95,17 +103,133 @@ let ChatSessionResolver = class ChatSessionResolver {
      * 집계 쿼리를 쓰지 않는다: 세션의 비정규화된 lastMessageAt 과 내 참여자 lastReadAt 을 **값 비교**한다
      * (5개 DB 드라이버 지원 때문에 group by/MAX 를 목록 경로에 두지 않는다).
      */
-    async chatSessionInbox(anchorType, anchorId, context) {
+    async chatSessionInbox(anchorType, anchorId, context, showHidden, search, mineOnly, limit, offset) {
+        const filtered = await this._inboxFiltered(anchorType, anchorId, context, { showHidden, search, mineOnly });
+        const from = Math.max(0, offset ?? 0);
+        const size = Math.min(Math.max(1, limit ?? 50), 200);
+        return filtered.slice(from, from + size);
+    }
+    /**
+     * 필터를 통과한 **전체 개수** — "더 보기" 가 남았는지, 검색 결과가 몇 건인지.
+     *
+     * 목록과 같은 요청에 담아 가져가므로 왕복은 늘지 않는다. 개수를 모르면 사용자는 목록의 끝이
+     * 페이지의 끝인지 자료의 끝인지 구별할 수 없다.
+     */
+    async chatSessionInboxTotal(anchorType, anchorId, context, showHidden, search, mineOnly) {
+        return (await this._inboxFiltered(anchorType, anchorId, context, { showHidden, search, mineOnly })).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);
+        if (opts.mineOnly)
+            entries = entries.filter(e => e.mine);
+        return (0, session_inbox_js_1.searchInbox)(entries, opts.search);
+    }
+    /**
+     * 내가 숨긴 대화 수 — 필터에 "몇 개가 접혀 있는지" 를 보여주기 위한 값.
+     *
+     * 숨긴 것이 몇 개인지 모르면 필터를 눌러 볼 이유가 생기지 않는다(숨긴 사실 자체를 잊는다).
+     * 목록 조회와 **같은 요청**에 담아 가져갈 수 있으므로 왕복은 늘지 않는다.
+     */
+    async hiddenSessionCount(anchorType, anchorId, context) {
+        const all = await this._inboxEntries(anchorType, anchorId, context);
+        return all.filter(e => e.hidden).length;
+    }
+    /** 목록 조립 — 숨김 표시까지 붙인 **전체**. 목록·개수 두 진입점이 같은 규칙을 쓰도록 한 곳에 둔다. */
+    async _inboxEntries(anchorType, anchorId, context) {
         const { domain, user } = context.state;
+        /* 조회 상한 — 한 앵커의 대화가 아무리 늘어도 한 번에 이만큼만 훑는다. 최근 활동순으로 자른다
+         * (오래된 대화가 잘리는 것이 최근 대화가 잘리는 것보다 낫다). 정렬·검색·페이지는 순수 로직이 한다. */
         const sessions = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession).find({
-            where: (0, session_anchor_js_1.anchorWhere)(domain.id, anchorType, anchorId)
+            where: (0, session_anchor_js_1.anchorWhere)(domain.id, anchorType, anchorId),
+            order: { lastMessageAt: 'DESC' },
+            take: session_inbox_js_1.INBOX_SCAN_CAP
         });
         if (sessions.length === 0)
             return [];
-        const mine = await (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant).find({
+        const rows = await (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant).find({
             where: { domain: { id: domain.id }, user: { id: user.id }, session: { id: (0, typeorm_1.In)(sessions.map(s => s.id)) } }
         });
-        return (0, session_inbox_js_1.buildInbox)(sessions, mine);
+        /* 'viewer' 는 대화에 낀 사람이 아니다 — 숨김을 기록하려고 만든 행이므로 읽음·안 읽음 판정에서 뺀다.
+         * (참여자가 아닌 사람에게 남의 협의 배지를 띄우지 않는다.) */
+        const participations = rows.filter(r => r.role !== 'viewer');
+        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)
+        }));
+        /* showHidden=true 로 불러 **전체**를 얻는다 — 숨김 여부 판정을 두 곳에 복제하지 않기 위함. */
+        return (0, session_inbox_js_1.applyHidden)(entries, hiddenAt, true);
+    }
+    /**
+     * 세션 삭제 — **만든 사람만.**
+     *
+     * 협의는 여럿의 기록이고 삭제는 화면에서 되돌릴 수 없다. 그래서 권한을 좁힌다(이름 변경은 되돌릴 수
+     * 있어서 누구나 할 수 있는 것과 대비). 권한이 없는 사람에게는 `hideAISession`(내 목록에서만 숨김)이
+     * 있다 — 남의 기록을 지우지 않고 자기 목록을 정리하는 길.
+     *
+     * 소프트 삭제(deletedAt)다 — 메시지·패치는 세션을 통해서만 도달하므로 함께 사라지고, 잘못 지운 경우
+     * 데이터로는 남아 있다. 다른 참여자 목록에서도 사라져야 하므로 meta 활동으로 방송한다.
+     */
+    async deleteAISession(sessionId, context) {
+        const { domain, user } = context.state;
+        const repo = (0, shell_1.getRepository)(chat_session_js_1.ChatSession);
+        const session = await repo.findOneBy({ id: sessionId, domain: { id: domain.id } });
+        if (!session)
+            return false;
+        if (!user?.id || session.creatorId !== user.id) {
+            /* 조용한 무동작이 아니라 명시 실패 — 지워진 줄 알고 넘어가면 안 된다. */
+            throw new Error('Only the user who created this session may delete it. Hide it from your own list instead.');
+        }
+        await repo.softDelete(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;
+    }
+    /**
+     * 내 목록에서 숨기기·되돌리기 — **나에게만** 적용된다(대화·다른 참여자 목록은 그대로).
+     *
+     * 참여자가 아니어도 숨길 수 있어야 한다 — 목록에는 같은 공간의 남의 협의도 보이고, 그것을 정리하는
+     * 것은 남에게 아무 영향이 없다. 그 경우 'viewer' 역할로 기록만 남긴다(참여자 명부·배지에는 들지 않는다).
+     */
+    async hideAISession(sessionId, context, hidden) {
+        const { domain, user } = context.state;
+        if (!user?.id)
+            return false;
+        const session = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession).findOneBy({ id: sessionId, domain: { id: domain.id } });
+        if (!session)
+            return false;
+        const repo = (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant);
+        const existing = await repo.findOne({
+            where: { domain: { id: domain.id }, session: { id: sessionId }, user: { id: user.id } }
+        });
+        const hiddenAt = hidden === false ? null : new Date();
+        if (existing) {
+            await repo.update(existing.id, { hiddenAt, updater: user });
+        }
+        else {
+            if (hidden === false)
+                return true; // 숨긴 적이 없으면 되돌릴 것도 없다
+            await repo.save({
+                domain: { id: domain.id },
+                session: { id: sessionId },
+                user: { id: user.id },
+                role: 'viewer', // 대화에 낀 것이 아니라 숨김만 기록한다
+                hiddenAt,
+                creator: user,
+                updater: user
+            });
+        }
+        return true;
     }
     /**
      * 세션 이름 변경 — **참여자 누구나** 할 수 있다.
@@ -285,6 +409,101 @@ let ChatSessionResolver = class ChatSessionResolver {
         await repo.update(sessionId, { name: name.trim() || null, updater: user });
         return true;
     }
+    async appendSessionNote(sessionId, content, context) {
+        const { domain, user, tx } = context.state;
+        const session = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession, tx).findOneBy({ id: sessionId, domain: { id: domain.id } });
+        if (!session)
+            throw new Error(`ChatSession ${sessionId} not found`);
+        /* 프롬프트가 한 기록으로 폭증하지 않도록 자른다 — 맥락 전달이 목적이고 전문 보존이 아니다. */
+        const body = (content ?? '').trim().slice(0, 4000);
+        if (!body)
+            return false;
+        const previousLast = await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage, tx).findOne({
+            where: { session: { id: session.id } },
+            order: { createdAt: 'DESC' }
+        });
+        const sysMsg = await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage, tx).save({
+            session: { id: session.id },
+            role: 'system',
+            content: body,
+            creator: user,
+            updater: user,
+            parentMessage: previousLast ? { id: previousLast.id } : undefined
+        });
+        /* 활동 갱신 + 방송 — 다른 참여자 목록·안 읽음과 열려 있는 화면의 transcript 일관성. best-effort. */
+        try {
+            await (0, shell_1.getRepository)(chat_session_js_1.ChatSession, tx).update(session.id, (0, session_inbox_js_1.activityPatch)(body));
+        }
+        catch {
+            /* 기록 자체를 막지 않는다 */
+        }
+        (0, session_activity_publish_js_1.publishSessionActivity)({
+            domainId: domain.id,
+            sessionId: session.id,
+            kind: 'message',
+            anchorType: session.anchorType,
+            anchorId: session.anchorId,
+            preview: body,
+            actorId: user?.id
+        });
+        (0, chat_message_publish_js_1.publishChatMessage)({ domainId: domain.id, sessionId: session.id, message: sysMsg });
+        return true;
+    }
+    async appendSessionTurns(sessionId, turns, context) {
+        const { domain, user, tx } = context.state;
+        const session = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession, tx).findOneBy({ id: sessionId, domain: { id: domain.id } });
+        if (!session)
+            throw new Error(`ChatSession ${sessionId} not found`);
+        /* 옮겨온 대화는 **그 대화의 발언 그대로** 들어간다 — 한 덩어리 기록으로 뭉치면 사람이 읽을 수 없고
+         * (화면 하나를 잡아먹는 이탤릭 덩어리), 마크다운도 죽는다. 대신 개수·길이는 제한한다: 맥락 전달이
+         * 목적이고 전문 보존이 아니다. */
+        const rows = (Array.isArray(turns) ? turns : [])
+            .map(t => ({
+            role: t?.role === 'ai' || t?.role === 'assistant' ? 'assistant' : t?.role === 'user' ? 'user' : 'system',
+            content: (t?.content ?? '').trim().slice(0, 4000)
+        }))
+            .filter(t => t.content)
+            .slice(-40);
+        if (!rows.length)
+            return false;
+        let previous = await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage, tx).findOne({
+            where: { session: { id: session.id } },
+            order: { createdAt: 'DESC' }
+        });
+        const saved = [];
+        for (const row of rows) {
+            previous = await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage, tx).save({
+                session: { id: session.id },
+                role: row.role,
+                content: row.content,
+                creator: user,
+                updater: user,
+                parentMessage: previous ? { id: previous.id } : undefined
+            });
+            saved.push(previous);
+        }
+        /* 활동은 마지막 발언 기준 한 번만 — 옮긴 줄마다 목록을 흔들 이유가 없다. */
+        const last = rows[rows.length - 1];
+        try {
+            await (0, shell_1.getRepository)(chat_session_js_1.ChatSession, tx).update(session.id, (0, session_inbox_js_1.activityPatch)(last.content));
+        }
+        catch {
+            /* best-effort — 옮기기 자체를 막지 않는다 */
+        }
+        (0, session_activity_publish_js_1.publishSessionActivity)({
+            domainId: domain.id,
+            sessionId: session.id,
+            kind: 'message',
+            anchorType: session.anchorType,
+            anchorId: session.anchorId,
+            preview: last.content,
+            actorId: user?.id
+        });
+        for (const message of saved) {
+            (0, chat_message_publish_js_1.publishChatMessage)({ domainId: domain.id, sessionId: session.id, message });
+        }
+        return true;
+    }
     async recordDirectPatch(sessionId, ops, summary, context) {
         const { domain, tx, user } = context.state;
         const session = await (0, shell_1.getRepository)(chat_session_js_1.ChatSession, tx).findOneBy({
@@ -387,16 +606,71 @@ tslib_1.__decorate([
 ], ChatSessionResolver.prototype, "chatSessionsByBoard", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Query)(() => [ChatSessionInboxEntry], {
-        description: "List sessions anchored to a target with this viewer's unread state, ordered by recent activity. Uses the denormalized last-activity timestamp compared against the viewer's read point — no per-session aggregation."
+        description: "List sessions anchored to a target with this viewer's unread state, most recent activity first. Supports free-text search over name and last preview, a mine-only filter, hidden inclusion, and paging. Uses the denormalized last-activity timestamp compared against the viewer's read point — no per-session aggregation."
     }),
     (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "query")'),
     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.__param(3, (0, type_graphql_1.Arg)('showHidden', { nullable: true })),
+    tslib_1.__param(4, (0, type_graphql_1.Arg)('search', { nullable: true })),
+    tslib_1.__param(5, (0, type_graphql_1.Arg)('mineOnly', { nullable: true })),
+    tslib_1.__param(6, (0, type_graphql_1.Arg)('limit', () => type_graphql_1.Int, { nullable: true })),
+    tslib_1.__param(7, (0, type_graphql_1.Arg)('offset', () => type_graphql_1.Int, { nullable: true })),
     tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object, Boolean, String, Boolean, Number, Number]),
     tslib_1.__metadata("design:returntype", Promise)
 ], ChatSessionResolver.prototype, "chatSessionInbox", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => type_graphql_1.Int, {
+        description: 'Total number of sessions matching the same filters as chatSessionInbox (before paging). Request it alongside the list so the UI can tell "end of page" from "end of data".'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "query")'),
+    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.__param(3, (0, type_graphql_1.Arg)('showHidden', { nullable: true })),
+    tslib_1.__param(4, (0, type_graphql_1.Arg)('search', { nullable: true })),
+    tslib_1.__param(5, (0, type_graphql_1.Arg)('mineOnly', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object, Boolean, String, Boolean]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ChatSessionResolver.prototype, "chatSessionInboxTotal", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => type_graphql_1.Int, {
+        description: "Number of sessions on this anchor that the caller has hidden and that have had no activity since. Meant to be requested alongside chatSessionInbox in the same operation so the filter can say how many are folded away."
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "query")'),
+    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, "hiddenSessionCount", 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.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "mutation")'),
+    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, "deleteAISession", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Mutation)(() => Boolean, {
+        description: 'Hide (or unhide) a session from the calling user\'s own list. Per-user and reversible — the session and other participants are unaffected. Activity newer than the hide makes it reappear; the inbox filter (showHidden) reveals hidden ones.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "mutation")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('sessionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('hidden', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object, Boolean]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ChatSessionResolver.prototype, "hideAISession", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Mutation)(() => Boolean, {
         description: 'Rename a chat session. Any participant may rename it — the name is the topic label of a shared deliberation and the change is reversible. Broadcast as meta activity so every participant sees it without raising unread badges.'
@@ -526,6 +800,32 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [String, String, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], ChatSessionResolver.prototype, "renameChatSession", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(() => Boolean, {
+        description: 'Append a system note to a session — context that did not come from a participant typing (e.g. a conversation carried over from another surface, an external state change). The AI sees it as part of the shared history.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "mutation")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('sessionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('content')),
+    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, "appendSessionNote", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(() => Boolean, {
+        description: 'Carry a conversation from another surface into this session as its own turns (user / assistant), preserving order. Use when a lightweight exchange is promoted into a persistent discussion — the participants should read it as the conversation continuing, not as a machine dump.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "mutation")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('sessionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('turns', () => graphql_scalars_1.GraphQLJSON)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ChatSessionResolver.prototype, "appendSessionTurns", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Directive)('@transaction'),
     (0, type_graphql_1.Mutation)(() => patch_entry_js_1.PatchEntry, {