@things-factory/board-ai 10.1.7 → 10.1.13

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

@@ -40,6 +40,7 @@ declare class BoardAIChatOutput {
     historyFolded?: any;
     proposals?: any;
     groundingWarnings?: any;
+    analysis?: any;
 }
 export declare class BoardAIChatResolver {
     /**

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

@@ -262,6 +262,13 @@ tslib_1.__decorate([
     }),
     tslib_1.__metadata("design:type", Object)
 ], BoardAIChatOutput.prototype, "groundingWarnings", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Grounded analysis contract for this turn: scope, evidence-backed claims, limitations, proposal and explicit approval boundary. Null when the turn did not perform an analysis.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], BoardAIChatOutput.prototype, "analysis", void 0);
 BoardAIChatOutput = tslib_1.__decorate([
     (0, type_graphql_1.ObjectType)()
 ], BoardAIChatOutput);
@@ -494,7 +501,8 @@ let BoardAIChatResolver = class BoardAIChatResolver {
             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
+            groundingWarnings: r.groundingWarnings && r.groundingWarnings.length > 0 ? r.groundingWarnings : null,
+            analysis: r.analysis ?? null
         };
     }
     /**

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 { MoreThan } from 'typeorm'\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 { effectiveBoardTools } from './board-tool-rights.js'\nimport type { LLMMessage } from './types.js'\nimport { ChatSession } from '@things-factory/ai-assistant'\nimport { ChatMessage } from '@things-factory/ai-assistant'\nimport { buildLlmHistory } from '@things-factory/ai-assistant'\nimport { splitByCap, summaryInstruction } from '@things-factory/ai-assistant'\nimport { foldHistorySummary } from '@things-factory/ai-assistant'\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 '@things-factory/ai-assistant'\nimport { publishSessionActivity } from '@things-factory/ai-assistant'\nimport { publishChatMessage } from '@things-factory/ai-assistant'\nimport { PatchEntry } from './patch-entry/patch-entry.js'\nimport { publishBoardPatch } from './patch-entry/board-patch-subscription.js'\nimport { ChatSessionParticipant } from '@things-factory/ai-assistant'\nimport { buildInviteNotification } from '@things-factory/ai-assistant'\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  /*\n   * ── 이 문은 「묻는 것」이지 「보드를 고치는 것」이 아니다 (2026-09-10) ──────────\n   * 공장 현황을 묻는 화면이 **보드 편집 권한**을 요구하던 것이 이 분리의 시작이었다. 대화는\n   * `ai-assistant:mutation`, 보드 편집은 `board-ai:mutation` — 둘은 다른 능력이다.\n   *\n   * ⚠ 문만 바꾸면 **거꾸로 넓어진다.** 코어 보드 편집 도구가 기본으로 켜져 있으므로, 대화 권한만\n   * 가진 사람이 이 문으로 보드를 고치게 된다. 그래서 아래에서 **보드 편집 권한을 따로 보고**\n   * 없으면 그 도구를 끈다(§`effectiveBoardTools`).\n   */\n  @Directive('@privilege(category: \"ai-assistant\", 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: await effectiveBoardTools(input.boardTools, context),\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\n      const stored = {\n        text: (session as any).lastSummary,\n        upToMessageId: (session as any).summaryUpToMessageId\n      }\n      const { rows, startsAfterSummary } = await this._historyForFold(sessionId, stored)\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        rowsStartAfterSummary: startsAfterSummary,\n        stored,\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   * 요약에 필요한 만큼만 읽는다 — **요약이 덮은 지점 뒤부터.**\n   *\n   * ── 왜 (2026-08-20) ─────────────────────────────────────────────────────────\n   * 이 함수를 부르는 자리는 **메시지를 보낼 때마다**다. 예전에는 세션의 대화를 처음부터 끝까지 읽었고\n   * (`creator` 조인까지), 정작 쓰는 것은 두 조각뿐이었다: 마지막 `maxTurns`개와, 요약 워터마크 뒤부터의\n   * 미반영분. 대화가 2,000개면 매 메시지마다 2,000행을 읽어 수십 행을 쓴 셈이다.\n   *\n   * 워터마크 뒤부터 읽으면 그 구간이 곧 `미반영분 + 최근 유지분`이라, 읽는 행 수가 **대화 길이와\n   * 무관**해진다(정상 상태에서 대략 `threshold + maxTurns`).\n   *\n   * ── 안전 규율을 지킨다 ──────────────────────────────────────────────────────\n   * 워터마크 행이 지워졌거나(삭제·편집) 요약이 아직 없으면 **전체를 읽는다.** 그때는 요약이 어디까지\n   * 덮는지 알 수 없고, 「빠뜨리는 쪽보다 다시 요약하는 쪽이 안전하다」는 것이 이 기능의 규율이다\n   * (`pendingForSummary` 주석). 그 경우는 드물다.\n   *\n   * 순서는 `(createdAt, id)` — 읽는 순서와 자르는 기준이 같아야 한다. 같은 시각의 메시지가 있으면\n   * id 로 가른다(원래 정렬이 이미 그 규약이다).\n   */\n  private async _historyForFold(\n    sessionId: string,\n    stored: { text?: string | null; upToMessageId?: string | null }\n  ): Promise<{ rows: ChatMessage[]; startsAfterSummary: boolean }> {\n    const repo = getRepository(ChatMessage)\n    const session = { id: sessionId } as any\n    const order = { createdAt: 'ASC', id: 'ASC' } as any\n    const relations = { creator: true } as any\n\n    if (stored.text && stored.upToMessageId) {\n      const mark = await repo.findOne({ where: { session, id: stored.upToMessageId } })\n      if (mark?.createdAt) {\n        const rows = await repo.find({\n          /* 배열 = OR. 같은 시각 안에서는 id 로 이어 자른다(정렬 규약과 같은 축). */\n          where: [\n            { session, createdAt: MoreThan(mark.createdAt) },\n            { session, createdAt: mark.createdAt, id: MoreThan(mark.id) }\n          ],\n          relations,\n          order\n        })\n        return { rows, startsAfterSummary: true }\n      }\n    }\n\n    /* 워터마크가 없거나 그 행이 사라졌다 — 덮은 범위를 모르므로 전부 다시 본다. */\n    return { rows: await repo.find({ where: { session }, relations, order }), startsAfterSummary: false }\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":";;;;AAAA;;;;;GAKG;AACH,+CAAyG;AACzG,qDAA6C;AAC7C,qCAAkC;AAClC,qCAAkC;AAElC,6CAA4C;AAC5C,iDAAqD;AACrD,mEAAkG;AAGlG,iDAAwD;AACxD,iEAA4D;AAE5D,+DAA0D;AAC1D,+DAA0D;AAC1D,+DAA8D;AAC9D,+DAA6E;AAC7E,+DAAiE;AAEjE;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEhC;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAChC,+DAA6E;AAC7E,+DAAqE;AACrE,+DAAiE;AACjE,iEAAyD;AACzD,2FAA6E;AAC7E,+DAAqE;AACrE,gEAAsE;AACtE,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;CA2GrB,CAAA;AAtGC;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;AAOjB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,oUAAoU;KACvU,CAAC;;qDACe;AAOjB;IALC,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,4RAA4R;KAC/R,CAAC;;gEAC6B;AAO/B;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;QACrB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,wQAAwQ;KAC3Q,CAAC;;wDACuB;AAOzB;IALC,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,ySAAyS;KAC5S,CAAC;;oDACkB;AAOpB;IALC,IAAA,oBAAK,EAAC;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,kXAAkX;KACrX,CAAC;;+DAC6B;AAM/B;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;AA1Gd,gBAAgB;IADrB,IAAA,wBAAS,GAAE;GACN,gBAAgB,CA2GrB;AAGD,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAkEtB,CAAA;AAhEC;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;AAOb;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,wQAAwQ;KAC3Q,CAAC;;wDACiB;AAOnB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,gPAAgP;KACnP,CAAC;;oDACa;AAOf;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,uRAAuR;KAC1R,CAAC;;4DACqB;AAOvB;IALC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,gLAAgL;KACnL,CAAC;;mDACY;AAjEV,iBAAiB;IADtB,IAAA,yBAAU,GAAE;GACP,iBAAiB,CAkEtB;AAGM,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B;;;;;;OAMG;IAcG,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,0BAAW,CAAC,CAAA;QAC9C,MAAM,WAAW,GAAG,IAAA,qBAAa,EAAC,0BAAW,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;;;gEAGoD;YACpD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAQ,IAAA,4BAAa,EAAC,QAAQ,CAAC,CAAA;gBAC1C,IAAI,CAAC,OAAO,CAAC,IAAI;oBAAE,KAAK,CAAC,IAAI,GAAG,IAAA,8BAAe,EAAC,QAAQ,CAAC,CAAA;gBACzD,MAAM,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAG,EAAE,KAAK,CAAC,CAAA;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;YACD,kDAAkD;YAClD,IAAA,qCAAsB,EAAC;gBACrB,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,SAAS,EAAE,OAAO,CAAC,EAAG;gBACtB,IAAI,EAAE,SAAS;gBACf,UAAU,EAAG,OAAe,CAAC,UAAU;gBACvC,QAAQ,EAAG,OAAe,CAAC,QAAQ;gBACnC,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,IAAI,EAAE,EAAE;aAClB,CAAC,CAAA;YAEF,sDAAsD;YACtD,uCAAuC;YACvC,IAAA,iCAAkB,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;;;;;;4DAMoD;QACpD,IAAI,WAAyB,CAAA;QAC7B,IAAI,aAAmE,CAAA;QACvE,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC;gBAClC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAS,EAAE;gBAC7C,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC5B,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE;aACvC,CAAC,CAAA;YACF,4DAA4D;YAC5D,MAAM,MAAM,GAAG,IAAA,yBAAU,EACvB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,EAC7E,qBAAqB,CACtB,CAAA;YACD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,aAAa,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAE,OAAe,CAAC,WAAW,EAAE,CAAA;YAChG,CAAC;YACD,WAAW,GAAG,IAAA,8BAAe,EAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACf,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,IAAA,sCAAkB,EAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC9C,QAAQ,EAAG,GAAW,CAAC,OAAO,EAAE,EAAE;gBAClC,wCAAwC;gBACxC,UAAU,EAAG,GAAW,CAAC,OAAO,EAAE,IAAI,IAAK,GAAW,CAAC,OAAO,EAAE,QAAQ;aACzE,CAAC,CAAC,EACH;gBACE,sBAAsB,EAAE,KAAK,CAAC,sBAAsB,IAAI,SAAS;gBACjE,6CAA6C;gBAC7C,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;gBACpD,4DAA4D;gBAC5D,QAAQ,EAAE,qBAAqB;gBAC/B,2DAA2D;gBAC3D,OAAO,EAAE,EAAE,IAAI,EAAG,OAAe,CAAC,WAAW,EAAE,aAAa,EAAG,OAAe,CAAC,oBAAoB,EAAE;aACtG,CACF,CAAA;QACH,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;gBACnD,OAAO,EAAE,IAAA,sCAAkB,EAAC,CAAC,CAAC,OAAO,CAAC;aACvC,CAAC,CAAC,CAAA;QACL,CAAC;QAED,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS,EAAE;YAC3E,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS;YAC3C,uCAAuC;YACvC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,SAAS;YACjD,UAAU,EAAE,MAAM,IAAA,0CAAmB,EAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC;YAChE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,IAAI,SAAS;YAC/D,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;6EAC6D;gBAC7D,iBAAiB,EACf,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;oBACnD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClD,CAAC,CAAC,SAAS;gBACf,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,iCAAkB,EAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;YAClF,uDAAuD;YACvD,IAAA,qCAAsB,EAAC;gBACrB,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,SAAS,EAAE,OAAO,CAAC,EAAG;gBACtB,IAAI,EAAE,SAAS;gBACf,UAAU,EAAG,OAAe,CAAC,UAAU;gBACvC,QAAQ,EAAG,OAAe,CAAC,QAAQ;gBACnC,OAAO,EAAE,aAAa;gBACtB,OAAO,EAAE,IAAI,EAAE,EAAE;aAClB,CAAC,CAAA;YAEF,MAAM,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE;gBACnC,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,OAAO,EAAE,IAAI;gBACb,sDAAsD;gBACtD,GAAG,IAAA,4BAAa,EAAC,aAAa,CAAC;aAChC,CAAC,CAAA;YAEF;;;2DAG+C;YAC/C,KAAK,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAG,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC7D,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;YAC7D,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YACrE,aAAa,EAAE,aAAa,IAAI,IAAI;YACpC,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI;YACrG,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;SAC7B,CAAA;IACH,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK,CAAC,mBAAmB,CAC/B,SAAiB,EACjB,QAAgB,EAChB,MAAgB;QAEhB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAA,qBAAa,EAAC,0BAAW,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAS,EAAE,CAAC,CAAA;YAC/F,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,MAAM,MAAM,GAAG;gBACb,IAAI,EAAG,OAAe,CAAC,WAAW;gBAClC,aAAa,EAAG,OAAe,CAAC,oBAAoB;aACrD,CAAA;YACD,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;YAClF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC/B,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,IAAA,sCAAkB,EAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC9C,QAAQ,EAAG,GAAW,CAAC,OAAO,EAAE,EAAE;gBAClC,UAAU,EAAG,GAAW,CAAC,OAAO,EAAE,IAAI,IAAK,GAAW,CAAC,OAAO,EAAE,QAAQ;aACzE,CAAC,CAAC,CAAA;YACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAA,iCAAkB,EAAC;gBACzC,IAAI,EAAE,OAAO;gBACb,qBAAqB,EAAE,kBAAkB;gBACzC,MAAM;gBACN,QAAQ,EAAE,qBAAqB;gBAC/B,SAAS,EAAE,qBAAqB;gBAChC,SAAS,EAAE,OAAO,CAAC,EAAE,CACnB,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE;oBACvC,YAAY,EAAE,IAAA,iCAAkB,GAAE;oBAClC,SAAS,EAAE,GAAG;oBACd,6BAA6B;oBAC7B,WAAW,EAAE,CAAC;iBACf,CAAC;aACL,CAAC,CAAA;YACF,IAAI,KAAK;gBAAE,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,KAAY,CAAC,CAAA;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACK,KAAK,CAAC,eAAe,CAC3B,SAAiB,EACjB,MAA+D;QAE/D,MAAM,IAAI,GAAG,IAAA,qBAAa,EAAC,0BAAW,CAAC,CAAA;QACvC,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,SAAS,EAAS,CAAA;QACxC,MAAM,KAAK,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAS,CAAA;QACpD,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,IAAI,EAAS,CAAA;QAE1C,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;YACjF,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;oBAC3B,mDAAmD;oBACnD,KAAK,EAAE;wBACL,EAAE,OAAO,EAAE,SAAS,EAAE,IAAA,kBAAQ,EAAC,IAAI,CAAC,SAAS,CAAC,EAAE;wBAChD,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAA,kBAAQ,EAAC,IAAI,CAAC,EAAE,CAAC,EAAE;qBAC9D;oBACD,SAAS;oBACT,KAAK;iBACN,CAAC,CAAA;gBACF,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAA;YAC3C,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAA;IACvG,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,qCAAsB,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,uCAAuB,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;AAhbY,kDAAmB;AAqBxB;IAbL,IAAA,uBAAQ,EAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE;QACjC,WAAW,EAAE,+DAA+D;KAC7E,CAAC;IACF;;;;;;;;OAQG;;IACF,IAAA,wBAAS,EAAC,6DAA6D,CAAC;IAEtE,mBAAA,IAAA,kBAAG,EAAC,OAAO,CAAC,CAAA;IACZ,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CADe,gBAAgB;;sDAsPtC;8BA5QU,mBAAmB;IAD/B,IAAA,uBAAQ,GAAE;GACE,mBAAmB,CAgb/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 { MoreThan } from 'typeorm'\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 { effectiveBoardTools } from './board-tool-rights.js'\nimport type { LLMMessage } from './types.js'\nimport { ChatSession } from '@things-factory/ai-assistant'\nimport { ChatMessage } from '@things-factory/ai-assistant'\nimport { buildLlmHistory } from '@things-factory/ai-assistant'\nimport { splitByCap, summaryInstruction } from '@things-factory/ai-assistant'\nimport { foldHistorySummary } from '@things-factory/ai-assistant'\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 '@things-factory/ai-assistant'\nimport { publishSessionActivity } from '@things-factory/ai-assistant'\nimport { publishChatMessage } from '@things-factory/ai-assistant'\nimport { PatchEntry } from './patch-entry/patch-entry.js'\nimport { publishBoardPatch } from './patch-entry/board-patch-subscription.js'\nimport { ChatSessionParticipant } from '@things-factory/ai-assistant'\nimport { buildInviteNotification } from '@things-factory/ai-assistant'\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  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Grounded analysis contract for this turn: scope, evidence-backed claims, limitations, proposal and explicit approval boundary. Null when the turn did not perform an analysis.'\n  })\n  analysis?: 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  /*\n   * ── 이 문은 「묻는 것」이지 「보드를 고치는 것」이 아니다 (2026-09-10) ──────────\n   * 공장 현황을 묻는 화면이 **보드 편집 권한**을 요구하던 것이 이 분리의 시작이었다. 대화는\n   * `ai-assistant:mutation`, 보드 편집은 `board-ai:mutation` — 둘은 다른 능력이다.\n   *\n   * ⚠ 문만 바꾸면 **거꾸로 넓어진다.** 코어 보드 편집 도구가 기본으로 켜져 있으므로, 대화 권한만\n   * 가진 사람이 이 문으로 보드를 고치게 된다. 그래서 아래에서 **보드 편집 권한을 따로 보고**\n   * 없으면 그 도구를 끈다(§`effectiveBoardTools`).\n   */\n  @Directive('@privilege(category: \"ai-assistant\", 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: await effectiveBoardTools(input.boardTools, context),\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      analysis: r.analysis ?? 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\n      const stored = {\n        text: (session as any).lastSummary,\n        upToMessageId: (session as any).summaryUpToMessageId\n      }\n      const { rows, startsAfterSummary } = await this._historyForFold(sessionId, stored)\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        rowsStartAfterSummary: startsAfterSummary,\n        stored,\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   * 요약에 필요한 만큼만 읽는다 — **요약이 덮은 지점 뒤부터.**\n   *\n   * ── 왜 (2026-08-20) ─────────────────────────────────────────────────────────\n   * 이 함수를 부르는 자리는 **메시지를 보낼 때마다**다. 예전에는 세션의 대화를 처음부터 끝까지 읽었고\n   * (`creator` 조인까지), 정작 쓰는 것은 두 조각뿐이었다: 마지막 `maxTurns`개와, 요약 워터마크 뒤부터의\n   * 미반영분. 대화가 2,000개면 매 메시지마다 2,000행을 읽어 수십 행을 쓴 셈이다.\n   *\n   * 워터마크 뒤부터 읽으면 그 구간이 곧 `미반영분 + 최근 유지분`이라, 읽는 행 수가 **대화 길이와\n   * 무관**해진다(정상 상태에서 대략 `threshold + maxTurns`).\n   *\n   * ── 안전 규율을 지킨다 ──────────────────────────────────────────────────────\n   * 워터마크 행이 지워졌거나(삭제·편집) 요약이 아직 없으면 **전체를 읽는다.** 그때는 요약이 어디까지\n   * 덮는지 알 수 없고, 「빠뜨리는 쪽보다 다시 요약하는 쪽이 안전하다」는 것이 이 기능의 규율이다\n   * (`pendingForSummary` 주석). 그 경우는 드물다.\n   *\n   * 순서는 `(createdAt, id)` — 읽는 순서와 자르는 기준이 같아야 한다. 같은 시각의 메시지가 있으면\n   * id 로 가른다(원래 정렬이 이미 그 규약이다).\n   */\n  private async _historyForFold(\n    sessionId: string,\n    stored: { text?: string | null; upToMessageId?: string | null }\n  ): Promise<{ rows: ChatMessage[]; startsAfterSummary: boolean }> {\n    const repo = getRepository(ChatMessage)\n    const session = { id: sessionId } as any\n    const order = { createdAt: 'ASC', id: 'ASC' } as any\n    const relations = { creator: true } as any\n\n    if (stored.text && stored.upToMessageId) {\n      const mark = await repo.findOne({ where: { session, id: stored.upToMessageId } })\n      if (mark?.createdAt) {\n        const rows = await repo.find({\n          /* 배열 = OR. 같은 시각 안에서는 id 로 이어 자른다(정렬 규약과 같은 축). */\n          where: [\n            { session, createdAt: MoreThan(mark.createdAt) },\n            { session, createdAt: mark.createdAt, id: MoreThan(mark.id) }\n          ],\n          relations,\n          order\n        })\n        return { rows, startsAfterSummary: true }\n      }\n    }\n\n    /* 워터마크가 없거나 그 행이 사라졌다 — 덮은 범위를 모르므로 전부 다시 본다. */\n    return { rows: await repo.find({ where: { session }, relations, order }), startsAfterSummary: false }\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/types.d.ts

@@ -115,7 +115,12 @@ export interface ComponentSchema {
  * import 를 그대로 두기 위해서다 — 뜻의 정본은 저쪽 한 곳이다.
  */
 import type { ToolUsage } from '@things-factory/ai-client-base';
+import type { AIAnalysisClaim, GroundedAnalysisContract } from '@things-factory/ai-client-base';
 export type { ToolUsage };
+/** Board-specific extension of the shared evidence/approval analysis boundary. */
+export interface BoardGroundedAnalysis extends GroundedAnalysisContract<any, AIAnalysisClaim, BoardEditPatch | BoardActionOp[]> {
+    kind: 'board.analysis.v1';
+}
 export interface ChatResponse {
     /** 사용자에게 보여줄 텍스트 응답 */
     reply: string;
@@ -144,6 +149,8 @@ export interface ChatResponse {
      * 판정 규칙·사정거리는 ./grounding 참조. 비면(undefined) 접지 정상.
      */
     groundingWarnings?: string[];
+    /** Present when the turn inspected state or proposed a board/action change. */
+    analysis?: BoardGroundedAnalysis;
 }
 export interface BoardEditPatch {
     ops: BoardEditOp[];

package/dist-server/service/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/service/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Board AI — 자연어 채팅 인터페이스 타입 정의.\n *\n * 핵심 개념:\n *   - 단일 진입점 `chat()`. 의도 분류(생성/편집/스타일/질문)는 AI 의 일.\n *   - 출력은 항상 `ChatResponse`. 보드 변경이 있으면 `patch` 동봉.\n *   - patch 의 op 는 직교 4 종 (add / remove / modify / replace).\n *     style/move 등은 modify.patch 안에 흡수.\n */\nimport type { BoardComponent, BoardModel } from '@things-factory/board-import'\n\n/* 대화 한 줄은 도메인을 모른다 — 정의는 `@things-factory/ai-assistant` 에 있다(2026-09-10). */\nimport type { LLMMessage } from '@things-factory/ai-assistant'\nexport type { LLMMessage }\n\nexport interface ChatOptions {\n  /**\n   * 이 대화에 노출할 **외부 도구 카테고리** 화이트리스트(registerToolCategory 이름).\n   * 미지정 = 등록된 전부(현행 동작). 성격이 다른 대화면(보드 저작 도크 · 운영 도크)이\n   * 서로의 능력을 갖지 않게 하는 경계 — 정의뿐 아니라 실행 판정에도 적용된다.\n   */\n  toolCategories?: string[]\n  /**\n   * 코어 보드 편집 도구(addComponent · 스타일링 · 씬 조작) 노출 여부. 기본 true.\n   * 운영 대화처럼 보드를 고칠 이유가 없는 면에서는 false 로 꺼서, 되돌릴 수 없는 행동과\n   * 되돌릴 수 있는 편집이 한 대화에 섞이지 않게 한다.\n   */\n  boardTools?: boolean\n  /**\n   * **첫 턴에 도구 호출을 강제**한다. 라이브 상태를 다루는 대화면(운영 협의)에서 켠다.\n   *\n   * 접지 가드는 답이 지어낸 **식별자**를 잡지만, 식별자 없이 지어낸 **상황 서술**은 잡지 못한다\n   * (\"지게차들이 바쁘게 움직이고 있다\" — 실제로 나온 답이다). 그건 도구를 아예 부르지 않고 답한\n   * 경우여서 사후 검사로 막을 수 없다. 첫 턴에 무엇이든 조회하게 만들면 근거 없이 상태를 단언할\n   * 길이 없어진다. 켜고 끄는 판단은 대화면이 한다 — 서버가 질문 내용을 눈치로 분류하지 않는다.\n   */\n  requireGroundingTools?: boolean\n  /**\n   * 호스트(대화면)가 실어 보내는 **문맥** — 도구가 ctx.state.host 로 읽는다.\n   *\n   * 왜 필요한가: 대화면마다 \"지금 무엇을 보고 있는지\" 가 다르다(어느 공간·어느 인스턴스·어느 보드).\n   * 이것 없이는 도구가 대상을 알 수 없어 모델이 사용자에게 식별자를 되묻는다 — 제품으로 성립하지 않는다.\n   * 보드 대화는 보드 모델에 각인해 우회할 수 있었지만 보드가 없는 대화면(공간 협의)은 통로가 없었다.\n   *\n   * 신뢰 경계: 이 값은 **클라이언트가 보낸 것**이다. 도메인·사용자 같은 권한 판정에 쓰지 말 것\n   * (그건 서버가 세션에서 얻는 ctx.state.domain/user 가 정본). 여기 값은 \"무엇을 보고 있는지\" 범위\n   * 힌트이며, 도구는 그 범위가 호출자 테넌트 소속인지 반드시 검증한다.\n   */\n  hostContext?: any\n  /** board-import 의 registry scope — 등록된 ImportRule 에서 type/category 후보 추출 */\n  scopes?: string[]\n  /** 사용 가능한 도메인 type (override). 미지정 시 scopes 에서 자동 추출 */\n  knownTypes?: string[]\n  /** 사용 가능한 카테고리 (override). 미지정 시 scopes 에서 자동 추출 */\n  categories?: string[]\n  /**\n   * 컴포넌트 type 별 유효 속성 스킴.\n   * LLM 이 정확한 컴포넌트 생성을 하도록 type 의 description, group, default model 키 전달.\n   *\n   * 예:\n   *   [{ type: 'rect', description: 'Rectangle', group: 'shape',\n   *      properties: { fillStyle: '#fff', strokeStyle: '#000' } }, ...]\n   */\n  componentSchemas?: ComponentSchema[]\n  /**\n   * 사용자가 모델러에서 현재 선택한 컴포넌트의 `refid` 목록.\n   *\n   * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.\n   * id (데이터 바인딩 이름, unique 아님) 와는 다른 개념 — 선택은 항상 refid 로 표현.\n   */\n  selectedRefids?: number[]\n  /**\n   * popup 에서 사용자가 명시 선택한 #mention 매핑 — {token, refid}.\n   * server 가 mention 해석 시 이 매핑을 우선 사용. 본문엔 #token 만 남고\n   * refid 는 사용자에게 노출되지 않음 (LLM mention map 에만 첨부).\n   */\n  mentionPicks?: Array<{ token: string; refid: number }>\n  /** LLM 모델 override */\n  model?: string\n  /** LLM 옵션 */\n  temperature?: number\n  maxTokens?: number\n  /**\n   * Tool 카테고리 (read/external) builder 가 사용할 컨텍스트.\n   *\n   * board-ai 자체는 ResolverContext / typeorm 을 직접 알지 않지만, 외부 도메인 패키지가\n   * 등록한 tool (예: board-import 의 importBoardAsync) 은 server-side 의존성 (도메인,\n   * 사용자, 트랜잭션) 이 필요할 수 있다. board-ai-resolver 가 ResolverContext.state 등을\n   * 이 필드로 전달하면, dispatch 시 closure 로 builder 의 ctx.state 에 주입.\n   *\n   * 미지정이면 외부 builder 는 ctx.state === undefined — 빈 응답이나 에러를 반환할 책임.\n   */\n  toolCallContext?: any\n}\n\nexport interface ComponentSchema {\n  type: string\n  description?: string\n  group?: string\n  /**\n   * 좌표/크기/경로 관련 키들 — type 마다 다름.\n   * 예) ['left', 'top', 'width', 'height']  vs  ['cx', 'cy', 'radius']  vs  ['points']\n   * LLM 이 type 별 정확한 좌표 키를 사용하도록 명시.\n   */\n  geometryKeys?: string[]\n  /**\n   * 좌표 외 type 특화 속성 (style, value, min/max 등).\n   * default 값 또는 keys 만 — LLM 의 token 절감을 위해 호출자가 적절히 압축.\n   */\n  properties?: Record<string, any>\n}\n\n/**\n * 도구 사용 기록 — **`@things-factory/ai-client-base` 가 소유한다.**\n *\n * 도메인 중립이라 루프와 함께 그리로 옮겼다(2026-09-05). 여기서 다시 내보내는 것은 부르는 쪽의\n * import 를 그대로 두기 위해서다 — 뜻의 정본은 저쪽 한 곳이다.\n */\nimport type { ToolUsage } from '@things-factory/ai-client-base'\nexport type { ToolUsage }\n\n\nexport interface ChatResponse {\n  /** 사용자에게 보여줄 텍스트 응답 */\n  reply: string\n  /** 보드 변경이 있으면 patch */\n  patch?: BoardEditPatch\n  /**\n   * Scene 조작 action (ephemeral — 모델 변경 없음 / undo 영향 없음).\n   * 시간순 시퀀스로 호스트가 things-scene API 직접 실행.\n   */\n  actions?: BoardActionOp[]\n  /** 모호한 입력 시 명확화 질문 (patch 없음) */\n  followUp?: string\n  /** AI 가 응답 만드는 과정에서 호출한 도구들 (시간순). UI fold-able 박스용. */\n  toolUsages?: ToolUsage[]\n  /**\n   * **조치 제안** — 도구가 실행하지 않고 제안만 한 것들. 실행은 사용자가 버튼으로 한다.\n   *\n   * 규약: 도구 결과에 `proposed: true` 가 있으면 제안이다(도메인 무관 — board-ai 는 내용을 해석하지\n   * 않고 그대로 전달한다). 되돌릴 수 없는 조치를 AI 가 직접 실행하지 않게 하는 경계가 이 채널이다.\n   */\n  proposals?: any[]\n  /**\n   * 접지 경고 — 답이 언급했으나 모델이 받은 근거(프롬프트·보드 문맥·이력·도구 결과)에 없는 식별자.\n   *\n   * 있으면 그 대상은 **만들어 낸 것일 수 있다**. 답을 막거나 고치지 않고 사용자에게 표시한다 —\n   * 판정 규칙·사정거리는 ./grounding 참조. 비면(undefined) 접지 정상.\n   */\n  groundingWarnings?: string[]\n}\n\nexport interface BoardEditPatch {\n  ops: BoardEditOp[]\n  /** 사용자 검수용 1-2 문장 요약 */\n  summary: string\n  /** 0..1 신뢰도 */\n  confidence: number\n}\n\n/**\n * 보드 변경 op.\n *\n * 식별자 정책 — 기존 컴포넌트 타깃팅은 `refid` (number) 만 사용.\n * things-scene 의 모든 컴포넌트는 `refid` 를 자동 발급받는다 (universal).\n * `model.id` 는 optional metadata 일 뿐 — 항상 존재하지 않으므로 targeting 에는\n * 부적합. 별개 개념이므로 BoardEditOp / tool 인자에서도 별개 식별자로 분리하지\n * 않고 refid 단일 채널로 일원화.\n *\n * 계층 — 보드는 **최상위 부모** (things-scene 의 model-layer) 이고 그 자체로 자기\n * 속성을 갖는다 (fillStyle, width, height, fitMode, translate, scale, sky, skyColor,\n * exposure, hemi/dirLight 계열, camera 계열). 자식 컴포넌트와 별개. 보드 속성 변경은\n * `modifyBoard`, 자식 변경은 `modify` (refid 기반).\n *\n * 주의 — `name` 은 보드 *엔티티* (DB row) 의 컬럼이지 scene MODEL 의 필드가 아니다.\n * things-scene 의 model-layer 가 인식 안 함. modifyBoard 로 name 을 보내면 model\n * JSON 에 죽은 필드로 박힐 뿐 렌더링/동작에 영향 없음. 보드 라벨 변경은 GraphQL\n * boardPatch (BoardPatch input 의 name 필드) 영역.\n *\n * style 변경 / 이동 / 크기 변경 등 자식 컴포넌트의 변경은 모두 `modify.patch` 안에\n * 흡수. 보드 root 속성 변경은 `modifyBoard.patch` 로.\n */\n/**\n * Phase 2 — Scene 조작 op 들. 모델 차원 (좌표 / 부모-자식 관계 / z-order) 변경이지만\n * things-scene 의 자체 API (align/distribute/group/ungroup/zorder) 가 일관된 결과를\n * 보장하므로 호스트가 직접 호출. 모델 차원 시뮬레이션 (apply-patch) 은 단순화 —\n * scene 호출 결과가 정본.\n */\nexport type AlignDirection =\n  | 'left'\n  | 'right'\n  | 'center'\n  | 'top'\n  | 'middle'\n  | 'bottom'\n\nexport type DistributeAxis = 'horizontal' | 'vertical'\n\nexport type ZorderDirection = 'front' | 'back' | 'forward' | 'backward'\n\n/**\n * Sugar layout — `arrange` op 의 layout 종류.\n *\n * 의도: align/distribute 위에 얹는 high-level 의도 표현. AI 가 \"3x2 그리드로\",\n * \"한 줄로\", \"세로로 일렬\" 같은 자연어를 픽셀 노가다 없이 단일 op 로 표현.\n *\n * left/top 만 변경 — width/height 는 유지. AI 가 사이즈도 바꾸려면 별도 modify.\n *\n * 위치 계산은 호스트 (things-scene 측) 가 담당 — 각 컴포넌트의 현재 width/height 를\n * 정확히 알아야 하므로 model 차원 시뮬레이션은 SCENE_ONLY (apply-patch noop).\n */\nexport type ArrangeLayout =\n  | { type: 'grid'; cols: number; gap?: number; anchor?: { left: number; top: number } }\n  | {\n      type: 'row'\n      gap?: number\n      anchor?: { left: number; top: number }\n      align?: 'start' | 'center' | 'end'\n    }\n  | {\n      type: 'column'\n      gap?: number\n      anchor?: { left: number; top: number }\n      align?: 'start' | 'center' | 'end'\n    }\n\n/**\n * C-1 — Scene 조작 action 들 (ephemeral). 모델 변경 X, 따라서 BoardEditOp 와 별개\n * 채널 (board-action-execute 이벤트). undo 히스토리 미영향, dirty flag 미영향.\n *\n * 종류:\n *   - selectComponents: scene.selected 직접 set (사용자 선택 변경)\n *   - centerToComponent: 특정 컴포넌트로 view 이동\n *   - fitToView: 보드 전체가 보이도록 fit\n *   - setSceneMode: edit / view 모드 전환\n */\nexport type BoardActionOp =\n  | { action: 'selectComponents'; refids: number[] }\n  | { action: 'centerToComponent'; refid: number; animated?: boolean }\n  | { action: 'fitToView'; mode?: 'fit' | 'ratio' | 'width' | 'height' }\n  | { action: 'setSceneMode'; mode: 'edit' | 'view' }\n  /** 다중 컴포넌트 outline highlight — search/finder UX 의 \"이게 모두 매칭이다\" 시각화.\n   *  things-scene 의 highlightSearchResults API 위임 (2D/3D 모두 지원). */\n  | { action: 'highlightComponents'; refids: number[] }\n\nexport type BoardEditOp =\n  | { op: 'add'; component: BoardComponent }\n  | { op: 'remove'; refid: number }\n  | { op: 'modify'; refid: number; patch: Partial<BoardComponent> }\n  | { op: 'modifyBoard'; patch: Partial<BoardModel> }\n  | { op: 'replace'; board: BoardModel }\n  | { op: 'align'; refids: number[]; direction: AlignDirection }\n  | { op: 'distribute'; refids: number[]; axis: DistributeAxis }\n  | { op: 'group'; refids: number[] }\n  | { op: 'ungroup'; refid: number }\n  | { op: 'zorder'; refid: number; direction: ZorderDirection }\n  | { op: 'arrange'; refids: number[]; layout: ArrangeLayout }\n\n/**\n * BoardAIAssistant — 자연어 채팅으로 보드를 다루는 단일 인터페이스.\n *\n * 사용:\n *   const ai = new DefaultBoardAIAssistant(baseClient, { scopes: ['fmsim'] })\n *   const r = await ai.chat([{ role: 'user', content: 'AGV 3대 추가' }], currentBoard)\n *   if (r.patch) currentBoard = applyBoardEditPatch(currentBoard, r.patch)\n */\nexport interface BoardAIAssistant {\n  readonly id: string\n  chat(\n    messages: LLMMessage[],\n    currentBoard: BoardModel | undefined,\n    options?: ChatOptions\n  ): Promise<ChatResponse>\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/service/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Board AI — 자연어 채팅 인터페이스 타입 정의.\n *\n * 핵심 개념:\n *   - 단일 진입점 `chat()`. 의도 분류(생성/편집/스타일/질문)는 AI 의 일.\n *   - 출력은 항상 `ChatResponse`. 보드 변경이 있으면 `patch` 동봉.\n *   - patch 의 op 는 직교 4 종 (add / remove / modify / replace).\n *     style/move 등은 modify.patch 안에 흡수.\n */\nimport type { BoardComponent, BoardModel } from '@things-factory/board-import'\n\n/* 대화 한 줄은 도메인을 모른다 — 정의는 `@things-factory/ai-assistant` 에 있다(2026-09-10). */\nimport type { LLMMessage } from '@things-factory/ai-assistant'\nexport type { LLMMessage }\n\nexport interface ChatOptions {\n  /**\n   * 이 대화에 노출할 **외부 도구 카테고리** 화이트리스트(registerToolCategory 이름).\n   * 미지정 = 등록된 전부(현행 동작). 성격이 다른 대화면(보드 저작 도크 · 운영 도크)이\n   * 서로의 능력을 갖지 않게 하는 경계 — 정의뿐 아니라 실행 판정에도 적용된다.\n   */\n  toolCategories?: string[]\n  /**\n   * 코어 보드 편집 도구(addComponent · 스타일링 · 씬 조작) 노출 여부. 기본 true.\n   * 운영 대화처럼 보드를 고칠 이유가 없는 면에서는 false 로 꺼서, 되돌릴 수 없는 행동과\n   * 되돌릴 수 있는 편집이 한 대화에 섞이지 않게 한다.\n   */\n  boardTools?: boolean\n  /**\n   * **첫 턴에 도구 호출을 강제**한다. 라이브 상태를 다루는 대화면(운영 협의)에서 켠다.\n   *\n   * 접지 가드는 답이 지어낸 **식별자**를 잡지만, 식별자 없이 지어낸 **상황 서술**은 잡지 못한다\n   * (\"지게차들이 바쁘게 움직이고 있다\" — 실제로 나온 답이다). 그건 도구를 아예 부르지 않고 답한\n   * 경우여서 사후 검사로 막을 수 없다. 첫 턴에 무엇이든 조회하게 만들면 근거 없이 상태를 단언할\n   * 길이 없어진다. 켜고 끄는 판단은 대화면이 한다 — 서버가 질문 내용을 눈치로 분류하지 않는다.\n   */\n  requireGroundingTools?: boolean\n  /**\n   * 호스트(대화면)가 실어 보내는 **문맥** — 도구가 ctx.state.host 로 읽는다.\n   *\n   * 왜 필요한가: 대화면마다 \"지금 무엇을 보고 있는지\" 가 다르다(어느 공간·어느 인스턴스·어느 보드).\n   * 이것 없이는 도구가 대상을 알 수 없어 모델이 사용자에게 식별자를 되묻는다 — 제품으로 성립하지 않는다.\n   * 보드 대화는 보드 모델에 각인해 우회할 수 있었지만 보드가 없는 대화면(공간 협의)은 통로가 없었다.\n   *\n   * 신뢰 경계: 이 값은 **클라이언트가 보낸 것**이다. 도메인·사용자 같은 권한 판정에 쓰지 말 것\n   * (그건 서버가 세션에서 얻는 ctx.state.domain/user 가 정본). 여기 값은 \"무엇을 보고 있는지\" 범위\n   * 힌트이며, 도구는 그 범위가 호출자 테넌트 소속인지 반드시 검증한다.\n   */\n  hostContext?: any\n  /** board-import 의 registry scope — 등록된 ImportRule 에서 type/category 후보 추출 */\n  scopes?: string[]\n  /** 사용 가능한 도메인 type (override). 미지정 시 scopes 에서 자동 추출 */\n  knownTypes?: string[]\n  /** 사용 가능한 카테고리 (override). 미지정 시 scopes 에서 자동 추출 */\n  categories?: string[]\n  /**\n   * 컴포넌트 type 별 유효 속성 스킴.\n   * LLM 이 정확한 컴포넌트 생성을 하도록 type 의 description, group, default model 키 전달.\n   *\n   * 예:\n   *   [{ type: 'rect', description: 'Rectangle', group: 'shape',\n   *      properties: { fillStyle: '#fff', strokeStyle: '#000' } }, ...]\n   */\n  componentSchemas?: ComponentSchema[]\n  /**\n   * 사용자가 모델러에서 현재 선택한 컴포넌트의 `refid` 목록.\n   *\n   * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.\n   * id (데이터 바인딩 이름, unique 아님) 와는 다른 개념 — 선택은 항상 refid 로 표현.\n   */\n  selectedRefids?: number[]\n  /**\n   * popup 에서 사용자가 명시 선택한 #mention 매핑 — {token, refid}.\n   * server 가 mention 해석 시 이 매핑을 우선 사용. 본문엔 #token 만 남고\n   * refid 는 사용자에게 노출되지 않음 (LLM mention map 에만 첨부).\n   */\n  mentionPicks?: Array<{ token: string; refid: number }>\n  /** LLM 모델 override */\n  model?: string\n  /** LLM 옵션 */\n  temperature?: number\n  maxTokens?: number\n  /**\n   * Tool 카테고리 (read/external) builder 가 사용할 컨텍스트.\n   *\n   * board-ai 자체는 ResolverContext / typeorm 을 직접 알지 않지만, 외부 도메인 패키지가\n   * 등록한 tool (예: board-import 의 importBoardAsync) 은 server-side 의존성 (도메인,\n   * 사용자, 트랜잭션) 이 필요할 수 있다. board-ai-resolver 가 ResolverContext.state 등을\n   * 이 필드로 전달하면, dispatch 시 closure 로 builder 의 ctx.state 에 주입.\n   *\n   * 미지정이면 외부 builder 는 ctx.state === undefined — 빈 응답이나 에러를 반환할 책임.\n   */\n  toolCallContext?: any\n}\n\nexport interface ComponentSchema {\n  type: string\n  description?: string\n  group?: string\n  /**\n   * 좌표/크기/경로 관련 키들 — type 마다 다름.\n   * 예) ['left', 'top', 'width', 'height']  vs  ['cx', 'cy', 'radius']  vs  ['points']\n   * LLM 이 type 별 정확한 좌표 키를 사용하도록 명시.\n   */\n  geometryKeys?: string[]\n  /**\n   * 좌표 외 type 특화 속성 (style, value, min/max 등).\n   * default 값 또는 keys 만 — LLM 의 token 절감을 위해 호출자가 적절히 압축.\n   */\n  properties?: Record<string, any>\n}\n\n/**\n * 도구 사용 기록 — **`@things-factory/ai-client-base` 가 소유한다.**\n *\n * 도메인 중립이라 루프와 함께 그리로 옮겼다(2026-09-05). 여기서 다시 내보내는 것은 부르는 쪽의\n * import 를 그대로 두기 위해서다 — 뜻의 정본은 저쪽 한 곳이다.\n */\nimport type { ToolUsage } from '@things-factory/ai-client-base'\nimport type { AIAnalysisClaim, GroundedAnalysisContract } from '@things-factory/ai-client-base'\nexport type { ToolUsage }\n\n/** Board-specific extension of the shared evidence/approval analysis boundary. */\nexport interface BoardGroundedAnalysis extends GroundedAnalysisContract<any, AIAnalysisClaim, BoardEditPatch | BoardActionOp[]> {\n  kind: 'board.analysis.v1'\n}\n\n\nexport interface ChatResponse {\n  /** 사용자에게 보여줄 텍스트 응답 */\n  reply: string\n  /** 보드 변경이 있으면 patch */\n  patch?: BoardEditPatch\n  /**\n   * Scene 조작 action (ephemeral — 모델 변경 없음 / undo 영향 없음).\n   * 시간순 시퀀스로 호스트가 things-scene API 직접 실행.\n   */\n  actions?: BoardActionOp[]\n  /** 모호한 입력 시 명확화 질문 (patch 없음) */\n  followUp?: string\n  /** AI 가 응답 만드는 과정에서 호출한 도구들 (시간순). UI fold-able 박스용. */\n  toolUsages?: ToolUsage[]\n  /**\n   * **조치 제안** — 도구가 실행하지 않고 제안만 한 것들. 실행은 사용자가 버튼으로 한다.\n   *\n   * 규약: 도구 결과에 `proposed: true` 가 있으면 제안이다(도메인 무관 — board-ai 는 내용을 해석하지\n   * 않고 그대로 전달한다). 되돌릴 수 없는 조치를 AI 가 직접 실행하지 않게 하는 경계가 이 채널이다.\n   */\n  proposals?: any[]\n  /**\n   * 접지 경고 — 답이 언급했으나 모델이 받은 근거(프롬프트·보드 문맥·이력·도구 결과)에 없는 식별자.\n   *\n   * 있으면 그 대상은 **만들어 낸 것일 수 있다**. 답을 막거나 고치지 않고 사용자에게 표시한다 —\n   * 판정 규칙·사정거리는 ./grounding 참조. 비면(undefined) 접지 정상.\n   */\n  groundingWarnings?: string[]\n  /** Present when the turn inspected state or proposed a board/action change. */\n  analysis?: BoardGroundedAnalysis\n}\n\nexport interface BoardEditPatch {\n  ops: BoardEditOp[]\n  /** 사용자 검수용 1-2 문장 요약 */\n  summary: string\n  /** 0..1 신뢰도 */\n  confidence: number\n}\n\n/**\n * 보드 변경 op.\n *\n * 식별자 정책 — 기존 컴포넌트 타깃팅은 `refid` (number) 만 사용.\n * things-scene 의 모든 컴포넌트는 `refid` 를 자동 발급받는다 (universal).\n * `model.id` 는 optional metadata 일 뿐 — 항상 존재하지 않으므로 targeting 에는\n * 부적합. 별개 개념이므로 BoardEditOp / tool 인자에서도 별개 식별자로 분리하지\n * 않고 refid 단일 채널로 일원화.\n *\n * 계층 — 보드는 **최상위 부모** (things-scene 의 model-layer) 이고 그 자체로 자기\n * 속성을 갖는다 (fillStyle, width, height, fitMode, translate, scale, sky, skyColor,\n * exposure, hemi/dirLight 계열, camera 계열). 자식 컴포넌트와 별개. 보드 속성 변경은\n * `modifyBoard`, 자식 변경은 `modify` (refid 기반).\n *\n * 주의 — `name` 은 보드 *엔티티* (DB row) 의 컬럼이지 scene MODEL 의 필드가 아니다.\n * things-scene 의 model-layer 가 인식 안 함. modifyBoard 로 name 을 보내면 model\n * JSON 에 죽은 필드로 박힐 뿐 렌더링/동작에 영향 없음. 보드 라벨 변경은 GraphQL\n * boardPatch (BoardPatch input 의 name 필드) 영역.\n *\n * style 변경 / 이동 / 크기 변경 등 자식 컴포넌트의 변경은 모두 `modify.patch` 안에\n * 흡수. 보드 root 속성 변경은 `modifyBoard.patch` 로.\n */\n/**\n * Phase 2 — Scene 조작 op 들. 모델 차원 (좌표 / 부모-자식 관계 / z-order) 변경이지만\n * things-scene 의 자체 API (align/distribute/group/ungroup/zorder) 가 일관된 결과를\n * 보장하므로 호스트가 직접 호출. 모델 차원 시뮬레이션 (apply-patch) 은 단순화 —\n * scene 호출 결과가 정본.\n */\nexport type AlignDirection =\n  | 'left'\n  | 'right'\n  | 'center'\n  | 'top'\n  | 'middle'\n  | 'bottom'\n\nexport type DistributeAxis = 'horizontal' | 'vertical'\n\nexport type ZorderDirection = 'front' | 'back' | 'forward' | 'backward'\n\n/**\n * Sugar layout — `arrange` op 의 layout 종류.\n *\n * 의도: align/distribute 위에 얹는 high-level 의도 표현. AI 가 \"3x2 그리드로\",\n * \"한 줄로\", \"세로로 일렬\" 같은 자연어를 픽셀 노가다 없이 단일 op 로 표현.\n *\n * left/top 만 변경 — width/height 는 유지. AI 가 사이즈도 바꾸려면 별도 modify.\n *\n * 위치 계산은 호스트 (things-scene 측) 가 담당 — 각 컴포넌트의 현재 width/height 를\n * 정확히 알아야 하므로 model 차원 시뮬레이션은 SCENE_ONLY (apply-patch noop).\n */\nexport type ArrangeLayout =\n  | { type: 'grid'; cols: number; gap?: number; anchor?: { left: number; top: number } }\n  | {\n      type: 'row'\n      gap?: number\n      anchor?: { left: number; top: number }\n      align?: 'start' | 'center' | 'end'\n    }\n  | {\n      type: 'column'\n      gap?: number\n      anchor?: { left: number; top: number }\n      align?: 'start' | 'center' | 'end'\n    }\n\n/**\n * C-1 — Scene 조작 action 들 (ephemeral). 모델 변경 X, 따라서 BoardEditOp 와 별개\n * 채널 (board-action-execute 이벤트). undo 히스토리 미영향, dirty flag 미영향.\n *\n * 종류:\n *   - selectComponents: scene.selected 직접 set (사용자 선택 변경)\n *   - centerToComponent: 특정 컴포넌트로 view 이동\n *   - fitToView: 보드 전체가 보이도록 fit\n *   - setSceneMode: edit / view 모드 전환\n */\nexport type BoardActionOp =\n  | { action: 'selectComponents'; refids: number[] }\n  | { action: 'centerToComponent'; refid: number; animated?: boolean }\n  | { action: 'fitToView'; mode?: 'fit' | 'ratio' | 'width' | 'height' }\n  | { action: 'setSceneMode'; mode: 'edit' | 'view' }\n  /** 다중 컴포넌트 outline highlight — search/finder UX 의 \"이게 모두 매칭이다\" 시각화.\n   *  things-scene 의 highlightSearchResults API 위임 (2D/3D 모두 지원). */\n  | { action: 'highlightComponents'; refids: number[] }\n\nexport type BoardEditOp =\n  | { op: 'add'; component: BoardComponent }\n  | { op: 'remove'; refid: number }\n  | { op: 'modify'; refid: number; patch: Partial<BoardComponent> }\n  | { op: 'modifyBoard'; patch: Partial<BoardModel> }\n  | { op: 'replace'; board: BoardModel }\n  | { op: 'align'; refids: number[]; direction: AlignDirection }\n  | { op: 'distribute'; refids: number[]; axis: DistributeAxis }\n  | { op: 'group'; refids: number[] }\n  | { op: 'ungroup'; refid: number }\n  | { op: 'zorder'; refid: number; direction: ZorderDirection }\n  | { op: 'arrange'; refids: number[]; layout: ArrangeLayout }\n\n/**\n * BoardAIAssistant — 자연어 채팅으로 보드를 다루는 단일 인터페이스.\n *\n * 사용:\n *   const ai = new DefaultBoardAIAssistant(baseClient, { scopes: ['fmsim'] })\n *   const r = await ai.chat([{ role: 'user', content: 'AGV 3대 추가' }], currentBoard)\n *   if (r.patch) currentBoard = applyBoardEditPatch(currentBoard, r.patch)\n */\nexport interface BoardAIAssistant {\n  readonly id: string\n  chat(\n    messages: LLMMessage[],\n    currentBoard: BoardModel | undefined,\n    options?: ChatOptions\n  ): Promise<ChatResponse>\n}\n"]}