@things-factory/board-ai 10.0.0-beta.108

package/dist-server/service/board-ai-resolver.js

@@ -0,0 +1,409 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoardAIChatResolver = void 0;
+const tslib_1 = require("tslib");
+/**
+ * GraphQL resolver — AI 주도 보드 모델링 (chat).
+ *
+ * Mutation: boardAIChat — 자연어 채팅. sessionId 가 있으면 메시지/패치 영속.
+ * sessionId 가 없으면 ad-hoc 모드로 단발 호출 (영속 없음).
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const shell_1 = require("@things-factory/shell");
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+const assistant_js_1 = require("./assistant.js");
+const chat_session_js_1 = require("./chat-session/chat-session.js");
+const chat_message_js_1 = require("./chat-message/chat-message.js");
+const chat_message_publish_js_1 = require("./chat-message/chat-message-publish.js");
+const patch_entry_js_1 = require("./patch-entry/patch-entry.js");
+const board_patch_subscription_js_1 = require("./patch-entry/board-patch-subscription.js");
+const chat_session_participant_js_1 = require("./chat-session-participant/chat-session-participant.js");
+const invite_notification_js_1 = require("./chat-session-participant/invite-notification.js");
+const mention_marker_js_1 = require("./mention-marker.js");
+let BoardAILLMMessageInput = class BoardAILLMMessageInput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: "Role: 'user' or 'assistant'" }),
+    tslib_1.__metadata("design:type", String)
+], BoardAILLMMessageInput.prototype, "role", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Message content' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAILLMMessageInput.prototype, "content", void 0);
+BoardAILLMMessageInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)()
+], BoardAILLMMessageInput);
+let BoardAIMentionPickInput = class BoardAIMentionPickInput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Token used by user (e.g. "경광등1" — the part after #).' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIMentionPickInput.prototype, "token", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.Int, {
+        description: 'Refid explicitly picked from popup. Server uses this for deterministic resolution — bypasses fallback name/id/type matching for this token.'
+    }),
+    tslib_1.__metadata("design:type", Number)
+], BoardAIMentionPickInput.prototype, "refid", void 0);
+BoardAIMentionPickInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)()
+], BoardAIMentionPickInput);
+let BoardAIChatInput = class BoardAIChatInput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'ChatSession id. Omit for ad-hoc (no persistence). When given, messages/patches are persisted.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatInput.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [BoardAILLMMessageInput], {
+        description: 'Conversation history (latest user message at the end). For persisted sessions, only the last user message is appended; older are loaded from DB.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], BoardAIChatInput.prototype, "messages", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'Current BoardModel JSON.' }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatInput.prototype, "currentBoard", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String], {
+        nullable: true,
+        description: "Capability scopes the AI is allowed to use (e.g. 'create', 'edit', 'style'). Filters which tools are exposed to the LLM."
+    }),
+    tslib_1.__metadata("design:type", Array)
+], BoardAIChatInput.prototype, "scopes", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String], {
+        nullable: true,
+        description: 'Component types the LLM is allowed to emit (e.g. ["rect", "label"]). Constrains generation to the current solution.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], BoardAIChatInput.prototype, "knownTypes", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String], {
+        nullable: true,
+        description: 'Component categories to surface (e.g. ["3D", "form"]). Subset filter for groupings exposed in component-schemas.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], BoardAIChatInput.prototype, "categories", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Component schemas — array of { type, description?, group?, properties? } so the LLM knows valid props per type.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatInput.prototype, "componentSchemas", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [type_graphql_1.Int], {
+        nullable: true,
+        description: 'Refids of components currently selected in the modeller (universal numeric handle, things-scene auto-assigned). For "selected" / "선택한" intent. Note: distinct from `id` which is a data-binding name.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], BoardAIChatInput.prototype, "selectedRefids", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [BoardAIMentionPickInput], {
+        nullable: true,
+        description: 'Explicit #mention picks from popup — {token, refid}. User text stays clean (#token only); these picks let server resolve deterministically without exposing refid in the user-visible message. Tokens not in this list fall back to free name/id/type matching.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], BoardAIChatInput.prototype, "mentions", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'AI model identifier override (e.g. "claude-opus-4-7"). Falls back to the configured default when omitted.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatInput.prototype, "model", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Sampling temperature override. Falls back to assistant default when omitted.'
+    }),
+    tslib_1.__metadata("design:type", Number)
+], BoardAIChatInput.prototype, "temperature", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Max output tokens override per LLM call. Falls back to assistant default when omitted.'
+    }),
+    tslib_1.__metadata("design:type", Number)
+], BoardAIChatInput.prototype, "maxTokens", void 0);
+BoardAIChatInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)()
+], BoardAIChatInput);
+let BoardAIChatOutput = class BoardAIChatOutput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Conversational reply.' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatOutput.prototype, "reply", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'BoardEditPatch.' }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatOutput.prototype, "patch", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Clarifying question when input is ambiguous.' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatOutput.prototype, "followUp", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'AI client identifier (provider:model).' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatOutput.prototype, "clientId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Echo of session id (when persisted).' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatOutput.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Persisted ChatMessage id of the user input.' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatOutput.prototype, "userMessageId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Persisted ChatMessage id of the AI reply.' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatOutput.prototype, "assistantMessageId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Persisted PatchEntry id (when patch was generated).' }),
+    tslib_1.__metadata("design:type", String)
+], BoardAIChatOutput.prototype, "patchId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Tool usages collected during agentic loop — sequence of {name, arguments, result, kind}. UI fold-able box for transparency / debug.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatOutput.prototype, "toolUsages", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Ephemeral scene actions (selection/view/mode) — sequence of BoardActionOp. Applied via board-action-execute event on the host. Distinct from `patch` which carries persistent model changes.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatOutput.prototype, "actions", void 0);
+BoardAIChatOutput = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], BoardAIChatOutput);
+let BoardAIChatResolver = class BoardAIChatResolver {
+    /**
+     * NOTE: 일부러 @Directive('@transaction') 사용하지 않는다.
+     * LLM 호출은 수 초~수십 초 — 트랜잭션 안에서 호출하면 SQLite write lock 을
+     * 그 시간 동안 보유 → 다른 작업 (cache 정리 등) 과 SQLITE_BUSY 충돌.
+     * 따라서 DB 쓰기를 LLM 호출 전후의 짧은 단위로 나누고 각각 auto-commit.
+     * 데이터 일관성: 채팅 이력은 부분 누락보다 부분 보존이 안전 (대화 컨텍스트).
+     */
+    async boardAIChat(input, context) {
+        const base = resolveAIClient();
+        if (!base) {
+            throw new Error('No AI client configured. Set config.aiClient = { provider: "anthropic" | "gemini", model, apiKey } or call setDefaultAIClient(...).');
+        }
+        const { domain, user } = context.state;
+        const sessionRepo = (0, shell_1.getRepository)(chat_session_js_1.ChatSession);
+        const messageRepo = (0, shell_1.getRepository)(chat_message_js_1.ChatMessage);
+        const patchRepo = (0, shell_1.getRepository)(patch_entry_js_1.PatchEntry);
+        // ── Phase A: LLM 호출 전 짧은 DB 쓰기 ─────────────────────────
+        let session;
+        if (input.sessionId) {
+            const found = await sessionRepo.findOneBy({ id: input.sessionId, domain: { id: domain.id } });
+            if (!found)
+                throw new Error(`ChatSession ${input.sessionId} not found`);
+            session = found;
+        }
+        const lastUserMsg = input.messages[input.messages.length - 1];
+        let userMessageId;
+        if (session && lastUserMsg && lastUserMsg.role === 'user') {
+            // popup pick 의 refid 를 #token{refid:N} inline marker 로 content 에 박아 저장.
+            // 단일 source-of-truth — 별도 컬럼 없이 content 안에서 token-refid 매핑 보존.
+            const enriched = (0, mention_marker_js_1.injectMentionRefids)(lastUserMsg.content, input.mentions);
+            // parentMessage = 이 세션의 직전 메시지 (보통 assistant / system / 또는 첫 turn 이면 null).
+            // tree 구조 인프라 — branching (regenerate / 사용자별 분기) 는 같은 부모 child 로.
+            const previousLast = await messageRepo.findOne({
+                where: { session: { id: session.id } },
+                order: { createdAt: 'DESC' }
+            });
+            const saved = await messageRepo.save({
+                session: { id: session.id },
+                role: 'user',
+                content: enriched,
+                creator: user,
+                updater: user,
+                parentMessage: previousLast ? { id: previousLast.id } : undefined
+            });
+            userMessageId = saved.id;
+            // C4: 사용자 메시지를 같은 세션 구독자에게 방송 (그룹챗 실시간). best-effort.
+            // 자기 발신 에코는 클라이언트가 message.id 로 dedup.
+            (0, chat_message_publish_js_1.publishChatMessage)({ domainId: domain.id, sessionId: session.id, message: saved });
+            // C4: @user 멘션 → 세션 참여자(member) 자동 등록 (초대). best-effort — 실패해도 chat 흐름 무영향.
+            // enriched content 의 {userId:UUID} 마커에서 추출 → 기존 참여자/자기 제외한 신규만 member 로 등록.
+            try {
+                await this._inviteMentionedUsers(enriched, session.id, domain.id, user, session.boardId, context.state.notify);
+            }
+            catch {
+                /* 초대 실패는 대화를 막지 않는다 */
+            }
+        }
+        // ── Phase B: LLM 호출 (DB 잠금 없음, 오래 걸려도 OK) ───────────
+        const assistant = new assistant_js_1.DefaultBoardAIAssistant(base, {
+            scopes: input.scopes,
+            knownTypes: input.knownTypes,
+            categories: input.categories
+        });
+        // 영속된 메시지에는 #token{refid:N} inline marker 가 박혀 있을 수 있음. LLM 한테는
+        // 깨끗한 텍스트만 보여 주의 분산 방지 + 토큰 낭비 방지.
+        const llmMessages = input.messages.map(m => ({
+            role: m.role === 'assistant' ? 'assistant' : 'user',
+            content: (0, mention_marker_js_1.stripMentionRefids)(m.content)
+        }));
+        const r = await assistant.chat(llmMessages, input.currentBoard ?? undefined, {
+            scopes: input.scopes,
+            knownTypes: input.knownTypes,
+            categories: input.categories,
+            selectedRefids: input.selectedRefids,
+            mentionPicks: input.mentions,
+            componentSchemas: Array.isArray(input.componentSchemas) ? input.componentSchemas : undefined,
+            model: input.model,
+            temperature: input.temperature ?? undefined,
+            maxTokens: input.maxTokens ?? undefined,
+            // 외부 도메인 (board-import 등) 의 read/external tool builder 가 server-side
+            // 의존성 (도메인 / 유저 / 트랜잭션) 을 사용할 수 있도록 ResolverContext.state 전달.
+            // board-ai 코어 자체는 이 값을 알지 않고 dispatch 단계에서 closure 로만 흘림.
+            toolCallContext: context.state
+        });
+        // ── Phase C: LLM 호출 후 짧은 DB 쓰기 ─────────────────────────
+        let assistantMessageId;
+        let patchId;
+        if (session) {
+            let patchEntry;
+            if (r.patch) {
+                patchEntry = await patchRepo.save({
+                    session: { id: session.id },
+                    source: 'ai',
+                    ops: JSON.stringify(r.patch.ops),
+                    summary: r.patch.summary,
+                    confidence: r.patch.confidence,
+                    reverted: false
+                });
+                patchId = patchEntry.id;
+                // C1: 같은 board 구독자에게 방송 (실시간 공동편집 spine). best-effort.
+                (0, board_patch_subscription_js_1.publishBoardPatch)({ domainId: domain.id, boardId: session.boardId, patch: patchEntry });
+            }
+            // AI 응답의 #token 들을 currentBoard 에 대해 resolve 한 뒤 inline marker 로 박음.
+            // patch 로 새로 만든 컴포넌트는 input.currentBoard 에 없으므로 marker 없이 저장 →
+            // 클릭 시 runtime fallback 으로 해석 (그때는 patch 적용 후라 scene 에 존재).
+            const enrichedReply = (0, mention_marker_js_1.injectAiMentionRefids)(r.reply, input.currentBoard ?? null);
+            const aiMsg = await messageRepo.save({
+                session: { id: session.id },
+                role: 'assistant',
+                content: enrichedReply,
+                relatedPatchId: patchEntry?.id,
+                toolUsages: r.toolUsages && r.toolUsages.length > 0 ? JSON.stringify(r.toolUsages) : undefined,
+                // assistant 메시지의 creator = 이 응답을 트리거한 user (= 직전 user 메시지의 작성자).
+                // 같은 turn 으로 묶임 → 향후 사용자별 필터에서 user/assistant 가 함께 따라옴.
+                creator: user,
+                updater: user,
+                // parentMessage = 이 응답이 답하는 user 메시지. regenerate 시 같은 user 메시지를
+                // 부모로 하는 형제 assistant 들이 생기면 자연스럽게 branching tree.
+                parentMessage: userMessageId ? { id: userMessageId } : undefined
+            });
+            assistantMessageId = aiMsg.id;
+            // C4: AI 응답도 같은 세션 구독자에게 방송 (트리거한 본인 포함 — id dedup). best-effort.
+            (0, chat_message_publish_js_1.publishChatMessage)({ domainId: domain.id, sessionId: session.id, message: aiMsg });
+            await sessionRepo.update(session.id, {
+                aiClientId: base.id,
+                updater: user
+            });
+        }
+        return {
+            reply: r.reply,
+            patch: r.patch ?? null,
+            followUp: r.followUp ?? null,
+            clientId: base.id,
+            sessionId: session?.id,
+            userMessageId,
+            assistantMessageId,
+            patchId,
+            toolUsages: r.toolUsages ?? null,
+            actions: r.actions && r.actions.length > 0 ? r.actions : null
+        };
+    }
+    /**
+     * C4: 메시지에 @멘션된 사용자를 세션 참여자(member)로 자동 등록 — 초대.
+     * enriched content 의 {userId:UUID} 마커에서 추출 → 기존 참여자·자기 제외한 신규만 등록.
+     * 소프트삭제(deletedAt)된 과거 참여자는 다시 살린다(재초대). 신규 등록 후 협업 초대 알림 발송(C4b-2, best-effort).
+     */
+    async _inviteMentionedUsers(content, sessionId, domainId, inviter, boardId, notify) {
+        const mentioned = (0, mention_marker_js_1.extractMentionUserIds)(content);
+        if (mentioned.length === 0)
+            return;
+        const repo = (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant);
+        const existing = await repo.find({
+            where: { session: { id: sessionId }, domain: { id: domainId } },
+            withDeleted: true
+        });
+        const activeIds = existing.filter(p => !p.deletedAt).map(p => p.userId).filter(Boolean);
+        const fresh = (0, mention_marker_js_1.newParticipantUserIds)(mentioned, activeIds, inviter?.id);
+        if (fresh.length === 0)
+            return;
+        for (const userId of fresh) {
+            // 과거에 나갔던(soft-deleted) 참여자면 되살리고, 아니면 새로 등록.
+            const prior = existing.find(p => p.userId === userId && p.deletedAt);
+            if (prior) {
+                await repo.update(prior.id, { deletedAt: null, role: 'member', updater: inviter });
+            }
+            else {
+                await repo.save({
+                    domain: { id: domainId },
+                    session: { id: sessionId },
+                    user: { id: userId },
+                    role: 'member',
+                    creator: inviter,
+                    updater: inviter
+                });
+            }
+        }
+        // C4b-2: 초대 알림 — notification 모듈의 기존 발송 메커니즘 재사용(중복 구현 금지).
+        // context.state.notify 는 notification-middleware 가 전역 주입(FCM/pubsub). duck-typed →
+        // board-ai 에 의존성 추가 없이 런타임 호출. 미로드 환경이면 undefined → graceful skip.
+        this._notifyInvited(notify, fresh, boardId, inviter);
+    }
+    /** 초대된 사용자들에게 협업 초대 알림 발송 (best-effort, capability 있을 때만). */
+    _notifyInvited(notify, userIds, boardId, inviter) {
+        if (typeof notify !== 'function')
+            return;
+        const payload = (0, invite_notification_js_1.buildInviteNotification)(userIds, boardId, inviter);
+        if (!payload)
+            return;
+        Promise.resolve(notify(payload)).catch(() => {
+            /* 알림 실패는 초대·대화를 막지 않는다 */
+        });
+    }
+};
+exports.BoardAIChatResolver = BoardAIChatResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Mutation)(() => BoardAIChatOutput, {
+        description: 'AI 주도 보드 모델링 — 자연어 채팅으로 보드 생성·구조편집·스타일링. sessionId 로 영속 컨텍스트.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-ai", privilege: "mutation")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('input')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [BoardAIChatInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], BoardAIChatResolver.prototype, "boardAIChat", null);
+exports.BoardAIChatResolver = BoardAIChatResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], BoardAIChatResolver);
+function resolveAIClient() {
+    const existing = (0, ai_client_base_1.getDefaultAIClient)();
+    if (existing)
+        return existing;
+    const cfg = env_1.config.get('aiClient', null);
+    if (cfg && cfg.provider) {
+        return (0, ai_client_base_1.createAIClient)(cfg);
+    }
+    return undefined;
+}
+//# sourceMappingURL=board-ai-resolver.js.map

