@things-factory/board-ai 10.0.1 → 10.0.3

package/dist-server/service/board-ai-resolver.d.ts

@@ -16,6 +16,7 @@ declare class BoardAIChatInput {
     truncateAfterMessageId?: string;
     toolCategories?: string[];
     boardTools?: boolean;
+    requireGroundingTools?: boolean;
     knownTypes?: string[];
     categories?: string[];
     componentSchemas?: any;
@@ -36,6 +37,9 @@ declare class BoardAIChatOutput {
     patchId?: string;
     toolUsages?: any;
     actions?: any;
+    historyFolded?: any;
+    proposals?: any;
+    groundingWarnings?: any;
 }
 export declare class BoardAIChatResolver {
     /**
@@ -46,6 +50,17 @@ export declare class BoardAIChatResolver {
      * 데이터 일관성: 채팅 이력은 부분 누락보다 부분 보존이 안전 (대화 컨텍스트).
      */
     boardAIChat(input: BoardAIChatInput, context: ResolverContext): Promise<BoardAIChatOutput>;
+    /**
+     * 이력 요약 접기 — 상한 밖으로 밀려난 앞부분을 요약으로 눌러 담는다.
+     *
+     * 왜 이렇게 나눠 두었나: 판정(무엇을 요약할지·다시 만들 때인지)은 순수 로직(history-summary)이
+     * 갖고, 여기서는 **호출과 저장**만 한다. 그래야 규칙을 테스트로 고정할 수 있다.
+     *
+     * 아껴 만든다: 새로 밀려난 것이 임계치를 넘을 때만 LLM 을 부른다(상한을 넘긴 뒤 매 턴 부르면
+     * 대화마다 호출이 두 번씩 붙는다). 실패는 조용히 넘긴다 — 다음 턴이 "생략" 으로 알리고,
+     * 다음 임계치에서 다시 시도한다.
+     */
+    private _foldHistorySummary;
     /**
      * C4: 메시지에 @멘션된 사용자를 세션 참여자(member)로 자동 등록 — 초대.
      * enriched content 의 {userId:UUID} 마커에서 추출 → 기존 참여자·자기 제외한 신규만 등록.

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

@@ -18,6 +18,23 @@ 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 llm_history_js_1 = require("./chat-message/llm-history.js");
+const history_summary_js_1 = require("./chat-message/history-summary.js");
+const fold_history_js_1 = require("./chat-message/fold-history.js");
+/**
+ * 모델에 넘길 최근 메시지 수 상한.
+ *
+ * 협의는 여럿이 며칠에 걸쳐 이어진다 — 상한 없이 전체를 매 턴 보내면 프롬프트가 무한히 자라고
+ * (비용·지연·문맥 한계) 오래된 말이 최근 상황을 덮는다. 40 은 첫 경계선이다: 한 자리의 협의를
+ * 담기에 넉넉하고, 넘치면 생략 사실을 모델에 알린다(조용히 버리지 않는다).
+ * 버린 앞부분을 **요약해서** 실어 보내는 것이 다음 단계다(ChatSession.lastSummary 미사용 상태).
+ */
+const LLM_HISTORY_MAX_TURNS = 40;
+/**
+ * 요약을 다시 만드는 임계치 — 상한 밖으로 **새로 밀려난** 메시지 수.
+ *
+ * 상한을 넘긴 뒤 매 턴 요약을 만들면 대화마다 LLM 호출이 두 번씩 붙는다. 10 개씩 모아 접는다.
+ */
+const LLM_SUMMARY_THRESHOLD = 10;
 const session_inbox_js_1 = require("./chat-session/session-inbox.js");
 const session_activity_publish_js_1 = require("./chat-session/session-activity-publish.js");
 const chat_message_publish_js_1 = require("./chat-message/chat-message-publish.js");
@@ -108,6 +125,13 @@ tslib_1.__decorate([
     }),
     tslib_1.__metadata("design:type", Boolean)
 ], BoardAIChatInput.prototype, "boardTools", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Force a tool call on the first turn (toolChoice: required). Turn this on for surfaces that discuss live state: the grounding guard catches invented identifiers but not an invented situation stated without any, which only happens when the model answers without querying at all. Concept / how-to questions are unaffected — they are answered through a documentation tool.'
+    }),
+    tslib_1.__metadata("design:type", Boolean)
+], BoardAIChatInput.prototype, "requireGroundingTools", void 0);
 tslib_1.__decorate([
     (0, type_graphql_1.Field)(() => [String], {
         nullable: true,
@@ -215,6 +239,27 @@ tslib_1.__decorate([
     }),
     tslib_1.__metadata("design:type", Object)
 ], BoardAIChatOutput.prototype, "actions", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Reported when the stored history exceeded the prompt cap for this turn: { omitted, summarized }. The surface uses it to tell the user the conversation grew long — a new conversation is better for a different topic. Objective fact only; no topic-change detection.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatOutput.prototype, "historyFolded", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Action proposals the AI recorded without executing — each carries what a tool returned alongside `proposed: true`. The surface renders a confirm button; execution is the user\'s act, never the assistant\'s. Null when nothing was proposed.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatOutput.prototype, "proposals", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Ungrounded identifiers mentioned by the reply — present in the answer but absent from everything the model received (prompt, board context, history, tool results). Hallucination candidates surfaced to the user; the reply itself is not altered. Null when the answer is grounded.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatOutput.prototype, "groundingWarnings", void 0);
 BoardAIChatOutput = tslib_1.__decorate([
     (0, type_graphql_1.ObjectType)()
 ], BoardAIChatOutput);
@@ -313,12 +358,18 @@ let BoardAIChatResolver = class BoardAIChatResolver {
          * 정렬은 createdAt ASC + id ASC — 같은 시각 삽입의 순서까지 결정적으로 만든다(조립 쪽에서
          * 다시 정렬하지 않으므로 여기서 확정해야 한다). 멘션 마커는 여기서 제거해 넘긴다. */
         let llmMessages;
+        let historyFolded;
         if (session) {
             const rows = await messageRepo.find({
                 where: { session: { id: session.id } },
                 relations: { creator: true },
                 order: { createdAt: 'ASC', id: 'ASC' }
             });
+            /* 이번 턴에 상한 밖으로 밀려난 것이 있는가 — 화면이 "대화가 길어졌다" 를 알릴 근거(사실만). */
+            const capped = (0, history_summary_js_1.splitByCap)(rows.map(row => ({ id: row.id, role: row.role, content: row.content ?? '' })), LLM_HISTORY_MAX_TURNS);
+            if (capped.dropped.length > 0) {
+                historyFolded = { omitted: capped.dropped.length, summarized: !!session.lastSummary };
+            }
             llmMessages = (0, llm_history_js_1.buildLlmHistory)(rows.map(row => ({
                 id: row.id,
                 role: row.role,
@@ -329,7 +380,11 @@ let BoardAIChatResolver = class BoardAIChatResolver {
             })), {
                 truncateAfterMessageId: input.truncateAfterMessageId ?? undefined,
                 /* 방금 저장한 사용자 메시지는 접은 구간보다 뒤에 있어도 반드시 남긴다. */
-                keepMessageIds: userMessageId ? [userMessageId] : []
+                keepMessageIds: userMessageId ? [userMessageId] : [],
+                /* 이력 상한 — 협의는 며칠 이어진다. 상한이 없으면 매 턴 전체를 보내 프롬프트가 무한히 자란다. */
+                maxTurns: LLM_HISTORY_MAX_TURNS,
+                /* 밀려난 앞부분은 요약으로 대체한다(있으면). 요약은 응답 뒤에 갱신한다 — 아래 Phase D. */
+                summary: { text: session.lastSummary, upToMessageId: session.summaryUpToMessageId }
             });
         }
         else {
@@ -344,6 +399,7 @@ let BoardAIChatResolver = class BoardAIChatResolver {
             /* 대화면별 도구 노출 — 미지정이면 현행(전부 허용) 그대로. */
             toolCategories: input.toolCategories ?? undefined,
             boardTools: input.boardTools ?? undefined,
+            requireGroundingTools: input.requireGroundingTools ?? undefined,
             knownTypes: input.knownTypes,
             categories: input.categories,
             selectedRefids: input.selectedRefids,
@@ -385,6 +441,11 @@ let BoardAIChatResolver = class BoardAIChatResolver {
                 content: enrichedReply,
                 relatedPatchId: patchEntry?.id,
                 toolUsages: r.toolUsages && r.toolUsages.length > 0 ? JSON.stringify(r.toolUsages) : undefined,
+                /* 접지 경고를 함께 영속 — 나중에 읽는 참여자도 같은 주의를 봐야 한다(재계산 불가: 근거 원문이 남지 않는다).
+                 * 컬럼 길이(1024) 안에 들도록 앞 20개까지만 — 그 이상이면 목록이 아니라 답 자체가 문제다. */
+                groundingWarnings: r.groundingWarnings && r.groundingWarnings.length > 0
+                    ? JSON.stringify(r.groundingWarnings.slice(0, 20))
+                    : undefined,
                 // assistant 메시지의 creator = 이 응답을 트리거한 user (= 직전 user 메시지의 작성자).
                 // 같은 turn 으로 묶임 → 향후 사용자별 필터에서 user/assistant 가 함께 따라옴.
                 creator: user,
@@ -412,6 +473,11 @@ let BoardAIChatResolver = class BoardAIChatResolver {
                 /* AI 응답도 세션 활동이다 — 이걸 빼면 다른 참여자에게 "새 소식 없음"으로 보인다. */
                 ...(0, session_inbox_js_1.activityPatch)(enrichedReply)
             });
+            /* ── Phase D: 이력 요약 접기 ────────────────────────────────────────────
+             * 응답을 **돌려준 뒤** 갱신한다 — 사용자 대기 시간에 요약용 LLM 호출을 얹지 않는다.
+             * 기다리지 않으므로(await 없음) 실패해도 대화에는 영향이 없다: 요약이 없으면 다음 턴은
+             * "N개 생략" 으로 정직하게 알리고 넘어간다(조용한 맥락 상실이 아니다). */
+            void this._foldHistorySummary(session.id, domain.id, base);
         }
         return {
             reply: r.reply,
@@ -423,9 +489,62 @@ let BoardAIChatResolver = class BoardAIChatResolver {
             assistantMessageId,
             patchId,
             toolUsages: r.toolUsages ?? null,
-            actions: r.actions && r.actions.length > 0 ? r.actions : null
+            actions: r.actions && r.actions.length > 0 ? r.actions : null,
+            proposals: r.proposals && r.proposals.length > 0 ? r.proposals : null,
+            historyFolded: historyFolded ?? null,
+            groundingWarnings: r.groundingWarnings && r.groundingWarnings.length > 0 ? r.groundingWarnings : null
         };
     }
+    /**
+     * 이력 요약 접기 — 상한 밖으로 밀려난 앞부분을 요약으로 눌러 담는다.
+     *
+     * 왜 이렇게 나눠 두었나: 판정(무엇을 요약할지·다시 만들 때인지)은 순수 로직(history-summary)이
+     * 갖고, 여기서는 **호출과 저장**만 한다. 그래야 규칙을 테스트로 고정할 수 있다.
+     *
+     * 아껴 만든다: 새로 밀려난 것이 임계치를 넘을 때만 LLM 을 부른다(상한을 넘긴 뒤 매 턴 부르면
+     * 대화마다 호출이 두 번씩 붙는다). 실패는 조용히 넘긴다 — 다음 턴이 "생략" 으로 알리고,
+     * 다음 임계치에서 다시 시도한다.
+     */
+    async _foldHistorySummary(sessionId, domainId, client) {
+        try {
+            const sessionRepo = (0, shell_1.getRepository)(chat_session_js_1.ChatSession);
+            const session = await sessionRepo.findOneBy({ id: sessionId, domain: { id: domainId } });
+            if (!session)
+                return;
+            const rows = await (0, shell_1.getRepository)(chat_message_js_1.ChatMessage).find({
+                where: { session: { id: sessionId } },
+                relations: { creator: true },
+                order: { createdAt: 'ASC', id: 'ASC' }
+            });
+            const history = rows.map(row => ({
+                id: row.id,
+                role: row.role,
+                content: (0, mention_marker_js_1.stripMentionRefids)(row.content ?? ''),
+                senderId: row.creator?.id,
+                senderName: row.creator?.name || row.creator?.username
+            }));
+            const { patch } = await (0, fold_history_js_1.foldHistorySummary)({
+                rows: history,
+                stored: {
+                    text: session.lastSummary,
+                    upToMessageId: session.summaryUpToMessageId
+                },
+                maxTurns: LLM_HISTORY_MAX_TURNS,
+                threshold: LLM_SUMMARY_THRESHOLD,
+                summarize: content => client.chat([{ role: 'user', content }], {
+                    systemPrompt: (0, history_summary_js_1.summaryInstruction)(),
+                    maxTokens: 700,
+                    /* 요약은 창작이 아니다 — 흔들림을 줄인다. */
+                    temperature: 0
+                })
+            });
+            if (patch)
+                await sessionRepo.update(sessionId, patch);
+        }
+        catch {
+            /* 요약 실패는 대화를 막지 않는다 — 다음 턴은 "생략" 으로 정직하게 알린다. */
+        }
+    }
     /**
      * C4: 메시지에 @멘션된 사용자를 세션 참여자(member)로 자동 등록 — 초대.
      * enriched content 의 {userId:UUID} 마커에서 추출 → 기존 참여자·자기 제외한 신규만 등록.

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

@@ -1 +1 @@
-{"version":3,"file":"board-ai-resolver.js","sourceRoot":"","sources":["../../server/service/board-ai-resolver.ts"],"names":[],"mappings":"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","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 { buildLlmHistory } from './chat-message/llm-history.js'\nimport { activityPatch, autoSessionName } from './chat-session/session-inbox.js'\nimport { publishSessionActivity } from './chat-session/session-activity-publish.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(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Host context describing what this surface is looking at (e.g. { spaceId } for a space deliberation, { boardId } for board authoring). Tools read it as ctx.state.host so the model never has to ask the user for identifiers. Client-supplied — never used for authorization; tools verify the scope belongs to the caller tenant.'\n  })\n  hostContext?: any\n\n  @Field({\n    nullable: true,\n    description:\n      'Id of the last message to keep from the stored history. The client keeps its own truncation when a user edits a message (the server history is intentionally preserved), so pass the last kept message id to hide the retracted span from the agent. Omit to use the whole stored history.'\n  })\n  truncateAfterMessageId?: string\n\n  @Field(() => [String], {\n    nullable: true,\n    description:\n      'Registered external tool categories this conversation may use (registerToolCategory names, e.g. [\"twin\", \"board-import\"]). Omit to allow every registered category. Applies to tool definitions AND execution, so a surface cannot call a category it was not granted.'\n  })\n  toolCategories?: string[]\n\n  @Field({\n    nullable: true,\n    description:\n      'Whether core board editing tools (addComponent / styling / scene actions) are available. Defaults to true. Set false for surfaces that must not modify the board — e.g. an operations chat where irreversible commands live, so reversible edits and irreversible actions never share one conversation.'\n  })\n  boardTools?: boolean\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      /* 세션 활동 갱신(비정규화) — 목록 최근활동순 정렬과 다른 참여자의 안 읽음 판정 기준.\n       * 이름이 아직 없으면 **첫 발화로 자동 작명** 한다 — `세션 2` 보다 \"A-DC 포화 원인\" 이 목록에서\n       * 훨씬 유용하다. 사용자가 직접 바꾼 이름은 여기서 건드리지 않는다(이름이 있으면 그대로).\n       * best-effort: 실패해도 대화를 막지 않는다(목록 정렬이 한 칸 늦을 뿐). */\n      try {\n        const patch: any = activityPatch(enriched)\n        if (!session.name) patch.name = autoSessionName(enriched)\n        await sessionRepo.update(session.id!, patch)\n      } catch {\n        /* noop */\n      }\n      /* 내가 참여한 세션 활동 방송 — 창을 닫아 둔 다른 참여자의 배지·목록을 위해. */\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: enriched,\n        actorId: user?.id\n      })\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    /* 에이전트가 볼 이력 — **세션이 있으면 서버 정본(ChatMessage)** 을 쓴다.\n     * 클라이언트가 보낸 줄을 쓰면 협의에서 참여자마다 화면이 달라 에이전트가 사람마다 다른 대화를 본다.\n     * 발신자 표기·system 기록 포함·접은 구간 제외 규칙은 buildLlmHistory 가 소유(그 파일 머리말 참조).\n     * 즉석 대화(sessionId 없음)는 영속 이력이 없으므로 클라이언트 이력을 그대로 쓴다.\n     *\n     * 정렬은 createdAt ASC + id ASC — 같은 시각 삽입의 순서까지 결정적으로 만든다(조립 쪽에서\n     * 다시 정렬하지 않으므로 여기서 확정해야 한다). 멘션 마커는 여기서 제거해 넘긴다. */\n    let llmMessages: LLMMessage[]\n    if (session) {\n      const rows = await messageRepo.find({\n        where: { session: { id: session.id } as any },\n        relations: { creator: true },\n        order: { createdAt: 'ASC', id: 'ASC' }\n      })\n      llmMessages = buildLlmHistory(\n        rows.map(row => ({\n          id: row.id,\n          role: row.role,\n          content: stripMentionRefids(row.content ?? ''),\n          senderId: (row as any).creator?.id,\n          /* 표시 이름만 — 이메일 등 개인정보는 프롬프트에 넣지 않는다. */\n          senderName: (row as any).creator?.name || (row as any).creator?.username\n        })),\n        {\n          truncateAfterMessageId: input.truncateAfterMessageId ?? undefined,\n          /* 방금 저장한 사용자 메시지는 접은 구간보다 뒤에 있어도 반드시 남긴다. */\n          keepMessageIds: userMessageId ? [userMessageId] : []\n        }\n      )\n    } else {\n      llmMessages = input.messages.map(m => ({\n        role: m.role === 'assistant' ? 'assistant' : 'user',\n        content: stripMentionRefids(m.content)\n      }))\n    }\n\n    const r = await assistant.chat(llmMessages, input.currentBoard ?? undefined, {\n      scopes: input.scopes,\n      hostContext: input.hostContext ?? undefined,\n      /* 대화면별 도구 노출 — 미지정이면 현행(전부 허용) 그대로. */\n      toolCategories: input.toolCategories ?? undefined,\n      boardTools: input.boardTools ?? undefined,\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      /* AI 응답도 세션 활동이다 — 이걸 빼면 다른 참여자에게 \"새 소식 없음\" 으로 보인다. */\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: enrichedReply,\n        actorId: user?.id\n      })\n\n      await sessionRepo.update(session.id, {\n        aiClientId: base.id,\n        updater: user,\n        /* AI 응답도 세션 활동이다 — 이걸 빼면 다른 참여자에게 \"새 소식 없음\"으로 보인다. */\n        ...activityPatch(enrichedReply)\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"]}
+{"version":3,"file":"board-ai-resolver.js","sourceRoot":"","sources":["../../server/service/board-ai-resolver.ts"],"names":[],"mappings":"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","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 { buildLlmHistory } from './chat-message/llm-history.js'\nimport { splitByCap, summaryInstruction } from './chat-message/history-summary.js'\nimport { foldHistorySummary } from './chat-message/fold-history.js'\n\n/**\n * 모델에 넘길 최근 메시지 수 상한.\n *\n * 협의는 여럿이 며칠에 걸쳐 이어진다 — 상한 없이 전체를 매 턴 보내면 프롬프트가 무한히 자라고\n * (비용·지연·문맥 한계) 오래된 말이 최근 상황을 덮는다. 40 은 첫 경계선이다: 한 자리의 협의를\n * 담기에 넉넉하고, 넘치면 생략 사실을 모델에 알린다(조용히 버리지 않는다).\n * 버린 앞부분을 **요약해서** 실어 보내는 것이 다음 단계다(ChatSession.lastSummary 미사용 상태).\n */\nconst LLM_HISTORY_MAX_TURNS = 40\n\n/**\n * 요약을 다시 만드는 임계치 — 상한 밖으로 **새로 밀려난** 메시지 수.\n *\n * 상한을 넘긴 뒤 매 턴 요약을 만들면 대화마다 LLM 호출이 두 번씩 붙는다. 10 개씩 모아 접는다.\n */\nconst LLM_SUMMARY_THRESHOLD = 10\nimport { activityPatch, autoSessionName } from './chat-session/session-inbox.js'\nimport { publishSessionActivity } from './chat-session/session-activity-publish.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(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Host context describing what this surface is looking at (e.g. { spaceId } for a space deliberation, { boardId } for board authoring). Tools read it as ctx.state.host so the model never has to ask the user for identifiers. Client-supplied — never used for authorization; tools verify the scope belongs to the caller tenant.'\n  })\n  hostContext?: any\n\n  @Field({\n    nullable: true,\n    description:\n      'Id of the last message to keep from the stored history. The client keeps its own truncation when a user edits a message (the server history is intentionally preserved), so pass the last kept message id to hide the retracted span from the agent. Omit to use the whole stored history.'\n  })\n  truncateAfterMessageId?: string\n\n  @Field(() => [String], {\n    nullable: true,\n    description:\n      'Registered external tool categories this conversation may use (registerToolCategory names, e.g. [\"twin\", \"board-import\"]). Omit to allow every registered category. Applies to tool definitions AND execution, so a surface cannot call a category it was not granted.'\n  })\n  toolCategories?: string[]\n\n  @Field({\n    nullable: true,\n    description:\n      'Whether core board editing tools (addComponent / styling / scene actions) are available. Defaults to true. Set false for surfaces that must not modify the board — e.g. an operations chat where irreversible commands live, so reversible edits and irreversible actions never share one conversation.'\n  })\n  boardTools?: boolean\n\n  @Field({\n    nullable: true,\n    description:\n      'Force a tool call on the first turn (toolChoice: required). Turn this on for surfaces that discuss live state: the grounding guard catches invented identifiers but not an invented situation stated without any, which only happens when the model answers without querying at all. Concept / how-to questions are unaffected — they are answered through a documentation tool.'\n  })\n  requireGroundingTools?: boolean\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  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Reported when the stored history exceeded the prompt cap for this turn: { omitted, summarized }. The surface uses it to tell the user the conversation grew long — a new conversation is better for a different topic. Objective fact only; no topic-change detection.'\n  })\n  historyFolded?: any\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Action proposals the AI recorded without executing — each carries what a tool returned alongside `proposed: true`. The surface renders a confirm button; execution is the user\\'s act, never the assistant\\'s. Null when nothing was proposed.'\n  })\n  proposals?: any\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Ungrounded identifiers mentioned by the reply — present in the answer but absent from everything the model received (prompt, board context, history, tool results). Hallucination candidates surfaced to the user; the reply itself is not altered. Null when the answer is grounded.'\n  })\n  groundingWarnings?: 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      /* 세션 활동 갱신(비정규화) — 목록 최근활동순 정렬과 다른 참여자의 안 읽음 판정 기준.\n       * 이름이 아직 없으면 **첫 발화로 자동 작명** 한다 — `세션 2` 보다 \"A-DC 포화 원인\" 이 목록에서\n       * 훨씬 유용하다. 사용자가 직접 바꾼 이름은 여기서 건드리지 않는다(이름이 있으면 그대로).\n       * best-effort: 실패해도 대화를 막지 않는다(목록 정렬이 한 칸 늦을 뿐). */\n      try {\n        const patch: any = activityPatch(enriched)\n        if (!session.name) patch.name = autoSessionName(enriched)\n        await sessionRepo.update(session.id!, patch)\n      } catch {\n        /* noop */\n      }\n      /* 내가 참여한 세션 활동 방송 — 창을 닫아 둔 다른 참여자의 배지·목록을 위해. */\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: enriched,\n        actorId: user?.id\n      })\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    /* 에이전트가 볼 이력 — **세션이 있으면 서버 정본(ChatMessage)** 을 쓴다.\n     * 클라이언트가 보낸 줄을 쓰면 협의에서 참여자마다 화면이 달라 에이전트가 사람마다 다른 대화를 본다.\n     * 발신자 표기·system 기록 포함·접은 구간 제외 규칙은 buildLlmHistory 가 소유(그 파일 머리말 참조).\n     * 즉석 대화(sessionId 없음)는 영속 이력이 없으므로 클라이언트 이력을 그대로 쓴다.\n     *\n     * 정렬은 createdAt ASC + id ASC — 같은 시각 삽입의 순서까지 결정적으로 만든다(조립 쪽에서\n     * 다시 정렬하지 않으므로 여기서 확정해야 한다). 멘션 마커는 여기서 제거해 넘긴다. */\n    let llmMessages: LLMMessage[]\n    let historyFolded: { omitted: number; summarized: boolean } | undefined\n    if (session) {\n      const rows = await messageRepo.find({\n        where: { session: { id: session.id } as any },\n        relations: { creator: true },\n        order: { createdAt: 'ASC', id: 'ASC' }\n      })\n      /* 이번 턴에 상한 밖으로 밀려난 것이 있는가 — 화면이 \"대화가 길어졌다\" 를 알릴 근거(사실만). */\n      const capped = splitByCap(\n        rows.map(row => ({ id: row.id, role: row.role, content: row.content ?? '' })),\n        LLM_HISTORY_MAX_TURNS\n      )\n      if (capped.dropped.length > 0) {\n        historyFolded = { omitted: capped.dropped.length, summarized: !!(session as any).lastSummary }\n      }\n      llmMessages = buildLlmHistory(\n        rows.map(row => ({\n          id: row.id,\n          role: row.role,\n          content: stripMentionRefids(row.content ?? ''),\n          senderId: (row as any).creator?.id,\n          /* 표시 이름만 — 이메일 등 개인정보는 프롬프트에 넣지 않는다. */\n          senderName: (row as any).creator?.name || (row as any).creator?.username\n        })),\n        {\n          truncateAfterMessageId: input.truncateAfterMessageId ?? undefined,\n          /* 방금 저장한 사용자 메시지는 접은 구간보다 뒤에 있어도 반드시 남긴다. */\n          keepMessageIds: userMessageId ? [userMessageId] : [],\n          /* 이력 상한 — 협의는 며칠 이어진다. 상한이 없으면 매 턴 전체를 보내 프롬프트가 무한히 자란다. */\n          maxTurns: LLM_HISTORY_MAX_TURNS,\n          /* 밀려난 앞부분은 요약으로 대체한다(있으면). 요약은 응답 뒤에 갱신한다 — 아래 Phase D. */\n          summary: { text: (session as any).lastSummary, upToMessageId: (session as any).summaryUpToMessageId }\n        }\n      )\n    } else {\n      llmMessages = input.messages.map(m => ({\n        role: m.role === 'assistant' ? 'assistant' : 'user',\n        content: stripMentionRefids(m.content)\n      }))\n    }\n\n    const r = await assistant.chat(llmMessages, input.currentBoard ?? undefined, {\n      scopes: input.scopes,\n      hostContext: input.hostContext ?? undefined,\n      /* 대화면별 도구 노출 — 미지정이면 현행(전부 허용) 그대로. */\n      toolCategories: input.toolCategories ?? undefined,\n      boardTools: input.boardTools ?? undefined,\n      requireGroundingTools: input.requireGroundingTools ?? undefined,\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        /* 접지 경고를 함께 영속 — 나중에 읽는 참여자도 같은 주의를 봐야 한다(재계산 불가: 근거 원문이 남지 않는다).\n         * 컬럼 길이(1024) 안에 들도록 앞 20개까지만 — 그 이상이면 목록이 아니라 답 자체가 문제다. */\n        groundingWarnings:\n          r.groundingWarnings && r.groundingWarnings.length > 0\n            ? JSON.stringify(r.groundingWarnings.slice(0, 20))\n            : 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      /* AI 응답도 세션 활동이다 — 이걸 빼면 다른 참여자에게 \"새 소식 없음\" 으로 보인다. */\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: enrichedReply,\n        actorId: user?.id\n      })\n\n      await sessionRepo.update(session.id, {\n        aiClientId: base.id,\n        updater: user,\n        /* AI 응답도 세션 활동이다 — 이걸 빼면 다른 참여자에게 \"새 소식 없음\"으로 보인다. */\n        ...activityPatch(enrichedReply)\n      })\n\n      /* ── Phase D: 이력 요약 접기 ────────────────────────────────────────────\n       * 응답을 **돌려준 뒤** 갱신한다 — 사용자 대기 시간에 요약용 LLM 호출을 얹지 않는다.\n       * 기다리지 않으므로(await 없음) 실패해도 대화에는 영향이 없다: 요약이 없으면 다음 턴은\n       * \"N개 생략\" 으로 정직하게 알리고 넘어간다(조용한 맥락 상실이 아니다). */\n      void this._foldHistorySummary(session.id!, domain.id, base)\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      proposals: r.proposals && r.proposals.length > 0 ? r.proposals : null,\n      historyFolded: historyFolded ?? null,\n      groundingWarnings: r.groundingWarnings && r.groundingWarnings.length > 0 ? r.groundingWarnings : null\n    }\n  }\n\n  /**\n   * 이력 요약 접기 — 상한 밖으로 밀려난 앞부분을 요약으로 눌러 담는다.\n   *\n   * 왜 이렇게 나눠 두었나: 판정(무엇을 요약할지·다시 만들 때인지)은 순수 로직(history-summary)이\n   * 갖고, 여기서는 **호출과 저장**만 한다. 그래야 규칙을 테스트로 고정할 수 있다.\n   *\n   * 아껴 만든다: 새로 밀려난 것이 임계치를 넘을 때만 LLM 을 부른다(상한을 넘긴 뒤 매 턴 부르면\n   * 대화마다 호출이 두 번씩 붙는다). 실패는 조용히 넘긴다 — 다음 턴이 \"생략\" 으로 알리고,\n   * 다음 임계치에서 다시 시도한다.\n   */\n  private async _foldHistorySummary(\n    sessionId: string,\n    domainId: string,\n    client: AIClient\n  ): Promise<void> {\n    try {\n      const sessionRepo = getRepository(ChatSession)\n      const session = await sessionRepo.findOneBy({ id: sessionId, domain: { id: domainId } as any })\n      if (!session) return\n      const rows = await getRepository(ChatMessage).find({\n        where: { session: { id: sessionId } as any },\n        relations: { creator: true },\n        order: { createdAt: 'ASC', id: 'ASC' }\n      })\n      const history = rows.map(row => ({\n        id: row.id,\n        role: row.role,\n        content: stripMentionRefids(row.content ?? ''),\n        senderId: (row as any).creator?.id,\n        senderName: (row as any).creator?.name || (row as any).creator?.username\n      }))\n      const { patch } = await foldHistorySummary({\n        rows: history,\n        stored: {\n          text: (session as any).lastSummary,\n          upToMessageId: (session as any).summaryUpToMessageId\n        },\n        maxTurns: LLM_HISTORY_MAX_TURNS,\n        threshold: LLM_SUMMARY_THRESHOLD,\n        summarize: content =>\n          client.chat([{ role: 'user', content }], {\n            systemPrompt: summaryInstruction(),\n            maxTokens: 700,\n            /* 요약은 창작이 아니다 — 흔들림을 줄인다. */\n            temperature: 0\n          })\n      })\n      if (patch) await sessionRepo.update(sessionId, patch as any)\n    } catch {\n      /* 요약 실패는 대화를 막지 않는다 — 다음 턴은 \"생략\" 으로 정직하게 알린다. */\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/chat-message/chat-message.d.ts

@@ -21,6 +21,18 @@ export declare class ChatMessage {
     toolUsages?: string;
     /** GraphQL 노출용 — JSON 배열로 parse. */
     get toolUsagesJson(): any;
+    /**
+     * 접지 경고 — 이 답이 언급했으나 근거(프롬프트·보드 문맥·이력·도구 결과)에 없던 식별자 목록.
+     *
+     * **왜 영속하는가**: 도크의 협의는 여러 사람이 며칠에 걸쳐 읽는다. 경고가 그 자리에서만
+     * 보이고 새로 고치면 사라지면, 나중에 읽는 사람은 검증되지 않은 문장을 검증된 것으로 읽는다.
+     * 다시 계산할 수도 없다 — 근거였던 도구 결과 원문은 남지 않고 압축본만 남기 때문이다.
+     *
+     * 형태: string[] 를 JSON-stringify. 비었으면 null(= 접지 정상).
+     */
+    groundingWarnings?: string;
+    /** GraphQL 노출용 — 식별자 배열로 parse. */
+    get groundingWarningsJson(): any;
     /**
      * 메시지를 일으킨 사용자.
      *   - role='user' → 보낸 사용자

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

@@ -30,6 +30,17 @@ let ChatMessage = class ChatMessage {
             return null;
         }
     }
+    /** GraphQL 노출용 — 식별자 배열로 parse. */
+    get groundingWarningsJson() {
+        if (!this.groundingWarnings)
+            return null;
+        try {
+            return JSON.parse(this.groundingWarnings);
+        }
+        catch {
+            return null;
+        }
+    }
 };
 exports.ChatMessage = ChatMessage;
 tslib_1.__decorate([
@@ -96,6 +107,18 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:type", Object),
     tslib_1.__metadata("design:paramtypes", [])
 ], ChatMessage.prototype, "toolUsagesJson", null);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 1024, nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "groundingWarnings", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Ungrounded identifiers mentioned by this reply (hallucination candidates). Null when grounded.'
+    }),
+    tslib_1.__metadata("design:type", Object),
+    tslib_1.__metadata("design:paramtypes", [])
+], ChatMessage.prototype, "groundingWarningsJson", null);
 tslib_1.__decorate([
     (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
     (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who triggered this message.' }),

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

@@ -1 +1 @@
-{"version":3,"file":"chat-message.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatMessage — ChatSession 의 한 메시지.\n *\n * role: 'user' | 'assistant' | 'system'\n * 'system' 은 사용자 직접 편집/import 진행 등 시스템이 자동 생성하는 컨텍스트 메시지.\n *\n * relatedPatchId / relatedImportSessionId 로 메시지가 트리거한 패치·임포트와 연결.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_chat_message_1', (message: ChatMessage) => [message.session, message.createdAt])\n@ObjectType({ description: 'A single chat message in a ChatSession.' })\nexport class ChatMessage {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => ChatSession, session => session.messages, { onDelete: 'CASCADE' })\n  session?: ChatSession\n\n  @RelationId((message: ChatMessage) => message.session)\n  sessionId?: string\n\n  @Column({ type: 'varchar', length: 16 })\n  @Field({ description: \"'user' | 'assistant' | 'system'\" })\n  role!: string\n\n  @Column({\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({ description: 'Message content' })\n  content!: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'PatchEntry.id this message triggered (if any).' })\n  relatedPatchId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'ImportSession.id this message triggered (if any).' })\n  relatedImportSessionId?: string\n\n  /**\n   * AI 가 응답을 만드는 동안 호출한 도구 trace — JSON-stringified.\n   *\n   * 컬럼은 string (PatchEntry.ops 와 동일 패턴), GraphQL 노출은 toolUsagesJson getter\n   * 로 parse 된 객체. UI 의 fold-able 박스 (\"AI 가 이런 도구를 사용했습니다\") 가\n   * 페이지 reload / loadHistory 후에도 살아있도록 영속.\n   *\n   * 형태: ToolUsage[] (assistant.ts 의 시간순 trace, summarizeToolResult 로 압축).\n   * null 이면 도구 호출 없었던 메시지 (text-only 응답).\n   */\n  @Column({\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    nullable: true\n  })\n  toolUsages?: string\n\n  /** GraphQL 노출용 — JSON 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.'\n  })\n  get toolUsagesJson(): any {\n    if (!this.toolUsages) return null\n    try {\n      return JSON.parse(this.toolUsages)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 메시지를 일으킨 사용자.\n   *   - role='user' → 보낸 사용자\n   *   - role='assistant' → 그 응답을 트리거한 사용자 (직전 user 메시지의 작성자)\n   *   - role='system' → 시스템 액션을 일으킨 사용자 (예: 직접 편집한 사용자)\n   *\n   * nullable — legacy 메시지 (이 필드 추가 이전에 작성) 는 null. 또한 ad-hoc 모드 / 시스템\n   * 자동 메시지 중 사용자 컨텍스트가 없는 경우도 null 가능.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'User who triggered this message.' })\n  creator?: User\n\n  @RelationId((message: ChatMessage) => message.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Last user to update this message (for future edit support).' })\n  updater?: User\n\n  @RelationId((message: ChatMessage) => message.updater)\n  updaterId?: string\n\n  /**\n   * 부모 메시지 — 이 메시지가 \"응답하는 대상\" / \"이어가는 메시지\" 의 id.\n   *\n   * 의미 (role 별):\n   *   - 'user' → 직전 in-session 메시지 (보통 assistant 또는 system). 첫 turn 은 null.\n   *   - 'assistant' → 이 응답이 답하는 user 메시지. (regenerate 로 같은 user 메시지를 부모로\n   *     하는 형제 assistant 메시지가 생기면 자연스럽게 branching tree 가 됨)\n   *   - 'system' → 직전 in-session 메시지 (timeline 연속성 유지).\n   *\n   * 이 한 컬럼으로 향후 어떤 흐름이든 표현 가능 — linear chain / branching (regenerate) /\n   * tree (replies-to-specific-message) 등. UI/쿼리는 점진 도입.\n   *\n   * onDelete: 'SET NULL' — 부모 메시지가 삭제돼도 child 는 남되 dangling 마킹.\n   */\n  @ManyToOne(type => ChatMessage, { nullable: true, onDelete: 'SET NULL' })\n  parentMessage?: ChatMessage\n\n  @RelationId((message: ChatMessage) => message.parentMessage)\n  @Field({\n    nullable: true,\n    description:\n      'Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.'\n  })\n  parentMessageId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp (relevant once message editing is supported).' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft delete timestamp.' })\n  deletedAt?: Date\n}\n"]}
+{"version":3,"file":"chat-message.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatMessage — ChatSession 의 한 메시지.\n *\n * role: 'user' | 'assistant' | 'system'\n * 'system' 은 사용자 직접 편집/import 진행 등 시스템이 자동 생성하는 컨텍스트 메시지.\n *\n * relatedPatchId / relatedImportSessionId 로 메시지가 트리거한 패치·임포트와 연결.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_chat_message_1', (message: ChatMessage) => [message.session, message.createdAt])\n@ObjectType({ description: 'A single chat message in a ChatSession.' })\nexport class ChatMessage {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => ChatSession, session => session.messages, { onDelete: 'CASCADE' })\n  session?: ChatSession\n\n  @RelationId((message: ChatMessage) => message.session)\n  sessionId?: string\n\n  @Column({ type: 'varchar', length: 16 })\n  @Field({ description: \"'user' | 'assistant' | 'system'\" })\n  role!: string\n\n  @Column({\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({ description: 'Message content' })\n  content!: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'PatchEntry.id this message triggered (if any).' })\n  relatedPatchId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'ImportSession.id this message triggered (if any).' })\n  relatedImportSessionId?: string\n\n  /**\n   * AI 가 응답을 만드는 동안 호출한 도구 trace — JSON-stringified.\n   *\n   * 컬럼은 string (PatchEntry.ops 와 동일 패턴), GraphQL 노출은 toolUsagesJson getter\n   * 로 parse 된 객체. UI 의 fold-able 박스 (\"AI 가 이런 도구를 사용했습니다\") 가\n   * 페이지 reload / loadHistory 후에도 살아있도록 영속.\n   *\n   * 형태: ToolUsage[] (assistant.ts 의 시간순 trace, summarizeToolResult 로 압축).\n   * null 이면 도구 호출 없었던 메시지 (text-only 응답).\n   */\n  @Column({\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    nullable: true\n  })\n  toolUsages?: string\n\n  /** GraphQL 노출용 — JSON 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.'\n  })\n  get toolUsagesJson(): any {\n    if (!this.toolUsages) return null\n    try {\n      return JSON.parse(this.toolUsages)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 접지 경고 — 이 답이 언급했으나 근거(프롬프트·보드 문맥·이력·도구 결과)에 없던 식별자 목록.\n   *\n   * **왜 영속하는가**: 도크의 협의는 여러 사람이 며칠에 걸쳐 읽는다. 경고가 그 자리에서만\n   * 보이고 새로 고치면 사라지면, 나중에 읽는 사람은 검증되지 않은 문장을 검증된 것으로 읽는다.\n   * 다시 계산할 수도 없다 — 근거였던 도구 결과 원문은 남지 않고 압축본만 남기 때문이다.\n   *\n   * 형태: string[] 를 JSON-stringify. 비었으면 null(= 접지 정상).\n   */\n  @Column({ type: 'varchar', length: 1024, nullable: true })\n  groundingWarnings?: string\n\n  /** GraphQL 노출용 — 식별자 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description: 'Ungrounded identifiers mentioned by this reply (hallucination candidates). Null when grounded.'\n  })\n  get groundingWarningsJson(): any {\n    if (!this.groundingWarnings) return null\n    try {\n      return JSON.parse(this.groundingWarnings)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 메시지를 일으킨 사용자.\n   *   - role='user' → 보낸 사용자\n   *   - role='assistant' → 그 응답을 트리거한 사용자 (직전 user 메시지의 작성자)\n   *   - role='system' → 시스템 액션을 일으킨 사용자 (예: 직접 편집한 사용자)\n   *\n   * nullable — legacy 메시지 (이 필드 추가 이전에 작성) 는 null. 또한 ad-hoc 모드 / 시스템\n   * 자동 메시지 중 사용자 컨텍스트가 없는 경우도 null 가능.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'User who triggered this message.' })\n  creator?: User\n\n  @RelationId((message: ChatMessage) => message.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Last user to update this message (for future edit support).' })\n  updater?: User\n\n  @RelationId((message: ChatMessage) => message.updater)\n  updaterId?: string\n\n  /**\n   * 부모 메시지 — 이 메시지가 \"응답하는 대상\" / \"이어가는 메시지\" 의 id.\n   *\n   * 의미 (role 별):\n   *   - 'user' → 직전 in-session 메시지 (보통 assistant 또는 system). 첫 turn 은 null.\n   *   - 'assistant' → 이 응답이 답하는 user 메시지. (regenerate 로 같은 user 메시지를 부모로\n   *     하는 형제 assistant 메시지가 생기면 자연스럽게 branching tree 가 됨)\n   *   - 'system' → 직전 in-session 메시지 (timeline 연속성 유지).\n   *\n   * 이 한 컬럼으로 향후 어떤 흐름이든 표현 가능 — linear chain / branching (regenerate) /\n   * tree (replies-to-specific-message) 등. UI/쿼리는 점진 도입.\n   *\n   * onDelete: 'SET NULL' — 부모 메시지가 삭제돼도 child 는 남되 dangling 마킹.\n   */\n  @ManyToOne(type => ChatMessage, { nullable: true, onDelete: 'SET NULL' })\n  parentMessage?: ChatMessage\n\n  @RelationId((message: ChatMessage) => message.parentMessage)\n  @Field({\n    nullable: true,\n    description:\n      'Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.'\n  })\n  parentMessageId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp (relevant once message editing is supported).' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft delete timestamp.' })\n  deletedAt?: Date\n}\n"]}

package/dist-server/service/chat-message/fold-history.d.ts

@@ -0,0 +1,30 @@
+import type { HistoryRow } from './llm-history.js';
+import { type StoredSummary } from './history-summary.js';
+export interface FoldHistoryInput {
+    /** 시간 오름차순 이력 전체. */
+    rows: HistoryRow[];
+    /** 세션에 저장된 요약 상태. */
+    stored?: StoredSummary;
+    /** 프롬프트 상한(이 밖으로 밀려난 것이 요약 대상). */
+    maxTurns: number;
+    /** 새로 밀려난 것이 이 수 이상일 때만 요약을 만든다(매 턴 호출 방지). */
+    threshold: number;
+    /** 요약 생성 — 실패하면 throw 하거나 빈 문자열을 돌려주면 된다(둘 다 "접지 않음" 으로 처리). */
+    summarize: (content: string) => Promise<string | undefined | null>;
+}
+export interface FoldHistoryResult {
+    /** 세션에 저장할 값. null 이면 이번엔 접지 않는다(대상 없음·임계치 미만·생성 실패). */
+    patch: {
+        lastSummary: string;
+        summaryUpToMessageId?: string;
+    } | null;
+    /** 접지 않은 이유 — 관측·테스트용(조용한 무동작을 남기지 않는다). */
+    skipped?: 'nothing-dropped' | 'below-threshold' | 'empty-summary' | 'failed';
+}
+/**
+ * 접을지 판정하고, 접어야 하면 요약을 만들어 저장 값을 돌려준다.
+ *
+ * 실패를 삼키되 **왜 안 접었는지**는 남긴다 — 조용한 무동작은 나중에 "요약이 왜 안 생기지" 를
+ * 추적 불가능하게 만든다.
+ */
+export declare function foldHistorySummary(input: FoldHistoryInput): Promise<FoldHistoryResult>;

package/dist-server/service/chat-message/fold-history.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foldHistorySummary = foldHistorySummary;
+const history_summary_js_1 = require("./history-summary.js");
+/**
+ * 접을지 판정하고, 접어야 하면 요약을 만들어 저장 값을 돌려준다.
+ *
+ * 실패를 삼키되 **왜 안 접었는지**는 남긴다 — 조용한 무동작은 나중에 "요약이 왜 안 생기지" 를
+ * 추적 불가능하게 만든다.
+ */
+async function foldHistorySummary(input) {
+    const { dropped } = (0, history_summary_js_1.splitByCap)(input.rows, input.maxTurns);
+    if (dropped.length === 0)
+        return { patch: null, skipped: 'nothing-dropped' };
+    const pending = (0, history_summary_js_1.pendingForSummary)(dropped, input.stored);
+    if (!(0, history_summary_js_1.shouldResummarize)(pending, input.threshold))
+        return { patch: null, skipped: 'below-threshold' };
+    let text;
+    try {
+        text = await input.summarize((0, history_summary_js_1.summaryUserContent)(input.stored?.text, pending));
+    }
+    catch {
+        return { patch: null, skipped: 'failed' };
+    }
+    if (!text || !text.trim())
+        return { patch: null, skipped: 'empty-summary' };
+    return { patch: (0, history_summary_js_1.summaryPatch)(text, pending) };
+}
+//# sourceMappingURL=fold-history.js.map

package/dist-server/service/chat-message/fold-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-history.js","sourceRoot":"","sources":["../../../server/service/chat-message/fold-history.ts"],"names":[],"mappings":";;AA2CA,gDAgBC;AAnDD,6DAO6B;AAsB7B;;;;;GAKG;AACI,KAAK,UAAU,kBAAkB,CAAC,KAAuB;IAC9D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,+BAAU,EAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAE5E,MAAM,OAAO,GAAG,IAAA,sCAAiB,EAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACxD,IAAI,CAAC,IAAA,sCAAiB,EAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAEpG,IAAI,IAA+B,CAAA;IACnC,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,IAAA,uCAAkB,EAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;IAC3C,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAA;IAE3E,OAAO,EAAE,KAAK,EAAE,IAAA,iCAAY,EAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAA;AAC/C,CAAC","sourcesContent":["/*\n * 요약 접기 오케스트레이션 — **판정과 조립은 여기, DB 는 호출부**.\n *\n * 왜 분리하는가: 요약을 만드는 결정(무엇을·언제·무엇에 이어)은 규칙이고, 규칙은 테스트로 고정할 수\n * 있어야 한다. 리졸버 안에 두면 DB 없이 검증할 수 없어 \"배선했지만 한 번도 안 돌아본\" 코드가 된다.\n * 요약 생성기(LLM)와 이력·저장은 호출부가 주입한다.\n */\nimport type { HistoryRow } from './llm-history.js'\nimport {\n  splitByCap,\n  pendingForSummary,\n  shouldResummarize,\n  summaryUserContent,\n  summaryPatch,\n  type StoredSummary\n} from './history-summary.js'\n\nexport interface FoldHistoryInput {\n  /** 시간 오름차순 이력 전체. */\n  rows: HistoryRow[]\n  /** 세션에 저장된 요약 상태. */\n  stored?: StoredSummary\n  /** 프롬프트 상한(이 밖으로 밀려난 것이 요약 대상). */\n  maxTurns: number\n  /** 새로 밀려난 것이 이 수 이상일 때만 요약을 만든다(매 턴 호출 방지). */\n  threshold: number\n  /** 요약 생성 — 실패하면 throw 하거나 빈 문자열을 돌려주면 된다(둘 다 \"접지 않음\" 으로 처리). */\n  summarize: (content: string) => Promise<string | undefined | null>\n}\n\nexport interface FoldHistoryResult {\n  /** 세션에 저장할 값. null 이면 이번엔 접지 않는다(대상 없음·임계치 미만·생성 실패). */\n  patch: { lastSummary: string; summaryUpToMessageId?: string } | null\n  /** 접지 않은 이유 — 관측·테스트용(조용한 무동작을 남기지 않는다). */\n  skipped?: 'nothing-dropped' | 'below-threshold' | 'empty-summary' | 'failed'\n}\n\n/**\n * 접을지 판정하고, 접어야 하면 요약을 만들어 저장 값을 돌려준다.\n *\n * 실패를 삼키되 **왜 안 접었는지**는 남긴다 — 조용한 무동작은 나중에 \"요약이 왜 안 생기지\" 를\n * 추적 불가능하게 만든다.\n */\nexport async function foldHistorySummary(input: FoldHistoryInput): Promise<FoldHistoryResult> {\n  const { dropped } = splitByCap(input.rows, input.maxTurns)\n  if (dropped.length === 0) return { patch: null, skipped: 'nothing-dropped' }\n\n  const pending = pendingForSummary(dropped, input.stored)\n  if (!shouldResummarize(pending, input.threshold)) return { patch: null, skipped: 'below-threshold' }\n\n  let text: string | undefined | null\n  try {\n    text = await input.summarize(summaryUserContent(input.stored?.text, pending))\n  } catch {\n    return { patch: null, skipped: 'failed' }\n  }\n  if (!text || !text.trim()) return { patch: null, skipped: 'empty-summary' }\n\n  return { patch: summaryPatch(text, pending) }\n}\n"]}