@things-factory/board-ai 10.0.0-beta.64

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

@@ -0,0 +1,75 @@
+/**
+ * DefaultBoardAIAssistant — base AIClient 위에 LLM 프롬프트로 chat() 구현.
+ */
+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';
+export interface BoardAIAssistantOptions {
+    /** 기본 scope (chat 호출 시 옵션이 없으면 사용) */
+    scopes?: string[];
+    knownTypes?: string[];
+    categories?: ComponentCategory[];
+}
+export declare class DefaultBoardAIAssistant implements BoardAIAssistant {
+    private base;
+    private options;
+    readonly id: string;
+    constructor(base: AIClient, options?: BoardAIAssistantOptions);
+    chat(messages: LLMMessage[], currentBoard: BoardModel | undefined, options?: ChatOptions): Promise<ChatResponse>;
+    private chatViaTools;
+    private chatViaJSON;
+    private resolveTypesAndCategories;
+    private buildSystemPrompt;
+    private buildSystemPromptForTools;
+}
+/**
+ * 4 op 직교 set 을 4 개의 도구로 정의.
+ *
+ * 핵심: addComponent 의 `type` 파라미터가 knownTypes 의 enum 으로 강제 →
+ *       LLM 이 등록 안 된 type 을 만들 수 없음 (provider 단계에서 차단).
+ *
+ * 좌표/크기 키들은 모두 optional 로 허용 (type 별로 사용 키 다름).
+ * type-specific 추가 속성은 additionalProperties 로 허용.
+ */
+export declare function buildBoardEditTools(knownTypes: string[]): AITool[];
+/**
+ * Read tool 의 서버측 실행기 — currentBoard / selectedRefids 에 대해 즉시 실행해 결과 반환.
+ * LLM 의 다음 turn 에 tool_result 로 회신된다.
+ *
+ * 식별자 정책:
+ *   - 컴포넌트 targeting 은 항상 refid (universal numeric handle).
+ *   - id 는 데이터 바인딩 이름이며 unique 가 아니다 — filter 용도로만 사용 (findComponents).
+ */
+export declare function executeReadTool(call: AIToolCall, currentBoard: BoardModel | null | undefined, selectedRefids: number[]): any;
+export declare function isReadTool(name: string): boolean;
+/**
+ * tool 결과를 UI fold-able 박스에 보여줄 만한 크기로 요약.
+ *
+ * 원본 그대로면 findComponents 50개 / getAtmosphereGuide 같은 큰 객체가 ChatMessage
+ * 영속까지 부담 — 핵심 모양만 유지하고 나머지는 marker.
+ */
+export declare function summarizeToolResult(value: any, depth?: number): any;
+export declare function isWriteTool(name: string): boolean;
+/**
+ * AIToolChatResult → ChatResponse.
+ *
+ * 정책 — followUp 항상 undefined: reply 와 동일 텍스트를 followUp 에 복제하면 클라이언트
+ * 에서 .md-body 와 .followup 두 박스에 같은 내용이 표시되어 사용자에게 "동일 응답이
+ * 두 번 반복" 으로 보인다. 명확화 질문이 필요한 경우 LLM 이 reply 자체에 포함시키도록
+ * 설계.
+ */
+export declare function toolResultToChatResponse(result: AIToolChatResult): ChatResponse;
+export declare function toolCallToBoardEditOp(tc: AIToolCall): BoardEditOp | null;
+interface RawChatResponse {
+    reply?: string;
+    patch?: {
+        ops?: any[];
+        summary?: string;
+        confidence?: number;
+    } | null;
+    followUp?: string | null;
+}
+export declare function normalizeChatResponse(raw: RawChatResponse): ChatResponse;
+export declare function isValidOp(op: any): boolean;
+export declare function summarizeBoard(board: BoardModel | null | undefined): any;
+export {};