@things-factory/ai-assistant 10.1.6

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

@@ -0,0 +1,60 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+import { ChatMessage } from '../chat-message/chat-message.js';
+export declare class ChatSession {
+    readonly id?: string;
+    domain?: Domain;
+    domainId?: string;
+    /** Board.id 와 연결. Board 가 owning side 가 될 예정. 1:N — 한 보드에 여러 세션 가능.
+     *
+     * **앵커 일반화 이후에도 유지되는 하위호환 컬럼**이다(제거하지 말 것). 앵커가 board 인 세션은
+     * anchorId 와 함께 이 컬럼에도 같은 값을 쓴다(dual-write) — 기존 조회/인덱스/소비자가 그대로 동작한다. */
+    boardId?: string;
+    /**
+     * 대화가 매달린 대상의 **종류**. 세션은 보드에만 매달리지 않는다 —
+     * 저작 대화는 보드에, 운영 대화는 공간(사이트)에 매달린다. 앵커가 대화의 성격과 이력 경계를 정한다.
+     *
+     * 'board' | 'space' | 'instance' | 'none'. 미설정(기존 데이터)은 boardId 가 있으면 board 로 읽는다 —
+     * 백필 마이그레이션 없이 lazy 하위호환(컬럼 추가만).
+     */
+    anchorType?: string;
+    /** 앵커 대상의 id(보드 id · 공간 id · 인스턴스 id). anchorType 과 함께 의미를 갖는다. */
+    anchorId?: string;
+    /**
+     * 세션의 사용자 정의 이름 (탭 레이블 / 세션 식별 표시용).
+     *
+     * nullable — 미설정 시 UI 가 fallback 라벨 ("세션 N" 또는 createdAt 기반) 사용. 사용자가
+     * 다중 세션 운영 시 의미 부여 (예: "초기 설계", "운영 시뮬레이션", "사용자A 의 사적 세션").
+     */
+    name?: string;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    /** 토큰 절감용 — 오래된 메시지를 LLM 으로 압축한 요약. Phase 2 에서 작성. */
+    /**
+     * 마지막 메시지 시각 — **비정규화**. 목록 정렬(최근 활동순)과 안 읽음 판정의 기준.
+     *
+     * 왜 비정규화인가: 세션마다 메시지를 집계하면(MAX/COUNT + group by) 목록 한 번에 집계 쿼리가 붙고,
+     * 이 프레임워크는 5개 DB 드라이버를 지원해야 한다. 세션 컬럼 하나로 두면 정렬·비교가 값싸게 끝나고
+     * 드라이버 차이가 없다. 메시지를 저장할 때 함께 갱신한다(activityPatch).
+     */
+    lastMessageAt?: Date;
+    /** 목록에 보여줄 마지막 메시지 미리보기 — 목록에서 메시지 테이블을 다시 읽지 않기 위해 짧게 저장. */
+    lastMessagePreview?: string;
+    lastSummary?: string;
+    /**
+     * `lastSummary` 가 **어디까지 덮는지** — 이 메시지까지 요약에 반영됐다.
+     *
+     * 이게 없으면 누적 요약을 할 수 없다: 매 턴 전체를 다시 요약하거나(비용) 이미 요약한 구간을
+     * 또 이어 붙인다(중복). 이력에서 이 id 를 못 찾으면(삭제·편집) 덮은 범위를 알 수 없으므로
+     * 전부 미반영으로 보고 다시 요약한다 — 빠뜨리는 쪽보다 안전하다.
+     */
+    summaryUpToMessageId?: string;
+    /** 사용 모델 식별 — 'anthropic:claude-sonnet-4-6' 등 */
+    aiClientId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+    messages?: ChatMessage[];
+}

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

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatSession = void 0;
+const tslib_1 = require("tslib");
+/**
+ * ChatSession — Board 와 결합되는 AI 협력 세션.
+ *
+ * 한 보드에 여러 세션 가능 — DB 레벨 unique 제약 없음.
+ *
+ * 향후 폭증할 세션 분화 차원 (예: thread / 사용자별 / 컨텍스트별 design vs ops /
+ * archived / forked from clone / agent별) 을 미리 차단하지 않기 위해 구조 자체는 1:N
+ * 으로 열어둠. 단일 세션 정책 (현재 UX) 은 app 레벨 idempotent 로직 — `startBoardAISession`
+ * 이 boardId 매칭 시 기존 세션 반환, `chatSessionByBoard` 가 첫 매칭 반환.
+ *
+ * 미래에 다중 세션 활성화 시 discriminator 컬럼 (kind / name / threadId / creatorId 등)
+ * 을 그때 추가. 마이그레이션 부담 최소화 — 현재는 unique 만 풀어 자리 마련.
+ *
+ * board-service 의 Board 가 owning side 가 될 예정 (ChatSession FK).
+ */
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const chat_message_js_1 = require("../chat-message/chat-message.js");
+const ORMCONFIG = env_1.config.get('ormconfig', {});
+const DATABASE_TYPE = ORMCONFIG.type;
+let ChatSession = class ChatSession {
+};
+exports.ChatSession = ChatSession;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], ChatSession.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((session) => session.domain),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts). Kept for backward compatibility — board-anchored sessions dual-write this alongside anchorId.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "boardId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: "What this conversation is anchored to: 'board' (authoring a board) | 'space' (a site and the twins running there) | 'instance' | 'none'. Absent on legacy rows — treated as 'board' when boardId is present."
+    }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "anchorType", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Id of the anchored target (board id / space id / instance id).' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "anchorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, length: 200 }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'User-given name of this session (tab label / identification).' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who created this session.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatSession.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((session) => session.creator),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who last updated this session.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatSession.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((session) => session.updater),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "updaterId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Timestamp of the last message in this session (denormalized for list ordering and unread comparison — avoids per-session aggregation across the supported DB drivers).' }),
+    tslib_1.__metadata("design:type", Date
+    /** 목록에 보여줄 마지막 메시지 미리보기 — 목록에서 메시지 테이블을 다시 읽지 않기 위해 짧게 저장. */
+    )
+], ChatSession.prototype, "lastMessageAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, length: 200 }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Short preview of the last message, stored so the session list does not need to query messages.' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "lastMessagePreview", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({
+        nullable: true,
+        type: DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+            ? 'longtext'
+            : DATABASE_TYPE == 'oracle'
+                ? 'clob'
+                : DATABASE_TYPE == 'mssql'
+                    ? 'nvarchar'
+                    : 'text',
+        length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined
+    }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Compressed summary of older messages (for token saving).' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "lastSummary", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Id of the last message folded into lastSummary — enables incremental summarization instead of re-reading the whole history.' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "summaryUpToMessageId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "aiClientId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSession.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSession.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    tslib_1.__metadata("design:type", Date
+    // ── 관계 (TypeORM 만, GraphQL 노출은 별도 query 통해 페이징) ──
+    )
+], ChatSession.prototype, "deletedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.OneToMany)(type => chat_message_js_1.ChatMessage, message => message.session),
+    tslib_1.__metadata("design:type", Array)
+], ChatSession.prototype, "messages", void 0);
+exports.ChatSession = ChatSession = tslib_1.__decorate([
+    (0, typeorm_1.Entity)()
+    // 인덱스는 조회 성능용으로 유지 (chatSessionByBoard 가 [domain, boardId] 로 자주 쿼리).
+    // unique 제약은 의도적으로 제거 — 한 보드에 여러 세션을 미래에 허용하기 위함.
+    ,
+    (0, typeorm_1.Index)('ix_chat_session_1', (session) => [session.domain, session.boardId])
+    // 앵커 조회용 — chatSessionsByAnchor 가 [domain, anchorType, anchorId] 로 질의.
+    ,
+    (0, typeorm_1.Index)('ix_chat_session_2', (session) => [session.domain, session.anchorType, session.anchorId]),
+    (0, type_graphql_1.ObjectType)({
+        description: 'AI 협력 세션 — Board 와 결합. 한 보드에 여러 세션 가능 (thread / 사용자별 / 컨텍스트별 등 미래 확장).'
+    })
+], ChatSession);
+//# sourceMappingURL=chat-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.js","sourceRoot":"","sources":["../../../server/service/chat-session/chat-session.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,qCAWgB;AAChB,+CAAoD;AAEpD,iDAA8C;AAC9C,yDAAgD;AAChD,6CAA4C;AAE5C,qEAA6D;AAE7D,MAAM,SAAS,GAAG,YAAM,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;AAC7C,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAA;AAW7B,IAAM,WAAW,GAAjB,MAAM,WAAW;CAiJvB,CAAA;AAjJY,kCAAW;AAGb;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uCAClB;AAIpB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACjC,cAAM;2CAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,OAAoB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;;6CACpC;AAYjB;IANC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,gMAAgM;KACnM,CAAC;;4CACc;AAehB;IANC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,8MAA8M;KACjN,CAAC;;+CACiB;AAKnB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;;6CACxF;AAUjB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACvC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC;;yCAC3F;AAIb;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,CAAC;IACvB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;sCAC7E,gBAAI;4CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,OAAoB,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;;8CACpC;AAIlB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,CAAC;IACvB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;sCAClF,gBAAI;4CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,OAAoB,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;;8CACpC;AAYlB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wKAAwK,EAAE,CAAC;sCACjM,IAAI;IAEpB,8DAA8D;;kDAF1C;AAKpB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACvC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gGAAgG,EAAE,CAAC;;uDAC9G;AAe3B;IAbC,IAAA,gBAAM,EAAC;QACN,QAAQ,EAAE,IAAI;QACd,IAAI,EACF,aAAa,IAAI,OAAO,IAAI,aAAa,IAAI,SAAS;YACpD,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,aAAa,IAAI,QAAQ;gBACzB,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,aAAa,IAAI,OAAO;oBACxB,CAAC,CAAC,UAAU;oBACZ,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,aAAa,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC;IACD,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC;;gDAC/E;AAWpB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6HAA6H,EAAE,CAAC;;yDACzI;AAK7B;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACP;AAInB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;8CAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;8CAAA;AAGhB;IADC,IAAA,0BAAgB,GAAE;sCACP,IAAI;IAEhB,oDAAoD;;8CAFpC;AAIhB;IADC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,6BAAW,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;;6CACnC;sBAjIb,WAAW;IATvB,IAAA,gBAAM,GAAE;IACT,qEAAqE;IACrE,kDAAkD;;IACjD,IAAA,eAAK,EAAC,mBAAmB,EAAE,CAAC,OAAoB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxF,uEAAuE;;IACtE,IAAA,eAAK,EAAC,mBAAmB,EAAE,CAAC,OAAoB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5G,IAAA,yBAAU,EAAC;QACV,WAAW,EAAE,wEAAwE;KACtF,CAAC;GACW,WAAW,CAiJvB","sourcesContent":["/**\n * ChatSession — Board 와 결합되는 AI 협력 세션.\n *\n * 한 보드에 여러 세션 가능 — DB 레벨 unique 제약 없음.\n *\n * 향후 폭증할 세션 분화 차원 (예: thread / 사용자별 / 컨텍스트별 design vs ops /\n * archived / forked from clone / agent별) 을 미리 차단하지 않기 위해 구조 자체는 1:N\n * 으로 열어둠. 단일 세션 정책 (현재 UX) 은 app 레벨 idempotent 로직 — `startBoardAISession`\n * 이 boardId 매칭 시 기존 세션 반환, `chatSessionByBoard` 가 첫 매칭 반환.\n *\n * 미래에 다중 세션 활성화 시 discriminator 컬럼 (kind / name / threadId / creatorId 등)\n * 을 그때 추가. 마이그레이션 부담 최소화 — 현재는 unique 만 풀어 자리 마련.\n *\n * board-service 의 Board 가 owning side 가 될 예정 (ChatSession FK).\n */\nimport {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  OneToMany,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\n\nimport { Domain } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nimport { ChatMessage } from '../chat-message/chat-message.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n// 인덱스는 조회 성능용으로 유지 (chatSessionByBoard 가 [domain, boardId] 로 자주 쿼리).\n// unique 제약은 의도적으로 제거 — 한 보드에 여러 세션을 미래에 허용하기 위함.\n@Index('ix_chat_session_1', (session: ChatSession) => [session.domain, session.boardId])\n// 앵커 조회용 — chatSessionsByAnchor 가 [domain, anchorType, anchorId] 로 질의.\n@Index('ix_chat_session_2', (session: ChatSession) => [session.domain, session.anchorType, session.anchorId])\n@ObjectType({\n  description: 'AI 협력 세션 — Board 와 결합. 한 보드에 여러 세션 가능 (thread / 사용자별 / 컨텍스트별 등 미래 확장).'\n})\nexport class ChatSession {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true })\n  domain?: Domain\n\n  @RelationId((session: ChatSession) => session.domain)\n  domainId?: string\n\n  /** Board.id 와 연결. Board 가 owning side 가 될 예정. 1:N — 한 보드에 여러 세션 가능.\n   *\n   * **앵커 일반화 이후에도 유지되는 하위호환 컬럼**이다(제거하지 말 것). 앵커가 board 인 세션은\n   * anchorId 와 함께 이 컬럼에도 같은 값을 쓴다(dual-write) — 기존 조회/인덱스/소비자가 그대로 동작한다. */\n  @Column({ nullable: true })\n  @Field({\n    nullable: true,\n    description:\n      'Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts). Kept for backward compatibility — board-anchored sessions dual-write this alongside anchorId.'\n  })\n  boardId?: string\n\n  /**\n   * 대화가 매달린 대상의 **종류**. 세션은 보드에만 매달리지 않는다 —\n   * 저작 대화는 보드에, 운영 대화는 공간(사이트)에 매달린다. 앵커가 대화의 성격과 이력 경계를 정한다.\n   *\n   * 'board' | 'space' | 'instance' | 'none'. 미설정(기존 데이터)은 boardId 가 있으면 board 로 읽는다 —\n   * 백필 마이그레이션 없이 lazy 하위호환(컬럼 추가만).\n   */\n  @Column({ nullable: true })\n  @Field({\n    nullable: true,\n    description:\n      \"What this conversation is anchored to: 'board' (authoring a board) | 'space' (a site and the twins running there) | 'instance' | 'none'. Absent on legacy rows — treated as 'board' when boardId is present.\"\n  })\n  anchorType?: string\n\n  /** 앵커 대상의 id(보드 id · 공간 id · 인스턴스 id). anchorType 과 함께 의미를 갖는다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Id of the anchored target (board id / space id / instance id).' })\n  anchorId?: string\n\n  /**\n   * 세션의 사용자 정의 이름 (탭 레이블 / 세션 식별 표시용).\n   *\n   * nullable — 미설정 시 UI 가 fallback 라벨 (\"세션 N\" 또는 createdAt 기반) 사용. 사용자가\n   * 다중 세션 운영 시 의미 부여 (예: \"초기 설계\", \"운영 시뮬레이션\", \"사용자A 의 사적 세션\").\n   */\n  @Column({ nullable: true, length: 200 })\n  @Field({ nullable: true, description: 'User-given name of this session (tab label / identification).' })\n  name?: string\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true, description: 'User who created this session.' })\n  creator?: User\n\n  @RelationId((session: ChatSession) => session.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true, description: 'User who last updated this session.' })\n  updater?: User\n\n  @RelationId((session: ChatSession) => session.updater)\n  updaterId?: string\n\n  /** 토큰 절감용 — 오래된 메시지를 LLM 으로 압축한 요약. Phase 2 에서 작성. */\n  /**\n   * 마지막 메시지 시각 — **비정규화**. 목록 정렬(최근 활동순)과 안 읽음 판정의 기준.\n   *\n   * 왜 비정규화인가: 세션마다 메시지를 집계하면(MAX/COUNT + group by) 목록 한 번에 집계 쿼리가 붙고,\n   * 이 프레임워크는 5개 DB 드라이버를 지원해야 한다. 세션 컬럼 하나로 두면 정렬·비교가 값싸게 끝나고\n   * 드라이버 차이가 없다. 메시지를 저장할 때 함께 갱신한다(activityPatch).\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Timestamp of the last message in this session (denormalized for list ordering and unread comparison — avoids per-session aggregation across the supported DB drivers).' })\n  lastMessageAt?: Date\n\n  /** 목록에 보여줄 마지막 메시지 미리보기 — 목록에서 메시지 테이블을 다시 읽지 않기 위해 짧게 저장. */\n  @Column({ nullable: true, length: 200 })\n  @Field({ nullable: true, description: 'Short preview of the last message, stored so the session list does not need to query messages.' })\n  lastMessagePreview?: string\n\n  @Column({\n    nullable: true,\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined\n  })\n  @Field({ nullable: true, description: 'Compressed summary of older messages (for token saving).' })\n  lastSummary?: string\n\n  /**\n   * `lastSummary` 가 **어디까지 덮는지** — 이 메시지까지 요약에 반영됐다.\n   *\n   * 이게 없으면 누적 요약을 할 수 없다: 매 턴 전체를 다시 요약하거나(비용) 이미 요약한 구간을\n   * 또 이어 붙인다(중복). 이력에서 이 id 를 못 찾으면(삭제·편집) 덮은 범위를 알 수 없으므로\n   * 전부 미반영으로 보고 다시 요약한다 — 빠뜨리는 쪽보다 안전하다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Id of the last message folded into lastSummary — enables incremental summarization instead of re-reading the whole history.' })\n  summaryUpToMessageId?: string\n\n  /** 사용 모델 식별 — 'anthropic:claude-sonnet-4-6' 등 */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  aiClientId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  deletedAt?: Date\n\n  // ── 관계 (TypeORM 만, GraphQL 노출은 별도 query 통해 페이징) ──\n  @OneToMany(type => ChatMessage, message => message.session)\n  messages?: ChatMessage[]\n\n  /*\n   * ── 보드 패치 관계를 끊었다 (2026-09-10) ──────────────────────────────────\n   * 여기 `@OneToMany(PatchEntry)` 가 있었다. 그래서 **대화 세션이 보드 편집기를 알아야** 했고,\n   * 세션 계열을 중립 패키지로 옮기려는 순간 `ai-assistant → board-ai → ai-assistant` 순환이\n   * 된다.\n   *\n   * 끊어도 잃는 것이 없다 — 이 관계를 **자료로 읽는 자리가 하나도 없었다**(전 저장소에서\n   * `session.patches` 를 읽는 코드 0 건). 유일한 쓰임이 `PatchEntry` 쪽의 역방향 선언 한 줄이었고,\n   * TypeORM 은 역방향 없이도 `@ManyToOne` 을 만든다. 패치는 `sessionId` 로 찾는다\n   * (`chatPatches` 가 이미 그렇게 한다).\n   *\n   * 방향은 남는다: **보드 패치가 세션을 안다. 세션은 보드 패치를 모른다.** 종속이 한쪽이면\n   * 중립 쪽이 옮겨질 수 있다.\n   */\n}\n"]}

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

