@things-factory/ai-assistant 10.1.24 → 10.1.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/client/components/assistant-chat.ts +90 -18
  2. package/client/components/assistant-mode.test.ts +97 -0
  3. package/client/components/assistant-mode.ts +130 -0
  4. package/client/index.ts +1 -1
  5. package/dist-client/components/assistant-chat.d.ts +15 -4
  6. package/dist-client/components/assistant-chat.js +73 -18
  7. package/dist-client/components/assistant-chat.js.map +1 -1
  8. package/dist-client/components/assistant-mode.d.ts +97 -0
  9. package/dist-client/components/assistant-mode.js +36 -0
  10. package/dist-client/components/assistant-mode.js.map +1 -0
  11. package/dist-client/components/assistant-mode.test.d.ts +1 -0
  12. package/dist-client/components/assistant-mode.test.js +85 -0
  13. package/dist-client/components/assistant-mode.test.js.map +1 -0
  14. package/dist-client/index.d.ts +1 -1
  15. package/dist-client/index.js +1 -1
  16. package/dist-client/index.js.map +1 -1
  17. package/dist-client/tsconfig.tsbuildinfo +1 -1
  18. package/dist-server/index.d.ts +1 -0
  19. package/dist-server/index.js +1 -0
  20. package/dist-server/index.js.map +1 -1
  21. package/dist-server/service/assistant-chat-resolver.js +3 -1
  22. package/dist-server/service/assistant-chat-resolver.js.map +1 -1
  23. package/dist-server/service/index.d.ts +1 -0
  24. package/dist-server/service/index.js +1 -0
  25. package/dist-server/service/index.js.map +1 -1
  26. package/dist-server/service/tool-access.d.ts +4 -0
  27. package/dist-server/service/tool-access.js +23 -0
  28. package/dist-server/service/tool-access.js.map +1 -0
  29. package/dist-server/tool-registry-boot-report.d.ts +3 -0
  30. package/dist-server/tool-registry-boot-report.js +29 -0
  31. package/dist-server/tool-registry-boot-report.js.map +1 -0
  32. package/dist-server/tsconfig.tsbuildinfo +1 -1
  33. package/docs/session-controller.md +1 -1
  34. package/package.json +5 -5
  35. package/server/index.ts +1 -0
  36. package/server/service/assistant-chat-resolver.ts +3 -1
  37. package/server/service/index.ts +1 -0
  38. package/server/service/tool-access.test.ts +48 -0
  39. package/server/service/tool-access.ts +27 -0
  40. package/server/tool-registry-boot-report.test.ts +18 -0
  41. package/server/tool-registry-boot-report.ts +26 -0
  42. package/test/assistant-request-context.test.ts +2 -2
  43. package/test/assistant-session-controller.test.ts +0 -1
  44. package/test/assistant-session-toolbar.test.ts +2 -2
  45. package/client/utils/board-edit-patch.ts +0 -374
  46. package/dist-client/utils/board-edit-patch.d.ts +0 -157
  47. package/dist-client/utils/board-edit-patch.js +0 -284
  48. package/dist-client/utils/board-edit-patch.js.map +0 -1