package/dist-server/service/board-ai-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-ai-resolver.js","sourceRoot":"","sources":["../../server/service/board-ai-resolver.ts"],"names":[],"mappings":";;;;AAAA;;;;;GAKG;AACH,+CAAyG;AACzG,qDAA6C;AAC7C,qCAAkC;AAElC,6CAA4C;AAC5C,iDAAqD;AACrD,mEAAkG;AAGlG,iDAAwD;AAExD,oEAA4D;AAC5D,oEAA4D;AAC5D,oFAA2E;AAC3E,iEAAyD;AACzD,2FAA6E;AAC7E,wGAA+F;AAC/F,8FAA2F;AAC3F,2DAM4B;AAG5B,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CAM3B,CAAA;AAJC;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;;oDAC1C;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;;uDAC3B;AALX,sBAAsB;IAD3B,IAAA,wBAAS,GAAE;GACN,sBAAsB,CAM3B;AAGD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAS5B,CAAA;AAPC;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC;;sDAClE;AAMb;IAJC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,kBAAG,EAAE;QAChB,WAAW,EACT,6IAA6I;KAChJ,CAAC;;sDACW;AART,uBAAuB;IAD5B,IAAA,wBAAS,GAAE;GACN,uBAAuB,CAS5B;AAGD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAwErB,CAAA;AAnEC;IAJC,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,+FAA+F;KAC7G,CAAC;;mDACgB;AAKlB;IAHC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,sBAAsB,CAAC,EAAE;QACrC,WAAW,EAAE,kJAAkJ;KAChK,CAAC;;kDACgC;AAGlC;IADC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;;sDACpE;AAOlB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;QACrB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,0HAA0H;KAC7H,CAAC;;gDACe;AAMjB;IAJC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;QACrB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,qHAAqH;KACnI,CAAC;;oDACmB;AAMrB;IAJC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;QACrB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,kHAAkH;KAChI,CAAC;;oDACmB;AAOrB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,iHAAiH;KACpH,CAAC;;0DACoB;AAOtB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,kBAAG,CAAC,EAAE;QAClB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,uMAAuM;KAC1M,CAAC;;wDACuB;AAOzB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,uBAAuB,CAAC,EAAE;QACtC,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,iQAAiQ;KACpQ,CAAC;;kDACkC;AAMpC;IAJC,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,2GAA2G;KACzH,CAAC;;+CACY;AAMd;IAJC,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,8EAA8E;KAC5F,CAAC;;qDACkB;AAMpB;IAJC,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,wFAAwF;KACtG,CAAC;;mDACgB;AAvEd,gBAAgB;IADrB,IAAA,wBAAS,GAAE;GACN,gBAAgB,CAwErB;AAGD,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAsCtB,CAAA;AApCC;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;;gDACnC;AAGb;IADC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;;gDAClE;AAGX;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;;mDACtE;AAGjB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC;;mDACjD;AAGhB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;;oDAC7D;AAGlB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;;wDAChE;AAGtB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;;6DACzD;AAG3B;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;;kDAC9E;AAOhB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,qIAAqI;KACxI,CAAC;;qDACc;AAOhB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,8LAA8L;KACjM,CAAC;;kDACW;AArCT,iBAAiB;IADtB,IAAA,yBAAU,GAAE;GACP,iBAAiB,CAsCtB;AAGM,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B;;;;;;OAMG;IAKG,AAAN,KAAK,CAAC,WAAW,CACD,KAAuB,EAC9B,OAAwB;QAE/B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,qIAAqI,CACtI,CAAA;QACH,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QACtC,MAAM,WAAW,GAAG,IAAA,qBAAa,EAAC,6BAAW,CAAC,CAAA;QAC9C,MAAM,WAAW,GAAG,IAAA,qBAAa,EAAC,6BAAW,CAAC,CAAA;QAC9C,MAAM,SAAS,GAAG,IAAA,qBAAa,EAAC,2BAAU,CAAC,CAAA;QAE3C,0DAA0D;QAC1D,IAAI,OAAgC,CAAA;QACpC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;YAC7F,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,SAAS,YAAY,CAAC,CAAA;YACvE,OAAO,GAAG,KAAK,CAAA;QACjB,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC7D,IAAI,aAAiC,CAAA;QACrC,IAAI,OAAO,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1D,wEAAwE;YACxE,+DAA+D;YAC/D,MAAM,QAAQ,GAAG,IAAA,uCAAmB,EAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;YACzE,4EAA4E;YAC5E,kEAAkE;YAClE,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC;gBAC7C,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAS,EAAE;gBAC7C,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;aAC7B,CAAC,CAAA;YACF,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC;gBACnC,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAS;gBAClC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,YAAY,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,YAAY,CAAC,EAAE,EAAU,CAAC,CAAC,CAAC,SAAS;aAC3E,CAAC,CAAA;YACF,aAAa,GAAG,KAAK,CAAC,EAAE,CAAA;YAExB,sDAAsD;YACtD,uCAAuC;YACvC,IAAA,4CAAkB,EAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;YAElF,4EAA4E;YAC5E,4EAA4E;YAC5E,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAG,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAG,OAAO,CAAC,KAAa,CAAC,MAAM,CAAC,CAAA;YAC1H,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;QAED,uDAAuD;QACvD,MAAM,SAAS,GAAG,IAAI,sCAAuB,CAAC,IAAI,EAAE;YAClD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,KAAK,CAAC,UAA6C;SAChE,CAAC,CAAA;QAEF,gEAAgE;QAC/D,mCAAmC;QACpC,MAAM,WAAW,GAAiB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;YACnD,OAAO,EAAE,IAAA,sCAAkB,EAAC,CAAC,CAAC,OAAO,CAAC;SACvC,CAAC,CAAC,CAAA;QAEH,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS,EAAE;YAC3E,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,KAAK,CAAC,UAA6C;YAC/D,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,YAAY,EAAE,KAAK,CAAC,QAAQ;YAC5B,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;YAC5F,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS;YAC3C,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;YACvC,qEAAqE;YACrE,8DAA8D;YAC9D,0DAA0D;YAC1D,eAAe,EAAE,OAAO,CAAC,KAAK;SAC/B,CAAC,CAAA;QAEF,0DAA0D;QAC1D,IAAI,kBAAsC,CAAA;QAC1C,IAAI,OAA2B,CAAA;QAC/B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,UAAkC,CAAA;YACtC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACZ,UAAU,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC;oBAChC,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAS;oBAClC,MAAM,EAAE,IAAI;oBACZ,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;oBAChC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO;oBACxB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU;oBAC9B,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAA;gBACF,OAAO,GAAG,UAAU,CAAC,EAAE,CAAA;gBACvB,uDAAuD;gBACvD,IAAA,+CAAiB,EAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;YACzF,CAAC;YAED,qEAAqE;YACrE,+DAA+D;YAC/D,4DAA4D;YAC5D,MAAM,aAAa,GAAG,IAAA,yCAAqB,EAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,CAAA;YAEhF,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC;gBACnC,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAS;gBAClC,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,aAAa;gBACtB,cAAc,EAAE,UAAU,EAAE,EAAE;gBAC9B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9F,iEAAiE;gBACjE,wDAAwD;gBACxD,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,gEAAgE;gBAChE,mDAAmD;gBACnD,aAAa,EAAE,aAAa,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,aAAa,EAAU,CAAC,CAAC,CAAC,SAAS;aAC1E,CAAC,CAAA;YACF,kBAAkB,GAAG,KAAK,CAAC,EAAE,CAAA;YAE7B,kEAAkE;YAClE,IAAA,4CAAkB,EAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;YAElF,MAAM,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE;gBACnC,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,OAAO,EAAE,IAAI;aACd,CAAC,CAAA;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;YACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;YAC5B,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,SAAS,EAAE,OAAO,EAAE,EAAE;YACtB,aAAa;YACb,kBAAkB;YAClB,OAAO;YACP,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;YAChC,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;SAC9D,CAAA;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,qBAAqB,CACjC,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,OAAY,EACZ,OAAgB,EAChB,MAAoC;QAEpC,MAAM,SAAS,GAAG,IAAA,yCAAqB,EAAC,OAAO,CAAC,CAAA;QAChD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAElC,MAAM,IAAI,GAAG,IAAA,qBAAa,EAAC,oDAAsB,CAAC,CAAA;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;YAC/B,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAS,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAS,EAAE;YAC7E,WAAW,EAAE,IAAI;SAClB,CAAC,CAAA;QACF,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACxF,MAAM,KAAK,GAAG,IAAA,yCAAqB,EAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;QACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAE9B,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC3B,8CAA8C;YAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,SAAS,CAAC,CAAA;YACpE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAG,EAAE,EAAE,SAAS,EAAE,IAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAS,CAAC,CAAA;YACnG,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAS;oBAC/B,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAS;oBACjC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAS;oBAC3B,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,OAAO;oBAChB,OAAO,EAAE,OAAO;iBACV,CAAC,CAAA;YACX,CAAC;QACH,CAAC;QAED,4DAA4D;QAC5D,mFAAmF;QACnF,mEAAmE;QACnE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACtD,CAAC;IAED,8DAA8D;IACtD,cAAc,CACpB,MAAiD,EACjD,OAAiB,EACjB,OAA2B,EAC3B,OAAY;QAEZ,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAM;QACxC,MAAM,OAAO,GAAG,IAAA,gDAAuB,EAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAClE,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC1C,0BAA0B;QAC5B,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAlOY,kDAAmB;AAYxB;IAJL,IAAA,uBAAQ,EAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE;QACjC,WAAW,EAAE,+DAA+D;KAC7E,CAAC;IACD,IAAA,wBAAS,EAAC,yDAAyD,CAAC;IAElE,mBAAA,IAAA,kBAAG,EAAC,OAAO,CAAC,CAAA;IACZ,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CADe,gBAAgB;;sDAqJtC;8BAlKU,mBAAmB;IAD/B,IAAA,uBAAQ,GAAE;GACE,mBAAmB,CAkO/B;AAED,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAG,IAAA,mCAAkB,GAAE,CAAA;IACrC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,GAAG,GAAG,YAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAQ,CAAA;IAC/C,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAA,+BAAc,EAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC","sourcesContent":["/**\n * GraphQL resolver — AI 주도 보드 모델링 (chat).\n *\n * Mutation: boardAIChat — 자연어 채팅. sessionId 가 있으면 메시지/패치 영속.\n * sessionId 가 없으면 ad-hoc 모드로 단발 호출 (영속 없음).\n */\nimport { Resolver, Mutation, Arg, Ctx, Directive, Field, InputType, Int, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport '@things-factory/auth-base'\n\nimport { config } from '@things-factory/env'\nimport { getRepository } from '@things-factory/shell'\nimport { createAIClient, getDefaultAIClient, type AIClient } from '@things-factory/ai-client-base'\nimport type { ComponentCategory } from '@things-factory/board-import'\n\nimport { DefaultBoardAIAssistant } from './assistant.js'\nimport type { LLMMessage } from './types.js'\nimport { ChatSession } from './chat-session/chat-session.js'\nimport { ChatMessage } from './chat-message/chat-message.js'\nimport { publishChatMessage } from './chat-message/chat-message-publish.js'\nimport { PatchEntry } from './patch-entry/patch-entry.js'\nimport { publishBoardPatch } from './patch-entry/board-patch-subscription.js'\nimport { ChatSessionParticipant } from './chat-session-participant/chat-session-participant.js'\nimport { buildInviteNotification } from './chat-session-participant/invite-notification.js'\nimport {\n  injectMentionRefids,\n  injectAiMentionRefids,\n  stripMentionRefids,\n  extractMentionUserIds,\n  newParticipantUserIds\n} from './mention-marker.js'\n\n@InputType()\nclass BoardAILLMMessageInput {\n  @Field({ description: \"Role: 'user' or 'assistant'\" })\n  role: string\n\n  @Field({ description: 'Message content' })\n  content: string\n}\n\n@InputType()\nclass BoardAIMentionPickInput {\n  @Field({ description: 'Token used by user (e.g. \"경광등1\" — the part after #).' })\n  token: string\n\n  @Field(() => Int, {\n    description:\n      'Refid explicitly picked from popup. Server uses this for deterministic resolution — bypasses fallback name/id/type matching for this token.'\n  })\n  refid: number\n}\n\n@InputType()\nclass BoardAIChatInput {\n  @Field({\n    nullable: true,\n    description: 'ChatSession id. Omit for ad-hoc (no persistence). When given, messages/patches are persisted.'\n  })\n  sessionId?: string\n\n  @Field(() => [BoardAILLMMessageInput], {\n    description: 'Conversation history (latest user message at the end). For persisted sessions, only the last user message is appended; older are loaded from DB.'\n  })\n  messages: BoardAILLMMessageInput[]\n\n  @Field(() => GraphQLJSON, { nullable: true, description: 'Current BoardModel JSON.' })\n  currentBoard?: any\n\n  @Field(() => [String], {\n    nullable: true,\n    description:\n      \"Capability scopes the AI is allowed to use (e.g. 'create', 'edit', 'style'). Filters which tools are exposed to the LLM.\"\n  })\n  scopes?: string[]\n\n  @Field(() => [String], {\n    nullable: true,\n    description: 'Component types the LLM is allowed to emit (e.g. [\"rect\", \"label\"]). Constrains generation to the current solution.'\n  })\n  knownTypes?: string[]\n\n  @Field(() => [String], {\n    nullable: true,\n    description: 'Component categories to surface (e.g. [\"3D\", \"form\"]). Subset filter for groupings exposed in component-schemas.'\n  })\n  categories?: string[]\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Component schemas — array of { type, description?, group?, properties? } so the LLM knows valid props per type.'\n  })\n  componentSchemas?: any\n\n  @Field(() => [Int], {\n    nullable: true,\n    description:\n      'Refids of components currently selected in the modeller (universal numeric handle, things-scene auto-assigned). For \"selected\" / \"선택한\" intent. Note: distinct from `id` which is a data-binding name.'\n  })\n  selectedRefids?: number[]\n\n  @Field(() => [BoardAIMentionPickInput], {\n    nullable: true,\n    description:\n      'Explicit #mention picks from popup — {token, refid}. User text stays clean (#token only); these picks let server resolve deterministically without exposing refid in the user-visible message. Tokens not in this list fall back to free name/id/type matching.'\n  })\n  mentions?: BoardAIMentionPickInput[]\n\n  @Field({\n    nullable: true,\n    description: 'AI model identifier override (e.g. \"claude-opus-4-7\"). Falls back to the configured default when omitted.'\n  })\n  model?: string\n\n  @Field({\n    nullable: true,\n    description: 'Sampling temperature override. Falls back to assistant default when omitted.'\n  })\n  temperature?: number\n\n  @Field({\n    nullable: true,\n    description: 'Max output tokens override per LLM call. Falls back to assistant default when omitted.'\n  })\n  maxTokens?: number\n}\n\n@ObjectType()\nclass BoardAIChatOutput {\n  @Field({ description: 'Conversational reply.' })\n  reply: string\n\n  @Field(() => GraphQLJSON, { nullable: true, description: 'BoardEditPatch.' })\n  patch?: any\n\n  @Field({ nullable: true, description: 'Clarifying question when input is ambiguous.' })\n  followUp?: string\n\n  @Field({ description: 'AI client identifier (provider:model).' })\n  clientId: string\n\n  @Field({ nullable: true, description: 'Echo of session id (when persisted).' })\n  sessionId?: string\n\n  @Field({ nullable: true, description: 'Persisted ChatMessage id of the user input.' })\n  userMessageId?: string\n\n  @Field({ nullable: true, description: 'Persisted ChatMessage id of the AI reply.' })\n  assistantMessageId?: string\n\n  @Field({ nullable: true, description: 'Persisted PatchEntry id (when patch was generated).' })\n  patchId?: string\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Tool usages collected during agentic loop — sequence of {name, arguments, result, kind}. UI fold-able box for transparency / debug.'\n  })\n  toolUsages?: any\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Ephemeral scene actions (selection/view/mode) — sequence of BoardActionOp. Applied via board-action-execute event on the host. Distinct from `patch` which carries persistent model changes.'\n  })\n  actions?: any\n}\n\n@Resolver()\nexport class BoardAIChatResolver {\n  /**\n   * NOTE: 일부러 @Directive('@transaction') 사용하지 않는다.\n   * LLM 호출은 수 초~수십 초 — 트랜잭션 안에서 호출하면 SQLite write lock 을\n   * 그 시간 동안 보유 → 다른 작업 (cache 정리 등) 과 SQLITE_BUSY 충돌.\n   * 따라서 DB 쓰기를 LLM 호출 전후의 짧은 단위로 나누고 각각 auto-commit.\n   * 데이터 일관성: 채팅 이력은 부분 누락보다 부분 보존이 안전 (대화 컨텍스트).\n   */\n  @Mutation(() => BoardAIChatOutput, {\n    description: 'AI 주도 보드 모델링 — 자연어 채팅으로 보드 생성·구조편집·스타일링. sessionId 로 영속 컨텍스트.'\n  })\n  @Directive('@privilege(category: \"board-ai\", privilege: \"mutation\")')\n  async boardAIChat(\n    @Arg('input') input: BoardAIChatInput,\n    @Ctx() context: ResolverContext\n  ): Promise<BoardAIChatOutput> {\n    const base = resolveAIClient()\n    if (!base) {\n      throw new Error(\n        'No AI client configured. Set config.aiClient = { provider: \"anthropic\" | \"gemini\", model, apiKey } or call setDefaultAIClient(...).'\n      )\n    }\n\n    const { domain, user } = context.state\n    const sessionRepo = getRepository(ChatSession)\n    const messageRepo = getRepository(ChatMessage)\n    const patchRepo = getRepository(PatchEntry)\n\n    // ── Phase A: LLM 호출 전 짧은 DB 쓰기 ─────────────────────────\n    let session: ChatSession | undefined\n    if (input.sessionId) {\n      const found = await sessionRepo.findOneBy({ id: input.sessionId, domain: { id: domain.id } })\n      if (!found) throw new Error(`ChatSession ${input.sessionId} not found`)\n      session = found\n    }\n\n    const lastUserMsg = input.messages[input.messages.length - 1]\n    let userMessageId: string | undefined\n    if (session && lastUserMsg && lastUserMsg.role === 'user') {\n      // popup pick 의 refid 를 #token{refid:N} inline marker 로 content 에 박아 저장.\n      // 단일 source-of-truth — 별도 컬럼 없이 content 안에서 token-refid 매핑 보존.\n      const enriched = injectMentionRefids(lastUserMsg.content, input.mentions)\n      // parentMessage = 이 세션의 직전 메시지 (보통 assistant / system / 또는 첫 turn 이면 null).\n      // tree 구조 인프라 — branching (regenerate / 사용자별 분기) 는 같은 부모 child 로.\n      const previousLast = await messageRepo.findOne({\n        where: { session: { id: session.id } as any },\n        order: { createdAt: 'DESC' }\n      })\n      const saved = await messageRepo.save({\n        session: { id: session.id } as any,\n        role: 'user',\n        content: enriched,\n        creator: user,\n        updater: user,\n        parentMessage: previousLast ? ({ id: previousLast.id } as any) : undefined\n      })\n      userMessageId = saved.id\n\n      // C4: 사용자 메시지를 같은 세션 구독자에게 방송 (그룹챗 실시간). best-effort.\n      // 자기 발신 에코는 클라이언트가 message.id 로 dedup.\n      publishChatMessage({ domainId: domain.id, sessionId: session.id, message: saved })\n\n      // C4: @user 멘션 → 세션 참여자(member) 자동 등록 (초대). best-effort — 실패해도 chat 흐름 무영향.\n      // enriched content 의 {userId:UUID} 마커에서 추출 → 기존 참여자/자기 제외한 신규만 member 로 등록.\n      try {\n        await this._inviteMentionedUsers(enriched, session.id!, domain.id, user, session.boardId, (context.state as any).notify)\n      } catch {\n        /* 초대 실패는 대화를 막지 않는다 */\n      }\n    }\n\n    // ── Phase B: LLM 호출 (DB 잠금 없음, 오래 걸려도 OK) ───────────\n    const assistant = new DefaultBoardAIAssistant(base, {\n      scopes: input.scopes,\n      knownTypes: input.knownTypes,\n      categories: input.categories as ComponentCategory[] | undefined\n    })\n\n    // 영속된 메시지에는 #token{refid:N} inline marker 가 박혀 있을 수 있음. LLM 한테는\n     // 깨끗한 텍스트만 보여 주의 분산 방지 + 토큰 낭비 방지.\n    const llmMessages: LLMMessage[] = input.messages.map(m => ({\n      role: m.role === 'assistant' ? 'assistant' : 'user',\n      content: stripMentionRefids(m.content)\n    }))\n\n    const r = await assistant.chat(llmMessages, input.currentBoard ?? undefined, {\n      scopes: input.scopes,\n      knownTypes: input.knownTypes,\n      categories: input.categories as ComponentCategory[] | undefined,\n      selectedRefids: input.selectedRefids,\n      mentionPicks: input.mentions,\n      componentSchemas: Array.isArray(input.componentSchemas) ? input.componentSchemas : undefined,\n      model: input.model,\n      temperature: input.temperature ?? undefined,\n      maxTokens: input.maxTokens ?? undefined,\n      // 외부 도메인 (board-import 등) 의 read/external tool builder 가 server-side\n      // 의존성 (도메인 / 유저 / 트랜잭션) 을 사용할 수 있도록 ResolverContext.state 전달.\n      // board-ai 코어 자체는 이 값을 알지 않고 dispatch 단계에서 closure 로만 흘림.\n      toolCallContext: context.state\n    })\n\n    // ── Phase C: LLM 호출 후 짧은 DB 쓰기 ─────────────────────────\n    let assistantMessageId: string | undefined\n    let patchId: string | undefined\n    if (session) {\n      let patchEntry: PatchEntry | undefined\n      if (r.patch) {\n        patchEntry = await patchRepo.save({\n          session: { id: session.id } as any,\n          source: 'ai',\n          ops: JSON.stringify(r.patch.ops),\n          summary: r.patch.summary,\n          confidence: r.patch.confidence,\n          reverted: false\n        })\n        patchId = patchEntry.id\n        // C1: 같은 board 구독자에게 방송 (실시간 공동편집 spine). best-effort.\n        publishBoardPatch({ domainId: domain.id, boardId: session.boardId, patch: patchEntry })\n      }\n\n      // AI 응답의 #token 들을 currentBoard 에 대해 resolve 한 뒤 inline marker 로 박음.\n      // patch 로 새로 만든 컴포넌트는 input.currentBoard 에 없으므로 marker 없이 저장 →\n      // 클릭 시 runtime fallback 으로 해석 (그때는 patch 적용 후라 scene 에 존재).\n      const enrichedReply = injectAiMentionRefids(r.reply, input.currentBoard ?? null)\n\n      const aiMsg = await messageRepo.save({\n        session: { id: session.id } as any,\n        role: 'assistant',\n        content: enrichedReply,\n        relatedPatchId: patchEntry?.id,\n        toolUsages: r.toolUsages && r.toolUsages.length > 0 ? JSON.stringify(r.toolUsages) : undefined,\n        // assistant 메시지의 creator = 이 응답을 트리거한 user (= 직전 user 메시지의 작성자).\n        // 같은 turn 으로 묶임 → 향후 사용자별 필터에서 user/assistant 가 함께 따라옴.\n        creator: user,\n        updater: user,\n        // parentMessage = 이 응답이 답하는 user 메시지. regenerate 시 같은 user 메시지를\n        // 부모로 하는 형제 assistant 들이 생기면 자연스럽게 branching tree.\n        parentMessage: userMessageId ? ({ id: userMessageId } as any) : undefined\n      })\n      assistantMessageId = aiMsg.id\n\n      // C4: AI 응답도 같은 세션 구독자에게 방송 (트리거한 본인 포함 — id dedup). best-effort.\n      publishChatMessage({ domainId: domain.id, sessionId: session.id, message: aiMsg })\n\n      await sessionRepo.update(session.id, {\n        aiClientId: base.id,\n        updater: user\n      })\n    }\n\n    return {\n      reply: r.reply,\n      patch: r.patch ?? null,\n      followUp: r.followUp ?? null,\n      clientId: base.id,\n      sessionId: session?.id,\n      userMessageId,\n      assistantMessageId,\n      patchId,\n      toolUsages: r.toolUsages ?? null,\n      actions: r.actions && r.actions.length > 0 ? r.actions : null\n    }\n  }\n\n  /**\n   * C4: 메시지에 @멘션된 사용자를 세션 참여자(member)로 자동 등록 — 초대.\n   * enriched content 의 {userId:UUID} 마커에서 추출 → 기존 참여자·자기 제외한 신규만 등록.\n   * 소프트삭제(deletedAt)된 과거 참여자는 다시 살린다(재초대). 신규 등록 후 협업 초대 알림 발송(C4b-2, best-effort).\n   */\n  private async _inviteMentionedUsers(\n    content: string,\n    sessionId: string,\n    domainId: string,\n    inviter: any,\n    boardId?: string,\n    notify?: (arg: any) => Promise<void>\n  ): Promise<void> {\n    const mentioned = extractMentionUserIds(content)\n    if (mentioned.length === 0) return\n\n    const repo = getRepository(ChatSessionParticipant)\n    const existing = await repo.find({\n      where: { session: { id: sessionId } as any, domain: { id: domainId } as any },\n      withDeleted: true\n    })\n    const activeIds = existing.filter(p => !p.deletedAt).map(p => p.userId!).filter(Boolean)\n    const fresh = newParticipantUserIds(mentioned, activeIds, inviter?.id)\n    if (fresh.length === 0) return\n\n    for (const userId of fresh) {\n      // 과거에 나갔던(soft-deleted) 참여자면 되살리고, 아니면 새로 등록.\n      const prior = existing.find(p => p.userId === userId && p.deletedAt)\n      if (prior) {\n        await repo.update(prior.id!, { deletedAt: null as any, role: 'member', updater: inviter } as any)\n      } else {\n        await repo.save({\n          domain: { id: domainId } as any,\n          session: { id: sessionId } as any,\n          user: { id: userId } as any,\n          role: 'member',\n          creator: inviter,\n          updater: inviter\n        } as any)\n      }\n    }\n\n    // C4b-2: 초대 알림 — notification 모듈의 기존 발송 메커니즘 재사용(중복 구현 금지).\n    // context.state.notify 는 notification-middleware 가 전역 주입(FCM/pubsub). duck-typed →\n    // board-ai 에 의존성 추가 없이 런타임 호출. 미로드 환경이면 undefined → graceful skip.\n    this._notifyInvited(notify, fresh, boardId, inviter)\n  }\n\n  /** 초대된 사용자들에게 협업 초대 알림 발송 (best-effort, capability 있을 때만). */\n  private _notifyInvited(\n    notify: ((arg: any) => Promise<void>) | undefined,\n    userIds: string[],\n    boardId: string | undefined,\n    inviter: any\n  ): void {\n    if (typeof notify !== 'function') return\n    const payload = buildInviteNotification(userIds, boardId, inviter)\n    if (!payload) return\n    Promise.resolve(notify(payload)).catch(() => {\n      /* 알림 실패는 초대·대화를 막지 않는다 */\n    })\n  }\n}\n\nfunction resolveAIClient(): AIClient | undefined {\n  const existing = getDefaultAIClient()\n  if (existing) return existing\n  const cfg = config.get('aiClient', null) as any\n  if (cfg && cfg.provider) {\n    return createAIClient(cfg)\n  }\n  return undefined\n}\n"]}

package/dist-server/service/catalog-resolver.d.ts

@@ -0,0 +1,18 @@
+export type CatalogKind = 'prefab' | 'palette' | 'layout';
+/**
+ * 텍스트의 `@token` 들을 카탈로그와 매칭해 LLM 친화 형태로 변환.
+ */
+export declare function resolveCatalogMentions(text: string): string;
+/**
+ * Token 의 매칭 kind 목록 (case-sensitive — 카탈로그 식별자는 정확 매칭).
+ *
+ * 같은 이름이 여러 카탈로그에 존재해도 모두 반환. UI 가 disambiguation 안내.
+ */
+export declare function lookupCatalogKinds(token: string): CatalogKind[];
+/**
+ * 텍스트의 모든 `@token` 매칭 결과 — UI / 디버그용.
+ */
+export declare function findCatalogMentions(text: string): Array<{
+    token: string;
+    kinds: CatalogKind[];
+}>;

package/dist-server/service/catalog-resolver.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCatalogMentions = resolveCatalogMentions;
+exports.lookupCatalogKinds = lookupCatalogKinds;
+exports.findCatalogMentions = findCatalogMentions;
+/**
+ * `@name` 카탈로그 멘션 → kind disambiguation.
+ *
+ * Phase 1A 의 mention-resolver (#name → 'name (refid 35)') 와 같은 패턴을
+ * 카탈로그 (prefab / color palette / layout template) 식별자에 적용.
+ *
+ *   "@monitor-card 3개 추가"
+ *     → "monitor-card (prefab) 3개 추가"
+ *
+ *   "@industrial-steel 팔레트로 통일"
+ *     → "industrial-steel (palette) 팔레트로 통일"
+ *
+ * 다중 kind 매치 (이름이 prefab + palette 둘 다인 희귀 케이스):
+ *     → "name (prefab and palette)"
+ *
+ * 매칭 0 — 원문 보존 (AI 가 자연어로 폴백).
+ *
+ * Token 정의: `@` 뒤의 공백/`@` 이 아닌 모든 글자. 정규식 /@([^\s@]+)/g.
+ *
+ * 의도: AI 가 이름을 자유 작곡 / hallucinate 하지 않고 정확한 카탈로그 식별자를
+ * 사용하도록 호출자가 명시한 의도를 server-side 에서 보강.
+ */
+const prefab_registry_1 = require("./prefab-registry");
+const assistant_1 = require("./assistant");
+const CATALOG_PATTERN = /@([^\s@]+)/g;
+/**
+ * 텍스트의 `@token` 들을 카탈로그와 매칭해 LLM 친화 형태로 변환.
+ */
+function resolveCatalogMentions(text) {
+    if (!text || typeof text !== 'string')
+        return text;
+    const matches = collectCatalogMatches(text);
+    if (matches.length === 0)
+        return text;
+    let out = text;
+    for (let i = matches.length - 1; i >= 0; i--) {
+        const m = matches[i];
+        if (m.kinds.length === 0)
+            continue; // 매칭 실패 — 그대로
+        const replacement = formatCatalogReplacement(m.token, m.kinds);
+        out = out.slice(0, m.start) + replacement + out.slice(m.end);
+    }
+    return out;
+}
+function collectCatalogMatches(text) {
+    const matches = [];
+    const pattern = new RegExp(CATALOG_PATTERN.source, 'g');
+    let m;
+    while ((m = pattern.exec(text)) !== null) {
+        const token = m[1];
+        const kinds = lookupCatalogKinds(token);
+        matches.push({
+            token,
+            start: m.index,
+            end: m.index + m[0].length,
+            kinds
+        });
+    }
+    return matches;
+}
+/**
+ * Token 의 매칭 kind 목록 (case-sensitive — 카탈로그 식별자는 정확 매칭).
+ *
+ * 같은 이름이 여러 카탈로그에 존재해도 모두 반환. UI 가 disambiguation 안내.
+ */
+function lookupCatalogKinds(token) {
+    const kinds = [];
+    const prefabs = (0, prefab_registry_1.listBoardPrefabs)();
+    if (prefabs.some(p => p.name === token))
+        kinds.push('prefab');
+    if ((0, assistant_1.listColorPaletteNames)().includes(token))
+        kinds.push('palette');
+    if ((0, assistant_1.listLayoutTemplateNames)().includes(token))
+        kinds.push('layout');
+    return kinds;
+}
+function formatCatalogReplacement(token, kinds) {
+    if (kinds.length === 1)
+        return `${token} (${kinds[0]})`;
+    return `${token} (${kinds.join(' and ')})`;
+}
+/**
+ * 텍스트의 모든 `@token` 매칭 결과 — UI / 디버그용.
+ */
+function findCatalogMentions(text) {
+    if (!text || typeof text !== 'string')
+        return [];
+    return collectCatalogMatches(text).map(m => ({
+        token: m.token,
+        kinds: m.kinds
+    }));
+}
+//# sourceMappingURL=catalog-resolver.js.map

package/dist-server/service/catalog-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-resolver.js","sourceRoot":"","sources":["../../server/service/catalog-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `@name` 카탈로그 멘션 → kind disambiguation.\n *\n * Phase 1A 의 mention-resolver (#name → 'name (refid 35)') 와 같은 패턴을\n * 카탈로그 (prefab / color palette / layout template) 식별자에 적용.\n *\n *   \"@monitor-card 3개 추가\"\n *     → \"monitor-card (prefab) 3개 추가\"\n *\n *   \"@industrial-steel 팔레트로 통일\"\n *     → \"industrial-steel (palette) 팔레트로 통일\"\n *\n * 다중 kind 매치 (이름이 prefab + palette 둘 다인 희귀 케이스):\n *     → \"name (prefab and palette)\"\n *\n * 매칭 0 — 원문 보존 (AI 가 자연어로 폴백).\n *\n * Token 정의: `@` 뒤의 공백/`@` 이 아닌 모든 글자. 정규식 /@([^\\s@]+)/g.\n *\n * 의도: AI 가 이름을 자유 작곡 / hallucinate 하지 않고 정확한 카탈로그 식별자를\n * 사용하도록 호출자가 명시한 의도를 server-side 에서 보강.\n */\nimport { listBoardPrefabs } from './prefab-registry'\nimport { listColorPaletteNames, listLayoutTemplateNames } from './assistant'\n\nexport type CatalogKind = 'prefab' | 'palette' | 'layout'\n\nconst CATALOG_PATTERN = /@([^\\s@]+)/g\n\n/**\n * 텍스트의 `@token` 들을 카탈로그와 매칭해 LLM 친화 형태로 변환.\n */\nexport function resolveCatalogMentions(text: string): string {\n  if (!text || typeof text !== 'string') return text\n  const matches = collectCatalogMatches(text)\n  if (matches.length === 0) return text\n\n  let out = text\n  for (let i = matches.length - 1; i >= 0; i--) {\n    const m = matches[i]\n    if (m.kinds.length === 0) continue // 매칭 실패 — 그대로\n    const replacement = formatCatalogReplacement(m.token, m.kinds)\n    out = out.slice(0, m.start) + replacement + out.slice(m.end)\n  }\n  return out\n}\n\ninterface CatalogMatch {\n  token: string\n  start: number\n  end: number\n  kinds: CatalogKind[]\n}\n\nfunction collectCatalogMatches(text: string): CatalogMatch[] {\n  const matches: CatalogMatch[] = []\n  const pattern = new RegExp(CATALOG_PATTERN.source, 'g')\n  let m: RegExpExecArray | null\n  while ((m = pattern.exec(text)) !== null) {\n    const token = m[1]\n    const kinds = lookupCatalogKinds(token)\n    matches.push({\n      token,\n      start: m.index,\n      end: m.index + m[0].length,\n      kinds\n    })\n  }\n  return matches\n}\n\n/**\n * Token 의 매칭 kind 목록 (case-sensitive — 카탈로그 식별자는 정확 매칭).\n *\n * 같은 이름이 여러 카탈로그에 존재해도 모두 반환. UI 가 disambiguation 안내.\n */\nexport function lookupCatalogKinds(token: string): CatalogKind[] {\n  const kinds: CatalogKind[] = []\n  const prefabs = listBoardPrefabs()\n  if (prefabs.some(p => p.name === token)) kinds.push('prefab')\n  if (listColorPaletteNames().includes(token)) kinds.push('palette')\n  if (listLayoutTemplateNames().includes(token)) kinds.push('layout')\n  return kinds\n}\n\nfunction formatCatalogReplacement(token: string, kinds: CatalogKind[]): string {\n  if (kinds.length === 1) return `${token} (${kinds[0]})`\n  return `${token} (${kinds.join(' and ')})`\n}\n\n/**\n * 텍스트의 모든 `@token` 매칭 결과 — UI / 디버그용.\n */\nexport function findCatalogMentions(\n  text: string\n): Array<{ token: string; kinds: CatalogKind[] }> {\n  if (!text || typeof text !== 'string') return []\n  return collectCatalogMatches(text).map(m => ({\n    token: m.token,\n    kinds: m.kinds\n  }))\n}\n"]}

package/dist-server/service/chat-message/chat-message-broadcast.d.ts

@@ -0,0 +1,13 @@
+import type { ChatMessage } from './chat-message.js';
+/** chat-message 브로드캐스트 토픽. */
+export declare const CHAT_MESSAGE_TOPIC = "board-ai-chat-message";
+/** 방송 페이로드 — 구독 필터(domain+session)용 메타 + ChatMessage 본체. */
+export interface ChatMessagePayload {
+    domainId: string;
+    sessionId?: string;
+    message: ChatMessage;
+}
+/**
+ * 같은 domain + session 구독자에게만 통과시키는 필터 (도메인 격리 = 보안 핵심).
+ */
+export declare function chatMessageFilter(domainId: string, sessionId: string): (payload: ChatMessagePayload) => boolean;

package/dist-server/service/chat-message/chat-message-broadcast.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHAT_MESSAGE_TOPIC = void 0;
+exports.chatMessageFilter = chatMessageFilter;
+/** chat-message 브로드캐스트 토픽. */
+exports.CHAT_MESSAGE_TOPIC = 'board-ai-chat-message';
+/**
+ * 같은 domain + session 구독자에게만 통과시키는 필터 (도메인 격리 = 보안 핵심).
+ */
+function chatMessageFilter(domainId, sessionId) {
+    return (payload) => !!payload && payload.domainId === domainId && payload.sessionId === sessionId;
+}
+//# sourceMappingURL=chat-message-broadcast.js.map

package/dist-server/service/chat-message/chat-message-broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message-broadcast.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message-broadcast.ts"],"names":[],"mappings":";;;AAuBA,8CAGC;AAhBD,8BAA8B;AACjB,QAAA,kBAAkB,GAAG,uBAAuB,CAAA;AASzD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,SAAiB;IACnE,OAAO,CAAC,OAA2B,EAAW,EAAE,CAC9C,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,CAAA;AACjF,CAAC","sourcesContent":["/*\n * chat-message 브로드캐스트 — 순수 로직 (토픽/페이로드/필터). 데코레이터·pubsub import 없음\n * → 단위테스트 가능. 데코레이터 resolver(chat-message-subscription.ts)와 pubsub 의존\n * publishChatMessage 는 별도.\n *\n * patch spine(board-patch-broadcast.ts)과 동일 컨벤션. 다만 채팅 메시지는 board 가 아니라\n * **ChatSession 단위**로 묶이므로 필터 키가 sessionId (+ domain 격리).\n */\nimport type { ChatMessage } from './chat-message.js' // type-only — 런타임 import 아님\n\n/** chat-message 브로드캐스트 토픽. */\nexport const CHAT_MESSAGE_TOPIC = 'board-ai-chat-message'\n\n/** 방송 페이로드 — 구독 필터(domain+session)용 메타 + ChatMessage 본체. */\nexport interface ChatMessagePayload {\n  domainId: string\n  sessionId?: string\n  message: ChatMessage\n}\n\n/**\n * 같은 domain + session 구독자에게만 통과시키는 필터 (도메인 격리 = 보안 핵심).\n */\nexport function chatMessageFilter(domainId: string, sessionId: string) {\n  return (payload: ChatMessagePayload): boolean =>\n    !!payload && payload.domainId === domainId && payload.sessionId === sessionId\n}\n"]}

package/dist-server/service/chat-message/chat-message-publish.d.ts

@@ -0,0 +1,6 @@
+import { type ChatMessagePayload } from './chat-message-broadcast.js';
+/**
+ * ChatMessage 영속 직후 호출 — 같은 세션 구독자에게 방송.
+ * sessionId 없으면 skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.
+ */
+export declare function publishChatMessage(payload: ChatMessagePayload): void;