@@ -0,0 +1,3 @@
+import { ChatSession } from './chat-session.js';
+export { ChatSession };
+export declare const entities: (typeof ChatSession)[];

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entities = exports.ChatSession = void 0;
+const chat_session_js_1 = require("./chat-session.js");
+Object.defineProperty(exports, "ChatSession", { enumerable: true, get: function () { return chat_session_js_1.ChatSession; } });
+exports.entities = [chat_session_js_1.ChatSession];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/chat-session/index.ts"],"names":[],"mappings":";;;AAAA,uDAA+C;AAEtC,4FAFA,6BAAW,OAEA;AAEP,QAAA,QAAQ,GAAG,CAAC,6BAAW,CAAC,CAAA","sourcesContent":["import { ChatSession } from './chat-session.js'\n\nexport { ChatSession }\n\nexport const entities = [ChatSession]\n"]}

package/dist-server/service/chat-session/session-activity-broadcast.d.ts

@@ -0,0 +1,30 @@
+/** 세션 활동 방송 토픽. */
+export declare const SESSION_ACTIVITY_TOPIC = "board-ai-session-activity";
+/** 방송 페이로드 — 필터용 메타(도메인·참여자) + 목록 갱신용 최소 정보. 본문은 싣지 않는다. */
+/**
+ * 활동 종류.
+ *   message — 새 메시지. **안 읽음 배지를 올린다.**
+ *   meta    — 이름 변경·참여자 변동 등 세션 자체의 변화. 목록은 갱신하지만 배지는 올리지 않는다.
+ *             (이름이 바뀐 것을 "새 소식" 으로 알리면 소음이 된다.)
+ */
+export type SessionActivityKind = 'message' | 'meta';
+export interface SessionActivityPayload {
+    domainId: string;
+    sessionId: string;
+    kind: SessionActivityKind;
+    /** 이 세션 참여자 user id — 필터가 이 배열로 수신자를 정한다(필터에서 DB 를 읽지 않기 위함). */
+    participantIds: string[];
+    anchorType?: string;
+    anchorId?: string;
+    /** 활동 시각(ISO) — 클라가 목록 정렬·안 읽음 판정에 쓴다. */
+    at: string;
+    /** 한 줄 미리보기(짧게). 본문 전체가 아니다. */
+    preview?: string;
+    /** 이 활동을 만든 사용자 — 자기 발신은 배지를 올리지 않도록 클라가 쓴다. */
+    actorId?: string;
+}
+/**
+ * 같은 도메인 + **내가 참여자인 세션**의 활동만 통과. 도메인 격리가 보안 핵심이고,
+ * 참여자 검사가 "내 것만" 을 성립시킨다(참여하지 않은 대화의 활동을 받지 않는다).
+ */
+export declare function sessionActivityFilter(domainId: string, userId: string): (payload: SessionActivityPayload) => boolean;