@@ -1,157 +0,0 @@
1
- /**
2
- * Client-side BoardEditPatch types + applier.
3
- *
4
- * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.
5
- * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.
6
- */
7
- /**
8
- * 컴포넌트 타깃팅은 항상 `refid` (things-scene universal numeric handle).
9
- * `id` 는 데이터 바인딩 이름이며 unique 가 아니므로 targeting 에 사용하지 않는다.
10
- *
11
- * 보드는 최상위 부모 — 자체 속성 (fillStyle / width / height / name 등) 을 갖고,
12
- * `modifyBoard` 로 변경. 자식 컴포넌트 변경 (`modify`) 와 분리.
13
- *
14
- * Phase 2 — Scene 조작 op (align/distribute/group/ungroup/zorder). model 차원
15
- * 시뮬레이션은 noop 이고 things-scene API 가 정본.
16
- */
17
- export type AlignDirection = 'left' | 'right' | 'center' | 'top' | 'middle' | 'bottom';
18
- export type DistributeAxis = 'horizontal' | 'vertical';
19
- export type ZorderDirection = 'front' | 'back' | 'forward' | 'backward';
20
- /**
21
- * Sugar layout — `arrange` op 의 layout 종류.
22
- * Server-side types.ts 의 ArrangeLayout 와 일치 — drift test 가 검증.
23
- */
24
- export type ArrangeLayout = {
25
- type: 'grid';
26
- cols: number;
27
- gap?: number;
28
- anchor?: {
29
- left: number;
30
- top: number;
31
- };
32
- } | {
33
- type: 'row';
34
- gap?: number;
35
- anchor?: {
36
- left: number;
37
- top: number;
38
- };
39
- align?: 'start' | 'center' | 'end';
40
- } | {
41
- type: 'column';
42
- gap?: number;
43
- anchor?: {
44
- left: number;
45
- top: number;
46
- };
47
- align?: 'start' | 'center' | 'end';
48
- };
49
- export type BoardEditOp = {
50
- op: 'add';
51
- component: any;
52
- } | {
53
- op: 'remove';
54
- refid: number;
55
- } | {
56
- op: 'modify';
57
- refid: number;
58
- patch: any;
59
- } | {
60
- op: 'modifyBoard';
61
- patch: any;
62
- } | {
63
- op: 'replace';
64
- board: any;
65
- } | {
66
- op: 'align';
67
- refids: number[];
68
- direction: AlignDirection;
69
- } | {
70
- op: 'distribute';
71
- refids: number[];
72
- axis: DistributeAxis;
73
- } | {
74
- op: 'group';
75
- refids: number[];
76
- } | {
77
- op: 'ungroup';
78
- refid: number;
79
- } | {
80
- op: 'zorder';
81
- refid: number;
82
- direction: ZorderDirection;
83
- } | {
84
- op: 'arrange';
85
- refids: number[];
86
- layout: ArrangeLayout;
87
- };
88
- /**
89
- * C-1 — Scene 조작 action (ephemeral). 모델 변경 X, undo 영향 X.
90
- * 호스트가 board-action-execute 이벤트로 받아서 things-scene API 직접 호출.
91
- */
92
- export type BoardActionOp = {
93
- action: 'selectComponents';
94
- refids: number[];
95
- } | {
96
- action: 'centerToComponent';
97
- refid: number;
98
- animated?: boolean;
99
- } | {
100
- action: 'fitToView';
101
- mode?: 'fit' | 'ratio' | 'width' | 'height';
102
- } | {
103
- action: 'setSceneMode';
104
- mode: 'edit' | 'view';
105
- } | {
106
- action: 'highlightComponents';
107
- refids: number[];
108
- };
109
- export interface BoardEditPatch {
110
- ops: BoardEditOp[];
111
- summary: string;
112
- confidence: number;
113
- }
114
- export interface PatchApplyReport {
115
- /** 패치 적용 후 보드. 모든 op 가 noop 이어도 입력 그대로 반환. */
116
- board: any;
117
- /** 실제로 보드를 바꾼 op 들. */
118
- applied: BoardEditOp[];
119
- /** id 매칭 실패 등으로 noop 이 된 op 들 — 호출자가 사용자에게 알릴 단서. */
120
- missed: BoardEditOp[];
121
- }
122
- /**
123
- * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).
124
- */
125
- export declare function applyBoardEditPatch(board: any | undefined, patch: BoardEditPatch): any;
126
- /**
127
- * Verbose 변형 — 각 op 의 적용 여부를 보고.
128
- *
129
- * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된
130
- * id 를 만들어 보내면 사용자에게 "수정했습니다" 라고 답하지만 실제로는 아무 변화도
131
- * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도
132
- * entry point 제공.
133
- */
134
- export declare function applyBoardEditPatchVerbose(board: any | undefined, patch: BoardEditPatch): PatchApplyReport;
135
- /**
136
- * 주어진 board 상태에서 op 의 inverse 를 계산.
137
- *
138
- * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가
139
- * 누적해두면 나중에 역순 실행만으로 복원.
140
- *
141
- * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.
142
- * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.
143
- */
144
- export declare function computeInverseOp(board: any, op: BoardEditOp): BoardEditOp | null;
145
- /**
146
- * 컴포넌트에 부분 patch 를 적용 (deep merge).
147
- * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
148
- *
149
- * patch 내 `null` 의 시맨틱 — **"이 키를 제거하라"**:
150
- * - fillStyle/strokeStyle 처럼 `string | object | undefined` 인 필드는 null 로
151
- * set 하면 typeof null === 'object' 함정에 빠져 다운스트림 (3D 텍스처 등) 이 크래시.
152
- * - computeInverseOp 가 base 에 키가 없던 (`undefined`) 경우 inverse 를 null 로
153
- * 발급하므로, 이 시맨틱과 정확히 일치 — inverse 가 자연스럽게 올바로 동작.
154
- *
155
- * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.
156
- */
157
- export declare function mergeComponent(base: any, patch: any): any;
@@ -1,284 +0,0 @@
1
- /**
2
- * Client-side BoardEditPatch types + applier.
3
- *
4
- * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.
5
- * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.
6
- */
7
- const EMPTY_BOARD = { width: 1000, height: 600, components: [] };
8
- /**
9
- * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).
10
- */
11
- export function applyBoardEditPatch(board, patch) {
12
- return applyBoardEditPatchVerbose(board, patch).board;
13
- }
14
- /**
15
- * Verbose 변형 — 각 op 의 적용 여부를 보고.
16
- *
17
- * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된
18
- * id 를 만들어 보내면 사용자에게 "수정했습니다" 라고 답하지만 실제로는 아무 변화도
19
- * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도
20
- * entry point 제공.
21
- */
22
- export function applyBoardEditPatchVerbose(board, patch) {
23
- let result = board ?? EMPTY_BOARD;
24
- const applied = [];
25
- const missed = [];
26
- for (const op of patch.ops) {
27
- if (SCENE_ONLY_OPS.has(op.op)) {
28
- // scene-only — model 차원 noop, scene 차원 적용. applied 분류.
29
- applied.push(op);
30
- continue;
31
- }
32
- const next = applyOp(result, op);
33
- // componentsUnchanged 는 components 배열 동일 + width/height/fillStyle 동일 만 본다.
34
- // modify / remove 의 silent no-op (ghost refid) 검출 전용 — modifyBoard 가 sky
35
- // 등 다른 root 키만 바꿀 때 false negative 로 missed 분류되는 회귀 방지.
36
- const componentMutating = op.op === 'modify' || op.op === 'remove';
37
- if (next === result || (componentMutating && componentsUnchanged(result, next))) {
38
- missed.push(op);
39
- }
40
- else {
41
- applied.push(op);
42
- result = next;
43
- }
44
- }
45
- return { board: result, applied, missed };
46
- }
47
- function componentsUnchanged(prev, next) {
48
- // applyOp 는 항상 새 객체를 만든다. 따라서 reference 비교가 안 되고 내용 비교 필요.
49
- // components 는 map/filter 결과 reference 도 다를 수 있으므로 length + 요소 ref 비교.
50
- const a = prev.components ?? [];
51
- const b = next.components ?? [];
52
- if (a.length !== b.length)
53
- return false;
54
- for (let i = 0; i < a.length; i++) {
55
- if (a[i] !== b[i])
56
- return false;
57
- }
58
- return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle;
59
- }
60
- const SCENE_ONLY_OPS = new Set([
61
- 'align',
62
- 'distribute',
63
- 'group',
64
- 'ungroup',
65
- 'zorder',
66
- 'arrange'
67
- ]);
68
- function applyOp(board, op) {
69
- switch (op.op) {
70
- case 'replace':
71
- return op.board;
72
- case 'add':
73
- return { ...board, components: [...(board.components || []), op.component] };
74
- case 'remove':
75
- // 자식 (group/container 안) refid 도 매칭 — deep search.
76
- return {
77
- ...board,
78
- components: removeComponentDeep(board.components || [], op.refid)
79
- };
80
- case 'modify':
81
- // 자식 refid 도 매칭 — group/container 안의 컴포넌트 수정 가능.
82
- return {
83
- ...board,
84
- components: modifyComponentDeep(board.components || [], op.refid, op.patch)
85
- };
86
- case 'modifyBoard': {
87
- const patch = { ...(op.patch || {}) };
88
- delete patch.components; // 자식 변경은 별도 op
89
- return mergeComponent(board, patch); // 최상위 board 자체에 deep-merge
90
- }
91
- case 'align':
92
- case 'distribute':
93
- case 'group':
94
- case 'ungroup':
95
- case 'zorder':
96
- case 'arrange':
97
- // scene-only — model 차원 noop. things-scene API 가 정본.
98
- return board;
99
- default:
100
- return board;
101
- }
102
- }
103
- /**
104
- * 주어진 board 상태에서 op 의 inverse 를 계산.
105
- *
106
- * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가
107
- * 누적해두면 나중에 역순 실행만으로 복원.
108
- *
109
- * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.
110
- * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.
111
- */
112
- export function computeInverseOp(board, op) {
113
- if (!board)
114
- return null;
115
- const components = board.components ?? [];
116
- switch (op.op) {
117
- case 'add':
118
- return null;
119
- case 'remove': {
120
- // 자식 refid 도 매칭 (deep search)
121
- const target = findComponentDeep(components, op.refid);
122
- if (!target)
123
- return null;
124
- return { op: 'add', component: JSON.parse(JSON.stringify(target)) };
125
- }
126
- case 'modify': {
127
- // 자식 refid 도 매칭 (deep search)
128
- const target = findComponentDeep(components, op.refid);
129
- if (!target)
130
- return null;
131
- const oldValues = {};
132
- for (const k of Object.keys(op.patch || {})) {
133
- const v = target[k];
134
- oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
135
- }
136
- return { op: 'modify', refid: op.refid, patch: oldValues };
137
- }
138
- case 'modifyBoard': {
139
- const oldValues = {};
140
- const patch = op.patch || {};
141
- for (const k of Object.keys(patch)) {
142
- if (k === 'components')
143
- continue;
144
- const v = board[k];
145
- oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
146
- }
147
- return { op: 'modifyBoard', patch: oldValues };
148
- }
149
- case 'replace':
150
- return { op: 'replace', board: JSON.parse(JSON.stringify(board)) };
151
- case 'zorder': {
152
- // forward ↔ backward / front ↔ back. front/back 의 inverse 는 정확하지
153
- // 않을 수 있음 (best-effort) — 정확 inverse 는 호스트가 zorder 직전 index
154
- // 를 캡처해서 명시 modify 시퀀스로 만들어야.
155
- const opp = {
156
- forward: 'backward',
157
- backward: 'forward',
158
- front: 'back',
159
- back: 'front'
160
- };
161
- const dir = opp[op.direction];
162
- if (!dir)
163
- return null;
164
- return { op: 'zorder', refid: op.refid, direction: dir };
165
- }
166
- case 'align':
167
- case 'distribute':
168
- case 'group':
169
- case 'ungroup':
170
- case 'arrange':
171
- // scene 호출 후에야 변경 결과 알 수 있음. 호스트가 직접 inverse 만든다.
172
- return null;
173
- default:
174
- return null;
175
- }
176
- }
177
- /**
178
- * 컴포넌트에 부분 patch 를 적용 (deep merge).
179
- * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
180
- *
181
- * patch 내 `null` 의 시맨틱 — **"이 키를 제거하라"**:
182
- * - fillStyle/strokeStyle 처럼 `string | object | undefined` 인 필드는 null 로
183
- * set 하면 typeof null === 'object' 함정에 빠져 다운스트림 (3D 텍스처 등) 이 크래시.
184
- * - computeInverseOp 가 base 에 키가 없던 (`undefined`) 경우 inverse 를 null 로
185
- * 발급하므로, 이 시맨틱과 정확히 일치 — inverse 가 자연스럽게 올바로 동작.
186
- *
187
- * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.
188
- */
189
- export function mergeComponent(base, patch) {
190
- const out = { ...base };
191
- for (const key of Object.keys(patch)) {
192
- const patchVal = patch[key];
193
- if (patchVal === null) {
194
- delete out[key];
195
- }
196
- else if (isPlainObject(base[key]) && isPlainObject(patchVal)) {
197
- out[key] = deepMerge(base[key], patchVal);
198
- }
199
- else {
200
- out[key] = patchVal;
201
- }
202
- }
203
- return out;
204
- }
205
- function deepMerge(a, b) {
206
- const out = { ...a };
207
- for (const key of Object.keys(b)) {
208
- const bv = b[key];
209
- if (bv === null) {
210
- delete out[key];
211
- }
212
- else if (isPlainObject(a[key]) && isPlainObject(bv)) {
213
- out[key] = deepMerge(a[key], bv);
214
- }
215
- else {
216
- out[key] = bv;
217
- }
218
- }
219
- return out;
220
- }
221
- function isPlainObject(v) {
222
- return v !== null && typeof v === 'object' && !Array.isArray(v);
223
- }
224
- // ── 자식 컴포넌트 (group/container 안) 까지 매칭 — deep search ─
225
- // server/service/apply-patch.ts 와 동일 로직. drift test 가 동등성 보장.
226
- function findComponentDeep(components, refid) {
227
- for (const c of components) {
228
- if (!c)
229
- continue;
230
- if (c.refid === refid)
231
- return c;
232
- if (Array.isArray(c.components) && c.components.length > 0) {
233
- const sub = findComponentDeep(c.components, refid);
234
- if (sub)
235
- return sub;
236
- }
237
- }
238
- return undefined;
239
- }
240
- function modifyComponentDeep(components, refid, patch) {
241
- let changed = false;
242
- const out = components.map(c => {
243
- if (!c)
244
- return c;
245
- if (c.refid === refid) {
246
- changed = true;
247
- return mergeComponent(c, patch);
248
- }
249
- if (Array.isArray(c.components) && c.components.length > 0) {
250
- const updated = modifyComponentDeep(c.components, refid, patch);
251
- if (updated !== c.components) {
252
- changed = true;
253
- return { ...c, components: updated };
254
- }
255
- }
256
- return c;
257
- });
258
- return changed ? out : components;
259
- }
260
- function removeComponentDeep(components, refid) {
261
- let changed = false;
262
- const out = [];
263
- for (const c of components) {
264
- if (!c) {
265
- out.push(c);
266
- continue;
267
- }
268
- if (c.refid === refid) {
269
- changed = true;
270
- continue;
271
- }
272
- if (Array.isArray(c.components) && c.components.length > 0) {
273
- const updated = removeComponentDeep(c.components, refid);
274
- if (updated !== c.components) {
275
- changed = true;
276
- out.push({ ...c, components: updated });
277
- continue;
278
- }
279
- }
280
- out.push(c);
281
- }
282
- return changed ? out : components;
283
- }
284
- //# sourceMappingURL=board-edit-patch.js.map
@@ -1 +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"]}