@things-factory/ai-assistant 10.1.6

package/dist-client/utils/board-edit-patch.js

@@ -0,0 +1,284 @@
+/**
+ * Client-side BoardEditPatch types + applier.
+ *
+ * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.
+ * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.
+ */
+const EMPTY_BOARD = { width: 1000, height: 600, components: [] };
+/**
+ * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).
+ */
+export function applyBoardEditPatch(board, patch) {
+    return applyBoardEditPatchVerbose(board, patch).board;
+}
+/**
+ * Verbose 변형 — 각 op 의 적용 여부를 보고.
+ *
+ * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된
+ * id 를 만들어 보내면 사용자에게 "수정했습니다" 라고 답하지만 실제로는 아무 변화도
+ * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도
+ * entry point 제공.
+ */
+export function applyBoardEditPatchVerbose(board, patch) {
+    let result = board ?? EMPTY_BOARD;
+    const applied = [];
+    const missed = [];
+    for (const op of patch.ops) {
+        if (SCENE_ONLY_OPS.has(op.op)) {
+            // scene-only — model 차원 noop, scene 차원 적용. applied 분류.
+            applied.push(op);
+            continue;
+        }
+        const next = applyOp(result, op);
+        // componentsUnchanged 는 components 배열 동일 + width/height/fillStyle 동일 만 본다.
+        // modify / remove 의 silent no-op (ghost refid) 검출 전용 — modifyBoard 가 sky
+        // 등 다른 root 키만 바꿀 때 false negative 로 missed 분류되는 회귀 방지.
+        const componentMutating = op.op === 'modify' || op.op === 'remove';
+        if (next === result || (componentMutating && componentsUnchanged(result, next))) {
+            missed.push(op);
+        }
+        else {
+            applied.push(op);
+            result = next;
+        }
+    }
+    return { board: result, applied, missed };
+}
+function componentsUnchanged(prev, next) {
+    // applyOp 는 항상 새 객체를 만든다. 따라서 reference 비교가 안 되고 내용 비교 필요.
+    // components 는 map/filter 결과 reference 도 다를 수 있으므로 length + 요소 ref 비교.
+    const a = prev.components ?? [];
+    const b = next.components ?? [];
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle;
+}
+const SCENE_ONLY_OPS = new Set([
+    'align',
+    'distribute',
+    'group',
+    'ungroup',
+    'zorder',
+    'arrange'
+]);
+function applyOp(board, op) {
+    switch (op.op) {
+        case 'replace':
+            return op.board;
+        case 'add':
+            return { ...board, components: [...(board.components || []), op.component] };
+        case 'remove':
+            // 자식 (group/container 안) refid 도 매칭 — deep search.
+            return {
+                ...board,
+                components: removeComponentDeep(board.components || [], op.refid)
+            };
+        case 'modify':
+            // 자식 refid 도 매칭 — group/container 안의 컴포넌트 수정 가능.
+            return {
+                ...board,
+                components: modifyComponentDeep(board.components || [], op.refid, op.patch)
+            };
+        case 'modifyBoard': {
+            const patch = { ...(op.patch || {}) };
+            delete patch.components; // 자식 변경은 별도 op
+            return mergeComponent(board, patch); // 최상위 board 자체에 deep-merge
+        }
+        case 'align':
+        case 'distribute':
+        case 'group':
+        case 'ungroup':
+        case 'zorder':
+        case 'arrange':
+            // scene-only — model 차원 noop. things-scene API 가 정본.
+            return board;
+        default:
+            return board;
+    }
+}
+/**
+ * 주어진 board 상태에서 op 의 inverse 를 계산.
+ *
+ * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가
+ * 누적해두면 나중에 역순 실행만으로 복원.
+ *
+ * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.
+ * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.
+ */
+export function computeInverseOp(board, op) {
+    if (!board)
+        return null;
+    const components = board.components ?? [];
+    switch (op.op) {
+        case 'add':
+            return null;
+        case 'remove': {
+            // 자식 refid 도 매칭 (deep search)
+            const target = findComponentDeep(components, op.refid);
+            if (!target)
+                return null;
+            return { op: 'add', component: JSON.parse(JSON.stringify(target)) };
+        }
+        case 'modify': {
+            // 자식 refid 도 매칭 (deep search)
+            const target = findComponentDeep(components, op.refid);
+            if (!target)
+                return null;
+            const oldValues = {};
+            for (const k of Object.keys(op.patch || {})) {
+                const v = target[k];
+                oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
+            }
+            return { op: 'modify', refid: op.refid, patch: oldValues };
+        }
+        case 'modifyBoard': {
+            const oldValues = {};
+            const patch = op.patch || {};
+            for (const k of Object.keys(patch)) {
+                if (k === 'components')
+                    continue;
+                const v = board[k];
+                oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
+            }
+            return { op: 'modifyBoard', patch: oldValues };
+        }
+        case 'replace':
+            return { op: 'replace', board: JSON.parse(JSON.stringify(board)) };
+        case 'zorder': {
+            // forward ↔ backward / front ↔ back. front/back 의 inverse 는 정확하지
+            // 않을 수 있음 (best-effort) — 정확 inverse 는 호스트가 zorder 직전 index
+            // 를 캡처해서 명시 modify 시퀀스로 만들어야.
+            const opp = {
+                forward: 'backward',
+                backward: 'forward',
+                front: 'back',
+                back: 'front'
+            };
+            const dir = opp[op.direction];
+            if (!dir)
+                return null;
+            return { op: 'zorder', refid: op.refid, direction: dir };
+        }
+        case 'align':
+        case 'distribute':
+        case 'group':
+        case 'ungroup':
+        case 'arrange':
+            // scene 호출 후에야 변경 결과 알 수 있음. 호스트가 직접 inverse 만든다.
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * 컴포넌트에 부분 patch 를 적용 (deep merge).
+ * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
+ *
+ * patch 내 `null` 의 시맨틱 — **"이 키를 제거하라"**:
+ *   - fillStyle/strokeStyle 처럼 `string | object | undefined` 인 필드는 null 로
+ *     set 하면 typeof null === 'object' 함정에 빠져 다운스트림 (3D 텍스처 등) 이 크래시.
+ *   - computeInverseOp 가 base 에 키가 없던 (`undefined`) 경우 inverse 를 null 로
+ *     발급하므로, 이 시맨틱과 정확히 일치 — inverse 가 자연스럽게 올바로 동작.
+ *
+ * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.
+ */
+export function mergeComponent(base, patch) {
+    const out = { ...base };
+    for (const key of Object.keys(patch)) {
+        const patchVal = patch[key];
+        if (patchVal === null) {
+            delete out[key];
+        }
+        else if (isPlainObject(base[key]) && isPlainObject(patchVal)) {
+            out[key] = deepMerge(base[key], patchVal);
+        }
+        else {
+            out[key] = patchVal;
+        }
+    }
+    return out;
+}
+function deepMerge(a, b) {
+    const out = { ...a };
+    for (const key of Object.keys(b)) {
+        const bv = b[key];
+        if (bv === null) {
+            delete out[key];
+        }
+        else if (isPlainObject(a[key]) && isPlainObject(bv)) {
+            out[key] = deepMerge(a[key], bv);
+        }
+        else {
+            out[key] = bv;
+        }
+    }
+    return out;
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+// ── 자식 컴포넌트 (group/container 안) 까지 매칭 — deep search ─
+// server/service/apply-patch.ts 와 동일 로직. drift test 가 동등성 보장.
+function findComponentDeep(components, refid) {
+    for (const c of components) {
+        if (!c)
+            continue;
+        if (c.refid === refid)
+            return c;
+        if (Array.isArray(c.components) && c.components.length > 0) {
+            const sub = findComponentDeep(c.components, refid);
+            if (sub)
+                return sub;
+        }
+    }
+    return undefined;
+}
+function modifyComponentDeep(components, refid, patch) {
+    let changed = false;
+    const out = components.map(c => {
+        if (!c)
+            return c;
+        if (c.refid === refid) {
+            changed = true;
+            return mergeComponent(c, patch);
+        }
+        if (Array.isArray(c.components) && c.components.length > 0) {
+            const updated = modifyComponentDeep(c.components, refid, patch);
+            if (updated !== c.components) {
+                changed = true;
+                return { ...c, components: updated };
+            }
+        }
+        return c;
+    });
+    return changed ? out : components;
+}
+function removeComponentDeep(components, refid) {
+    let changed = false;
+    const out = [];
+    for (const c of components) {
+        if (!c) {
+            out.push(c);
+            continue;
+        }
+        if (c.refid === refid) {
+            changed = true;
+            continue;
+        }
+        if (Array.isArray(c.components) && c.components.length > 0) {
+            const updated = removeComponentDeep(c.components, refid);
+            if (updated !== c.components) {
+                changed = true;
+                out.push({ ...c, components: updated });
+                continue;
+            }
+        }
+        out.push(c);
+    }
+    return changed ? out : components;
+}
+//# sourceMappingURL=board-edit-patch.js.map

package/dist-client/utils/board-edit-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-edit-patch.js","sourceRoot":"","sources":["../../client/utils/board-edit-patch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client-side BoardEditPatch types + applier.\n *\n * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.\n * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.\n */\n\n/**\n * 컴포넌트 타깃팅은 항상 `refid` (things-scene universal numeric handle).\n * `id` 는 데이터 바인딩 이름이며 unique 가 아니므로 targeting 에 사용하지 않는다.\n *\n * 보드는 최상위 부모 — 자체 속성 (fillStyle / width / height / name 등) 을 갖고,\n * `modifyBoard` 로 변경. 자식 컴포넌트 변경 (`modify`) 와 분리.\n *\n * Phase 2 — Scene 조작 op (align/distribute/group/ungroup/zorder). model 차원\n * 시뮬레이션은 noop 이고 things-scene API 가 정본.\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 * Server-side types.ts 의 ArrangeLayout 와 일치 — drift test 가 검증.\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\nexport type BoardEditOp =\n  | { op: 'add'; component: any }\n  | { op: 'remove'; refid: number }\n  | { op: 'modify'; refid: number; patch: any }\n  | { op: 'modifyBoard'; patch: any }\n  | { op: 'replace'; board: any }\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 * C-1 — Scene 조작 action (ephemeral). 모델 변경 X, undo 영향 X.\n * 호스트가 board-action-execute 이벤트로 받아서 things-scene API 직접 호출.\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  | { action: 'highlightComponents'; refids: number[] }\n\nexport interface BoardEditPatch {\n  ops: BoardEditOp[]\n  summary: string\n  confidence: number\n}\n\nexport interface PatchApplyReport {\n  /** 패치 적용 후 보드. 모든 op 가 noop 이어도 입력 그대로 반환. */\n  board: any\n  /** 실제로 보드를 바꾼 op 들. */\n  applied: BoardEditOp[]\n  /** id 매칭 실패 등으로 noop 이 된 op 들 — 호출자가 사용자에게 알릴 단서. */\n  missed: BoardEditOp[]\n}\n\nconst EMPTY_BOARD = { width: 1000, height: 600, components: [] as any[] }\n\n/**\n * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).\n */\nexport function applyBoardEditPatch(board: any | undefined, patch: BoardEditPatch): any {\n  return applyBoardEditPatchVerbose(board, patch).board\n}\n\n/**\n * Verbose 변형 — 각 op 의 적용 여부를 보고.\n *\n * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된\n * id 를 만들어 보내면 사용자에게 \"수정했습니다\" 라고 답하지만 실제로는 아무 변화도\n * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도\n * entry point 제공.\n */\nexport function applyBoardEditPatchVerbose(\n  board: any | undefined,\n  patch: BoardEditPatch\n): PatchApplyReport {\n  let result: any = board ?? EMPTY_BOARD\n  const applied: BoardEditOp[] = []\n  const missed: BoardEditOp[] = []\n\n  for (const op of patch.ops) {\n    if (SCENE_ONLY_OPS.has(op.op)) {\n      // scene-only — model 차원 noop, scene 차원 적용. applied 분류.\n      applied.push(op)\n      continue\n    }\n    const next = applyOp(result, op)\n    // componentsUnchanged 는 components 배열 동일 + width/height/fillStyle 동일 만 본다.\n    // modify / remove 의 silent no-op (ghost refid) 검출 전용 — modifyBoard 가 sky\n    // 등 다른 root 키만 바꿀 때 false negative 로 missed 분류되는 회귀 방지.\n    const componentMutating = op.op === 'modify' || op.op === 'remove'\n    if (next === result || (componentMutating && componentsUnchanged(result, next))) {\n      missed.push(op)\n    } else {\n      applied.push(op)\n      result = next\n    }\n  }\n\n  return { board: result, applied, missed }\n}\n\nfunction componentsUnchanged(prev: any, next: any): boolean {\n  // applyOp 는 항상 새 객체를 만든다. 따라서 reference 비교가 안 되고 내용 비교 필요.\n  // components 는 map/filter 결과 reference 도 다를 수 있으므로 length + 요소 ref 비교.\n  const a = prev.components ?? []\n  const b = next.components ?? []\n  if (a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false\n  }\n  return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle\n}\n\nconst SCENE_ONLY_OPS = new Set<BoardEditOp['op']>([\n  'align',\n  'distribute',\n  'group',\n  'ungroup',\n  'zorder',\n  'arrange'\n])\n\nfunction applyOp(board: any, op: BoardEditOp): any {\n  switch (op.op) {\n    case 'replace':\n      return op.board\n    case 'add':\n      return { ...board, components: [...(board.components || []), op.component] }\n    case 'remove':\n      // 자식 (group/container 안) refid 도 매칭 — deep search.\n      return {\n        ...board,\n        components: removeComponentDeep(board.components || [], op.refid)\n      }\n    case 'modify':\n      // 자식 refid 도 매칭 — group/container 안의 컴포넌트 수정 가능.\n      return {\n        ...board,\n        components: modifyComponentDeep(board.components || [], op.refid, op.patch)\n      }\n    case 'modifyBoard': {\n      const patch = { ...(op.patch || {}) }\n      delete patch.components // 자식 변경은 별도 op\n      return mergeComponent(board, patch) // 최상위 board 자체에 deep-merge\n    }\n    case 'align':\n    case 'distribute':\n    case 'group':\n    case 'ungroup':\n    case 'zorder':\n    case 'arrange':\n      // scene-only — model 차원 noop. things-scene API 가 정본.\n      return board\n    default:\n      return board\n  }\n}\n\n/**\n * 주어진 board 상태에서 op 의 inverse 를 계산.\n *\n * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가\n * 누적해두면 나중에 역순 실행만으로 복원.\n *\n * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.\n * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.\n */\nexport function computeInverseOp(board: any, op: BoardEditOp): BoardEditOp | null {\n  if (!board) return null\n  const components = board.components ?? []\n\n  switch (op.op) {\n    case 'add':\n      return null\n\n    case 'remove': {\n      // 자식 refid 도 매칭 (deep search)\n      const target = findComponentDeep(components, op.refid)\n      if (!target) return null\n      return { op: 'add', component: JSON.parse(JSON.stringify(target)) }\n    }\n\n    case 'modify': {\n      // 자식 refid 도 매칭 (deep search)\n      const target = findComponentDeep(components, op.refid)\n      if (!target) return null\n      const oldValues: any = {}\n      for (const k of Object.keys(op.patch || {})) {\n        const v = (target as any)[k]\n        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))\n      }\n      return { op: 'modify', refid: op.refid, patch: oldValues }\n    }\n\n    case 'modifyBoard': {\n      const oldValues: any = {}\n      const patch = op.patch || {}\n      for (const k of Object.keys(patch)) {\n        if (k === 'components') continue\n        const v = (board as any)[k]\n        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))\n      }\n      return { op: 'modifyBoard', patch: oldValues }\n    }\n\n    case 'replace':\n      return { op: 'replace', board: JSON.parse(JSON.stringify(board)) }\n\n    case 'zorder': {\n      // forward ↔ backward / front ↔ back. front/back 의 inverse 는 정확하지\n      // 않을 수 있음 (best-effort) — 정확 inverse 는 호스트가 zorder 직전 index\n      // 를 캡처해서 명시 modify 시퀀스로 만들어야.\n      const opp: Record<string, 'front' | 'back' | 'forward' | 'backward'> = {\n        forward: 'backward',\n        backward: 'forward',\n        front: 'back',\n        back: 'front'\n      }\n      const dir = opp[op.direction]\n      if (!dir) return null\n      return { op: 'zorder', refid: op.refid, direction: dir }\n    }\n\n    case 'align':\n    case 'distribute':\n    case 'group':\n    case 'ungroup':\n    case 'arrange':\n      // scene 호출 후에야 변경 결과 알 수 있음. 호스트가 직접 inverse 만든다.\n      return null\n\n    default:\n      return null\n  }\n}\n\n/**\n * 컴포넌트에 부분 patch 를 적용 (deep merge).\n * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.\n *\n * patch 내 `null` 의 시맨틱 — **\"이 키를 제거하라\"**:\n *   - fillStyle/strokeStyle 처럼 `string | object | undefined` 인 필드는 null 로\n *     set 하면 typeof null === 'object' 함정에 빠져 다운스트림 (3D 텍스처 등) 이 크래시.\n *   - computeInverseOp 가 base 에 키가 없던 (`undefined`) 경우 inverse 를 null 로\n *     발급하므로, 이 시맨틱과 정확히 일치 — inverse 가 자연스럽게 올바로 동작.\n *\n * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.\n */\nexport function mergeComponent(base: any, patch: any): any {\n  const out: any = { ...base }\n  for (const key of Object.keys(patch)) {\n    const patchVal = patch[key]\n    if (patchVal === null) {\n      delete out[key]\n    } else if (isPlainObject(base[key]) && isPlainObject(patchVal)) {\n      out[key] = deepMerge(base[key], patchVal)\n    } else {\n      out[key] = patchVal\n    }\n  }\n  return out\n}\n\nfunction deepMerge(a: any, b: any): any {\n  const out: any = { ...a }\n  for (const key of Object.keys(b)) {\n    const bv = b[key]\n    if (bv === null) {\n      delete out[key]\n    } else if (isPlainObject(a[key]) && isPlainObject(bv)) {\n      out[key] = deepMerge(a[key], bv)\n    } else {\n      out[key] = bv\n    }\n  }\n  return out\n}\n\nfunction isPlainObject(v: any): boolean {\n  return v !== null && typeof v === 'object' && !Array.isArray(v)\n}\n\n// ── 자식 컴포넌트 (group/container 안) 까지 매칭 — deep search ─\n// server/service/apply-patch.ts 와 동일 로직. drift test 가 동등성 보장.\n\nfunction findComponentDeep(components: any[], refid: number): any | undefined {\n  for (const c of components) {\n    if (!c) continue\n    if (c.refid === refid) return c\n    if (Array.isArray(c.components) && c.components.length > 0) {\n      const sub = findComponentDeep(c.components, refid)\n      if (sub) return sub\n    }\n  }\n  return undefined\n}\n\nfunction modifyComponentDeep(components: any[], refid: number, patch: any): any[] {\n  let changed = false\n  const out = components.map(c => {\n    if (!c) return c\n    if (c.refid === refid) {\n      changed = true\n      return mergeComponent(c, patch)\n    }\n    if (Array.isArray(c.components) && c.components.length > 0) {\n      const updated = modifyComponentDeep(c.components, refid, patch)\n      if (updated !== c.components) {\n        changed = true\n        return { ...c, components: updated }\n      }\n    }\n    return c\n  })\n  return changed ? out : components\n}\n\nfunction removeComponentDeep(components: any[], refid: number): any[] {\n  let changed = false\n  const out: any[] = []\n  for (const c of components) {\n    if (!c) {\n      out.push(c)\n      continue\n    }\n    if (c.refid === refid) {\n      changed = true\n      continue\n    }\n    if (Array.isArray(c.components) && c.components.length > 0) {\n      const updated = removeComponentDeep(c.components, refid)\n      if (updated !== c.components) {\n        changed = true\n        out.push({ ...c, components: updated })\n        continue\n      }\n    }\n    out.push(c)\n  }\n  return changed ? out : components\n}\n"]}

package/dist-server/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `@things-factory/ai-assistant` — **AI 대화의 집.**
+ *
+ * 세션·메시지·참가자·인박스·구독. 도메인을 모른다: 보드도, 공장도, 자산도.
+ *
+ * ── 왜 board-ai 에서 나왔나 (2026-09-10) ────────────────────────────────────
+ * 시작한 물음은 하나였다. **「왜 board-ai 에 종속되어 있는가.」** 공장에 「지금 몇 대 밀렸나」를
+ * 묻는 화면이 보드 편집 권한을 요구했고, 그 문 뒤에 스물다섯이 있는데 쓰는 것은 하나였다.
+ *
+ * 재 보니 문제는 「공통이냐 아니냐」가 아니었다 — `board-ui` 를 지나 **아홉 개 앱**이 이미 이
+ * 기계를 싣고 있었다. 이미 공통이었고, 이름과 게이트만 보드 편집기의 것이었다.
+ *
+ * ── 자르는 선 ───────────────────────────────────────────────────────────────
+ * 물음 하나로 줄였다: **「이것이 보드가 없는 제품에서도 뜻이 있나.」**
+ *
+ *   여기       세션·메시지·참가자·인박스·구독 인증·앵커
+ *   board-ai   보드 편집기 — assistant · 패치 · 프리팹 · 컴포넌트 트리 · 스타일링
+ *
+ * `assistant.ts`(113KB)는 **안 옮겼다.** 거의 전부 보드 편집이다. 가장 큰 파일이 제자리에 있다는
+ * 뜻이고, 그래서 이 분리는 생각보다 작았다.
+ *
+ * ── 의존은 한쪽이다 ─────────────────────────────────────────────────────────
+ * `board-ai → ai-assistant`. 반대는 없다. 그것을 위해 두 변을 먼저 끊었다 — `ChatSession` 의
+ * 보드 패치 관계와, 리졸버 안에 섞여 있던 보드 op 여섯.
+ *
+ * 설계 정본은 `things-factory/docs/design/ai-modules.md`.
+ */
+export * from './service/index.js';

package/dist-server/index.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * `@things-factory/ai-assistant` — **AI 대화의 집.**
+ *
+ * 세션·메시지·참가자·인박스·구독. 도메인을 모른다: 보드도, 공장도, 자산도.
+ *
+ * ── 왜 board-ai 에서 나왔나 (2026-09-10) ────────────────────────────────────
+ * 시작한 물음은 하나였다. **「왜 board-ai 에 종속되어 있는가.」** 공장에 「지금 몇 대 밀렸나」를
+ * 묻는 화면이 보드 편집 권한을 요구했고, 그 문 뒤에 스물다섯이 있는데 쓰는 것은 하나였다.
+ *
+ * 재 보니 문제는 「공통이냐 아니냐」가 아니었다 — `board-ui` 를 지나 **아홉 개 앱**이 이미 이
+ * 기계를 싣고 있었다. 이미 공통이었고, 이름과 게이트만 보드 편집기의 것이었다.
+ *
+ * ── 자르는 선 ───────────────────────────────────────────────────────────────
+ * 물음 하나로 줄였다: **「이것이 보드가 없는 제품에서도 뜻이 있나.」**
+ *
+ *   여기       세션·메시지·참가자·인박스·구독 인증·앵커
+ *   board-ai   보드 편집기 — assistant · 패치 · 프리팹 · 컴포넌트 트리 · 스타일링
+ *
+ * `assistant.ts`(113KB)는 **안 옮겼다.** 거의 전부 보드 편집이다. 가장 큰 파일이 제자리에 있다는
+ * 뜻이고, 그래서 이 분리는 생각보다 작았다.
+ *
+ * ── 의존은 한쪽이다 ─────────────────────────────────────────────────────────
+ * `board-ai → ai-assistant`. 반대는 없다. 그것을 위해 두 변을 먼저 끊었다 — `ChatSession` 의
+ * 보드 패치 관계와, 리졸버 안에 섞여 있던 보드 op 여섯.
+ *
+ * 설계 정본은 `things-factory/docs/design/ai-modules.md`.
+ */
+tslib_1.__exportStar(require("./service/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,6DAAkC","sourcesContent":["/**\n * `@things-factory/ai-assistant` — **AI 대화의 집.**\n *\n * 세션·메시지·참가자·인박스·구독. 도메인을 모른다: 보드도, 공장도, 자산도.\n *\n * ── 왜 board-ai 에서 나왔나 (2026-09-10) ────────────────────────────────────\n * 시작한 물음은 하나였다. **「왜 board-ai 에 종속되어 있는가.」** 공장에 「지금 몇 대 밀렸나」를\n * 묻는 화면이 보드 편집 권한을 요구했고, 그 문 뒤에 스물다섯이 있는데 쓰는 것은 하나였다.\n *\n * 재 보니 문제는 「공통이냐 아니냐」가 아니었다 — `board-ui` 를 지나 **아홉 개 앱**이 이미 이\n * 기계를 싣고 있었다. 이미 공통이었고, 이름과 게이트만 보드 편집기의 것이었다.\n *\n * ── 자르는 선 ───────────────────────────────────────────────────────────────\n * 물음 하나로 줄였다: **「이것이 보드가 없는 제품에서도 뜻이 있나.」**\n *\n *   여기       세션·메시지·참가자·인박스·구독 인증·앵커\n *   board-ai   보드 편집기 — assistant · 패치 · 프리팹 · 컴포넌트 트리 · 스타일링\n *\n * `assistant.ts`(113KB)는 **안 옮겼다.** 거의 전부 보드 편집이다. 가장 큰 파일이 제자리에 있다는\n * 뜻이고, 그래서 이 분리는 생각보다 작았다.\n *\n * ── 의존은 한쪽이다 ─────────────────────────────────────────────────────────\n * `board-ai → ai-assistant`. 반대는 없다. 그것을 위해 두 변을 먼저 끊었다 — `ChatSession` 의\n * 보드 패치 관계와, 리졸버 안에 섞여 있던 보드 op 여섯.\n *\n * 설계 정본은 `things-factory/docs/design/ai-modules.md`.\n */\nexport * from './service/index.js'\n"]}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishChatMessage = publishChatMessage;
+/*
+ * chat-message 방송 publisher — pubsub 의존, 데코레이터 없음.
+ *
+ * 데코레이터 resolver(chat-message-subscription.ts)와 분리한 이유: babel-jest 가 파라미터
+ * 데코레이터(@Root/@Arg)를 파싱 못 해 그 파일을 테스트에서 import 할 수 없다. 이 모듈은
+ * 데코레이터가 없어 통합 테스트가 실제 publish→방송 경로를 직접 구동할 수 있다.
+ */
+const shell_1 = require("@things-factory/shell");
+const chat_message_broadcast_js_1 = require("./chat-message-broadcast.js");
+/**
+ * ChatMessage 영속 직후 호출 — 같은 세션 구독자에게 방송.
+ * sessionId 없으면 skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.
+ */
+function publishChatMessage(payload) {
+    if (!payload.sessionId)
+        return;
+    try {
+        shell_1.pubsub.publish(chat_message_broadcast_js_1.CHAT_MESSAGE_TOPIC, payload);
+    }
+    catch {
+        /* 방송 생략 — 영속은 이미 끝남 */
+    }
+}
+//# sourceMappingURL=chat-message-publish.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message-publish.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message-publish.ts"],"names":[],"mappings":";;AAcA,gDAOC;AArBD;;;;;;GAMG;AACH,iDAA8C;AAC9C,2EAAyF;AAEzF;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,OAA2B;IAC5D,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAM;IAC9B,IAAI,CAAC;QACH,cAAM,CAAC,OAAO,CAAC,8CAAkB,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC","sourcesContent":["/*\n * chat-message 방송 publisher — pubsub 의존, 데코레이터 없음.\n *\n * 데코레이터 resolver(chat-message-subscription.ts)와 분리한 이유: babel-jest 가 파라미터\n * 데코레이터(@Root/@Arg)를 파싱 못 해 그 파일을 테스트에서 import 할 수 없다. 이 모듈은\n * 데코레이터가 없어 통합 테스트가 실제 publish→방송 경로를 직접 구동할 수 있다.\n */\nimport { pubsub } from '@things-factory/shell'\nimport { CHAT_MESSAGE_TOPIC, type ChatMessagePayload } from './chat-message-broadcast.js'\n\n/**\n * ChatMessage 영속 직후 호출 — 같은 세션 구독자에게 방송.\n * sessionId 없으면 skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.\n */\nexport function publishChatMessage(payload: ChatMessagePayload): void {\n  if (!payload.sessionId) return\n  try {\n    pubsub.publish(CHAT_MESSAGE_TOPIC, payload)\n  } catch {\n    /* 방송 생략 — 영속은 이미 끝남 */\n  }\n}\n"]}

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

@@ -0,0 +1,8 @@
+import { ChatMessage } from './chat-message.js';
+import { type ChatMessagePayload } from './chat-message-broadcast.js';
+export { publishChatMessage } from './chat-message-publish.js';
+export { CHAT_MESSAGE_TOPIC, chatMessageFilter } from './chat-message-broadcast.js';
+export type { ChatMessagePayload } from './chat-message-broadcast.js';
+export declare class ChatMessageSubscription {
+    chatMessageActivity(payload: ChatMessagePayload, sessionId: string): ChatMessage;
+}

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatMessageSubscription = exports.chatMessageFilter = exports.CHAT_MESSAGE_TOPIC = exports.publishChatMessage = void 0;
+const tslib_1 = require("tslib");
+/*
+ * ChatMessageSubscription — 그룹챗 메시지 실시간 방송.
+ *
+ * 클래스 이름이 `BoardChatMessageSubscription` 이었다. 전선 이름(`chatMessageActivity`)은 처음부터
+ * 중립이었고 클래스 이름만 보드였다 — 중립 패키지로 옮기면서 고쳤다(2026-09-10). 전선이 안 바뀌므로
+ * 소비처는 그대로다.
+ *
+ * ChatMessage(사용자 / AI / system) 가 영속될 때마다 같은 세션 구독자에게 방송 →
+ * 그룹챗의 척추. 클라이언트(board-ai-chat)가 구독해 원격 메시지를 transcript 에 append.
+ * 자기 발신 에코는 클라이언트가 message.id 로 dedup (mutation 응답으로 이미 렌더).
+ *
+ * patch spine(board-patch-subscription.ts)과 동일 패턴 — PubSub + graphql-ws, domain 격리.
+ * 차이: 필터 키가 board 가 아닌 sessionId (채팅은 ChatSession 단위).
+ * 순수 로직(토픽/필터)은 chat-message-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_yoga_1 = require("graphql-yoga");
+const shell_1 = require("@things-factory/shell");
+const chat_message_js_1 = require("./chat-message.js");
+const chat_message_broadcast_js_1 = require("./chat-message-broadcast.js");
+const subscribe_auth_js_1 = require("../subscribe-auth.js");
+// publishChatMessage 는 데코레이터 없는 chat-message-publish.ts 에 분리 (테스트 import 가능).
+var chat_message_publish_js_1 = require("./chat-message-publish.js");
+Object.defineProperty(exports, "publishChatMessage", { enumerable: true, get: function () { return chat_message_publish_js_1.publishChatMessage; } });
+var chat_message_broadcast_js_2 = require("./chat-message-broadcast.js");
+Object.defineProperty(exports, "CHAT_MESSAGE_TOPIC", { enumerable: true, get: function () { return chat_message_broadcast_js_2.CHAT_MESSAGE_TOPIC; } });
+Object.defineProperty(exports, "chatMessageFilter", { enumerable: true, get: function () { return chat_message_broadcast_js_2.chatMessageFilter; } });
+let ChatMessageSubscription = class ChatMessageSubscription {
+    chatMessageActivity(payload, sessionId) {
+        return payload.message;
+    }
+};
+exports.ChatMessageSubscription = ChatMessageSubscription;
+tslib_1.__decorate([
+    (0, type_graphql_1.Subscription)({
+        description: 'Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.',
+        subscribe: async ({ args, context }) => {
+            const { domain, user } = context.state;
+            const { sessionId } = args;
+            await (0, subscribe_auth_js_1.assertDomainSubscribeAllowed)(domain, user, (d, u) => process.superUserGranted(d, u));
+            return (0, graphql_yoga_1.pipe)(shell_1.pubsub.subscribe(chat_message_broadcast_js_1.CHAT_MESSAGE_TOPIC), (0, graphql_yoga_1.filter)((0, chat_message_broadcast_js_1.chatMessageFilter)(domain.id, sessionId)));
+        }
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('sessionId')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String]),
+    tslib_1.__metadata("design:returntype", chat_message_js_1.ChatMessage)
+], ChatMessageSubscription.prototype, "chatMessageActivity", null);
+exports.ChatMessageSubscription = ChatMessageSubscription = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(chat_message_js_1.ChatMessage)
+], ChatMessageSubscription);
+//# sourceMappingURL=chat-message-subscription.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message-subscription.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message-subscription.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,+CAAgE;AAChE,+CAA2C;AAC3C,iDAA8C;AAC9C,uDAA+C;AAC/C,2EAA4G;AAC5G,4DAAmE;AAEnE,8EAA8E;AAC9E,qEAA8D;AAArD,6HAAA,kBAAkB,OAAA;AAC3B,yEAAmF;AAA1E,+HAAA,kBAAkB,OAAA;AAAE,8HAAA,iBAAiB,OAAA;AAIvC,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAalC,mBAAmB,CAAS,OAA2B,EAAoB,SAAiB;QAC1F,OAAO,OAAO,CAAC,OAAO,CAAA;IACxB,CAAC;CACF,CAAA;AAhBY,0DAAuB;AAalC;IAZC,IAAA,2BAAY,EAAC;QACZ,WAAW,EACT,gGAAgG;QAClG,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;YACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;YAE1B,MAAM,IAAA,gDAA4B,EAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE1F,OAAO,IAAA,mBAAI,EAAC,cAAM,CAAC,SAAS,CAAC,8CAAkB,CAAC,EAAE,IAAA,qBAAM,EAAC,IAAA,6CAAiB,EAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QACpG,CAAC;KACF,CAAC;IACmB,mBAAA,IAAA,mBAAI,GAAE,CAAA;IAA+B,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;;;4CAAqB,6BAAW;kEAEzG;kCAfU,uBAAuB;IADnC,IAAA,uBAAQ,EAAC,6BAAW,CAAC;GACT,uBAAuB,CAgBnC","sourcesContent":["/*\n * ChatMessageSubscription — 그룹챗 메시지 실시간 방송.\n *\n * 클래스 이름이 `BoardChatMessageSubscription` 이었다. 전선 이름(`chatMessageActivity`)은 처음부터\n * 중립이었고 클래스 이름만 보드였다 — 중립 패키지로 옮기면서 고쳤다(2026-09-10). 전선이 안 바뀌므로\n * 소비처는 그대로다.\n *\n * ChatMessage(사용자 / AI / system) 가 영속될 때마다 같은 세션 구독자에게 방송 →\n * 그룹챗의 척추. 클라이언트(board-ai-chat)가 구독해 원격 메시지를 transcript 에 append.\n * 자기 발신 에코는 클라이언트가 message.id 로 dedup (mutation 응답으로 이미 렌더).\n *\n * patch spine(board-patch-subscription.ts)과 동일 패턴 — PubSub + graphql-ws, domain 격리.\n * 차이: 필터 키가 board 가 아닌 sessionId (채팅은 ChatSession 단위).\n * 순수 로직(토픽/필터)은 chat-message-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.\n */\nimport { Resolver, Subscription, Root, Arg } from 'type-graphql'\nimport { filter, pipe } from 'graphql-yoga'\nimport { pubsub } from '@things-factory/shell'\nimport { ChatMessage } from './chat-message.js'\nimport { CHAT_MESSAGE_TOPIC, chatMessageFilter, type ChatMessagePayload } from './chat-message-broadcast.js'\nimport { assertDomainSubscribeAllowed } from '../subscribe-auth.js'\n\n// publishChatMessage 는 데코레이터 없는 chat-message-publish.ts 에 분리 (테스트 import 가능).\nexport { publishChatMessage } from './chat-message-publish.js'\nexport { CHAT_MESSAGE_TOPIC, chatMessageFilter } from './chat-message-broadcast.js'\nexport type { ChatMessagePayload } from './chat-message-broadcast.js'\n\n@Resolver(ChatMessage)\nexport class ChatMessageSubscription {\n  @Subscription({\n    description:\n      'Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.',\n    subscribe: async ({ args, context }) => {\n      const { domain, user } = context.state\n      const { sessionId } = args\n\n      await assertDomainSubscribeAllowed(domain, user, (d, u) => process.superUserGranted(d, u))\n\n      return pipe(pubsub.subscribe(CHAT_MESSAGE_TOPIC), filter(chatMessageFilter(domain.id, sessionId)))\n    }\n  })\n  chatMessageActivity(@Root() payload: ChatMessagePayload, @Arg('sessionId') sessionId: string): ChatMessage {\n    return payload.message\n  }\n}\n"]}

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

@@ -0,0 +1,68 @@
+import { User } from '@things-factory/auth-base';
+import { ChatSession } from '../chat-session/chat-session.js';
+export declare class ChatMessage {
+    readonly id?: string;
+    session?: ChatSession;
+    sessionId?: string;
+    role: string;
+    content: string;
+    relatedPatchId?: string;
+    relatedImportSessionId?: string;
+    /**
+     * AI 가 응답을 만드는 동안 호출한 도구 trace — JSON-stringified.
+     *
+     * 컬럼은 string (PatchEntry.ops 와 동일 패턴), GraphQL 노출은 toolUsagesJson getter
+     * 로 parse 된 객체. UI 의 fold-able 박스 ("AI 가 이런 도구를 사용했습니다") 가
+     * 페이지 reload / loadHistory 후에도 살아있도록 영속.
+     *
+     * 형태: ToolUsage[] (assistant.ts 의 시간순 trace, summarizeToolResult 로 압축).
+     * null 이면 도구 호출 없었던 메시지 (text-only 응답).
+     */
+    toolUsages?: string;
+    /** GraphQL 노출용 — JSON 배열로 parse. */
+    get toolUsagesJson(): any;
+    /**
+     * 접지 경고 — 이 답이 언급했으나 근거(프롬프트·보드 문맥·이력·도구 결과)에 없던 식별자 목록.
+     *
+     * **왜 영속하는가**: 도크의 협의는 여러 사람이 며칠에 걸쳐 읽는다. 경고가 그 자리에서만
+     * 보이고 새로 고치면 사라지면, 나중에 읽는 사람은 검증되지 않은 문장을 검증된 것으로 읽는다.
+     * 다시 계산할 수도 없다 — 근거였던 도구 결과 원문은 남지 않고 압축본만 남기 때문이다.
+     *
+     * 형태: string[] 를 JSON-stringify. 비었으면 null(= 접지 정상).
+     */
+    groundingWarnings?: string;
+    /** GraphQL 노출용 — 식별자 배열로 parse. */
+    get groundingWarningsJson(): any;
+    /**
+     * 메시지를 일으킨 사용자.
+     *   - role='user' → 보낸 사용자
+     *   - role='assistant' → 그 응답을 트리거한 사용자 (직전 user 메시지의 작성자)
+     *   - role='system' → 시스템 액션을 일으킨 사용자 (예: 직접 편집한 사용자)
+     *
+     * nullable — legacy 메시지 (이 필드 추가 이전에 작성) 는 null. 또한 ad-hoc 모드 / 시스템
+     * 자동 메시지 중 사용자 컨텍스트가 없는 경우도 null 가능.
+     */
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    /**
+     * 부모 메시지 — 이 메시지가 "응답하는 대상" / "이어가는 메시지" 의 id.
+     *
+     * 의미 (role 별):
+     *   - 'user' → 직전 in-session 메시지 (보통 assistant 또는 system). 첫 turn 은 null.
+     *   - 'assistant' → 이 응답이 답하는 user 메시지. (regenerate 로 같은 user 메시지를 부모로
+     *     하는 형제 assistant 메시지가 생기면 자연스럽게 branching tree 가 됨)
+     *   - 'system' → 직전 in-session 메시지 (timeline 연속성 유지).
+     *
+     * 이 한 컬럼으로 향후 어떤 흐름이든 표현 가능 — linear chain / branching (regenerate) /
+     * tree (replies-to-specific-message) 등. UI/쿼리는 점진 도입.
+     *
+     * onDelete: 'SET NULL' — 부모 메시지가 삭제돼도 child 는 남되 dangling 마킹.
+     */
+    parentMessage?: ChatMessage;
+    parentMessageId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}