package/dist-server/service/chat-session/session-activity-broadcast.js

@@ -0,0 +1,34 @@
+"use strict";
+/*
+ * 세션 활동 방송 — 순수 로직(토픽·페이로드·필터). 데코레이터·pubsub import 없음 → 단위 테스트 가능.
+ *
+ * ── 왜 메시지 방송(chat-message)과 따로 두는가 ──────────────────────────────
+ * 기존 `chatMessageActivity` 는 **그 세션을 열어 둔** 구독자에게 메시지 본문을 보낸다. 그래서 창을 닫아
+ * 두면 새 메시지를 알 수 없다 — 초대 알림 한 번 받고 나면 이후 대화는 사용자가 스스로 들어와 봐야 안다.
+ *
+ * 이 토픽은 **내가 참여한 모든 세션**의 활동을 알린다. 목적이 배지·목록 갱신이므로 본문을 싣지 않고
+ * 최소 정보(세션·앵커·시각·미리보기)만 보낸다:
+ *   · 열지도 않은 세션들의 본문이 한 채널로 쏟아지는 것을 피한다(대역·주의 낭비).
+ *   · 본문이 필요한 시점은 그 세션을 열 때이고, 그때는 기존 메시지 구독이 담당한다.
+ *
+ * ── 구독자 판정을 필터에서 DB 로 하지 않는다 ────────────────────────────────
+ * 필터는 **구독자 × 메시지마다** 돈다. 여기서 DB 를 읽으면 방송 한 번이 구독자 수만큼의 질의가 된다.
+ * 그래서 발행 시점에 참여자 id 목록을 페이로드에 실어 보내고, 필터는 배열 포함 검사만 한다.
+ * 참여자 조회는 발행당 1회 — 사람 대화 빈도에서 감당 가능한 비용이다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_ACTIVITY_TOPIC = void 0;
+exports.sessionActivityFilter = sessionActivityFilter;
+/** 세션 활동 방송 토픽. */
+exports.SESSION_ACTIVITY_TOPIC = 'board-ai-session-activity';
+/**
+ * 같은 도메인 + **내가 참여자인 세션**의 활동만 통과. 도메인 격리가 보안 핵심이고,
+ * 참여자 검사가 "내 것만" 을 성립시킨다(참여하지 않은 대화의 활동을 받지 않는다).
+ */
+function sessionActivityFilter(domainId, userId) {
+    return (payload) => !!payload &&
+        payload.domainId === domainId &&
+        Array.isArray(payload.participantIds) &&
+        payload.participantIds.includes(userId);
+}
+//# sourceMappingURL=session-activity-broadcast.js.map

