@things-factory/board-ai 10.1.45 → 10.1.47

package/dist-client/server/service/types.d.ts

@@ -12,6 +12,12 @@ import type { SceneActionOp, SceneEditPatch } from '@operato/scene-ops';
 import type { LLMMessage } from '@things-factory/ai-assistant';
 export type { LLMMessage };
 export interface ChatOptions {
+    /**
+     * Who the assistant is on this surface — a registered mode's `systemPrompt` (ADR-0061 decision 7).
+     * Added after board-ai's own authoring instructions, which stay: they describe the board document
+     * and its tools, and the mode describes the product and the person's work.
+     */
+    surfacePrompt?: string;
     /**
      * 이 대화에 노출할 **외부 도구 카테고리** 화이트리스트(registerToolCategory 이름).
      * 미지정 = 등록된 전부(현행 동작). 성격이 다른 대화면(보드 저작 도크 · 운영 도크)이

package/dist-client/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). */\n/*\n * The edit vocabulary is not this package's. A person dragging a box produces the same\n * operations, so they live in @operato/scene-ops with the two appliers that carry them out.\n */\nimport type { SceneActionOp, SceneEditPatch } from '@operato/scene-ops'\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, SceneEditPatch | SceneActionOp[]> {\n  kind: 'board.analysis.v1'\n}\n\n\nexport interface ChatResponse {\n  /** 사용자에게 보여줄 텍스트 응답 */\n  reply: string\n  /** 보드 변경이 있으면 patch */\n  patch?: SceneEditPatch\n  /**\n   * Scene 조작 action (ephemeral — 모델 변경 없음 / undo 영향 없음).\n   * 시간순 시퀀스로 호스트가 things-scene API 직접 실행.\n   */\n  actions?: SceneActionOp[]\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\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 = applyScenePatch(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). */\n/*\n * The edit vocabulary is not this package's. A person dragging a box produces the same\n * operations, so they live in @operato/scene-ops with the two appliers that carry them out.\n */\nimport type { SceneActionOp, SceneEditPatch } from '@operato/scene-ops'\nimport type { LLMMessage } from '@things-factory/ai-assistant'\nexport type { LLMMessage }\n\nexport interface ChatOptions {\n  /**\n   * Who the assistant is on this surface — a registered mode's `systemPrompt` (ADR-0061 decision 7).\n   * Added after board-ai's own authoring instructions, which stay: they describe the board document\n   * and its tools, and the mode describes the product and the person's work.\n   */\n  surfacePrompt?: string\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, SceneEditPatch | SceneActionOp[]> {\n  kind: 'board.analysis.v1'\n}\n\n\nexport interface ChatResponse {\n  /** 사용자에게 보여줄 텍스트 응답 */\n  reply: string\n  /** 보드 변경이 있으면 patch */\n  patch?: SceneEditPatch\n  /**\n   * Scene 조작 action (ephemeral — 모델 변경 없음 / undo 영향 없음).\n   * 시간순 시퀀스로 호스트가 things-scene API 직접 실행.\n   */\n  actions?: SceneActionOp[]\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\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 = applyScenePatch(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"]}

package/dist-client/server/service/validation/tool-validation.d.ts

@@ -10,7 +10,7 @@
  * 이게 silent 데이터 손상을 막는 마지막 능동 방어선. 검증 통과한 args 만 누적
  * → patch 로 변환되므로 깨진 데이터가 영속까지 못 감.
  */
-import type { AIToolCall } from '@things-factory/ai-client-base';
+import { type AIToolCall } from '@things-factory/ai-client-base';
 export interface ToolValidationResult {
     /** 검증 통과 — 누적 진행 가능 */
     valid: boolean;

package/dist-client/server/service/validation/tool-validation.js

@@ -1,3 +1,16 @@
+/**
+ * Write tool 의 사전 검증 — agentic loop 의 retry 메커니즘.
+ *
+ * 흐름:
+ *   1. LLM 이 write tool 호출
+ *   2. 본 함수가 args 검증 (styling tool 의 build* 함수 또는 schema 직접)
+ *   3. 실패 시 errors 반환 → caller 가 tool_result 에 error 메시지 담아 LLM 한테
+ *   4. LLM 다음 turn 에서 정정 후 재호출 (자기 회복)
+ *
+ * 이게 silent 데이터 손상을 막는 마지막 능동 방어선. 검증 통과한 args 만 누적
+ * → patch 로 변환되므로 깨진 데이터가 영속까지 못 감.
+ */
+import { findToolSpec } from '@things-factory/ai-client-base';
 import { validateComponentPatch, validateComponent, validateBoardPatch } from './board-model-schema';
 import { buildSetFillOps } from '../styling/fill-tools';
 import { buildSetStrokeOps } from '../styling/stroke-tools';
@@ -150,8 +163,21 @@ export function validateWriteToolCall(tc, components = []) {
             return { valid: true };
         }
         // 그 외 — 기존 dispatcher 검증에 위임
-        default:
+        default: {
+            /*
+             * A write tool registered by another category (e.g. board-binding) checks its own arguments
+             * and says what is wrong in `errors`. Its ops were dropped with the errors unread, so the model
+             * heard nothing and told the person the edit was made. Return them as a validation failure.
+             */
+            const spec = findToolSpec(tc.name);
+            if (spec && spec.kind === 'write') {
+                const r = spec.builder(args, { components });
+                if (r && !Array.isArray(r) && Array.isArray(r.errors) && r.errors.length > 0) {
+                    return { valid: false, errors: r.errors };
+                }
+            }
             return { valid: true };
+        }
     }
 }
 function modifySceneSuggestion() {

package/dist-client/server/service/validation/tool-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-validation.js","sourceRoot":"","sources":["../../../../server/service/validation/tool-validation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Write tool 의 사전 검증 — agentic loop 의 retry 메커니즘.\n *\n * 흐름:\n *   1. LLM 이 write tool 호출\n *   2. 본 함수가 args 검증 (styling tool 의 build* 함수 또는 schema 직접)\n *   3. 실패 시 errors 반환 → caller 가 tool_result 에 error 메시지 담아 LLM 한테\n *   4. LLM 다음 turn 에서 정정 후 재호출 (자기 회복)\n *\n * 이게 silent 데이터 손상을 막는 마지막 능동 방어선. 검증 통과한 args 만 누적\n * → patch 로 변환되므로 깨진 데이터가 영속까지 못 감.\n */\nimport type { AIToolCall } from '@things-factory/ai-client-base'\nimport {\n  validateComponentPatch,\n  validateComponent,\n  validateBoardPatch,\n  type ValidationResult\n} from './board-model-schema'\nimport { buildSetFillOps } from '../styling/fill-tools'\nimport { buildSetStrokeOps } from '../styling/stroke-tools'\nimport { buildSetTextOps, buildSetFontOps } from '../styling/text-tools'\nimport {\n  buildSetShadowOps,\n  buildSetOpacityOps,\n  buildSetVisibleOps\n} from '../styling/effect-tools'\nimport {\n  buildSetMaterialOps,\n  buildSetShadowPropertiesOps\n} from '../styling/material-tools'\nimport { buildClearStyleOps } from '../styling/clear-tools'\nimport { buildCopyStyleOps } from '../styling/copy-tools'\n\nexport interface ToolValidationResult {\n  /** 검증 통과 — 누적 진행 가능 */\n  valid: boolean\n  /** 실패 시 LLM 한테 보일 에러 메시지 (자기 회복 정보 포함) */\n  errors?: string[]\n  /** LLM 한테 정정 가이드 — 가능한 경우 어떤 형식이 맞는지 */\n  suggestion?: string\n}\n\n/**\n * write tool 의 args 사전 검증.\n *\n * 정책:\n *   - styling tool: 해당 build* 함수가 errors 반환 — 그대로 LLM 한테\n *   - modifyComponentByRefid: ComponentPatchSchema 로 검증 (raw fallback 영역)\n *   - addComponent: ComponentSchema 로 검증\n *   - 그 외: 기존 dispatcher 의 자체 검증에 위임 (재시도 보장 X)\n */\nexport function validateWriteToolCall(\n  tc: AIToolCall,\n  components: ReadonlyArray<any> = []\n): ToolValidationResult {\n  const args = tc.arguments ?? {}\n\n  // Styling tool 들 — 각 build 함수가 detailed errors 반환\n  switch (tc.name) {\n    case 'setFill': {\n      const r = buildSetFillOps(args as any)\n      if (r.errors.length > 0)\n        return {\n          valid: false,\n          errors: r.errors,\n          suggestion: setFillSuggestion()\n        }\n      return { valid: true }\n    }\n    case 'setStroke': {\n      const r = buildSetStrokeOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setText': {\n      const r = buildSetTextOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setFont': {\n      const r = buildSetFontOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setShadow': {\n      const r = buildSetShadowOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setOpacity': {\n      const r = buildSetOpacityOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setVisible': {\n      const r = buildSetVisibleOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setMaterial': {\n      const r = buildSetMaterialOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setShadowProperties': {\n      const r = buildSetShadowPropertiesOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'clearStyle': {\n      const r = buildClearStyleOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'copyStyle': {\n      const r = buildCopyStyleOps(args as any, components)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n\n    // raw fallback — schema 검증\n    case 'modifyComponentByRefid': {\n      if (typeof args.refid !== 'number') {\n        return { valid: false, errors: ['refid (number) is required'] }\n      }\n      if (!args.patch || typeof args.patch !== 'object') {\n        return { valid: false, errors: ['patch (object) is required'] }\n      }\n      const v = validateComponentPatch(args.patch)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v),\n          suggestion: modifyPatchSuggestion()\n        }\n      }\n      return { valid: true }\n    }\n    case 'addComponent': {\n      const v = validateComponent(args)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v)\n        }\n      }\n      return { valid: true }\n    }\n    case 'modifyScene': {\n      // 보드 root partial 검증 — fillStyle/shadow 같은 nested 의 strict schema 가\n      // unknown key (e.g. fillStyle.gradientStops 같은 stale 이름) 를 거부.\n      // 이게 마지막 방어선 — 다른 styling tool 에서 학습된 vocabulary 가 leak 되면 catch.\n      if (!args.patch || typeof args.patch !== 'object' || Array.isArray(args.patch)) {\n        return { valid: false, errors: ['patch (object) is required'] }\n      }\n      const v = validateBoardPatch(args.patch)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v),\n          suggestion: modifySceneSuggestion()\n        }\n      }\n      return { valid: true }\n    }\n    case 'replaceBoard': {\n      // 보드 통째 교체 — 영속 직전 가장 강력한 검증 필요. components 까지 한 번에\n      // 검사. 자식 컴포넌트의 fillStyle.gradientStops 같은 stale 키도 즉시 catch.\n      // (BoardPatchSchema 는 component 도 array 로 통과시키되 ComponentSchema 가\n      // strict styling sub-objects 로 stale 차단.)\n      const v = validateBoardPatch(args)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v),\n          suggestion: modifySceneSuggestion()\n        }\n      }\n      return { valid: true }\n    }\n\n    // 그 외 — 기존 dispatcher 검증에 위임\n    default:\n      return { valid: true }\n  }\n}\n\nfunction modifySceneSuggestion(): string {\n  return (\n    'modifyScene 의 patch 는 things-scene 의 model-layer 가 인식하는 root key 만 사용. ' +\n    'fillStyle / strokeStyle / shadow 같은 nested object 의 안쪽 필드는 canonical 이름 (colorStops 등) 정확히 사용. ' +\n    'rect 등 자식 컴포넌트 변경은 modifyComponentByRefid 로 분리.'\n  )\n}\n\nfunction formatValidationErrors(v: ValidationResult): string[] {\n  if (v.valid || !v.errors) return []\n  return v.errors.map(e => `${e.path || '<root>'}: ${e.message}`)\n}\n\n/**\n * setFill 정정 가이드 — 자주 실수하는 패턴 + 올바른 예시.\n */\nfunction setFillSuggestion(): string {\n  return [\n    'Valid setFill patterns:',\n    \"  - Solid: { refids:[35], mode:'solid', color:'#ff0000' }\",\n    \"  - Gradient: { refids:[35], mode:'gradient', gradientType:'linear', \" +\n      \"colorStops:[{position:0,color:'#ff0000'},{position:1,color:'#0000ff'}], rotation:90 }\",\n    \"  - Pattern: { refids:[35], mode:'pattern', image:'url' }\",\n    \"  - Partial color update: { refids:[35], color:'green' }  // mode 미지정\",\n    'Notes:',\n    '  - rotation 은 degrees 로 입력 (서버가 라디안으로 변환해 fillStyle.rotation 에 저장)',\n    '  - colorStops 는 { position: 0..1, color: hex/rgb/named } 객체 배열',\n    '  - 옛 이름 (colors / stops / gradientStops) 사용 금지 — engine canonical 은 colorStops'\n  ].join('\\n')\n}\n\nfunction modifyPatchSuggestion(): string {\n  return [\n    'modifyComponentByRefid is the raw fallback — prefer specific styling tools (setFill/setStroke/setText/setFont/setShadow/setMaterial/setOpacity/setVisible) for any styling change.',\n    'If you must use raw modify:',\n    '  - fillStyle string (solid) or {type:\"gradient\",gradientType,colorStops:[{position,color}]} or {type:\"pattern\",image,...}',\n    '  - shadow {color, offsetX, offsetY, blur}  (CSS box-shadow / Canvas 표준 이름)',\n    '  - lineDash STRING preset only (NOT number array)'\n  ].join('\\n')\n}\n"]}
+{"version":3,"file":"tool-validation.js","sourceRoot":"","sources":["../../../../server/service/validation/tool-validation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Write tool 의 사전 검증 — agentic loop 의 retry 메커니즘.\n *\n * 흐름:\n *   1. LLM 이 write tool 호출\n *   2. 본 함수가 args 검증 (styling tool 의 build* 함수 또는 schema 직접)\n *   3. 실패 시 errors 반환 → caller 가 tool_result 에 error 메시지 담아 LLM 한테\n *   4. LLM 다음 turn 에서 정정 후 재호출 (자기 회복)\n *\n * 이게 silent 데이터 손상을 막는 마지막 능동 방어선. 검증 통과한 args 만 누적\n * → patch 로 변환되므로 깨진 데이터가 영속까지 못 감.\n */\nimport { findToolSpec, type AIToolCall } from '@things-factory/ai-client-base'\nimport {\n  validateComponentPatch,\n  validateComponent,\n  validateBoardPatch,\n  type ValidationResult\n} from './board-model-schema'\nimport { buildSetFillOps } from '../styling/fill-tools'\nimport { buildSetStrokeOps } from '../styling/stroke-tools'\nimport { buildSetTextOps, buildSetFontOps } from '../styling/text-tools'\nimport {\n  buildSetShadowOps,\n  buildSetOpacityOps,\n  buildSetVisibleOps\n} from '../styling/effect-tools'\nimport {\n  buildSetMaterialOps,\n  buildSetShadowPropertiesOps\n} from '../styling/material-tools'\nimport { buildClearStyleOps } from '../styling/clear-tools'\nimport { buildCopyStyleOps } from '../styling/copy-tools'\n\nexport interface ToolValidationResult {\n  /** 검증 통과 — 누적 진행 가능 */\n  valid: boolean\n  /** 실패 시 LLM 한테 보일 에러 메시지 (자기 회복 정보 포함) */\n  errors?: string[]\n  /** LLM 한테 정정 가이드 — 가능한 경우 어떤 형식이 맞는지 */\n  suggestion?: string\n}\n\n/**\n * write tool 의 args 사전 검증.\n *\n * 정책:\n *   - styling tool: 해당 build* 함수가 errors 반환 — 그대로 LLM 한테\n *   - modifyComponentByRefid: ComponentPatchSchema 로 검증 (raw fallback 영역)\n *   - addComponent: ComponentSchema 로 검증\n *   - 그 외: 기존 dispatcher 의 자체 검증에 위임 (재시도 보장 X)\n */\nexport function validateWriteToolCall(\n  tc: AIToolCall,\n  components: ReadonlyArray<any> = []\n): ToolValidationResult {\n  const args = tc.arguments ?? {}\n\n  // Styling tool 들 — 각 build 함수가 detailed errors 반환\n  switch (tc.name) {\n    case 'setFill': {\n      const r = buildSetFillOps(args as any)\n      if (r.errors.length > 0)\n        return {\n          valid: false,\n          errors: r.errors,\n          suggestion: setFillSuggestion()\n        }\n      return { valid: true }\n    }\n    case 'setStroke': {\n      const r = buildSetStrokeOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setText': {\n      const r = buildSetTextOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setFont': {\n      const r = buildSetFontOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setShadow': {\n      const r = buildSetShadowOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setOpacity': {\n      const r = buildSetOpacityOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setVisible': {\n      const r = buildSetVisibleOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setMaterial': {\n      const r = buildSetMaterialOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'setShadowProperties': {\n      const r = buildSetShadowPropertiesOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'clearStyle': {\n      const r = buildClearStyleOps(args as any)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n    case 'copyStyle': {\n      const r = buildCopyStyleOps(args as any, components)\n      if (r.errors.length > 0) return { valid: false, errors: r.errors }\n      return { valid: true }\n    }\n\n    // raw fallback — schema 검증\n    case 'modifyComponentByRefid': {\n      if (typeof args.refid !== 'number') {\n        return { valid: false, errors: ['refid (number) is required'] }\n      }\n      if (!args.patch || typeof args.patch !== 'object') {\n        return { valid: false, errors: ['patch (object) is required'] }\n      }\n      const v = validateComponentPatch(args.patch)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v),\n          suggestion: modifyPatchSuggestion()\n        }\n      }\n      return { valid: true }\n    }\n    case 'addComponent': {\n      const v = validateComponent(args)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v)\n        }\n      }\n      return { valid: true }\n    }\n    case 'modifyScene': {\n      // 보드 root partial 검증 — fillStyle/shadow 같은 nested 의 strict schema 가\n      // unknown key (e.g. fillStyle.gradientStops 같은 stale 이름) 를 거부.\n      // 이게 마지막 방어선 — 다른 styling tool 에서 학습된 vocabulary 가 leak 되면 catch.\n      if (!args.patch || typeof args.patch !== 'object' || Array.isArray(args.patch)) {\n        return { valid: false, errors: ['patch (object) is required'] }\n      }\n      const v = validateBoardPatch(args.patch)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v),\n          suggestion: modifySceneSuggestion()\n        }\n      }\n      return { valid: true }\n    }\n    case 'replaceBoard': {\n      // 보드 통째 교체 — 영속 직전 가장 강력한 검증 필요. components 까지 한 번에\n      // 검사. 자식 컴포넌트의 fillStyle.gradientStops 같은 stale 키도 즉시 catch.\n      // (BoardPatchSchema 는 component 도 array 로 통과시키되 ComponentSchema 가\n      // strict styling sub-objects 로 stale 차단.)\n      const v = validateBoardPatch(args)\n      if (!v.valid) {\n        return {\n          valid: false,\n          errors: formatValidationErrors(v),\n          suggestion: modifySceneSuggestion()\n        }\n      }\n      return { valid: true }\n    }\n\n    // 그 외 — 기존 dispatcher 검증에 위임\n    default: {\n      /*\n       * A write tool registered by another category (e.g. board-binding) checks its own arguments\n       * and says what is wrong in `errors`. Its ops were dropped with the errors unread, so the model\n       * heard nothing and told the person the edit was made. Return them as a validation failure.\n       */\n      const spec = findToolSpec(tc.name)\n      if (spec && spec.kind === 'write') {\n        const r: any = (spec.builder as any)(args, { components })\n        if (r && !Array.isArray(r) && Array.isArray(r.errors) && r.errors.length > 0) {\n          return { valid: false, errors: r.errors }\n        }\n      }\n      return { valid: true }\n    }\n  }\n}\n\nfunction modifySceneSuggestion(): string {\n  return (\n    'modifyScene 의 patch 는 things-scene 의 model-layer 가 인식하는 root key 만 사용. ' +\n    'fillStyle / strokeStyle / shadow 같은 nested object 의 안쪽 필드는 canonical 이름 (colorStops 등) 정확히 사용. ' +\n    'rect 등 자식 컴포넌트 변경은 modifyComponentByRefid 로 분리.'\n  )\n}\n\nfunction formatValidationErrors(v: ValidationResult): string[] {\n  if (v.valid || !v.errors) return []\n  return v.errors.map(e => `${e.path || '<root>'}: ${e.message}`)\n}\n\n/**\n * setFill 정정 가이드 — 자주 실수하는 패턴 + 올바른 예시.\n */\nfunction setFillSuggestion(): string {\n  return [\n    'Valid setFill patterns:',\n    \"  - Solid: { refids:[35], mode:'solid', color:'#ff0000' }\",\n    \"  - Gradient: { refids:[35], mode:'gradient', gradientType:'linear', \" +\n      \"colorStops:[{position:0,color:'#ff0000'},{position:1,color:'#0000ff'}], rotation:90 }\",\n    \"  - Pattern: { refids:[35], mode:'pattern', image:'url' }\",\n    \"  - Partial color update: { refids:[35], color:'green' }  // mode 미지정\",\n    'Notes:',\n    '  - rotation 은 degrees 로 입력 (서버가 라디안으로 변환해 fillStyle.rotation 에 저장)',\n    '  - colorStops 는 { position: 0..1, color: hex/rgb/named } 객체 배열',\n    '  - 옛 이름 (colors / stops / gradientStops) 사용 금지 — engine canonical 은 colorStops'\n  ].join('\\n')\n}\n\nfunction modifyPatchSuggestion(): string {\n  return [\n    'modifyComponentByRefid is the raw fallback — prefer specific styling tools (setFill/setStroke/setText/setFont/setShadow/setMaterial/setOpacity/setVisible) for any styling change.',\n    'If you must use raw modify:',\n    '  - fillStyle string (solid) or {type:\"gradient\",gradientType,colorStops:[{position,color}]} or {type:\"pattern\",image,...}',\n    '  - shadow {color, offsetX, offsetY, blur}  (CSS box-shadow / Canvas 표준 이름)',\n    '  - lineDash STRING preset only (NOT number array)'\n  ].join('\\n')\n}\n"]}