@things-factory/board-ai 10.0.0-beta.71 → 10.0.0-beta.72

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

@@ -7,7 +7,8 @@ import { resolveCatalogMentions } from './catalog-resolver';
 import { buildComponentStyleSummary } from './styling/read-tools';
 import { runAgenticLoop } from './agentic-loop';
 import { collectAllComponents, findComponentByRefid } from './component-tree';
-import { isStylingTool, dispatchStylingTool, buildStylingToolDefinitions } from './styling/registry';
+import { isStylingTool, dispatchStylingTool, buildStylingToolDefinitions } from './styling/registry.js';
+import { getAllToolSpecs, getToolKind, findToolSpec } from '@things-factory/ai-client-base';
 import { validateWriteToolCall } from './validation/tool-validation';
 const ALL_CATEGORIES = [
     'container',
@@ -99,6 +100,29 @@ export class DefaultBoardAIAssistant {
         ];
         // multi-turn agentic loop — LLM 이 read 호출 → 서버 실행 → 결과 회신 → LLM 추론 반복.
         // write tool 은 누적해 client 에 patch 로 전달. 본체는 ./agentic-loop 에 분리.
+        //
+        // executeReadTool 은 closure wrapper — board-ai 자체 read tool (READ_TOOL_NAMES) 은
+        // 기존 hardcoded executeReadTool 로 dispatch, registry 에 등록된 read/external tool
+        // 은 spec.builder 에 ctx (board, selectedRefids, state=options.toolCallContext) 주입.
+        const toolCallContext = options.toolCallContext;
+        const wrappedExecuteReadTool = (call, board, selectedRefids) => {
+            // 1) board-ai 코어 read tool — 기존 hardcoded 경로
+            if (READ_TOOL_NAMES.has(call.name)) {
+                return executeReadTool(call, board, selectedRefids);
+            }
+            // 2) registry — read 와 external 둘 다 동일 dispatch path (LLM 회신 측면 동일).
+            //    external builder 가 server-side mutation 호출하는 케이스라 ctx.state 주입 필수.
+            const spec = findToolSpec(call.name);
+            if (spec && (spec.kind === 'read' || spec.kind === 'external')) {
+                return spec.builder(call.arguments ?? {}, {
+                    board,
+                    selectedRefids,
+                    state: toolCallContext
+                });
+            }
+            // 3) 미등록 / 잘못된 분기 — 빈 응답. agentic-loop 가 LLM 에 회신 후 다음 turn.
+            return undefined;
+        };
         const loopResult = await runAgenticLoop({
             initialConversation: conversation,
             tools,
@@ -113,7 +137,7 @@ export class DefaultBoardAIAssistant {
                 isReadTool,
                 isWriteTool,
                 isActionTool,
-                executeReadTool,
+                executeReadTool: wrappedExecuteReadTool,
                 validateWriteToolCall,
                 toolCallToBoardActionOp,
                 summarizeToolResult
@@ -529,6 +553,10 @@ export function buildBoardEditTools(knownTypes) {
         // styling registry 에서 자동 도출 — setFill 부터 점진 이전 중.
         // 다음 tool 들은 registry 로 옮겨질 때마다 본 spread 가 자동 흡수.
         ...buildStylingToolDefinitions(),
+        // tool-registry plugin point — 외부 도메인 패키지 (board-import 등) 가
+        // registerToolCategory() 로 등록한 모든 tool 의 LLM 정의를 spread.
+        // styling 처럼 board-ai 코어 안에 정의되지 않고 외부에서 들어오는 카테고리들.
+        ...buildExternalCategoryDefinitions(),
         {
             name: 'getComponentStyle',
             description: "Get the current STYLING state of a component (read-only). Useful before modifying styles to understand what's already applied (avoid blind overwrites). Returns fill / stroke / shadow / material3d / font / opacity / visibility / text. Use `aspects` to limit response size.",
@@ -1698,7 +1726,13 @@ const LAYOUT_TEMPLATES = {
     ]
 };
 export function isReadTool(name) {
-    return READ_TOOL_NAMES.has(name);
+    if (READ_TOOL_NAMES.has(name))
+        return true;
+    // tool-registry plugin point — 'read' 와 'external' 는 LLM 측에서 동일하게 다뤄짐
+    // (server 즉시 실행 + 결과 회신). external 은 board model 외부 entity 변경이
+    // 가능한 점에서 의미 차이가 있지만, dispatch path 는 read 와 같다.
+    const kind = getToolKind(name);
+    return kind === 'read' || kind === 'external';
 }
 /**
  * 등록된 색 팔레트 이름 목록 — catalog-resolver / 클라이언트 popup 데이터 source.
@@ -1769,10 +1803,26 @@ export function summarizeToolResult(value, depth = 0) {
     return undefined;
 }
 export function isWriteTool(name) {
-    return WRITE_TOOL_NAMES.has(name);
+    if (WRITE_TOOL_NAMES.has(name))
+        return true;
+    return getToolKind(name) === 'write';
 }
 export function isActionTool(name) {
-    return ACTION_TOOL_NAMES.has(name);
+    if (ACTION_TOOL_NAMES.has(name))
+        return true;
+    return getToolKind(name) === 'action';
+}
+/**
+ * tool-registry plugin point — 등록된 모든 외부 카테고리의 LLM tool 정의를 도출.
+ * styling-tools 가 buildStylingToolDefinitions 로 자기 정의를 내보내듯, 외부 카테고리
+ * (board-import 등) 도 본 함수로 합집합. buildBoardEditTools 의 spread 부분에서 호출.
+ */
+function buildExternalCategoryDefinitions() {
+    return getAllToolSpecs().map(spec => ({
+        name: spec.name,
+        description: spec.themeNote ? `${spec.description} ${spec.themeNote}` : spec.description,
+        parameters: spec.schema
+    }));
 }
 /**
  * Tool call → BoardActionOp 변환 (C-1 ephemeral scene 조작).
@@ -1846,6 +1896,18 @@ export function toolCallToBoardEditOp(tc, components = []) {
     if (isStylingTool(tc.name)) {
         return dispatchStylingTool(tc.name, args, components);
     }
+    // tool-registry plugin point — 외부 등록 'write' 카테고리 dispatch.
+    // builder 결과는 BoardEditOp[] | { ops, errors? } | null 셋 중 하나.
+    // (read/external 카테고리는 별도 dispatch path — agentic loop 의 executeReadTool 이 직접 처리.)
+    const registrySpec = findToolSpec(tc.name);
+    if (registrySpec && registrySpec.kind === 'write') {
+        const r = registrySpec.builder(args, { components });
+        if (!r)
+            return null;
+        if (Array.isArray(r))
+            return r.length > 0 ? r : null;
+        return r.ops.length > 0 ? r.ops : null;
+    }
     switch (tc.name) {
         case 'addComponent': {
             if (typeof args.type !== 'string')