package/dist-server/service/chat-session/session-activity-broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-activity-broadcast.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-activity-broadcast.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAkCH,sDAMC;AAtCD,mBAAmB;AACN,QAAA,sBAAsB,GAAG,2BAA2B,CAAA;AA2BjE;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,QAAgB,EAAE,MAAc;IACpE,OAAO,CAAC,OAA+B,EAAW,EAAE,CAClD,CAAC,CAAC,OAAO;QACT,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC7B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;QACrC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC3C,CAAC","sourcesContent":["/*\n * 세션 활동 방송 — 순수 로직(토픽·페이로드·필터). 데코레이터·pubsub import 없음 → 단위 테스트 가능.\n *\n * ── 왜 메시지 방송(chat-message)과 따로 두는가 ──────────────────────────────\n * 기존 `chatMessageActivity` 는 **그 세션을 열어 둔** 구독자에게 메시지 본문을 보낸다. 그래서 창을 닫아\n * 두면 새 메시지를 알 수 없다 — 초대 알림 한 번 받고 나면 이후 대화는 사용자가 스스로 들어와 봐야 안다.\n *\n * 이 토픽은 **내가 참여한 모든 세션**의 활동을 알린다. 목적이 배지·목록 갱신이므로 본문을 싣지 않고\n * 최소 정보(세션·앵커·시각·미리보기)만 보낸다:\n *   · 열지도 않은 세션들의 본문이 한 채널로 쏟아지는 것을 피한다(대역·주의 낭비).\n *   · 본문이 필요한 시점은 그 세션을 열 때이고, 그때는 기존 메시지 구독이 담당한다.\n *\n * ── 구독자 판정을 필터에서 DB 로 하지 않는다 ────────────────────────────────\n * 필터는 **구독자 × 메시지마다** 돈다. 여기서 DB 를 읽으면 방송 한 번이 구독자 수만큼의 질의가 된다.\n * 그래서 발행 시점에 참여자 id 목록을 페이로드에 실어 보내고, 필터는 배열 포함 검사만 한다.\n * 참여자 조회는 발행당 1회 — 사람 대화 빈도에서 감당 가능한 비용이다.\n */\n\n/** 세션 활동 방송 토픽. */\nexport const SESSION_ACTIVITY_TOPIC = 'board-ai-session-activity'\n\n/** 방송 페이로드 — 필터용 메타(도메인·참여자) + 목록 갱신용 최소 정보. 본문은 싣지 않는다. */\n/**\n * 활동 종류.\n *   message — 새 메시지. **안 읽음 배지를 올린다.**\n *   meta    — 이름 변경·참여자 변동 등 세션 자체의 변화. 목록은 갱신하지만 배지는 올리지 않는다.\n *             (이름이 바뀐 것을 \"새 소식\" 으로 알리면 소음이 된다.)\n */\nexport type SessionActivityKind = 'message' | 'meta'\n\nexport interface SessionActivityPayload {\n  domainId: string\n  sessionId: string\n  kind: SessionActivityKind\n  /** 이 세션 참여자 user id — 필터가 이 배열로 수신자를 정한다(필터에서 DB 를 읽지 않기 위함). */\n  participantIds: string[]\n  anchorType?: string\n  anchorId?: string\n  /** 활동 시각(ISO) — 클라가 목록 정렬·안 읽음 판정에 쓴다. */\n  at: string\n  /** 한 줄 미리보기(짧게). 본문 전체가 아니다. */\n  preview?: string\n  /** 이 활동을 만든 사용자 — 자기 발신은 배지를 올리지 않도록 클라가 쓴다. */\n  actorId?: string\n}\n\n/**\n * 같은 도메인 + **내가 참여자인 세션**의 활동만 통과. 도메인 격리가 보안 핵심이고,\n * 참여자 검사가 \"내 것만\" 을 성립시킨다(참여하지 않은 대화의 활동을 받지 않는다).\n */\nexport function sessionActivityFilter(domainId: string, userId: string) {\n  return (payload: SessionActivityPayload): boolean =>\n    !!payload &&\n    payload.domainId === domainId &&\n    Array.isArray(payload.participantIds) &&\n    payload.participantIds.includes(userId)\n}\n"]}

