@things-factory/board-ai 10.0.18 → 10.1.0

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

@@ -4,7 +4,7 @@
 import type { AIClient, AITool, AIToolCall, AIToolChatResult } from '@things-factory/ai-client-base';
 import { type BoardModel, type ComponentCategory } from '@things-factory/board-import';
 import type { BoardAIAssistant, BoardEditOp, ChatOptions, ChatResponse, LLMMessage } from './types.js';
-import { type AgenticLoopResult } from './agentic-loop';
+import { type AgenticLoopResult } from '@things-factory/ai-client-base';
 import { type ToolSpec, type ToolCategoryFilter } from '@things-factory/ai-client-base';
 export interface BoardAIAssistantOptions {
     /** 기본 scope (chat 호출 시 옵션이 없으면 사용) */

package/dist-client/server/service/assistant.js

@@ -5,7 +5,14 @@ import { resolveCatalogMentions } from './catalog-resolver';
 // styling write tool builder 들은 registry (./styling/registry.ts) 에서 등록 + dispatch.
 // 직접 import 안 함 — 신규 styling tool 추가 시 registry 에만 spec 추가하면 됨.
 import { buildComponentStyleSummary } from './styling/read-tools';
-import { runAgenticLoop } from './agentic-loop';
+/*
+ * 도구 루프는 **계약 층이 소유한다**(2026-09-05). 전에는 이 패키지 안에 있었고, twin-ai 에 같은
+ * 모양이 한 벌 더 있었다 — 그래서 안전 장치가 서로 반대로 갈렸다(여기는 중단·조기종료, 저쪽은
+ * 접지 가드). 합친 것이 `@things-factory/ai-client-base` 에 있다.
+ *
+ * board 의 것(문서·선택 refid·편집 op)은 타입 매개변수로 넘긴다 — 루프는 그 모양을 모른다.
+ */
+import { runAgenticLoop } from '@things-factory/ai-client-base';
 import { checkReplyGrounding } from './grounding';
 import { collectAllComponents, findComponentByRefid } from './component-tree';
 import { isStylingTool, dispatchStylingTool, buildStylingToolDefinitions } from './styling/registry.js';
@@ -156,13 +163,13 @@ export class DefaultBoardAIAssistant {
                 isReadTool: gate.isRead,
                 isWriteTool: gate.isWrite,
                 isActionTool: gate.isAction,
-                executeReadTool: wrappedExecuteReadTool,
-                validateWriteToolCall,
-                toolCallToBoardActionOp,
+                executeReadTool: (tc, ctx) => wrappedExecuteReadTool(tc, ctx.board, ctx.selectedRefids),
+                /* 문서에서 부품을 꺼내는 일은 **여기서** 한다 — 루프는 board 의 모양을 모른다. */
+                validateWriteToolCall: (tc, ctx) => validateWriteToolCall(tc, (ctx.board?.components ?? [])),
+                toolCallToOp: toolCallToBoardActionOp,
                 summarizeToolResult
             },
-            currentBoard,
-            selectedRefids
+            context: { board: currentBoard, selectedRefids }
         });
         const accumulatedWriteCalls = loopResult.accumulatedWriteCalls;
         const accumulatedActions = loopResult.accumulatedActions;