package/dist-server/service/chat-session/session-activity-publish.d.ts

@@ -0,0 +1,12 @@
+import { type SessionActivityKind } from './session-activity-broadcast.js';
+export declare function publishSessionActivity(input: {
+    domainId: string;
+    sessionId: string;
+    /** message = 새 메시지(배지 올림) · meta = 이름 변경 등(목록만 갱신). 기본 message. */
+    kind?: SessionActivityKind;
+    anchorType?: string;
+    anchorId?: string;
+    at?: Date;
+    preview?: string;
+    actorId?: string;
+}): Promise<void>;

package/dist-server/service/chat-session/session-activity-publish.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishSessionActivity = publishSessionActivity;
+/*
+ * 세션 활동 발행 — pubsub 의존만(데코레이터 없음). 순수 로직은 session-activity-broadcast.ts.
+ *
+ * 참여자 목록을 여기서 읽어 페이로드에 싣는다 — 필터는 구독자 × 메시지마다 돌기 때문에 거기서 DB 를
+ * 읽으면 방송 한 번이 구독자 수만큼의 질의가 된다. 발행당 1회로 끝낸다.
+ *
+ * best-effort: 실패해도 대화·저장을 막지 않는다(배지가 한 번 늦을 뿐).
+ */
+const shell_1 = require("@things-factory/shell");
+const chat_session_participant_js_1 = require("../chat-session-participant/chat-session-participant.js");
+const session_activity_broadcast_js_1 = require("./session-activity-broadcast.js");
+async function publishSessionActivity(input) {
+    try {
+        const participants = await (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant).find({
+            where: { domain: { id: input.domainId }, session: { id: input.sessionId } }
+        });
+        const payload = {
+            domainId: input.domainId,
+            sessionId: input.sessionId,
+            kind: input.kind ?? 'message',
+            participantIds: participants.map(p => p.userId).filter(Boolean),
+            anchorType: input.anchorType,
+            anchorId: input.anchorId,
+            at: (input.at ?? new Date()).toISOString(),
+            preview: input.preview,
+            actorId: input.actorId
+        };
+        shell_1.pubsub.publish(session_activity_broadcast_js_1.SESSION_ACTIVITY_TOPIC, payload);
+    }
+    catch {
+        /* 방송 실패는 대화를 막지 않는다 */
+    }
+}
+//# sourceMappingURL=session-activity-publish.js.map

package/dist-server/service/chat-session/session-activity-publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-activity-publish.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-activity-publish.ts"],"names":[],"mappings":";;AAaA,wDA8BC;AA3CD;;;;;;;GAOG;AACH,iDAA6D;AAE7D,yGAAgG;AAChG,mFAA+H;AAExH,KAAK,UAAU,sBAAsB,CAAC,KAU5C;IACC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,IAAA,qBAAa,EAAC,oDAAsB,CAAC,CAAC,IAAI,CAAC;YACpE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAS,EAAE;SAC1F,CAAC,CAAA;QACF,MAAM,OAAO,GAA2B;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS;YAC7B,cAAc,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACxE,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;YAC1C,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAA;QACD,cAAM,CAAC,OAAO,CAAC,sDAAsB,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC","sourcesContent":["/*\n * 세션 활동 발행 — pubsub 의존만(데코레이터 없음). 순수 로직은 session-activity-broadcast.ts.\n *\n * 참여자 목록을 여기서 읽어 페이로드에 싣는다 — 필터는 구독자 × 메시지마다 돌기 때문에 거기서 DB 를\n * 읽으면 방송 한 번이 구독자 수만큼의 질의가 된다. 발행당 1회로 끝낸다.\n *\n * best-effort: 실패해도 대화·저장을 막지 않는다(배지가 한 번 늦을 뿐).\n */\nimport { pubsub, getRepository } from '@things-factory/shell'\n\nimport { ChatSessionParticipant } from '../chat-session-participant/chat-session-participant.js'\nimport { SESSION_ACTIVITY_TOPIC, type SessionActivityPayload, type SessionActivityKind } from './session-activity-broadcast.js'\n\nexport async function publishSessionActivity(input: {\n  domainId: string\n  sessionId: string\n  /** message = 새 메시지(배지 올림) · meta = 이름 변경 등(목록만 갱신). 기본 message. */\n  kind?: SessionActivityKind\n  anchorType?: string\n  anchorId?: string\n  at?: Date\n  preview?: string\n  actorId?: string\n}): Promise<void> {\n  try {\n    const participants = await getRepository(ChatSessionParticipant).find({\n      where: { domain: { id: input.domainId } as any, session: { id: input.sessionId } as any }\n    })\n    const payload: SessionActivityPayload = {\n      domainId: input.domainId,\n      sessionId: input.sessionId,\n      kind: input.kind ?? 'message',\n      participantIds: participants.map(p => (p as any).userId).filter(Boolean),\n      anchorType: input.anchorType,\n      anchorId: input.anchorId,\n      at: (input.at ?? new Date()).toISOString(),\n      preview: input.preview,\n      actorId: input.actorId\n    }\n    pubsub.publish(SESSION_ACTIVITY_TOPIC, payload)\n  } catch {\n    /* 방송 실패는 대화를 막지 않는다 */\n  }\n}\n"]}

package/dist-server/service/chat-session/session-activity-subscription.d.ts

@@ -0,0 +1,14 @@
+import { type SessionActivityPayload } from './session-activity-broadcast.js';
+export { publishSessionActivity } from './session-activity-publish.js';
+export declare class SessionActivity {
+    sessionId: string;
+    kind: string;
+    anchorType?: string;
+    anchorId?: string;
+    at: string;
+    preview?: string;
+    actorId?: string;
+}
+export declare class MySessionActivitySubscription {
+    mySessionActivity(payload: SessionActivityPayload): SessionActivity;
+}

package/dist-server/service/chat-session/session-activity-subscription.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MySessionActivitySubscription = exports.SessionActivity = exports.publishSessionActivity = void 0;
+const tslib_1 = require("tslib");
+/*
+ * MySessionActivitySubscription — **내가 참여한 모든 세션**의 활동 알림.
+ *
+ * 기존 chatMessageActivity 는 그 세션을 열어 둔 구독자에게 본문을 보낸다 → 창을 닫아 두면 새 메시지를
+ * 알 수 없었다. 이 구독은 배지·목록 갱신용으로 최소 정보만 보낸다(본문 없음).
+ *
+ * 도메인 격리는 필터가, "내 것만" 은 참여자 검사가 성립시킨다(session-activity-broadcast.ts).
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_yoga_1 = require("graphql-yoga");
+const shell_1 = require("@things-factory/shell");
+const session_activity_broadcast_js_1 = require("./session-activity-broadcast.js");
+const subscribe_auth_js_1 = require("../subscribe-auth.js");
+var session_activity_publish_js_1 = require("./session-activity-publish.js");
+Object.defineProperty(exports, "publishSessionActivity", { enumerable: true, get: function () { return session_activity_publish_js_1.publishSessionActivity; } });
+let SessionActivity = class SessionActivity {
+};
+exports.SessionActivity = SessionActivity;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Session that had activity.' }),
+    tslib_1.__metadata("design:type", String)
+], SessionActivity.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        description: "Kind of activity: 'message' (new message — raise the unread badge) or 'meta' (session itself changed, e.g. renamed — refresh the list but do not badge)."
+    }),
+    tslib_1.__metadata("design:type", String)
+], SessionActivity.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: "What the session is anchored to: 'board' | 'space' | 'instance' | 'none'." }),
+    tslib_1.__metadata("design:type", String)
+], SessionActivity.prototype, "anchorType", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Id of the anchored target.' }),
+    tslib_1.__metadata("design:type", String)
+], SessionActivity.prototype, "anchorId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Activity timestamp (ISO).' }),
+    tslib_1.__metadata("design:type", String)
+], SessionActivity.prototype, "at", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'One-line preview (not the full body).' }),
+    tslib_1.__metadata("design:type", String)
+], SessionActivity.prototype, "preview", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'User who caused the activity — clients skip badging their own.' }),
+    tslib_1.__metadata("design:type", String)
+], SessionActivity.prototype, "actorId", void 0);
+exports.SessionActivity = SessionActivity = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Activity notice for a session the current user participates in — badge/list refresh only, no message body.' })
+], SessionActivity);
+let MySessionActivitySubscription = class MySessionActivitySubscription {
+    mySessionActivity(payload) {
+        return {
+            sessionId: payload.sessionId,
+            kind: payload.kind ?? 'message',
+            anchorType: payload.anchorType,
+            anchorId: payload.anchorId,
+            at: payload.at,
+            preview: payload.preview,
+            actorId: payload.actorId
+        };
+    }
+};
+exports.MySessionActivitySubscription = MySessionActivitySubscription;
+tslib_1.__decorate([
+    (0, type_graphql_1.Subscription)(() => SessionActivity, {
+        description: 'Subscribes to activity in every session the current user participates in, so a closed chat surface can still show unread badges and refresh its list.',
+        subscribe: async ({ context }) => {
+            const { domain, user } = context.state;
+            await (0, subscribe_auth_js_1.assertDomainSubscribeAllowed)(domain, user, (d, u) => process.superUserGranted(d, u));
+            return (0, graphql_yoga_1.pipe)(shell_1.pubsub.subscribe(session_activity_broadcast_js_1.SESSION_ACTIVITY_TOPIC), (0, graphql_yoga_1.filter)((0, session_activity_broadcast_js_1.sessionActivityFilter)(domain.id, user.id)));
+        }
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", SessionActivity)
+], MySessionActivitySubscription.prototype, "mySessionActivity", null);
+exports.MySessionActivitySubscription = MySessionActivitySubscription = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(SessionActivity)
+], MySessionActivitySubscription);
+//# sourceMappingURL=session-activity-subscription.js.map

package/dist-server/service/chat-session/session-activity-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-activity-subscription.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-activity-subscription.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;GAOG;AACH,+CAA8E;AAC9E,+CAA2C;AAC3C,iDAA8C;AAE9C,mFAA4H;AAC5H,4DAAmE;AAEnE,6EAAsE;AAA7D,qIAAA,sBAAsB,OAAA;AAGxB,IAAM,eAAe,GAArB,MAAM,eAAe;CAwB3B,CAAA;AAxBY,0CAAe;AAE1B;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;;kDACnC;AAMlB;IAJC,IAAA,oBAAK,EAAC;QACL,WAAW,EACT,0JAA0J;KAC7J,CAAC;;6CACW;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2EAA2E,EAAE,CAAC;;mDACjG;AAGnB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;;iDACpD;AAGjB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;;2CACzC;AAGX;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;;gDAChE;AAGhB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;;gDACzF;0BAvBL,eAAe;IAD3B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,4GAA4G,EAAE,CAAC;GAC7H,eAAe,CAwB3B;AAGM,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAUxC,iBAAiB,CAAS,OAA+B;QACvD,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;YAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAA;IACH,CAAC;CACF,CAAA;AArBY,sEAA6B;AAUxC;IATC,IAAA,2BAAY,EAAC,GAAG,EAAE,CAAC,eAAe,EAAE;QACnC,WAAW,EACT,uJAAuJ;QACzJ,SAAS,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;YACtC,MAAM,IAAA,gDAA4B,EAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAC1F,OAAO,IAAA,mBAAI,EAAC,cAAM,CAAC,SAAS,CAAC,sDAAsB,CAAC,EAAE,IAAA,qBAAM,EAAC,IAAA,qDAAqB,EAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC1G,CAAC;KACF,CAAC;IACiB,mBAAA,IAAA,mBAAI,GAAE,CAAA;;;4CAAmC,eAAe;sEAU1E;wCApBU,6BAA6B;IADzC,IAAA,uBAAQ,EAAC,eAAe,CAAC;GACb,6BAA6B,CAqBzC","sourcesContent":["/*\n * MySessionActivitySubscription — **내가 참여한 모든 세션**의 활동 알림.\n *\n * 기존 chatMessageActivity 는 그 세션을 열어 둔 구독자에게 본문을 보낸다 → 창을 닫아 두면 새 메시지를\n * 알 수 없었다. 이 구독은 배지·목록 갱신용으로 최소 정보만 보낸다(본문 없음).\n *\n * 도메인 격리는 필터가, \"내 것만\" 은 참여자 검사가 성립시킨다(session-activity-broadcast.ts).\n */\nimport { Resolver, Subscription, Root, ObjectType, Field } from 'type-graphql'\nimport { filter, pipe } from 'graphql-yoga'\nimport { pubsub } from '@things-factory/shell'\n\nimport { SESSION_ACTIVITY_TOPIC, sessionActivityFilter, type SessionActivityPayload } from './session-activity-broadcast.js'\nimport { assertDomainSubscribeAllowed } from '../subscribe-auth.js'\n\nexport { publishSessionActivity } from './session-activity-publish.js'\n\n@ObjectType({ description: 'Activity notice for a session the current user participates in — badge/list refresh only, no message body.' })\nexport class SessionActivity {\n  @Field({ description: 'Session that had activity.' })\n  sessionId!: string\n\n  @Field({\n    description:\n      \"Kind of activity: 'message' (new message — raise the unread badge) or 'meta' (session itself changed, e.g. renamed — refresh the list but do not badge).\"\n  })\n  kind!: string\n\n  @Field({ nullable: true, description: \"What the session is anchored to: 'board' | 'space' | 'instance' | 'none'.\" })\n  anchorType?: string\n\n  @Field({ nullable: true, description: 'Id of the anchored target.' })\n  anchorId?: string\n\n  @Field({ description: 'Activity timestamp (ISO).' })\n  at!: string\n\n  @Field({ nullable: true, description: 'One-line preview (not the full body).' })\n  preview?: string\n\n  @Field({ nullable: true, description: 'User who caused the activity — clients skip badging their own.' })\n  actorId?: string\n}\n\n@Resolver(SessionActivity)\nexport class MySessionActivitySubscription {\n  @Subscription(() => SessionActivity, {\n    description:\n      'Subscribes to activity in every session the current user participates in, so a closed chat surface can still show unread badges and refresh its list.',\n    subscribe: async ({ context }) => {\n      const { domain, user } = context.state\n      await assertDomainSubscribeAllowed(domain, user, (d, u) => process.superUserGranted(d, u))\n      return pipe(pubsub.subscribe(SESSION_ACTIVITY_TOPIC), filter(sessionActivityFilter(domain.id, user.id)))\n    }\n  })\n  mySessionActivity(@Root() payload: SessionActivityPayload): SessionActivity {\n    return {\n      sessionId: payload.sessionId,\n      kind: payload.kind ?? 'message',\n      anchorType: payload.anchorType,\n      anchorId: payload.anchorId,\n      at: payload.at,\n      preview: payload.preview,\n      actorId: payload.actorId\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,26 @@
+/**
+ * 대화가 매달릴 수 있는 것. **저장되는 값이므로 늘리는 것은 아키텍트 판단이다.**
+ *
+ *   board     보드 저작 대화 — 그 보드의 편집 이력
+ *   space     공간 운영 대화 — 사이트와 그 공간에서 도는 트윈들
+ *   instance  트윈 하나에 대한 대화
+ *   domain    테넌트 전체가 주제인 대화 — 공장 전체 문답처럼 더 좁게 가리킬 것이 없을 때
+ *   none      앵커로 찾을 수 없는 대화. 「아직 아무것도 고르지 않았다」는 화면 상태다
+ */
+export declare const SESSION_ANCHOR_TYPES: readonly ["board", "space", "instance", "domain", "none"];
+export type SessionAnchorType = (typeof SESSION_ANCHOR_TYPES)[number];
+export declare function isSessionAnchorType(value: unknown): value is SessionAnchorType;
+/** 앵커 → 저장할 컬럼 값. 보드 앵커는 boardId 에도 같은 값을 넣어 기존 조회가 그대로 동작하게 한다. */
+export declare function anchorColumns(anchorType: string | undefined, anchorId: string | undefined): {
+    anchorType: SessionAnchorType;
+    anchorId?: string;
+    boardId?: string;
+};
+/**
+ * 앵커 조회 조건. 보드 앵커는 **앵커 컬럼이 빈 옛 행도 잡아야** 하므로 boardId 로 찾는다
+ * (dual-write 덕분에 신규 행도 같은 조건에 걸린다). 그 밖 앵커는 앵커 컬럼으로 찾는다.
+ *
+ * 여기서도 앵커 이름을 검사한다 — 읽기 경로에서 틀린 이름은 오류가 아니라 **0 행**으로 나오고,
+ * 화면은 「대화가 없다」로 그린다. 그 증상으로는 원인을 못 찾는다.
+ */
+export declare function anchorWhere(domainId: string, anchorType: string, anchorId: string): any;